Skip to content

Commit 5451acb

Browse files
Update README with logo and documentation (#61)
* update README with logo and documentation * update documentation based on review
1 parent 82ffe71 commit 5451acb

File tree

1 file changed

+41
-2
lines changed

1 file changed

+41
-2
lines changed

README.md

Lines changed: 41 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,42 @@
1-
# coSMicQC
1+
<img height="200" src="https://raw.githubusercontent.com/WayScience/coSMicQC/main/logo/with-text-for-light-bg.png?raw=true">
22

3-
coSMicQC is a software tool for single-cell quality control of morphology datasets.
3+
# Single cell Morphology Quality Control
4+
5+
[![Build Status](https://github.com/WayScience/coSMicQC/actions/workflows/run-tests.yml/badge.svg?branch=main)](https://github.com/WayScience/coSMicQC/actions/workflows/run-tests.yml?query=branch%3Amain)
6+
[![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff)
7+
[![Poetry](https://img.shields.io/endpoint?url=https://python-poetry.org/badge/v0.json)](https://python-poetry.org/)
8+
![PyPI - Version](https://img.shields.io/pypi/v/cosmicqc)
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

Comments
 (0)