quchip.declarative.dynamics

Public records for component-owned time-dependent Hamiltonian terms.

Functions

bind_time_coefficient(coefficient, bindings)

Bind symbolic coefficient fields to an owner's current values.

Classes

CosineCoefficient([amplitude, frequency, phase])

Cosine coefficient \(A\cos(2\pi f t+\phi)\).

TimeCoefficient()

Scalar coefficient of a component's time-dependent Hamiltonian term.

TimeDependentTerm(operator, coefficient)

An authored local operator and its time coefficient.
class quchip.declarative.dynamics.TimeCoefficient[source]

Bases: Registrable, ABC

Scalar coefficient of a component’s time-dependent Hamiltonian term.

Time is measured in ns. Implementations use quchip.qnp so values remain JAX-traceable without receiving an array namespace argument.

abstractmethod value(t)[source]

Evaluate the coefficient at time t in ns.

Parameters:

t (scalar or array-like) – Time in ns.

to_dict()[source]

Serialize the concrete coefficient and its numerical fields.

class quchip.declarative.dynamics.CosineCoefficient(amplitude=unbound, frequency=unbound, phase=0.0)[source]

Bases: TimeCoefficient

Cosine coefficient \(A\cos(2\pi f t+\phi)\).

Parameters:

  • amplitude (float) – Signed coefficient amplitude in GHz.

  • frequency (float) – Ordinary modulation frequency in GHz; positive.

  • phase (float, default 0.0) – Phase offset in radians.

amplitude: Any = Parameter(default=unbound, positive=False, nonnegative=False, serialize=True, unit='GHz', symbol=None, noise=False, kw_only=False, required=False)
frequency: Any = Parameter(default=unbound, positive=True, nonnegative=False, serialize=True, unit='GHz', symbol=None, noise=False, kw_only=False, required=False)
phase: Any = Parameter(default=0.0, positive=False, nonnegative=False, serialize=True, unit='rad', symbol=None, noise=False, kw_only=False, required=False)
value(t)[source]

Evaluate the coefficient at time t in ns.

Parameters:

t (scalar or array-like) – Time in ns.

quchip.declarative.dynamics.bind_time_coefficient(coefficient, bindings)[source]

Bind symbolic coefficient fields to an owner’s current values.

class quchip.declarative.dynamics.TimeDependentTerm(operator, coefficient)[source]

Bases: object

An authored local operator and its time coefficient.

Parameters:

  • operator (PhysicsExpr or backend operator) – Hamiltonian operator multiplied by the coefficient.

  • coefficient (TimeCoefficient) – Scalar coefficient evaluated as a function of time in ns.

operator: Any
coefficient: TimeCoefficient