models
¶
Reusable physical model factories.
IsingModel
dataclass
¶
Bundled operators for a classical or transverse-field Ising Hamiltonian.
Qubits are labeled 0 .. num_qubits - 1. Couplings act on the edge set
edges; single-site fields are on every qubit. Every ZZ edge and every
single-site field is a LocalHamiltonian. A long-range edge, including
the periodic wrap, names its two endpoints. Embedding that term puts
identity on the sites in between.
Attributes:
-
full_hamiltonians(list[Hamiltonian]) –Hamiltonian terms in the full Hilbert space.
-
local_hamiltonians(list[LocalHamiltonian]) –One ZZ term per edge and one single-site field per qubit.
-
c_ops_full(list[Operator]) –Lindblad operators in the full space (empty; closed system).
-
c_ops_local(list[LocalOperator]) –Local Lindblad operators (empty; closed system).
-
psi0(State) –Default initial state (all-|0⟩ classical, all-|+⟩ transverse).
-
e_ops(list[Operator]) –Per-site
Zobservables. -
measurements(list[Measurement]) –Per-site
Zexpectations from shot counts, matchinge_ops. -
pauli_sum(PauliSum) –Full Hamiltonian as a sparse Pauli sum.
-
edges(list[tuple[int, int]]) –Resolved undirected interaction pairs
(i, j)withi < j. -
num_qubits(int) –Number of qubits.
-
J(float) –Coupling strength.
-
h(float) –Field strength.
-
field(FieldKind) –"classical"(Z field) or"transverse"(X field). -
topology(TopologyKind) –"chain"or"custom"whenedgeswas supplied. -
boundary(BoundaryKind) –Boundary condition used for chain presets (
"open"for custom).
Source code in shadowsim/models/ising.py
JaynesCummingsModel
dataclass
¶
Bases: TavisCummingsModel
Bundled operators for the single-emitter Jaynes–Cummings open system.
This is a TavisCummingsModel with n_emitters fixed at 1.
Qubit layout is two cavity qubits (Fock truncation 4) followed by one
emitter qubit: sites [0, 1] then [2].
Source code in shadowsim/models/jaynes_cummings.py
__post_init__
¶
Require the single-emitter qubit layout.
Source code in shadowsim/models/jaynes_cummings.py
JaynesCummingsHubbardModel
dataclass
¶
Bases: TavisCummingsHubbardModel
Bundled operators for the single-emitter Jaynes–Cummings–Hubbard open system.
This is a TavisCummingsHubbardModel with n_emitters fixed at 1.
Each cavity is two Fock qubits followed by one emitter, so num_qubits
is 3 * n_cavities.
Source code in shadowsim/models/jaynes_cummings_hubbard.py
__post_init__
¶
Require one emitter on every cavity.
Source code in shadowsim/models/jaynes_cummings_hubbard.py
TavisCummingsModel
dataclass
¶
Bundled operators and helpers for the cavity–emitter open system.
Qubit layout is two cavity qubits (Fock truncation 4) followed by one qubit
per emitter: sites [0, 1] then [2, ..., 1 + n_emitters].
Attributes:
-
full_hamiltonians(list[Hamiltonian]) –Hamiltonian terms embedded in the full Hilbert space (QuTiP path).
-
local_hamiltonians(list[LocalHamiltonian]) –Hamiltonian terms on contiguous qubit blocks (Split-J path).
-
c_ops_full(list[Operator]) –Lindblad operators in the full Hilbert space.
-
c_ops_local(list[LocalOperator]) –Lindblad operators on local qubit blocks.
-
psi0(State) –Initial state (cavity Fock ⊗ all emitters in ground).
-
e_ops(list[Operator]) –Observables for QuTiP (cavity population, then each emitter).
-
measurements(list[Measurement]) –Shot-count measurements matching
e_ops(cavity population on qubits 0 and 1, then each emitter's population). -
num_qubits(int) –2 + n_emitters. -
n_emitters(int) –Number of two-level emitters.
Source code in shadowsim/models/tavis_cummings.py
TavisCummingsHubbardModel
dataclass
¶
Bases: TavisCummingsModel
Bundled operators for the Tavis–Cummings–Hubbard open system.
n_cavities blocks are concatenated. Each block is two cavity qubits
(Fock truncation 4) followed by n_emitters emitter qubits, so
n_emitters is the count on every cavity. num_qubits is
n_cavities * (2 + n_emitters).