https://github.com/gbouvignies/chemex
ChemEx is an analysis program for chemical exchange detected by NMR.
https://github.com/gbouvignies/chemex
cest chemical-exchange cpmg nmr python sparsely-populated-state
Last synced: 9 months ago
JSON representation
ChemEx is an analysis program for chemical exchange detected by NMR.
- Host: GitHub
- URL: https://github.com/gbouvignies/chemex
- Owner: gbouvignies
- License: gpl-3.0
- Created: 2013-10-28T18:42:50.000Z (over 12 years ago)
- Default Branch: main
- Last Pushed: 2025-10-21T10:18:20.000Z (9 months ago)
- Last Synced: 2025-10-21T19:48:47.942Z (9 months ago)
- Topics: cest, chemical-exchange, cpmg, nmr, python, sparsely-populated-state
- Language: Python
- Homepage: https://gbouvignies.github.io/ChemEx/
- Size: 49.7 MB
- Stars: 35
- Watchers: 9
- Forks: 17
- Open Issues: 7
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE.md
Awesome Lists containing this project
README
# 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)
## 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)
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.
---
Developed with ❤️ by the [ChemEx Contributors](https://github.com/gbouvignies/ChemEx/graphs/contributors)