cirq.sim.ActOnCliffordTableauArgs

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,
    axes: Iterable[int] = 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.
`axes`	The indices of axes corresponding to the qubits that the operation is supposed to act upon.

Attributes
`axes`	THIS FUNCTION IS DEPRECATED. IT WILL BE REMOVED IN `cirq v0.13`. Use `protocols.act_on` instead.
`log_of_measurement_results`	Gets the log of measurement results.
`qubits`	Gets the qubit order maintained by this target.

Attributes

axes

THIS FUNCTION IS DEPRECATED.

IT WILL BE REMOVED IN cirq v0.13.

Use protocols.act_on instead.

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"
)

Applies the operation to the state.

`copy`

View source

copy() -> "cirq.ActOnCliffordTableauArgs"

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
) -> 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
) -> 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_keys_` 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']
) -> cirq.sim.act_on_args.TSelf

Physically reindexes the state by the new basis.

`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.