Skip to main content
Yanked

This release has been yanked by its maintainers, and will be ignored by installers, except when explicitly specified.
Reason given by maintainers: Temporarily withdrawn pending review

ParaNMR

ParaNMR is an independently maintained research and engineering fork of SimpNMR, developed by Ernest Borysenko as part of his PhD research. It has its own release cycle and engineering direction, with particular emphasis on stable pipelines, reproducible validation, and maintainable architecture. Mature, broadly useful changes may later be adapted and contributed upstream to SimpNMR.

Docs CI Coverage PyPI License

ParaNMR is an open-source Python toolkit for prediction, fitting, and analysis of paramagnetic NMR spectra using experimental measurements and ab initio calculations. It provides a focused, reproducible environment for developing dependable workflows and validating new pNMR methods.

Features

  • Prediction of paramagnetic NMR shifts and spectra
  • Susceptibility tensor fitting from experimental measurements
  • Integration with quantum-chemistry outputs, including ORCA and Gaussian
  • Experimental fitting and inference workflows
  • Regression tests for prediction and fitting workflows
  • Research-oriented development of new pNMR analysis methods

Project relationship and authorship

Ernest Borysenko is the sole current maintainer and developer of the independent ParaNMR fork. His contributions to this fork are distinct from the inherited SimpNMR code and scientific methods.

The upstream SimpNMR contributors credited by this repository are Ernest Borysenko, Jon Kragskow, James Whipham, Elizaveta Suturina, and Dan Burrows. Their upstream contributions remain acknowledged; this list does not identify them as current maintainers of ParaNMR or imply their endorsement of the fork.

Original copyright and licence notices are retained. Authorship and maintenance metadata do not determine copyright ownership. See MODIFICATIONS.md and THIRD_PARTY_NOTICES.md for modification history and the provenance review.

Installation

pip install paranmr
paranmr --help

ParaNMR requires Python 3.10 or newer.

The supported baseline is verified in CI on Python 3.10, 3.11, and 3.12.

Quick example

paranmr predict input.yml

Demonstration

The P3FeCl example runs a complete prediction workflow from quantum-chemistry outputs and produces a simulated-versus-experimental 13C spectrum:

cd examples/P3FeCl/SIMULATIONS/Prediction
paranmr --hide predict P3FeCl_Prediction.yml

P3FeCl simulated and experimental 13C spectrum

The generated figures and tabular results are written to P3FeCl_13C_Prediction/.

Documentation

ParaNMR documentation:

https://mephistos-ml.github.io/paranmr/

Upstream SimpNMR documentation:

https://simpnmr.org/

Project status

ParaNMR is research software with a production-minded engineering baseline. Core workflows are versioned and tested, while new methods may evolve as part of the PhD research programme. Breaking changes are documented in the changelog.

Contributing

Development guidelines, architecture, testing conventions, and release policies are documented in the Developer Guide:

https://mephistos-ml.github.io/paranmr/developer_guide/

Install the development dependencies and enable local pre-commit checks:

python -m pip install -e ".[dev]"
pre-commit install

Run all checks manually with:

pre-commit run --all-files

Citation

If you use ParaNMR in academic work, please cite Ernest Borysenko, the software name, the exact version used, and its repository: https://github.com/Mephistos-ML/paranmr.

Machine-readable citation metadata for the fork is provided in CITATION.cff. No dedicated DOI for ParaNMR is currently declared there.

Please also acknowledge upstream SimpNMR and cite its original preprint when relevant to the methods used:

https://doi.org/10.26434/chemrxiv.15001463.v1

This DOI identifies the upstream SimpNMR publication, not ParaNMR. These citation requests do not add restrictions to the GPL licence.

Support

Please use GitHub Issues for bug reports and feature requests.

For security vulnerabilities, follow the process described in SECURITY.md.

Only the latest published release has a guaranteed security-support target; backports to older releases are discretionary.

License

GPL-3.0-or-later. See LICENSE.

Modified by Ernest Borysenko: renamed to ParaNMR on 2026-10-15. The latest incorporated upstream release is SimpNMR 2.4.0; the initial fork predates this rename. See MODIFICATIONS.md. This software is provided without warranty; see LICENSE.

Metadata

Release files for paranmr 1.20.1

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

Source distribution (sdist)

Source distribution for paranmr 1.20.1
File Size Uploaded Provenance Actions
paranmr-1.20.1.tar.gz 299.8 kB With provenance Details for paranmr-1.20.1.tar.gz

Built distribution (wheel)

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

Total release size: 630.5 kB

Release files / paranmr-1.20.1.tar.gz

Download URL paranmr-1.20.1.tar.gz
Size 299.8 kB
Tags Source
SHA-256 checksum
How to use checksums
b6731349f75ac39919db99477641768954f542a7587252afd2960ad1847d99e2
BLAKE2b-256 checksum
How to use checksums
510a52e827b5546e65bf4ac449ae0a54d06051fecd8a1cc1eddf663a5e3ae24b
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 Oct 15, 2026.

Transparency log

Release files / paranmr-1.20.1-py3-none-any.whl

Download URL paranmr-1.20.1-py3-none-any.whl
Size 330.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
54208ca8b33ee11225d50a65b42c923163444ecacec76737c0d9baf2702bb7d3
BLAKE2b-256 checksum
How to use checksums
461afc9b7e1635278d1a24ea4be38f8d50a2d65b6c76dfe17ba4ab31e8a4a3bd
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 Oct 15, 2026.

Transparency log

Security for paranmr 1.20.1

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 paranmr-1.20.1.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 Oct 15, 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

1.20.1 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