dclab

library0.71.9pypypi✓ verified 85d ago

Library for real-time deformability cytometry (RT-DC) data analysis. Provides data loading, filtering, and normalization for deformability cytometry datasets. Current version 0.71.8, requires Python >=3.9, <4. Released about every 3-6 months on PyPI.

data ai-ml

pip install dclab

github ↗package ↗homepage ↗docs ↗changelog ↗

INSTALL

IMPORT

SIG · DCLAB

dclab

datapythonv0.71.9

Install

9.7s avg

Import

3544ms

Disk

426MB

Pass rate

5/ 10

Env Coverage5 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v0.71.9 · pip install

no network on importno background threads

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

py 3.10–3.95 runs

build_error

glibc

py 3.10–3.95 runs

installs and imports cleanly · install 9.7s · import 3.544s · 421MB

426MB installed

● package 426MB

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

RTDCBase

✓ from dclab.rtdc_dataset import RTDCBase

RTDCBase is the base class for datasets; use for type checking.

new_dataset

✓ from dclab import new_dataset

✗ import dclab.dclab

new_dataset is a top-level function; do not import from submodule.

Load an RT-DC dataset from a .rtdc file and print the first five area values.

import dclab from dclab import new_dataset ds = new_dataset('path/to/file.rtdc') print(ds) # Access features: area_um = ds['area_um'] print('Area (um^2):', area_um[:5])

Debug

Known issues

breakingIn version 0.70.0, the `filter` module was restructured. `dclab.filter.xxx` is no longer available; use `dclab.features` and `dclab.features.xxx` instead.

fix

Replace `from dclab.filter import ...` with `from dclab.features import ...`.

affects: >=0.70.0

breakingPython 3.9 support dropped in version 0.72.0 (upcoming). Currently requires Python >=3.9; future versions will require >=3.10.

fix

Update Python environment to 3.10 or later.

affects: >=0.72.0

gotcha`new_dataset` fails silently if the file format is unsupported. It will raise a `ValueError` only if the file cannot be parsed at all.

fix

Always wrap `new_dataset` in a try/except block to catch `ValueError` and `OSError`.

affects: all

Errors

Common errors & fixes

ModuleNotFoundError: No module named 'dclab'

dclab not installed or virtual environment not activated.

fix

Run `pip install dclab` or `conda install -c conda-forge dclab`.

ValueError: File format not recognized.

The file provided to `new_dataset` is not a valid .rtdc, .tdms, or .h5 file.

fix

Ensure the file has the correct extension and is valid. Use `dclab.rtdc_dataset.RTDCFile` for low-level checks.

Upgrade

Version history

0.71.9latest on PyPI · released May 29, 2026

Audit

Dependencies

numpyrequirednumerical operations

scipyrequiredsignal processing and statistics

h5pyrequiredHDF5 file support for .tdms and .rtdc files

Agent activity

15 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/DC-Analysis/dclab ↗

packagehttps://pypi.org/project/dclab/ ↗

homepagehttps://dclab.readthedocs.io ↗

docshttps://dclab.readthedocs.io/en/stable/ ↗

changeloghttps://dclab.readthedocs.io/en/stable/sec_changelog.html ↗