qiskit.aqua.operators.legacy.MatrixOperator

class MatrixOperator(matrix, basis=None, z2_symmetries=None, atol=1e-12, name=None)

Operators relevant for quantum applications

注釈

For grouped paulis representation, all operations will always convert it to paulis and then convert it back. (It might be a performance issue.)

パラメータ

• matrix (numpy.ndarray or scipy.sparse.csr_matrix) – a 2-D sparse matrix represents operator (using CSR format internally)

• basis (list[tuple(object, [int])], optional) – the grouping basis, each element is a tuple composed of the basis and the indices to paulis which are belonged to that group. e.g., if tpb basis is used, the object will be a pauli. by default, the group is equal to non-grouping, each pauli is its own basis.

• z2_symmetries (Z2Symmetries) – represent the Z2 symmetries

• atol (float) – atol

• name (str) – name

__init__(matrix, basis=None, z2_symmetries=None, atol=1e-12, name=None)

パラメータ

• matrix (numpy.ndarray or scipy.sparse.csr_matrix) – a 2-D sparse matrix represents operator (using CSR format internally)

• basis (list[tuple(object, [int])], optional) – the grouping basis, each element is a tuple composed of the basis and the indices to paulis which are belonged to that group. e.g., if tpb basis is used, the object will be a pauli. by default, the group is equal to non-grouping, each pauli is its own basis.

• z2_symmetries (Z2Symmetries) – represent the Z2 symmetries

• atol (float) – atol

• name (str) – name

Methods

__init__(matrix[, basis, z2_symmetries, …])	param matrix a 2-D sparse matrix represents operator (using CSR format internally)
add(other[, copy])
chop([threshold, copy])	Eliminate the real and imagine part of coeff in each pauli by threshold.
construct_evaluation_circuit(wave_function)	Construct the circuits for evaluation.
copy()	Get a copy of self.
evaluate_with_result(result[, …])	Use the executed result with operator to get the evaluated value.
evaluate_with_statevector(quantum_state)	param quantum_state quantum state
evolve(state_in[, evo_time, …])	Carry out the eoh evolution for the operator under supplied specifications.
is_empty()	Check Operator is empty or not.
print_details()	returns a formatted operator.
sub(other[, copy])
to_opflow()	to op flow

Attributes

atol	return atol
basis	returns basis
dense_matrix	Getter of matrix in dense matrix form.
dia_matrix	diagonal matrix
matrix	Getter of matrix.
name	returns name
num_qubits	number of qubits required for the operator.
z2_symmetries	returns z2 symmetries

add(other, copy=False)

property atol

return atol

property basis

returns basis

chop(threshold=None, copy=False)

Eliminate the real and imagine part of coeff in each pauli by threshold. If pauli’s coeff is less then threshold in both real and imagine parts, the pauli is removed. To align the internal representations, all available representations are chopped. The chopped result is stored back to original property. Note: if coeff is real-only, the imag part is skipped.

パラメータ

• threshold (float) – threshold chops the paulis

• copy (bool) – copy or self

戻り値

self or copy

戻り値の型

MatrixOperator

construct_evaluation_circuit(wave_function, statevector_mode=True, use_simulator_snapshot_mode=None, circuit_name_prefix='')

Construct the circuits for evaluation.

パラメータ

• wave_function (QuantumCircuit) – the quantum circuit.

• statevector_mode (bool) – mode

• use_simulator_snapshot_mode (bool) – uses simulator operator mode

• circuit_name_prefix (str, optional) – a prefix of circuit name

戻り値

the circuits for computing the expectation of the operator over

the wavefunction evaluation.

戻り値の型

list[QuantumCircuit]

copy()

Get a copy of self.

property dense_matrix

Getter of matrix in dense matrix form.

property dia_matrix

diagonal matrix

evaluate_with_result(result, statevector_mode=True, use_simulator_snapshot_mode=None, circuit_name_prefix='')

Use the executed result with operator to get the evaluated value.

パラメータ

• result (qiskit.Result) – the result from the backend

• statevector_mode (bool) – mode

• use_simulator_snapshot_mode (bool) – uses simulator operator mode

• circuit_name_prefix (str, optional) – a prefix of circuit name

戻り値

the mean value float: the standard deviation

戻り値の型

float

例外

AquaError – if Operator is empty

evaluate_with_statevector(quantum_state)

パラメータ

quantum_state (numpy.ndarray) – quantum state

戻り値

the mean value float: the standard deviation

戻り値の型

float

例外

AquaError – if Operator is empty

evolve(state_in, evo_time=0, num_time_slices=0, expansion_mode='trotter', expansion_order=1)

Carry out the eoh evolution for the operator under supplied specifications.

パラメータ

• state_in (Union(list,numpy.array)) – A vector representing the initial state for the evolution

• evo_time (Union(complex, float)) – The evolution time

• num_time_slices (int) – The number of time slices for the expansion

• expansion_mode (str) – The mode under which the expansion is to be done. Currently support 『trotter』, which follows the expansion as discussed in http://science.sciencemag.org/content/273/5278/1073, and 『suzuki』, which corresponds to the discussion in https://arxiv.org/pdf/quant-ph/0508139.pdf

• expansion_order (int) – The order for suzuki expansion

戻り値

Return the matrix vector multiplication result.

戻り値の型

numpy.array

例外

• ValueError – Invalid arguments

• AquaError – if Operator is empty

is_empty()

Check Operator is empty or not.

戻り値

is empty?

戻り値の型

bool

property matrix

Getter of matrix.

property name

returns name

property num_qubits

number of qubits required for the operator.

戻り値

number of qubits

戻り値の型

int

print_details()

戻り値

a formatted operator.

戻り値の型

str

sub(other, copy=False)

to_opflow()

to op flow

property z2_symmetries

returns z2 symmetries