C³L (Coupled-Cluster Coupled Lindblad)
C³L (Coupled-Cluster Coupled Lindblad, "C cubed L") applies coupled-cluster theory to non-Markovian impurity dynamics. By representing bath memory with coupled Lindblad pseudomodes, it provides a scalable route to correlated steady states, dynamical Green functions, spectra, and nonequilibrium transport in multiorbital systems with general two-body interactions.
Install
C³L requires Python 3.11 or newer.
python -m pip install c3l
The installation includes JAX and RealTimeBath for bath fitting. In Python, use import c3l.
CPU and GPU calculations use the same installation. On Linux x86-64 and ARM64, CUDA 13 dependencies are installed automatically. GPU execution requires a compatible NVIDIA GPU and driver; see the JAX installation guide.
For some examples using additional utilities, install the optional benchmarking tools:
python -m pip install "c3l[benchmark]"
From source
From the root of a downloaded or cloned source tree:
python -m pip install .
For developers
For development, use python -m pip install -e ".[test]"; run the tests with python -m pytest.
Quick start
This CPU example computes a CCSD steady state and its $\mathcal S_{1,3}$ spectral function for an impurity coupled to two bath orbitals.
Show the CCSD and response example
import numpy as np
from c3l import FermionicLindbladModel
from c3l.cc.factorized import factorized_cc_problem
from c3l.cc.component_tensor import (
ComponentStaticProblem, ComponentEOMProblem, component_eom_context, component_eom_sources,
)
from c3l.cc.component_solver import solve_component_ccsd
from c3l.cc.eom import eom_ccsd_problem
from c3l.cc.component_response import ComponentSigmaOperator, component_retarded_green
model = FermionicLindbladModel(
E=np.array([[-0.6, 0.28, 0.28], [0.28, -1.2, 0.0], [0.28, 0.0, 1.2]]),
gamma_loss=np.diag([0.0, 0.06, 0.48]),
gamma_gain=np.diag([0.0, 0.48, 0.06]),
U=1.2,
)
problem = ComponentStaticProblem.compile(
factorized_cc_problem(model, "CCSD")
)
solution = solve_component_ccsd(problem)
print(f"CCSD residual: {solution.packed_residual_norm:.2e}")
eom = eom_ccsd_problem(problem.oracle)
context = component_eom_context(
ComponentEOMProblem.compile(eom, problem, charge=1), solution.amplitudes
)
omega = np.linspace(-4.0, 4.0, 81)
response = component_retarded_green(
ComponentSigmaOperator(context), component_eom_sources(context), omega, eta=0.0
)
np.savez("spectrum.npz", omega=omega, G_R=response.retarded, A=-response.retarded.imag / np.pi)
spectrum.npz contains the impurity Green function and spectral density $A(\omega)=-\Im G^R(\omega)/\pi$ per spin.
Examples
See the examples guide for more examples. These optional scripts are provided in the source repository.
Citing C³L
If you use C³L in your research, please cite our preprint:
Hao-En Li, Zhen Huang, and Lin Lin, Efficient simulations of spectra and transport for multiorbital quantum impurities, 2026.
@misc{LiHuangLin2026,
title = {Efficient simulations of spectra and transport for multiorbital quantum impurities},
author = {Li, Hao-En and Huang, Zhen and Lin, Lin},
year = {2026},
note = {Preprint},
url = {https://github.com/haoen2021/C3Lindblad/blob/main/preprint/Efficient_Multiorbital_Impurities.pdf}
}
If your calculation employed the bath fitting based on RealTimeBath, cite
Zhen Huang, Gunhee Park, Garnet Kin-Lic Chan, and Lin Lin, Coupled Lindblad Pseudomode Theory for Simulating Open Quantum Systems, Phys. Rev. Lett. 2026, 136, 090403
License
MIT License. Copyright (c) 2026 Hao-En Li.
Metadata
Release files for C3L 0.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| c3l-0.1.0.tar.gz | 159.5 kB | With provenance | Details for c3l-0.1.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| c3l-0.1.0-py3-none-any.whl | Python 3 | none | any | Details for c3l-0.1.0-py3-none-any.whl |
Total release size: 316.1 kB
Release files / c3l-0.1.0.tar.gz
| Download URL | c3l-0.1.0.tar.gz |
|---|---|
| Size | 159.5 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
c159b432077ddb18d4434feaa9e5c02d2a52a27d7d1318ea2e8a39015cf1e152
|
|
BLAKE2b-256 checksum How to use checksums |
366057d3b3e08f979e51d7c61bb56693ace8423fe2b15dffe7786d39604c08f6
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
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 30, 2026.
Transparency logRelease files / c3l-0.1.0-py3-none-any.whl
| Download URL | c3l-0.1.0-py3-none-any.whl |
|---|---|
| Size | 156.6 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
f8389f0874837a1e1751f7a864cb3f954df5c03b1221643aef54baf6386d3b59
|
|
BLAKE2b-256 checksum How to use checksums |
34717e457c060e2b626089df096dd176d2cfb9278c62e71108e99bff548b531f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
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 30, 2026.
Transparency logSecurity for C3L 0.1.0
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
All 2 files in this release have been uploaded with provenance metadata.
Attestation for c3l-0.1.0.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 30, 2026.
Transparency logA 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.