Skip to main content

C³L (Coupled-Cluster Coupled Lindblad)

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)

Source distribution for C3L 0.1.0
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)

Table of built distributions (wheels) for C3L 0.1.0
File Interpreter ABI Platform Actions
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 log

Release 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 log

Security 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.

Select from 2 files

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 log

A 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.

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 release files Full provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page