Skip to content

Commit 70803dc

Browse files
authored
Tighten website content and add details on org structures (#16)
* minor fixes to tighten * remove old file * add view on github * respond to comments and pass check * fix link check * setup hugo first
1 parent 44d9a8f commit 70803dc

19 files changed

Lines changed: 206 additions & 71 deletions

File tree

.github/workflows/link-check.yaml

Lines changed: 14 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -11,20 +11,33 @@ jobs:
1111
steps:
1212
- name: Checkout
1313
uses: actions/checkout@v6
14+
with:
15+
submodules: true
16+
17+
- name: Setup Hugo
18+
uses: peaceiris/actions-hugo@v3
19+
with:
20+
hugo-version: latest
21+
extended: true
22+
23+
- name: Build site
24+
run: hugo --minify
1425

1526
- name: Check links with lychee
1627
uses: lycheeverse/lychee-action@v2
1728
with:
18-
# Check all Markdown files in content/ and the root-level docs
29+
# Check all Markdown files; --root-dir resolves root-relative links against built site
1930
args: >-
2031
--verbose
2132
--no-progress
33+
--root-dir ./public
2234
--exclude-path node_modules
2335
--exclude "^https://forum\\.image\\.sc/"
2436
--exclude "^https://www\\.broadinstitute\\.org/"
2537
--exclude "^https://www\\.eu-openscreen\\.eu/"
2638
--exclude "^https://doi\\.org/"
2739
--exclude "^https://gohugo\\.io/installation/"
40+
--exclude "^https://sbi2\\.org/"
2841
'content/**/*.md'
2942
'*.md'
3043
fail: true

assets/css/custom.css

Lines changed: 33 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -138,6 +138,39 @@ html.dark .hero-btn-primary { background: #3b82f6 !important; }
138138
html.dark .hero-btn-outline { border-color: #374151 !important; color: #d1d5db !important; }
139139
html.dark .hero-secondary-link { color: #6b7280 !important; border-bottom-color: #374151 !important; }
140140

141+
/* Inline code: remove Congo's visible backtick pseudo-elements, style like standard markdown */
142+
.prose :where(code):not(:where([class~="not-prose"],[class~="not-prose"] *))::before,
143+
.prose :where(code):not(:where([class~="not-prose"],[class~="not-prose"] *))::after {
144+
content: "" !important;
145+
}
146+
.prose :where(code):not(:where(pre *, [class~="not-prose"], [class~="not-prose"] *)) {
147+
background: #f3f4f6;
148+
color: #374151;
149+
padding: 0.15em 0.4em;
150+
border-radius: 3px;
151+
font-weight: 400;
152+
font-size: 0.875em;
153+
}
154+
html.dark .prose :where(code):not(:where(pre *, [class~="not-prose"], [class~="not-prose"] *)) {
155+
background: #374151;
156+
color: #e5e7eb;
157+
}
158+
159+
/* Publication card dark mode */
160+
html.dark .publication-card {
161+
background: #1f2937 !important;
162+
border-color: #374151 !important;
163+
}
164+
html.dark .publication-card p[style*="color: #374151"] {
165+
color: #e5e7eb !important;
166+
}
167+
html.dark .publication-card p[style*="color: #6b7280"] {
168+
color: #9ca3af !important;
169+
}
170+
html.dark .publication-card a {
171+
color: #93c5fd !important;
172+
}
173+
141174
/* Header breakpoint override:
142175
Use hamburger menu up to 900px (instead of Congo's default 640px). */
143176
@media (max-width: 900px) {

content/about/_index.md

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -7,29 +7,29 @@ showAuthor: false
77

88
Cytomining is an open-source software ecosystem for single-cell image-based profiling — the practice of measuring thousands of cell morphology features from microscopy images to understand how cells respond to genetic, chemical, or environmental perturbations.
99

10-
Core tools are maintained under the [cytomining GitHub organization](https://github.com/cytomining) by [contributors](https://github.com/orgs/cytomining/people) from the [Way Lab](https://www.waysciencelab.com/) at the University of Colorado Anschutz Medical Campus and beyond.
10+
Core tools are maintained under the [Cytomining GitHub organization](https://github.com/cytomining) by [contributors](https://github.com/orgs/cytomining/people) from the [Way Lab](https://www.waysciencelab.com/) at the University of Colorado Anschutz Medical Campus and beyond.
1111
Experimental and emerging tools are developed under the [WayScience GitHub organization](https://github.com/WayScience) before graduating into the core ecosystem.
1212

1313
## Impact
1414

1515
Cytomining tools have been adopted across academia and industry for large-scale drug discovery and functional genomics.
16-
`Pycytominer` underpins some of the largest publicly available image-based profiling datasets, including the [JUMP Cell Painting dataset](https://jump-cellpainting.broadinstitute.org/) (over 136,000 chemical and genetic perturbations profiled across 12 partner sites) the [LINCS Drug Repurposing](https://github.com/broadinstitute/lincs-cell-painting) Cell Painting dataset, and the [EU-OPENSCREEN](https://www.eu-openscreen.eu/) Bioactive Compound Set profiled across multiple imaging sites.
16+
[`Pycytominer`](/tools/pycytominer/) underpins some of the largest publicly available image-based profiling datasets, including the [JUMP Cell Painting dataset](https://jump-cellpainting.broadinstitute.org/) (over 136,000 chemical and genetic perturbations profiled across 12 partner sites) the [LINCS Drug Repurposing](https://github.com/broadinstitute/lincs-cell-painting) Cell Painting dataset, and the [EU-OPENSCREEN](https://www.eu-openscreen.eu/) Bioactive Compound Set profiled across multiple imaging sites.
1717
It has also processed many of the 31+ datasets in the [Cell Painting Gallery](https://broadinstitute.github.io/cellpainting-gallery/).
1818

1919
The foundational [Caicedo et al. 2017](https://doi.org/10.1038/nmeth.4397) review has accumulated over 670 citations, and individual tool papers have together been cited more than 150 times since 2024.
2020
Packages are downloaded thousands of times per month via [PyPI] download statistics (https://pypistats.org/).
2121

2222
## History
2323

24-
The ecosystem traces its roots to the [Imaging Platform](https://www.broadinstitute.org/imaging) at the Broad Institute, where early contributors including Anne Carpenter, Shantanu Singh, Allen Goodman, and others developed `cytominer`, an R package for processing high-content imaging data.
24+
The ecosystem traces its roots to the [Imaging Platform](https://www.broadinstitute.org/imaging) at the Broad Institute, where early contributors including Anne Carpenter, Shantanu Singh, Allen Goodman, and others developed [`cytominer`](https://github.com/cytomining/cytominer), an R package for processing high-content imaging data.
2525

2626
In 2016, members of this community co-founded the [CytoData Society](https://www.cytodata.org/) to unite researchers across academia and industry around image-based profiling.
2727
The following year, the team contributed the landmark [Caicedo et al. 2017](https://doi.org/10.1038/nmeth.4397) review in _Nature Methods_ that established the field's foundational analysis standards.
2828

29-
Since 2021, the [Way Lab](https://www.waysciencelab.com/) has driven a major expansion of the ecosystem — migrating from R to Python with `Pycytominer` and building a modern infrastructure stack including `CytoTable` and `coSMicQC`.
29+
Since 2021, the [Way Lab](https://www.waysciencelab.com/) has driven a major expansion of the ecosystem — migrating from R to Python with [`Pycytominer`](/tools/pycytominer/) and building a modern infrastructure stack including [`CytoTable`](/tools/cytotable/), [`coSMicQC`](/tools/cosmicqc/), and others.
3030
In 2026, members of the CytoData community published an updated review, [Serrano et al.](https://doi.org/10.1038/s44320-026-00197-7) in _Molecular Systems Biology_, surveying progress and new challenges in image-based profiling.
3131
Today, Cytomining tools are used by research groups worldwide for drug discovery, functional genomics, and cell biology.
3232

33-
## Community
33+
## Communities
3434

35-
We are proud members of the [CytoData](https://www.cytodata.org/) community, which hosts an annual symposium bringing together researchers and developers working on image-based profiling.
35+
We are proud members of the [CytoData Society](https://www.cytodata.org/) and [The Society of Biomolecular Imaging and Informatics](https://sbi2.org/), which hosts an annual symposium bringing together researchers and developers working on image-based profiling.

content/contact/_index.md

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,6 +3,8 @@ title: Contact
33
description: Get in touch with the Cytomining community.
44
---
55

6-
- 💬 Join the conversation on our [Discourse forums](https://forum.image.sc/)
6+
- 🎮 Join us on [Discord](https://discord.gg/dgEDz6xzfJ)
7+
- 💬 Ask a question at [image.sc](https://forum.image.sc/)
78
- 📫 Subscribe to the [CytoData mailing list](https://www.cytodata.org/contact/)
9+
- 🔬 Join the [SBI2 community](https://sbi2.org/)
810
- 🐛 Report issues on [GitHub](https://github.com/cytomining)

content/experimental/buscar.md

Lines changed: 4 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -8,11 +8,14 @@ logoUrl: "https://raw.githubusercontent.com/WayScience/buscar/main/logo/just-ico
88
githubRepo: "WayScience/buscar"
99
---
1010

11+
<a href="https://github.com/WayScience/buscar" target="_blank" rel="external">
1112
<img class="logo-light" src="https://raw.githubusercontent.com/WayScience/buscar/main/logo/with-text-for-light-bg.png" alt="buscar logo" width="400">
1213
<img class="logo-dark" src="https://raw.githubusercontent.com/WayScience/buscar/main/logo/with-text-for-dark-bg.png" alt="buscar logo" width="400">
14+
</a>
1315

1416
{{< tool-badges >}}
1517

18+
1619
`buscar` scores perturbations directly on single-cell distributions using Earth Mover's Distance, preserving heterogeneity throughout hit calling.
1720

1821
**Problem:** Population-level hit calling averages away biologically meaningful cell-to-cell variation, making heterogeneous responses and rare subpopulations invisible to standard metrics.
@@ -23,6 +26,6 @@ githubRepo: "WayScience/buscar"
2326
- Score perturbation efficacy via Earth Mover's Distance
2427
- Assess specificity with off-target scoring to reduce false positives
2528
- Preserve single-cell heterogeneity throughout hit calling
26-
- Integrates directly with `Pycytominer`, `coSMicQC`, and `CytoTable` workflows
29+
- Integrates directly with [`Pycytominer`](/tools/pycytominer/), [`coSMicQC`](/tools/cosmicqc/), and [`CytoTable`](/tools/cytotable/) workflows
2730

2831
**[View on GitHub →](https://github.com/WayScience/buscar)**

content/experimental/iceberg-bioimage.md

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -8,10 +8,13 @@ logoUrl: "https://raw.githubusercontent.com/WayScience/iceberg-bioimage/main/doc
88
githubRepo: "WayScience/iceberg-bioimage"
99
---
1010

11+
<a href="https://github.com/WayScience/iceberg-bioimage" target="_blank" rel="external">
1112
<img src="https://raw.githubusercontent.com/WayScience/iceberg-bioimage/main/docs/src/_static/iceberg-bioimage-logo.png" alt="iceberg-bioimage logo" width="400">
13+
</a>
1214

1315
{{< tool-badges >}}
1416

17+
1518
`iceberg-bioimage` scans any image store into a versioned Apache Iceberg catalog that directly exports Cytomining-compatible Parquet warehouses.
1619

1720
**Problem:** Raw bioimaging archives have no standard catalog — finding, versioning, and joining images to downstream data requires bespoke scripts per lab.

content/experimental/ome-arrow.md

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -8,10 +8,13 @@ logoUrl: "https://raw.githubusercontent.com/wayscience/ome-arrow/main/docs/src/_
88
githubRepo: "WayScience/OME-arrow"
99
---
1010

11+
<a href="https://github.com/WayScience/OME-arrow" target="_blank" rel="external">
1112
<img src="https://raw.githubusercontent.com/wayscience/ome-arrow/main/docs/src/_static/ome-arrow-with-text.png?raw=true" alt="OME-arrow logo" width="400">
13+
</a>
1214

1315
{{< tool-badges >}}
1416

17+
1518
`OME-arrow` embeds images as first-class columns in Apache Arrow tables, so features, metadata, and pixel data travel together and can be queried or exported as tensors.
1619

1720
**Problem:** Images and feature tables live in separate systems — linking a numeric outlier back to its source cell requires error-prone manual joins across formats.

content/experimental/zedprofiler.md

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -8,11 +8,14 @@ logoUrl: "https://raw.githubusercontent.com/WayScience/ZedProfiler/main/logo/log
88
githubRepo: "WayScience/zedprofiler"
99
---
1010

11+
<a href="https://github.com/WayScience/ZedProfiler" target="_blank" rel="external">
1112
<img class="logo-light" src="https://raw.githubusercontent.com/WayScience/ZedProfiler/main/logo/with-text-for-light-bg.png" alt="ZEDprofiler logo" width="400">
1213
<img class="logo-dark" src="https://raw.githubusercontent.com/WayScience/ZedProfiler/main/logo/with-text-for-dark-bg.png" alt="ZEDprofiler logo" width="400">
14+
</a>
1315

1416
{{< tool-badges >}}
1517

18+
1619
`ZEDprofiler` extracts morphological features directly from 3D volumetric images, including anisotropic voxel spacing correction — no GPU required.
1720

1821
**Problem:** Classical profiling tools extract only 2D features, leaving organoid, cleared-tissue, and z-stack experiments without a CPU-efficient extractor.

content/media/_index.md

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -42,24 +42,24 @@ showAuthor: false
4242

4343
#### Peer-reviewed
4444

45-
- **CytoTable ([tool page](https://cytomining.github.io/tools/cytotable/)):** Bunten, D. et al. Scalable data harmonization for single-cell image-based profiling with CytoTable.
45+
- **CytoTable ([tool page](https://cytomining.github.io/tools/cytotable/) · [GitHub](https://github.com/cytomining/CytoTable)):** Bunten, D. et al. Scalable data harmonization for single-cell image-based profiling with CytoTable.
4646
*Patterns* **7**, 101514 (2026).
4747
[doi:10.1016/j.patter.2026.101514](https://doi.org/10.1016/j.patter.2026.101514)
48-
- **Pycytominer ([tool page](https://cytomining.github.io/tools/pycytominer/)):** Serrano, E. et al. Reproducible image-based profiling with Pycytominer.
48+
- **Pycytominer ([tool page](https://cytomining.github.io/tools/pycytominer/) · [GitHub](https://github.com/cytomining/pycytominer)):** Serrano, E. et al. Reproducible image-based profiling with Pycytominer.
4949
*Nat. Methods* **22**, 677–680 (2025).
5050
[doi:10.1038/s41592-025-02611-8](https://doi.org/10.1038/s41592-025-02611-8)
51-
- **copairs ([tool page](https://cytomining.github.io/tools/copairs/)):** Kalinin, A.A. et al. A versatile information retrieval framework for evaluating profile strength and similarity.
51+
- **copairs ([tool page](https://cytomining.github.io/tools/copairs/) · [GitHub](https://github.com/cytomining/copairs)):** Kalinin, A.A. et al. A versatile information retrieval framework for evaluating profile strength and similarity.
5252
*Nat. Commun.* **16**, 5181 (2025).
5353
[doi:10.1038/s41467-025-60306-2](https://doi.org/10.1038/s41467-025-60306-2)
54-
- **DeepProfiler ([tool page](https://cytomining.github.io/tools/deepprofiler/)):** Moshkov, N. et al. Learning representations for image-based profiling of perturbations.
54+
- **DeepProfiler ([tool page](https://cytomining.github.io/tools/deepprofiler/) · [GitHub](https://github.com/cytomining/DeepProfiler)):** Moshkov, N. et al. Learning representations for image-based profiling of perturbations.
5555
*Nat. Commun.* **15**, 1594 (2024).
5656
[doi:10.1038/s41467-024-45999-1](https://doi.org/10.1038/s41467-024-45999-1)
5757

5858
#### Preprints
5959

60-
- **buscar ([tool page](https://cytomining.github.io/experimental/buscar/)):** Serrano, E., Li, W.S. & Way, G.P. Single-cell hit calling in high-content imaging screens with Buscar.
60+
- **buscar ([tool page](https://cytomining.github.io/experimental/buscar/) · [GitHub](https://github.com/WayScience/buscar)):** Serrano, E., Li, W.S. & Way, G.P. Single-cell hit calling in high-content imaging screens with Buscar.
6161
*bioRxiv* (2026).
6262
[doi:10.64898/2026.04.15.718737](https://doi.org/10.64898/2026.04.15.718737)
63-
- **coSMicQC ([tool page](https://cytomining.github.io/tools/cosmicqc/)):** Tomkinson, J. et al. Stellar quality control for single-cell image-based profiling with coSMicQC.
63+
- **coSMicQC ([tool page](https://cytomining.github.io/tools/cosmicqc/) · [GitHub](https://github.com/cytomining/coSMicQC)):** Tomkinson, J. et al. Stellar quality control for single-cell image-based profiling with coSMicQC.
6464
*bioRxiv* (2025).
6565
[doi:10.1101/2025.10.14.682427](https://doi.org/10.1101/2025.10.14.682427)

content/people/_index.md

Lines changed: 27 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -19,9 +19,9 @@ We welcome issues, bug reports, documentation improvements, and pull requests fr
1919
## Governance
2020

2121
Cytomining uses a lightweight governance model centered on maintainers and public decision-making.
22-
We keep policy concise and bias toward transparent, repository-native workflows over heavy process.
22+
We keep policy concise and transparent.
2323

24-
- **Stewardship:** Repositories are maintained by designated maintainers in the `Cytomining` organization.
24+
- **Stewardship:** Repositories are maintained by designated maintainers in the [`Cytomining`](https://github.com/cytomining) organization.
2525
- **Decision-making:** Day-to-day technical decisions happen in public issues, pull requests, and our public [Discord](https://discord.gg/dgEDz6xzfJ).
2626
- **Consensus first:** Maintainers seek rough consensus from active contributors before merging impactful changes.
2727
- **Escalation path:** When consensus is unclear, maintainers make a final call, document rationale, and revisit with new evidence.
@@ -31,6 +31,31 @@ We keep policy concise and bias toward transparent, repository-native workflows
3131

3232
This reflects how the organization operates today and is intentionally compact so contributors can understand how decisions get made without navigating a large policy surface.
3333

34+
### Organizational structure
35+
36+
The Cytomining ecosystem currently spans two GitHub organizations with distinct roles.
37+
38+
The [**cytomining**](https://github.com/cytomining) organization hosts production-ready tools that have reached stable APIs, published documentation, test coverage, and community adoption.
39+
Tools here are maintained collaboratively by contributors from the [Way Lab](https://www.waysciencelab.com/) at the University of Colorado Anschutz and the broader image-based profiling community.
40+
41+
The [**WayScience**](https://github.com/WayScience) organization serves as an incubator for next-generation tools under active development.
42+
It is the primary home for roadmap work: tools here are experimental, may have unstable APIs, and have not yet graduated into [`Cytomining`](https://github.com/cytomining).
43+
44+
The two organizations are complementary.
45+
[`WayScience`](https://github.com/WayScience) is where new ideas are prototyped and validated; [`Cytomining`](https://github.com/cytomining) is where they become community infrastructure.
46+
Core production tools ([`Pycytominer`](/tools/pycytominer/), [`CytoTable`](/tools/cytotable/), [`coSMicQC`](/tools/cosmicqc/), [`copairs`](/tools/copairs/), [`DeepProfiler`](/tools/deepprofiler/), [`CytoDataFrame`](/tools/cytodataframe/)) live in [`Cytomining`](https://github.com/cytomining).
47+
Roadmap tools ([`buscar`](/experimental/buscar/), [`OME-arrow`](/experimental/ome-arrow/), [`iceberg-bioimage`](/experimental/iceberg-bioimage/), [`ZEDprofiler`](/experimental/zedprofiler/)) live in [`WayScience`](https://github.com/WayScience) until they are ready to graduate.
48+
49+
### Graduation process
50+
51+
A tool is considered ready to migrate from [`WayScience`](https://github.com/WayScience) (or any other repository from other organizations) into [`Cytomining`](https://github.com/cytomining) when it meets the following criteria:
52+
53+
- **Within scope** — the tool must be purpose-built for scientists who perform image-based profiling.
54+
- **Stable API** — no breaking changes anticipated in the near term; a versioned release has been tagged
55+
- **Documentation** — a published documentation site covering installation, usage, and API reference
56+
- **Test coverage** — a CI-passing test suite with meaningful coverage (>80%) of core functionality
57+
- **Publication or preprint** — a citable reference describing the tool's design and validation
58+
3459
## Code of Conduct
3560

3661
Participation in Cytomining spaces is expected to follow the organization-wide Code of Conduct:

0 commit comments

Comments
 (0)