MaxwellBloch
MaxwellBloch is a Python package for solving the coupled Maxwell-Bloch equations describing the nonlinear propagation of near-resonant light through thermal quantised systems such as atomic vapours.
Above is an example solution for the propagation of a 4π pulse through a dense atomic vapour. The pulse immediately breaks up on entering the medium and the resultant pulses form two optical solitons each with a pulse area of 2π.
Documentation
Docs for the project are at maxwellbloch.readthedocs.io.
Install
The recommended way to install is via uv:
uv pip install maxwellbloch
Or using pip:
pip install maxwellbloch
If you prefer Conda, you can create and activate an environment with the required dependencies with
conda create --name mb -c conda-forge python=3.11 qutip
conda activate mb
pip install maxwellbloch
More detailed installation instructions can be found in the docs along with many example problems.
Attribution
If you use MaxwellBloch for research, please use the following citation:
@misc{ogden2020maxwellbloch,
author = {Ogden, Thomas P.},
title = {{MaxwellBloch}: a Python package for solving the coupled
Maxwell-Bloch equations describing the nonlinear propagation of
near-resonant light through thermal quantised systems such as atomic
vapors.},
year = {2020},
publisher = {GitHub},
journal = {GitHub repository},
howpublished = {\url{https://github.com/tpogden/maxwellbloch}}
}
Changelog
See CHANGELOG.md.
License
MIT License. See LICENSE.txt.
Metadata
Release files for maxwellbloch 0.8.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| maxwellbloch-0.8.1.tar.gz | 48.6 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| maxwellbloch-0.8.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 125.2 kB
Release files / maxwellbloch-0.8.1.tar.gz
| Download URL | maxwellbloch-0.8.1.tar.gz |
|---|---|
| Size | 48.6 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
1fc3d4f2ad6e2d5cd1a1581cf846002ee21dade20acd0c586ee87b9f37c7dd67
|
|
BLAKE2b-256 checksum How to use checksums |
96b7ed7044a843c79fcfcf2a79731edb4f9586da8318dde7d4cb7799a6e69286
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
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 Apr 23, 2026.
Transparency logRelease files / maxwellbloch-0.8.1-py3-none-any.whl
| Download URL | maxwellbloch-0.8.1-py3-none-any.whl |
|---|---|
| Size | 76.6 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
94ca0fb87223c85824895f7a1800c74a49d47d308c4cf28d99628a16a5949bc3
|
|
BLAKE2b-256 checksum How to use checksums |
b1fdddf27e8e1672e30964bc406e96ec59ab39f6e8c660a80e6ccdd05297dacb
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
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 Apr 23, 2026.
Transparency log