# MaxwellBloch Documentation¶

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.

MaxwellBloch is used for theoretical research, for modelling experiments and for undergraduate and graduate teaching.

MaxwellBloch can model two, three or many-level systems with physical effects including:

Inhomogeneous broadening due to spontaneous decay,

Doppler broadening in thermal systems,

Collision dephasing,

Sub-level structure.

Modules are also available for:

Generating hyperfine structure for alkali atoms with the correct channels and angular momentum factors for coupling and decay,

Specral analysis,

Plotting and animating solutions.

Some phenomena that can be demonstrated:

Linear absorption and dispersion,

Fast light,

Slow light,

Electromagnetically Induced Transparency (EIT),

Storage and Retrieval of Light pulses,

Self-Induced Transparency (SIT) and Optical Solitons,

Matched Pulses and Simultons,

Hyperfine Pumping.

See the Examples section below for details.

- Two-level
- Three-level
- Λ Configuration
- V Configuration
- V-Type Three-Level: 0.5π Sech Pulse, 0.5π Coupling
- V-Type Three-Level: 0.5π Sech Pulse, 1.5π Coupling — Simulton Propagation
- V-Type Three-Level: √2π Sech Pulse, √2π Coupling
- V-Type Three-Level: √8π Sech Pulse, √8π Coupling
- V-Type Three-Level: √18π Sech Pulse, √18π Coupling
- V-Type Three-Level: Solitons form Simulton
- V-Type Three-Level: Weak CW, √2π Coupling: Optical Surfer
- V-Type Three-Level: Weak CW, √4π Coupling: Double Optical Surfer

- Ladder (Ξ) Configuration

- Structure