qutip
¶
QuTiP ↔ ShadowSim conversion helpers.
Convert QuTiP Qobj values to ShadowSim core types and back::
from shadowsim.interop.qutip import from_qutip, to_qutip
H = from_qutip(qutip_H) # → Hamiltonian
ops = [from_qutip(c) for c in c_ops] # → Operator
psi = from_qutip(psi0) # → State (ket)
rho = from_qutip(qutip_rho) # → DensityOperator
Hermitian PSD unit-trace opers become DensityOperator.
Override with kind="hamiltonian" or kind="operator" when needed (e.g. a
projector used as an observable).
from_qutip
¶
from_qutip(
qobj: Qobj,
*,
kind: Kind | None = None,
num_qubits: int | None = None,
local_dim: int | None = None,
) -> State | DensityOperator | Hamiltonian | Operator
Convert a QuTiP Qobj to a ShadowSim core type.
When kind is omitted, inference is:
- ket or bra →
State - square Hermitian PSD unit-trace oper →
DensityOperator - other square Hermitian oper →
Hamiltonian - other square oper →
Operator
Parameters:
-
qobj(Qobj) –QuTiP quantum object to convert.
-
kind(Kind | None, default:None) –Optional override:
"state","hamiltonian","operator", or"density". -
num_qubits(int | None, default:None) –Override inferred site count when building a
State. -
local_dim(int | None, default:None) –Override inferred local dimension when building a
State.
Returns:
-
State | DensityOperator | Hamiltonian | Operator–The corresponding ShadowSim object.
Raises:
-
TypeError–If
qobjis not aQobj, orkindis invalid. -
ValueError–If the object type cannot be converted, or state dims are ambiguous / inconsistent.
Source code in shadowsim/interop/qutip.py
to_qutip
¶
to_qutip(
obj: State | Operator | Hamiltonian | DensityOperator,
) -> Qobj
Convert a ShadowSim core type to a QuTiP Qobj.
Parameters:
-
obj(State | Operator | Hamiltonian | DensityOperator) –ShadowSim object to convert.
Returns:
-
Qobj–A ket
QobjforState(flat dims[[dim], [1]]), or an oper -
Qobj–Qobjfor operators (includingHamiltonianandDensityOperator). -
Qobj–Flat state dims match dense Hamiltonians passed to QuTiP solvers.
Raises:
-
TypeError–If
objis not a supported ShadowSim type.