Skip to main content

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, and dataframe(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 with IntEnum bindings.
  • 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)

Source distribution for cellpax 0.0.1
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)

Table of built distributions (wheels) for cellpax 0.0.1
File Interpreter ABI Platform Actions
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 log

Release 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 log

Security 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.

Select from 2 files

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 log

A 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.

Release history Release notifications | RSS feed

This release

0.0.1 This release

2 release files Full provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page