cirq_google.ops.AnalogDetuneCouplerOnly

Set a coupler detuning from g_0 to g_max according to analog model.

cirq_google.ops.AnalogDetuneCouplerOnly(
    length: su.ValueOrSymbol,
    w: su.ValueOrSymbol,
    g_0: su.ValueOrSymbol,
    g_max: su.ValueOrSymbol,
    g_ramp_exponent: cirq.TParamVal = 1.0,
    neighbor_qubits_freq: tuple[su.ValueOrSymbol | None, su.ValueOrSymbol | None] = (None, None),
    prev_neighbor_qubits_freq: tuple[su.ValueOrSymbol | None, su.ValueOrSymbol | None] = (None, None),
    interpolate_coupling_cal: bool = True,
    analog_cal_for_pulseshaping: bool = False
)

The shape of pulse followed by the g=g_0+A*t^g_exp (1 gives linear ramp), where the coefficient is auto calculated by the g_max.

Pulse shape:

.. svgbob:: :align: center

    |   ,--------|---- amp_max (parsed from g_max)
    |  /         |

amp_0---|-' - - - - -| - - | | |-w -| | | |---length --| | --------------------------(calculated from the g_0)

length The duration of gate.
w Width of the step envelope raising edge.
g_0 The pulse shape is specified with the equation g(t) = g_0+A*t^g_exp. where g(0)=g_0 and g(w)=g_max. The ramp is according to the power law with exponent specified by g_ramp_exponent.
g_max See g_0.
g_ramp_exponent See g_0.
neighbor_qubits_freq Two frequency of the neighbor qubits at the moment. If the provided value is None, we assume neighbor qubits are at idle freq.
prev_neighbor_qubits_freq Two frequency of the neighbor qubits at preivous moment.
interpolate_coupling_cal If true, find the required amp for the coupling strength through interpolation. If not true, require all coupling strength has associated amp calibrated in the registry.
analog_cal_for_pulseshaping If ture, using the analog model instead of standard transmon model to find the amp of pulse.

Methods

controlled

controlled(
    num_controls: (int | None) = None,
    control_values: (cv.AbstractControlValues | Sequence[int | Collection[int]] | None) = None,
    control_qid_shape: (tuple[int, ...] | None) = None
) -> Gate

Returns a controlled version of this gate. If no arguments are specified, defaults to a single qubit control.

Args
num_controls Total number of control qubits.
control_values Which control computational basis state to apply the sub gate. A sequence of length num_controls where each entry is an integer (or set of integers) corresponding to the computational basis state (or set of possible values) where that control is enabled. When all controls are enabled, the sub gate is applied. If unspecified, control values default to 1.
control_qid_shape The qid shape of the controls. A tuple of the expected dimension of each control qid. Defaults to (2,) * num_controls. Specify this argument when using qudits.

Returns
A cirq.Gate representing self controlled by the given control values and qubits. This is a cirq.ControlledGate in the base implementation, but subclasses may return a different gate type.

num_qubits

num_qubits() -> int

The number of qubits this gate acts on.

on

View source

on(
    *qubits
) -> cirq.Operation

Returns an application of this gate to the given qubits.

Coupler gate will silently change two qubit Qids into a single Coupler Qid object so that adjacent couplers can be simultaneously acted on in the same moment.

on_each

View source

on_each(
    *targets
) -> list[cirq.Operation]

Returns a list of operations applying the gate to all targets.

validate_args

validate_args(
    qubits: Sequence[cirq.Qid]
) -> None

Checks if this gate can be applied to the given qubits.

By default checks that:

  • inputs are of type Qid
  • len(qubits) == num_qubits()
  • qubit_i.dimension == qid_shape[i] for all qubits

Child classes can override. The child implementation should call super().validate_args(qubits) then do custom checks.

Args
qubits The sequence of qubits to potentially apply the gate to.

Raises
ValueError The gate can't be applied to the qubits.

with_probability

with_probability(
    probability: cirq.TParamVal
) -> cirq.Gate

Creates a probabilistic channel with this gate.

Args
probability floating point value between 0 and 1, giving the probability this gate is applied.

Returns
cirq.RandomGateChannel that applies self with probability probability and the identity with probability 1-p.

wrap_in_linear_combination

wrap_in_linear_combination(
    coefficient: cirq.TParamValComplex = 1
) -> cirq.LinearCombinationOfGates

Returns a LinearCombinationOfGates with this gate.

Args
coefficient number coefficient to use in the resulting cirq.LinearCombinationOfGates object.

Returns
cirq.LinearCombinationOfGates containing self with a coefficient of coefficient.

__add__

__add__(
    other: (Gate | cirq.LinearCombinationOfGates)
) -> cirq.LinearCombinationOfGates

__call__

__call__(
    *qubits, **kwargs
)

Call self as a function.

__eq__

__eq__(
    other: _SupportsValueEquality
) -> bool

__mul__

__mul__(
    other: complex
) -> cirq.LinearCombinationOfGates

__ne__

__ne__(
    other: _SupportsValueEquality
) -> bool

__neg__

__neg__() -> cirq.LinearCombinationOfGates

__pow__

__pow__(
    power
)

__rmul__

__rmul__(
    other: complex
) -> cirq.LinearCombinationOfGates

__sub__

__sub__(
    other: (Gate | cirq.LinearCombinationOfGates)
) -> cirq.LinearCombinationOfGates

__truediv__

__truediv__(
    other: complex
) -> cirq.LinearCombinationOfGates