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