Skip to main content

spinanalysis

spinanalysis is a high-level Python framework for the analysis of electron paramagnetic resonance (EPR) spectra.

The framework provides tools for loading, processing, plotting, simulating, optimizing, and saving EPR spectra. It is designed to support complete analysis workflows from experimental data to simulated and fitted spectra.

Features

  • High-level workflow for EPR spectral analysis
  • Loading of:
    • Bruker .bes3t files
    • Bruker ESP380E files
    • .txt files
  • Spectral processing:
    • Normalization
    • Offset reduction
    • Background correction
    • Reconstruction of out-of-phase (OOP) ESEEM spectra
  • Two-dimensional and three-dimensional plotting based on Matplotlib
  • Consistent plot designs using custom stylesheets
  • Profile-based configuration for:
    • Spin systems
    • Simulation routines
    • Optimization routines
    • Optimization parameter ranges
    • Plot settings
    • Saving settings
  • Simulation and optimization of EPR spectra
  • EasySpin-inspired classes for simulation and optimization workflows:
    • Sys
    • Exp
    • SimOpt
    • FitOpt
    • Var
  • Simulation of spin-correlated, singlet-born radical pairs
  • Simulation of out-of-phase (OOP) ESEEM signals
  • Interface to teacups
  • Saving processed and simulated spectra as .txt files

Requirements

  • Python 3.13 or newer

Additional dependencies for the simulation routines are currently under development and will be published separately.

Installation

Using uv

uv add spinanalysis

Using pip

pip install spinanalysis

Development

Clone the repository and install the development dependencies with uv:

git clone https://github.com/florianquintes/spinanalysis.git
cd spinanalysis
uv sync --dev

Run the tests:

uv run pytest

Documentation

The documentation is available on GitHub Pages.

License

This project is licensed under the GNU General Public License v3.0. See the LICENSE file for details.

Metadata

Release files for spinanalysis 0.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for spinanalysis 0.1.0
File Size Uploaded Provenance Actions
spinanalysis-0.1.0.tar.gz 74.2 kB With provenance Details for spinanalysis-0.1.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for spinanalysis 0.1.0
File Interpreter ABI Platform Actions
spinanalysis-0.1.0-py3-none-any.whl Python 3 none any Details for spinanalysis-0.1.0-py3-none-any.whl

Total release size: 145.0 kB

Release files / spinanalysis-0.1.0.tar.gz

Download URL spinanalysis-0.1.0.tar.gz
Size 74.2 kB
Tags Source
SHA-256 checksum
How to use checksums
94dc625f5df1a279b9b612c5c1bddd2d37088c501b02f33b570b8c3e0314de78
BLAKE2b-256 checksum
How to use checksums
ad81295f5a20b3c247fa62bd526298683f3e940b5fc1cec169a25ebb6425fc5f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Aug 20, 2026.

Transparency log

Release files / spinanalysis-0.1.0-py3-none-any.whl

Download URL spinanalysis-0.1.0-py3-none-any.whl
Size 70.8 kB
Tags Python 3
SHA-256 checksum
How to use checksums
ea57edf953c76d804d042111c25d5248f50a65822d413c0ab22be19f41b88ce7
BLAKE2b-256 checksum
How to use checksums
469af9c74be4fe3ec8e638ec3d0bc91ac416ddeab6d59f5d0a4a185c2ac7f31c
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Aug 20, 2026.

Transparency log

Security for spinanalysis 0.1.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for spinanalysis-0.1.0.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Aug 20, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 release files Full provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page