cirq.Circuit

class cirq.Circuit(moments: Iterable[cirq.circuits.moment.Moment] = (), device: cirq.devices.device.Device = cirq.UnconstrainedDevice)

A mutable list of groups of operations to apply to some qubits.

Methods returning information about the circuit:

next_moment_operating_on

prev_moment_operating_on

operation_at

qubits

findall_operations

to_unitary_matrix

apply_unitary_effect_to_state

to_text_diagram

to_text_diagram_drawer

Methods for mutation:

insert

append

insert_into_range

clear_operations_touching

Circuits can also be iterated over,

for moment in circuit:

…

and sliced,

circuit[1:3] is a new Circuit made up of two moments, the first being

circuit[1] and the second being circuit[2];

and concatenated,

circuit1 + circuit2 is a new Circuit made up of the moments in circuit1

followed by the moments in circuit2;

and multiplied by an integer,

circuit * k is a new Circuit made up of the moments in circuit repeated

k times.

and mutated,

circuit[1:7] = [Moment(…)]

__init__(moments: Iterable[cirq.circuits.moment.Moment] = (), device: cirq.devices.device.Device = cirq.UnconstrainedDevice) → None

Initializes a circuit.

Parameters:

• moments – The initial list of moments defining the circuit.
• device – Hardware that the circuit should be able to run on.

Methods

all_operations()	Iterates over the operations applied by this circuit.
all_qubits()	Returns the qubits acted upon by Operations in this circuit.
append(moment_or_operation_tree, …)	Appends operations onto the end of the circuit.
apply_unitary_effect_to_state(initial_state, …)	Left-multiplies a state vector by the circuit’s unitary effect.
are_all_measurements_terminal()
batch_insert(insertions, …)	Applies a batched insert operation to the circuit.
batch_insert_into(insert_intos, …)	Inserts operations into empty spaces in existing moments.
batch_remove(removals, …)	Removes several operations from a circuit.
clear_operations_touching(qubits, moment_indices)	Clears operations that are touching given qubits at given moments.
copy()
findall_operations(predicate, bool])	Find the locations of all operations that satisfy a given condition.
findall_operations_between(start_frontier, …)	Finds operations between the two given frontiers.
findall_operations_with_gate_type(gate_type)	Find the locations of all gate operations of a given type.
from_ops(*operations, strategy, device)	Creates an empty circuit and appends the given operations.
insert(index, moment_or_operation_tree, …)	Inserts a moment or operations into the circuit.
insert_at_frontier(operations, …)	Inserts operations inline at frontier.
insert_into_range(operations, …)	Writes operations inline into an area of the circuit.
next_moment_operating_on(qubits, …)	Finds the index of the next moment that touches the given qubits.
next_moments_operating_on(qubits, …)	Finds the index of the next moment that touches each qubit.
operation_at(qubit, moment_index)	Finds the operation on a qubit within a moment, if any.
prev_moment_operating_on(qubits, …)	Finds the index of the next moment that touches the given qubits.
reachable_frontier_from(start_frontier, …)	Determines how far can be reached into a circuit under certain rules.
save_qasm(file_path, bytes, int], header, …)	Save a QASM file equivalent to the circuit.
to_qasm(header, precision, qubit_order, …)	Returns QASM equivalent to the circuit.
to_text_diagram(*, use_unicode_characters, …)	Returns text containing a diagram describing the circuit.
to_text_diagram_drawer(*, …)	Returns a TextDiagramDrawer with the circuit drawn into it.
to_unitary_matrix(qubit_order, …)	Converts the circuit into a unitary matrix, if possible.
with_device(new_device, qubit_mapping, …)	Maps the current circuit onto a new device, and validates.

Attributes

device