Skip to content

Repository files navigation

scellop: Cell Type Composition Explorer

Scellop (previously CellPop) is an interactive visualization tool for cell type compositions. Easily compare your cell type compositions with different visual encodings, filter and sort on metadata, and export for communication.

Why scellop?

Cell type populations are commonly shown with stacked bar charts. However, scaling the number of samples and cell types in these visualizations create issues with analyzing these charts. Scellop alleviates this by presenting a flexible heatmap and side views with extending layered bar charts.

Installs

Scellop is available on NPM and PyPI.

npm i scellop

If you load data from the HuBMAP portal, also install the HuBMAP loader:

npm i @scellop/hubmap-data-loading
pip install scellop

Demo

A demo is available here. How to use the ScellopComponent is shown here.

The main view and interactions: Screen shot of scellop with 64 datasets and 61 celltypes.

Repository layout

This is a pnpm workspace monorepo.

Path Package Published
packages/scellop scellop NPM
packages/data-loading @scellop/data-loading NPM
packages/hubmap-data-loading @scellop/hubmap-data-loading NPM
sites/demo @scellop/demo no (deployed to Netlify)
python scellop PyPI

Set-up

This project uses pnpm.

Install dependencies with:

pnpm install

Run the demo with:

pnpm run dev

Other workspace-wide commands:

pnpm build       # build every package
pnpm test:run    # run all tests once
pnpm typecheck   # tsc --noEmit across packages
pnpm lint:fix    # Biome, auto-fix
pnpm bench       # performance benchmarks

Releases are managed with changesets. Add one with pnpm changeset in any PR that changes a published package.

Instructions for Python package are it's own contributing guidelines.

Team

HIDIVE Lab

Paper

Our preprint is available here.

Please cite this work as follows:

Thomas C Smits, Nikolay Akhmetov, Tiffany S. Liaw, Mark S. Keller, Eric Moerth, Nils Gehlenborg (2025). scellop: A Scalable Redesign of Cell Population Plots for Single-Cell Data. arXiv preprint. https://10.48550/arXiv.2510.09554

About

Cell Population Viewer

Topics

Resources

Stars

2 stars

Watchers

2 watching

Forks

Releases

Packages

Used by

Contributors

Languages