spectrochempy
Processing, analysis and modelling Spectroscopic data for Chemistry with Python
Processing, analysis and modelling Spectroscopic data for Chemistry with Python
To install this package, run one of the following:
SpectroChemPy (SCPy) is a framework for processing, analyzing, and modeling spectroscopic data for chemistry with Python. It is cross-platform (Linux, Windows, macOS) and combines a lightweight scientific core with optional plugins for domain-specific workflows.
Its central object, NDDataset, provides numerical data together with
coordinates, units, masks, labels, history, and metadata, making it easier
to build reproducible spectroscopy workflows in Python.
The history records participating operations on a dataset. It is inspectable, but it is not a complete provenance record; reproducibility also requires the originating script or notebook, inputs, environment, and parameters.
NDDataset with coordinates, units, masks, labels,
history, and metadataProject.mat exchange filesNDDataset ↔ xarray.Dataset ↔ NetCDF round-trips for the
maintained portable subset.scp / .pscp persistence by default, with explicit legacy
opt-in only for historical trusted archivesscp.nmr.read_topspin(...), scp.iris.IRIS()The recommended way to install SpectroChemPy is with uv:
curl -LsSf https://astral.sh/uv/install.sh | sh # if uv is not installed
uv venv scpy --python 3.13
source scpy/bin/activate
uv pip install spectrochempy
Alternatively, with mamba / conda:
mamba install -c spectrocat -c conda-forge spectrochempy
Or with pip:
pip install spectrochempy
See the full installation guide for platform-specific instructions, optional dependencies, and development setup.
Extend SpectroChemPy with official plugins (installed separately):
| Plugin | Install | What it provides |
|--------|---------|------------------|
| spectrochempy-carroucell | uv pip install spectrochempy-carroucell | Carroucell experiment reader |
| spectrochempy-iris | uv pip install spectrochempy-iris | 2D-IRIS analysis tools |
| spectrochempy-nmr | uv pip install spectrochempy-nmr | Bruker TopSpin reader, NMR-specific processing |
| spectrochempy-perkinelmer | uv pip install spectrochempy-perkinelmer | PerkinElmer .sp IR file reader |
| spectrochempy-tensor | uv pip install spectrochempy-tensor | Tensor learning tools |
pip install works as well if you are not using uv.
Plugins are also available via conda from the spectrocat channel:
mamba install -c spectrocat -c conda-forge spectrochempy-nmr
Plugins are discovered automatically once installed — no manual loading step required.
spectrochempy-cantera is available as an experimental plugin. It is not
officially supported, not included in aggregate extras, and must be installed
manually:
python -m pip install spectrochempy-cantera
If you want to contribute, start with:
CONTRIBUTING.mddocs/sources/devguide/Maintainer release procedures live in maintainers/.
Architecture, RFCs, and roadmap discussions are maintained in the
SpectroChemPy Maintainer Repository.
Summary
Processing, analysis and modelling Spectroscopic data for Chemistry with Python
Last Updated
Nov 14, 2026 at 13:00
License
LicenseRef-CeCILL-B
Supported Platforms
GitHub Repository
https://github.com/spectrochempy/spectrochempyDocumentation
https://www.spectrochempy.fr/