cellpax
Flexible, polars-native cell feature clustering for connectomics. You hold one
FeatureTable, mask subsets, preprocess heavy-tailed features, run consensus
clustering, turn cuts into clear named labels, compare approaches, and save the
whole analysis to a DataFolio.
Setup
This project uses uv for dependency management and poe for task running.
# During DataFolio development, uv uses the editable sibling checkout ../datafolio.
uv sync
poe lab # Jupyter Lab
poe test # pytest with coverage
Quick start
import polars as pl
from cellpax import FeatureTable, compare
ft = FeatureTable(cells_df, features=[...], feature_metadata=meta)
ft.define_features("axon", family="axon")
ft.add_mask("l23", pl.col("layer") == "L2/3")
ft.preprocess() # ihs heavy-tail transform
ft.cluster("l23", columns="axon", n_neighbors=(30,), name="run")
labels = ft.label("run", mask="l23", distance_threshold=0.6, name="subclass")
labels.rename({0: "L2a", 1: "L2b"})
ft.attach(labels)
L = labels.to_enum("Subclass") # IntEnum: filter with autocomplete
ft.dataframe("l23").filter(pl.col("subclass_id") == L.L2a)
ft.save(folio, "l23it") # many analyses per folio
What's here
FeatureTable— polars container with hierarchical masks, composable feature collections, anddataframe(mask, scaled=…)raw/normalized views.preprocess— heavy-tail (ihs) skew screening, fit per mask.- clustering — fauxnograph kNN/Leiden consensus +
SimilarityMatrix, with a hierarchy toolkit (merge_support, nested labels, per-cell stability) for choosing cuts, and deterministic-by-default seeds derived from the table. LabelSet— clear, relabelable clusters withIntEnumbindings.compare— ARI/NMI/FMI/Jaccard, contingency, alluvial across labelings.- persistence — first-class DataFolio
save/load, namespaced, many per folio.
See the documentation (poe doc-preview),
DESIGN_PROPOSAL.md for the architecture and rationale, and the tutorial to build
an analysis end to end.
Metadata
Release files for cellpax 0.0.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| cellpax-0.0.1.tar.gz | 332.0 kB | With provenance | Details for cellpax-0.0.1.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| cellpax-0.0.1-py3-none-any.whl | Python 3 | none | any | Details for cellpax-0.0.1-py3-none-any.whl |
Total release size: 679.6 kB
Release files / cellpax-0.0.1.tar.gz
| Download URL | cellpax-0.0.1.tar.gz |
|---|---|
| Size | 332.0 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
42dd58207e035875040a45d1d69ceec658ad18e0ad7330f85d987d5fad03459d
|
|
BLAKE2b-256 checksum How to use checksums |
80d0bc7364ea8bb7dcc503bbe476e6819a7a3efe0dae121acff612b340981a7e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 1, 2026.
Transparency logRelease files / cellpax-0.0.1-py3-none-any.whl
| Download URL | cellpax-0.0.1-py3-none-any.whl |
|---|---|
| Size | 347.6 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
06293f102685d4bb9401ecfcd135366acf1d6f98ab50a13078657c1a261f095c
|
|
BLAKE2b-256 checksum How to use checksums |
410c788710459959ae25acfb85240dae2ac1eff9c50a3137d5d3c7c02d31be7e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 1, 2026.
Transparency logSecurity for cellpax 0.0.1
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
Full provenance
Both files in this release have been uploaded with provenance metadata.
Attestation for cellpax-0.0.1.tar.gz
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 1, 2026.
Transparency logA note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.