|
1 |
| -# coSMicQC |
| 1 | +<img height="200" src="https://raw.githubusercontent.com/WayScience/coSMicQC/main/logo/with-text-for-light-bg.png?raw=true"> |
2 | 2 |
|
3 |
| -coSMicQC is a software tool for single-cell quality control of morphology datasets. |
| 3 | +# Single cell Morphology Quality Control |
| 4 | + |
| 5 | +[](https://github.com/WayScience/coSMicQC/actions/workflows/run-tests.yml?query=branch%3Amain) |
| 6 | +[](https://github.com/astral-sh/ruff) |
| 7 | +[](https://python-poetry.org/) |
| 8 | + |
| 9 | + |
| 10 | +> :stars: Navigate the cosmos of single-cell morphology with confidence — coSMicQC keeps your data on course! |
| 11 | +
|
| 12 | +coSMicQC is a Python package to evaluate converted single-cell morphology outputs from CytoTable. |
| 13 | + |
| 14 | +It can be challenging to get "perfect" single-cell compartment segmentation across large high-throughput screens when performing object detection in CellProfiler (or similar software). |
| 15 | +Technical artifacts can arise during segmentation, leading to issues such as under-segmentation, over-segmentation, or the erroneous segmentation of background noise, smudges, or bright artifacts. |
| 16 | + |
| 17 | +In single-cell analysis, intriguing phenotypes often emerge by examining morphological differences. |
| 18 | +However, technical outliers in the data can obscure these biological insights, compromising the validity of the findings. |
| 19 | + |
| 20 | +By utilizing specific morphological features extracted with CellProfiler, particularly AreaShape features, you can identify technically incorrect segmentations. |
| 21 | +These can then be labeled or removed before further preprocessing steps, such as those performed with pycytominer. |
| 22 | + |
| 23 | +## Installation |
| 24 | + |
| 25 | +Install coSMicQC from [PyPI](https://pypi.org/project/coSMicQC/) or from source: |
| 26 | + |
| 27 | +```shell |
| 28 | +# install from pypi |
| 29 | +pip install coSMicQC |
| 30 | + |
| 31 | +# install directly from source |
| 32 | +pip install git+https://github.com/WayScience/coSMicQC.git |
| 33 | +``` |
| 34 | + |
| 35 | +## Contributing, Development, and Testing |
| 36 | + |
| 37 | +Please see [CONTRIBUTING.md](CONTRIBUTING.md) for more details on contributions, development, and testing. |
| 38 | +## References |
| 39 | + |
| 40 | +- [pycytominer](https://github.com/cytomining/pycytominer) |
| 41 | +- [CellProfiler](https://github.com/CellProfiler/CellProfiler) |
| 42 | +- [CytoTable](https://github.com/cytomining/CytoTable) |
0 commit comments