# ChemEx: NMR Chemical Exchange Analysis Tool
[](https://github.com/ambv/black)
## Table of Contents
- [ChemEx: NMR Chemical Exchange Analysis Tool](#chemex-nmr-chemical-exchange-analysis-tool)
- [Table of Contents](#table-of-contents)
- [About ChemEx](#about-chemex)
- [Prerequisites](#prerequisites)
- [Installation](#installation)
- [Quick Start with uv (Recommended)](#quick-start-with-uv-recommended)
- [Using pip with venv](#using-pip-with-venv)
- [Using pip (global)](#using-pip-global)
- [From source](#from-source)
- [Using conda](#using-conda)
- [Performance Optimization](#performance-optimization)
- [Contributing](#contributing)
- [Support and Documentation](#support-and-documentation)
- [License](#license)
<!-- - [Citing ChemEx](#citing-chemex) -->
## About ChemEx
ChemEx is an advanced, open-source software specifically designed for analyzing NMR experimental data to characterize chemical exchange processes. Ideal for researchers and scientists in the field of biochemistry and molecular biology, ChemEx aids in the analysis of NMR experiments like Carr-Purcell-Meiboom-Gill (CPMG) relaxation dispersion and Chemical Exchange Saturation Transfer (CEST).
## Prerequisites
Before installing ChemEx, ensure you have **Python 3.13** installed on your system.
> **Note**: ChemEx requires Python 3.13. Python 3.14 was recently released and is being tested for compatibility, but **Python 3.13 is recommended** for production use until the scientific Python ecosystem fully adopts 3.14.
## Installation
ChemEx offers several installation methods to suit your specific setup:
### Quick Start with uv (Recommended)
[uv](https://docs.astral.sh/uv/) is a fast Python package and project manager. If you don't have it installed:
```shell
# macOS/Linux
curl -LsSf https://astral.sh/uv/install.sh | sh
# Windows
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
```
The fastest way to try ChemEx without installation:
```shell
uvx chemex --help
```
Or install it as a tool:
```shell
uv tool install chemex
chemex --help
```
### Using pip with venv
Create an isolated environment and install ChemEx:
```shell
python -m venv .venv
source .venv/bin/activate # On Windows: .venv\Scripts\activate
pip install chemex
```
### Using pip (global)
```shell
pip install chemex
```
### From source
```shell
pip install git+https://github.com/gbouvignies/ChemEx.git
```
### Using conda
If you prefer conda/mamba:
```shell
conda create -n chemex python=3.13
conda activate chemex
conda config --env --add channels conda-forge
conda install chemex
```
## Performance Optimization
ChemEx performance depends on the underlying numerical libraries (NumPy and SciPy). The default installation provides good performance for most users:
- **pip** (PyPI wheels): Uses OpenBLAS on Linux/Windows, or Apple's Accelerate framework on macOS
- **conda-forge**: Uses OpenBLAS as the BLAS/LAPACK backend
- **Anaconda** (defaults channel): Uses Intel® MKL, which can provide better performance for some operations
- **Intel® Distribution for Python**: Also uses Intel® MKL
For most use cases, the default pip or conda-forge installation is sufficient. If you need maximum performance and are doing intensive numerical computations, consider using Anaconda's defaults channel or Intel's Python distribution.
## Contributing
We encourage contributions from the community. Please see our [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines on how to make ChemEx better. For any issues or suggestions, please open an issue or a discussion on our [GitHub repository](https://github.com/gbouvignies/ChemEx).
## Support and Documentation
For additional support, tutorials, and detailed documentation, visit the [ChemEx Documentation](https://gbouvignies.github.io/ChemEx/).
## License
ChemEx is licensed under the [GPL-3.0](https://www.gnu.org/licenses/gpl-3.0.en.html). See the [LICENSE](LICENSE.md) file for more details.
<!-- ## Citing ChemEx
If you use ChemEx in your research, please cite it as follows: [Citation details](#). -->
---
Developed with ❤️ by the [ChemEx Contributors](https://github.com/gbouvignies/ChemEx/graphs/contributors)
Raw data
{
"_id": null,
"home_page": null,
"name": "chemex",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.13",
"maintainer_email": null,
"keywords": "NMR, chemical exchange, spectroscopy, analysis",
"author": "Guillaume Bouvignies",
"author_email": "Guillaume Bouvignies <guillaume.bouvignies@ens.psl.eu>",
"download_url": "https://files.pythonhosted.org/packages/81/06/599747c57742a935373022bb66ec49a5a8c8184a6b848b69530036e426d2/chemex-2025.10.0.tar.gz",
"platform": null,
"description": "# ChemEx: NMR Chemical Exchange Analysis Tool\n\n[](https://github.com/ambv/black)\n\n## Table of Contents\n\n- [ChemEx: NMR Chemical Exchange Analysis Tool](#chemex-nmr-chemical-exchange-analysis-tool)\n - [Table of Contents](#table-of-contents)\n - [About ChemEx](#about-chemex)\n - [Prerequisites](#prerequisites)\n - [Installation](#installation)\n - [Quick Start with uv (Recommended)](#quick-start-with-uv-recommended)\n - [Using pip with venv](#using-pip-with-venv)\n - [Using pip (global)](#using-pip-global)\n - [From source](#from-source)\n - [Using conda](#using-conda)\n - [Performance Optimization](#performance-optimization)\n - [Contributing](#contributing)\n - [Support and Documentation](#support-and-documentation)\n - [License](#license)\n<!-- - [Citing ChemEx](#citing-chemex) -->\n\n## About ChemEx\n\nChemEx is an advanced, open-source software specifically designed for analyzing NMR experimental data to characterize chemical exchange processes. Ideal for researchers and scientists in the field of biochemistry and molecular biology, ChemEx aids in the analysis of NMR experiments like Carr-Purcell-Meiboom-Gill (CPMG) relaxation dispersion and Chemical Exchange Saturation Transfer (CEST).\n\n## Prerequisites\n\nBefore installing ChemEx, ensure you have **Python 3.13** installed on your system.\n\n> **Note**: ChemEx requires Python 3.13. Python 3.14 was recently released and is being tested for compatibility, but **Python 3.13 is recommended** for production use until the scientific Python ecosystem fully adopts 3.14.\n\n## Installation\n\nChemEx offers several installation methods to suit your specific setup:\n\n### Quick Start with uv (Recommended)\n\n[uv](https://docs.astral.sh/uv/) is a fast Python package and project manager. If you don't have it installed:\n\n```shell\n# macOS/Linux\ncurl -LsSf https://astral.sh/uv/install.sh | sh\n\n# Windows\npowershell -ExecutionPolicy ByPass -c \"irm https://astral.sh/uv/install.ps1 | iex\"\n```\n\nThe fastest way to try ChemEx without installation:\n\n```shell\nuvx chemex --help\n```\n\nOr install it as a tool:\n\n```shell\nuv tool install chemex\nchemex --help\n```\n\n### Using pip with venv\n\nCreate an isolated environment and install ChemEx:\n\n```shell\npython -m venv .venv\nsource .venv/bin/activate # On Windows: .venv\\Scripts\\activate\npip install chemex\n```\n\n### Using pip (global)\n\n```shell\npip install chemex\n```\n\n### From source\n\n```shell\npip install git+https://github.com/gbouvignies/ChemEx.git\n```\n\n### Using conda\n\nIf you prefer conda/mamba:\n\n```shell\nconda create -n chemex python=3.13\nconda activate chemex\nconda config --env --add channels conda-forge\nconda install chemex\n```\n\n## Performance Optimization\n\nChemEx performance depends on the underlying numerical libraries (NumPy and SciPy). The default installation provides good performance for most users:\n\n- **pip** (PyPI wheels): Uses OpenBLAS on Linux/Windows, or Apple's Accelerate framework on macOS\n- **conda-forge**: Uses OpenBLAS as the BLAS/LAPACK backend\n- **Anaconda** (defaults channel): Uses Intel\u00ae MKL, which can provide better performance for some operations\n- **Intel\u00ae Distribution for Python**: Also uses Intel\u00ae MKL\n\nFor most use cases, the default pip or conda-forge installation is sufficient. If you need maximum performance and are doing intensive numerical computations, consider using Anaconda's defaults channel or Intel's Python distribution.\n\n## Contributing\n\nWe encourage contributions from the community. Please see our [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines on how to make ChemEx better. For any issues or suggestions, please open an issue or a discussion on our [GitHub repository](https://github.com/gbouvignies/ChemEx).\n\n## Support and Documentation\n\nFor additional support, tutorials, and detailed documentation, visit the [ChemEx Documentation](https://gbouvignies.github.io/ChemEx/).\n\n## License\n\nChemEx is licensed under the [GPL-3.0](https://www.gnu.org/licenses/gpl-3.0.en.html). See the [LICENSE](LICENSE.md) file for more details.\n\n<!-- ## Citing ChemEx\n\nIf you use ChemEx in your research, please cite it as follows: [Citation details](#). -->\n\n---\n\nDeveloped with \u2764\ufe0f by the [ChemEx Contributors](https://github.com/gbouvignies/ChemEx/graphs/contributors)\n",
"bugtrack_url": null,
"license": null,
"summary": "An analysis program for chemical exchange detected by NMR",
"version": "2025.10.0",
"project_urls": {
"Changelog": "https://github.com/gbouvignies/chemex/releases",
"Documentation": "http://gbouvignies.github.io/ChemEx/",
"Homepage": "http://gbouvignies.github.io/ChemEx/",
"Repository": "https://github.com/gbouvignies/chemex"
},
"split_keywords": [
"nmr",
" chemical exchange",
" spectroscopy",
" analysis"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "1597ad206baa87f701386e25df72c3b100f4a5c2c8fa21e69f73a0a1faf0403c",
"md5": "8d67b8f47bdba11de740d3cf2b32122e",
"sha256": "c290ce81d86956581fdacf812e990cbc22966d37ffd0c32a4c7d3680f45b9520"
},
"downloads": -1,
"filename": "chemex-2025.10.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "8d67b8f47bdba11de740d3cf2b32122e",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.13",
"size": 204132,
"upload_time": "2025-10-27T11:15:00",
"upload_time_iso_8601": "2025-10-27T11:15:00.183889Z",
"url": "https://files.pythonhosted.org/packages/15/97/ad206baa87f701386e25df72c3b100f4a5c2c8fa21e69f73a0a1faf0403c/chemex-2025.10.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "8106599747c57742a935373022bb66ec49a5a8c8184a6b848b69530036e426d2",
"md5": "e5ae513cc0a7d6114d4ff7f67b3e273b",
"sha256": "09f038e2b084359bbe07ebb2aa9b346fa1668e17b28f19e9ab2e1c349b990243"
},
"downloads": -1,
"filename": "chemex-2025.10.0.tar.gz",
"has_sig": false,
"md5_digest": "e5ae513cc0a7d6114d4ff7f67b3e273b",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.13",
"size": 110113,
"upload_time": "2025-10-27T11:15:02",
"upload_time_iso_8601": "2025-10-27T11:15:02.399940Z",
"url": "https://files.pythonhosted.org/packages/81/06/599747c57742a935373022bb66ec49a5a8c8184a6b848b69530036e426d2/chemex-2025.10.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-10-27 11:15:02",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "gbouvignies",
"github_project": "chemex",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "chemex"
}
JSON
