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 18, 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:
Latest release

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 18, 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.4.tar.gz (5.8 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.4-py3-none-any.whl (877.1 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: spectrochempy-0.12.4.tar.gz
  • Upload date:
  • Size: 5.8 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.4.tar.gz
Algorithm Hash digest
SHA256 daebf938982826c2ff22e2234bfc3e8fed0de445abff585bf30ece69a856e46f
MD5 42978fead2f3a3547a0df0596de29d5d
BLAKE2b-256 fd8ea2cbdbd8ab07438e3ed3a33b78a9fa5269d8af087992a944b7786f829c45

See more details on using hashes here.

Provenance

The following attestation bundles were made for spectrochempy-0.12.4.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.4-py3-none-any.whl.

File metadata

  • Download URL: spectrochempy-0.12.4-py3-none-any.whl
  • Upload date:
  • Size: 877.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.4-py3-none-any.whl
Algorithm Hash digest
SHA256 a2cb75d12ca600c43f4d23b4d768fea2a03787425dce84d27dbcc66cdae1cac6
MD5 a09efa5a713aba31a2e7548fbb5d2e6e
BLAKE2b-256 e278a22ea3ac23785f63c35e1972630894d0c1330821ce7b46eb347d626244d4

See more details on using hashes here.

Provenance

The following attestation bundles were made for spectrochempy-0.12.4-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