Skip to content

Chromosome-Recurrent Abnormality Detector (ReAD) is a neural network for automatically identifying structural rearrangements important in hematology oncology.

License

Notifications You must be signed in to change notification settings

DaehwanKimLab/Chromosome-ReAD

Repository files navigation

Contributors Forks Stargazers Issues MIT License LinkedIn


Logo

Chromosome-ReAD

A deep convolutional neural network for Recurrent Abnormality Detection in chromosomes!
Explore the docs »

View Demo · Report Bug · Request Feature

Table of Contents
  1. Manuscript
  2. About The Project
  3. Getting Started
  4. Usage
  5. Roadmap
  6. Contributing
  7. License
  8. Contact
  9. Acknowledgements

Manuscript

This work has been published by BMC Bioinformatics. Please check out the paper and reach out with any questions or comments!

About The Project

There are many great neural networks for classifying chromosomes, however, a great deal of clinical cytogenetics involves analyzing samples with abnormal chromosomes. So, we created Chromosome Recurrent Abnormality Detector (ReAD) to automatically classify many important abnormalities found in patients with blood cancer.

Here's why:

  • Currently, cytogeneticists spend the majority of their time manually classifying chromosomes but can only inspect a tiny fraction of the cells collected from imaging.
  • Recurrent abnormalities can heavily inform the diagnosis, prognisis, and treatment plan.
  • An automated classifier could screen hundreds of cells for abnormalities and flag cells requiring further inspection.

Certainly, this neural network does not cover all types of recurrent abnormalities in hematopathology. So I'll be updating the model in the near future to incorporate more. If you have your own dataset, you may also suggest changes by forking this repo and creating a pull request or opening an issue.

Built With

Getting Started

Prerequisites

  • python 3.7
  • fastai 2.1.4
  • fastai2 0.0.30
  • fastasi2-extensions 0.0.31
  • torch 1.7.0
  • jupyter 1.0.0
  • numpy 1.19.4

A dataset of individual chromosome images.

Installation

Clone the repository: git clone https:github.com/DaehwanKimLab/Chromosome-ReAD.

Usage

The directory contains 4 Jupyter notebooks, one for each convolutional neural network architecture tested, that can be ran to repeat training network from scratch and inferring on the test set. If you would like to preserve the orginal experimental results but would like to rerun the experiments yourself, simply make a copy a notebook and run the cells in the duplicate.

Roadmap

See the open issues for a list of proposed features (and known issues).

Contributing

Contributions are what make the open source community such an amazing place to be learn, inspire, and create. Any contributions you make are greatly appreciated.

  1. Fork the Project
  2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
  3. Commit your Changes (git commit -m 'Add some AmazingFeature')
  4. Push to the Branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

License

Distributed under the MIT License. See LICENSE for more information.

Contact

Your Name - @and_m_cox - Andrew.Cox@UTSouthwestern.edu

Project Link: https://github.com/DaehwanKimLab/Chromosome-ReAD

Acknowledgements

UT Southwestern Bioinformatics and Pathology Departments.

About

Chromosome-Recurrent Abnormality Detector (ReAD) is a neural network for automatically identifying structural rearrangements important in hematology oncology.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published