cirq.DensityMatrixTrialResult

View source on GitHub

A SimulationTrialResult for DensityMatrixSimulator runs.

Inherits From: SimulationTrialResultBase, SimulationTrialResult

cirq.DensityMatrixTrialResult(
    params: 'cirq.ParamResolver',
    measurements: Dict[str, np.ndarray],
    final_simulator_state: 'cirq.SimulationStateBase[cirq.DensityMatrixSimulationState]'
) -> None

The density matrix that is stored in this result is returned in the computational basis with these basis states defined by the qubit_map. In particular, the value in the qubit_map is the index of the qubit, and these are translated into binary vectors where the last qubit is the 1s bit of the index, the second-to-last is the 2s bit of the index, and so forth (i.e. big endian ordering). The density matrix is a 2 ** num_qubits square matrix, with rows and columns ordered by the computational basis as just described.

Example
qubit_map	{QubitA: 0, QubitB: 1, QubitC: 2} Then the returned density matrix will have (row and column) indices mapped to qubit basis states like the following table | | QubitA | QubitB | QubitC | | :-: | :----: | :----: | :----: | | 0 | 0 | 0 | 0 | | 1 | 0 | 0 | 1 | | 2 | 0 | 1 | 0 | | 3 | 0 | 1 | 1 | | 4 | 1 | 0 | 0 | | 5 | 1 | 0 | 1 | | 6 | 1 | 1 | 0 | | 7 | 1 | 1 | 1 |

Args
params	A ParamResolver of settings used for this result.
measurements	A dictionary from measurement gate key to measurement results. Measurement results are a numpy ndarray of actual boolean measurement results (ordered by the qubits acted on by the measurement gate.)
final_simulator_state	The final simulator state of the system after the trial finishes.

Attributes
params	A ParamResolver of settings used for this result.
measurements	A dictionary from measurement gate key to measurement results. Measurement results are a numpy ndarray of actual boolean measurement results (ordered by the qubits acted on by the measurement gate.)
final_simulator_state	The final simulator state of the system after the trial finishes.
final_density_matrix
qubit_map	A map from Qid to index used to define the ordering of the basis in the result.

Methods

get_state_containing_qubit

View source

get_state_containing_qubit(
    qubit: 'cirq.Qid'
) -> TSimulationState

Returns the independent state space containing the qubit.

Args
qubit	The qubit whose state space is required.

Returns
The state space containing the qubit.

__eq__

View source

__eq__(
    other: _SupportsValueEquality
) -> bool

__ne__

View source

__ne__(
    other: _SupportsValueEquality
) -> bool