SpectroChemPy

Tests Actions Status codecov Conda PyPI version Docs DOI Conda

What is SpectroChemPy?

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, provenance, and metadata, making it easier to build reproducible spectroscopy workflows in Python.

Key Features

  • Core Data Structure: NDDataset with coordinates, units, masks, labels, provenance, and metadata
  • Project Management: Organize and manipulate multiple datasets within a Project
  • Data Processing:
    • Unit-aware mathematical operations
    • Baseline correction, automatic subtraction, interpolation, FFT workflows
    • Core processing with plugin-specific extensions where appropriate
  • Analysis Tools:
    • SVD, PCA, MCR-ALS, EFA, PLS, fitting, and related result objects
  • I/O and Interoperability:
    • Import from major spectroscopy and scientific data formats
    • Export to lightweight interchange formats such as CSV, JCAMP-DX, and minimal MATLAB .mat exchange files
    • Portable NDDataset ↔ xarray.Dataset ↔ NetCDF round-trips for the maintained portable subset
    • Safe native .scp / .pscp persistence by default, with explicit legacy opt-in only for historical trusted archives
  • Plugin System:
    • Automatic discovery of optional plugins
    • Namespaced APIs: scp.nmr.read_topspin(...), scp.iris.IRIS()
    • Dataset accessors for plugin-bound operations

Installation

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.

Official Plugins

Extend SpectroChemPy with official plugins (installed separately):

Plugin Install What it provides
spectrochempy-carroucell uv pip install spectrochempy-carroucell Carroucell experiment reader
spectrochempy-hypercomplex uv pip install spectrochempy-hypercomplex Quaternion / hypercomplex support
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.

Experimental plugins

spectrochempy-cantera is available as an experimental plugin. It is not officially supported, not included in aggregate extras, and must be installed manually::

pip install spectrochempy-cantera

Quick Links

For contributors

If you want to contribute, start with:

Maintainer release procedures live in maintainers/. Architecture, RFCs, and roadmap discussions are maintained in the SpectroChemPy Maintainer Repository.

License

CeCILL-B FREE SOFTWARE LICENSE AGREEMENT

Project links

Data verified by PyPI on Aug 11, 2026
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (0.12.4)

3 maintainers

PyPI data
Data sourced directly from PyPI's database.
Avatar for atravert from gravatar.com atravert Avatar for fernandezc from gravatar.com fernandezc Avatar for spectrocat from gravatar.com spectrocat

Credits

Author: Arnaud Travert

GitHub Statistics

Data verified by PyPI on Aug 11, 2026
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License

CeCILL-B Free Software License Agreement (CECILL-B) (CeCILL-B FREE SOFTWARE LICENSE AGREEMENT)

Requires

Python >=3.11

Provides Extra

build cp dev docs interactive nmr iris tensor plugins test

Tags

spectroscopy chemistry data analysis

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

spectrochempy-0.12.2.tar.gz (5.7 MB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

spectrochempy-0.12.2-py3-none-any.whl (864.1 kB view details)

Uploaded Python 3

File details

Details for the file spectrochempy-0.12.2.tar.gz.

File metadata

  • Download URL: spectrochempy-0.12.2.tar.gz
  • Upload date:
  • Size: 5.7 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for spectrochempy-0.12.2.tar.gz
Algorithm Hash digest
SHA256 655129c52530d57188bd9cbe0cf7bf0bf86e3519f9dcf1c343fa2712ea0b85ad
MD5 3ae4fb84e0653a9d2dc777993a8150c5
BLAKE2b-256 cd92f740d719fcf2c5cf95cc9a1873e32699b57146c18e3d9538f3a6d234a763

See more details on using hashes here.

Provenance

The following attestation bundles were made for spectrochempy-0.12.2.tar.gz:

Publisher: build_package.yml on spectrochempy/spectrochempy

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file spectrochempy-0.12.2-py3-none-any.whl.

File metadata

  • Download URL: spectrochempy-0.12.2-py3-none-any.whl
  • Upload date:
  • Size: 864.1 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for spectrochempy-0.12.2-py3-none-any.whl
Algorithm Hash digest
SHA256 ec10d1ff3afe7fcae2d4155c089f3309657071f56c8ed8e33a97daaea70fb035
MD5 02873e14558d8e055288f223baa6e683
BLAKE2b-256 8a4fc9aa5029ce9f6f7ebf9d194086bc790b7737a3aedafe7a55b78ec9f3b28b

See more details on using hashes here.

Provenance

The following attestation bundles were made for spectrochempy-0.12.2-py3-none-any.whl:

Publisher: build_package.yml on spectrochempy/spectrochempy

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page