Troubleshooting

Installation and imports

Use the same Python interpreter for installation and execution:

python -m pip install --upgrade FlowCyPy
python -c "import FlowCyPy; print(FlowCyPy.__version__)"

A missing native module often means that no compatible wheel was installed or a source build did not finish. Confirm your Python version and platform before changing the simulation. Source builds need the repository’s compiler and native library dependencies.

Plots on a server

Use MPLBACKEND=Agg for Matplotlib on a headless machine. Save figures to files when no interactive display is available.

Units and signal interpretation

Supply dimensional inputs with FlowCyPy.units.ureg. Inspect particle arrivals and analog detector signals before adjusting triggering or classification. Clipping, saturation, noise and thresholds can change observed event counts; compare stages of the tutorial workflow rather than only its final plots.