cirq.sim.ActOnCliffordTableauArgs

View source on GitHub

State and context for an operation acting on a clifford tableau.

Inherits From: ActOnArgs, OperationTarget

View aliases

Main aliases

`cirq.ActOnCliffordTableauArgs`, `cirq.sim.clifford.ActOnCliffordTableauArgs`, `cirq.sim.clifford.act_on_clifford_tableau_args.ActOnCliffordTableauArgs`

cirq.sim.ActOnCliffordTableauArgs(
    tableau: cirq.qis.CliffordTableau,
    prng: np.random.RandomState,
    log_of_measurement_results: Dict[str, Any],
    qubits: Sequence['cirq.Qid'] = None
)

To act on this object, directly edit the tableau property, which is storing the density matrix of the quantum system with one axis per qubit.

Args
tableau	The CliffordTableau to act on. Operations are expected to perform inplace edits of this object.
qubits	Determines the canonical ordering of the qubits. This is often used in specifying the initial state, i.e. the ordering of the computational basis states.
prng	The pseudo random number generator to use for probabilistic effects.
log_of_measurement_results	A mutable object that measurements are being recorded into.

Attributes
log_of_measurement_results	Gets the log of measurement results.
qubits	Gets the qubit order maintained by this target.

Methods

apply_operation

View source

apply_operation(
    op: "cirq.Operation"
)

copy

View source

copy() -> cirq.sim.act_on_args.TSelf

Creates a copy of the object.

create_merged_state

View source

create_merged_state() -> cirq.sim.act_on_args.TSelf

Creates a final merged state.

factor

View source

factor(
    qubits: Sequence['cirq.Qid'],
    *,
    validate=True,
    atol=1e-07,
    inplace=False
) -> Tuple[cirq.sim.act_on_args.TSelf, cirq.sim.act_on_args.TSelf]

Splits two state spaces after a measurement or reset.

get_axes

View source

get_axes(
    qubits: Sequence['cirq.Qid']
) -> List[int]

kronecker_product

View source

kronecker_product(
    other: cirq.sim.act_on_args.TSelf,
    *,
    inplace=False
) -> cirq.sim.act_on_args.TSelf

Joins two state spaces together.

measure

View source

measure(
    qubits: Sequence['cirq.Qid'],
    key: str,
    invert_mask: Sequence[bool]
)

Adds a measurement result to the log.

Args
qubits	The qubits to measure.
key	The key the measurement result should be logged under. Note that operations should only store results under keys they have declared in a _measurement_key_names_ method.
invert_mask	The invert mask for the measurement.

rename

View source

rename(
    q1: "cirq.Qid",
    q2: "cirq.Qid",
    *,
    inplace=False
)

Renames q1 to q2.

Args
q1	The qubit to rename.
q2	The new name.
inplace	True to rename the qubit in the current object, False to create a copy with the qubit renamed.

Returns
The original object with the qubits renamed if inplace is requested, or a copy of the original object with the qubits renamed otherwise.

Raises
ValueError	If the qubits are of different dimensionality.

sample

View source

sample(
    qubits: Sequence['cirq.Qid'],
    repetitions: int = 1,
    seed: "cirq.RANDOM_STATE_OR_SEED_LIKE" = None
) -> np.ndarray

Samples the state value.

swap

View source

swap(
    q1: "cirq.Qid",
    q2: "cirq.Qid",
    *,
    inplace=False
)

Swaps two qubits.

This only affects the index, and does not modify the underlying state.

Args
q1	The first qubit to swap.
q2	The second qubit to swap.
inplace	True to swap the qubits in the current object, False to create a copy with the qubits swapped.

Returns
The original object with the qubits swapped if inplace is requested, or a copy of the original object with the qubits swapped otherwise.

Raises
ValueError	If the qubits are of different dimensionality.

transpose_to_qubit_order

View source

transpose_to_qubit_order(
    qubits: Sequence['cirq.Qid'],
    *,
    inplace=False
) -> cirq.sim.act_on_args.TSelf

Physically reindexes the state by the new basis.

Args
qubits	The desired qubit order.
inplace	True to perform this operation inplace.

Returns
The state with qubit order transposed and underlying representation updated.

Raises
ValueError	If the provided qubits do not match the existing ones.

__getitem__

View source

__getitem__(
    item: Optional['cirq.Qid']
) -> cirq.sim.act_on_args.TSelf

Gets the item associated with the qubit.

__iter__

View source

__iter__() -> Iterator[Optional['cirq.Qid']]

Iterates the keys of the mapping.

__len__

View source

__len__() -> int

Gets the number of items in the mapping.