cirq_google.devices.XmonDevice

A device with qubits placed in a grid. Neighboring qubits can interact.

cirq_google.devices.XmonDevice(
    measurement_duration: cirq.DURATION_LIKE,
    exp_w_duration: cirq.DURATION_LIKE,
    exp_11_duration: cirq.DURATION_LIKE,
    qubits: Iterable[cirq.GridQubit]
) -> None

measurement_duration The maximum duration of a measurement.
exp_w_duration The maximum duration of an ExpW operation.
exp_11_duration The maximum duration of an ExpZ operation.
qubits Qubits on the device, identified by their x, y location.

Methods

at

View source

at(
    row: int,
    col: int
) -> Optional[cirq.GridQubit]

Returns the qubit at the given position, if there is one, else None.

can_add_operation_into_moment

View source

can_add_operation_into_moment(
    operation: cirq.Operation,
    moment: cirq.Moment
) -> bool

Determines if it's possible to add an operation into a moment.

For example, on the XmonDevice two CZs shouldn't be placed in the same moment if they are on adjacent qubits.

Args
operation The operation being added.
moment The moment being transformed.

Returns
Whether or not the moment will validate after adding the operation.

col

View source

col(
    col: int
) -> cirq_google.line.placement.anneal.LineSequence

Returns the qubits in the given column, in ascending order.

decompose_operation

View source

decompose_operation(
    operation: cirq.Operation
) -> cirq.OP_TREE

Returns a device-valid decomposition for the given operation.

This method is used when adding operations into circuits with a device specified, to avoid spurious failures due to e.g. using a Hadamard gate that must be decomposed into native gates.

duration_of

View source

duration_of(
    operation
)

is_supported_gate

View source

@classmethod
is_supported_gate(
    gate: cirq.Gate
)

Returns true if the gate is allowed.

neighbors_of

View source

neighbors_of(
    qubit: cirq.GridQubit
)

Returns the qubits that the given qubit can interact with.

qid_pairs

qid_pairs() -> Optional[FrozenSet['cirq.SymmetricalQidPair']]

Returns a set of qubit edges on the device, if possible.

This property can be overridden in child classes for special handling. The default handling is: GridQids and LineQids will have neighbors as edges, and others will be fully connected.

Returns
If the device has a finite set of qubits, then a set of all edges on the device is returned.

If the device has no well defined finite set of qubits (e.g. cirq.UnconstrainedDevice has this property), then None is returned.

qubit_set

View source

qubit_set() -> FrozenSet[cirq.GridQubit]

Returns a set or frozenset of qubits on the device, if possible.

Returns
If the device has a finite set of qubits, then a set or frozen set of all qubits on the device is returned.

If the device has no well defined finite set of qubits (e.g. cirq.UnconstrainedDevice has this property), then None is returned.

row

View source

row(
    row: int
) -> cirq_google.line.placement.anneal.LineSequence

Returns the qubits in the given row, in ascending order.

validate_circuit

View source

validate_circuit(
    circuit: cirq.AbstractCircuit
)

Raises an exception if a circuit is not valid.

Args
circuit The circuit to validate.

Raises
ValueError The circuit isn't valid for this device.

validate_gate

View source

validate_gate(
    gate: cirq.Gate
)

Raises an error if the given gate isn't allowed.

Raises
ValueError Unsupported gate.

validate_moment

View source

validate_moment(
    moment: cirq.Moment
)

Raises an exception if a moment is not valid.

Args
moment The moment to validate.

Raises
ValueError The moment isn't valid for this device.

validate_operation

View source

validate_operation(
    operation: cirq.Operation
)

Raises an exception if an operation is not valid.

Args
operation The operation to validate.

Raises
ValueError The operation isn't valid for this device.

__eq__

__eq__(
    other: _SupportsValueEquality
) -> bool

__ne__

__ne__(
    other: _SupportsValueEquality
) -> bool