quchip.devices.fluxonium

Fluxonium authored on a finite phase grid.

Classes

Fluxonium(E_C, E_J, E_L[, phi_ext, levels, ...])

Fluxonium with its Hamiltonian authored in a finite phase-grid basis.
class quchip.devices.fluxonium.Fluxonium(E_C, E_J, E_L, phi_ext=0.0, levels=None, label=None, *, num_basis=400, phi_max=15.707963267948966, basis=None, collapse_model='fermi_golden', coupling_channel=None, collapse_rate_threshold=1e-08, **noise)[source]

Bases: DeviceModel

Fluxonium with its Hamiltonian authored in a finite phase-grid basis.

Parameters:

  • E_C (Scalar)

  • E_J (Scalar)

  • E_L (Scalar)

  • phi_ext (Scalar)

  • levels (int | None)

  • label (str | None)

  • num_basis (int)

  • phi_max (float)

  • basis (Literal['native', 'eigen'] | None)

  • collapse_model (Literal['fermi_golden', 'ladder'])

  • coupling_channel (Literal['charge', 'flux'] | None)

  • collapse_rate_threshold (float)

  • noise (Any)

tunable_param_names = ('E_C', 'E_J', 'E_L', 'phi_ext')

Bare parameters this device exposes as differentiable / tunable scalars. fit_a_dress walks this tuple to discover what it is allowed to optimize on each device, decoupling the inverse-design surface from any specific device model. Three states, keyed on whether the value is explicitly declared:

  • No explicit declaration anywhere in the DeviceModel lineage — the default is derived: every declared parameter() field, in declaration order (see DeviceModel.__init_subclass__).

  • Explicit tuple on the class or an ancestor — exact curation, validated at class-definition time; authoritative and inherited until a subclass explicitly replaces it.

  • Explicit empty tuple — deliberately freezes the device (and its subclasses, until one replaces it) out of inverse design.

On a plain (non-DeviceModel) BaseDevice subclass there is no derivation; the default stays empty unless the subclass declares its own tuple — e.g. Fluxonium uses ("E_C", "E_J", "E_L", "phi_ext").

approximation = 'Finite phase-grid model with a second-order charge kinetic operator; accuracy is governed by num_basis and phi_max.'

Declared approximation-regime statement surfaced by physics_notes() — the mechanism that keeps a model’s stated validity range attached to the class rather than buried in a docstring a caller may not read.

computational = True

Whether this device represents a computational qubit, as opposed to e.g. a bus resonator or a coupler element.

requires_projection_levels: ClassVar[bool] = True
structural_setting_names = ('num_basis', 'phi_max', 'basis', 'projection_levels', 'collapse_model', 'coupling_channel', 'collapse_rate_threshold')
E_C: Scalar = Parameter(default=unbound, positive=True, nonnegative=False, serialize=True, unit='GHz', symbol='E_C', noise=False, kw_only=False, required=False)
E_J: Scalar = Parameter(default=unbound, positive=True, nonnegative=False, serialize=True, unit='GHz', symbol='E_J', noise=False, kw_only=False, required=False)
E_L: Scalar = Parameter(default=unbound, positive=True, nonnegative=False, serialize=True, unit='GHz', symbol='E_L', noise=False, kw_only=False, required=False)
phi_ext: Scalar = Parameter(default=0.0, positive=False, nonnegative=False, serialize=True, unit=None, symbol='\\varphi_{\\mathrm{ext}}', noise=False, kw_only=False, required=False)
dissipation(op, p)[source]

Return device-local Lindblad channels.

The base channels implement T1, T2, and thermal occupation. Subclasses may append channels with super().dissipation(op, p).

Parameters:
Return type:

tuple[CollapseChannel, …]

local_space()[source]

Return the authored finite phase-grid space.

Return type:

PhaseGridSpace

local_hamiltonian(op, p)[source]

Return the native fluxonium Hamiltonian in ordinary GHz.

Parameters:
Return type:

PhysicsExpr

property freq: Any

Return the isolated 0-to-1 transition in GHz.

eigenenergies()[source]

Return isolated energies shifted to zero at the ground state.

Return type:

Any

eigenvectors()[source]

Return the isolated energy-ordered phase-grid eigenvectors.

Return type:

Any

charge_coupling_operator()[source]

Return the authored charge operator.

Return type:

Any

phase_coupling_operator()[source]

Return the authored phase operator.

Return type:

Any

flux_coupling_operator()[source]

Return the authored flux-line phase operator.

Return type:

Any

physics_notes()[source]

Return base device notes plus the declared approximation, if any.

Return type:

list[str]

to_dict()[source]

Serialize common device state plus declared parameter values.

Return type:

dict[str, Any]

classmethod from_dict(data)[source]

Reconstruct the device from to_dict() output.

Parameters:

data (dict[str, Any])

Return type:

Fluxonium