cuquantum.custatevec.expectations_on_pauli_basis¶

cuquantum.custatevec.expectations_on_pauli_basis(intptr_t handle, intptr_t sv, int sv_data_type, uint32_t n_index_bits, intptr_t expectations, pauli_ops, basis_bits, n_basis_bits, uint32_t n_pauli_op_arrays)¶

Compute expectation values for multiple multi-qubit Pauli strings.

Parameters

handle (intptr_t) – The library handle.
sv (intptr_t) – The pointer address (as Python int) to the statevector (on device).
sv_data_type (cuquantum.cudaDataType) – The data type of the statevector.
n_index_bits (uint32_t) – The number of index bits.
expectations (intptr_t) – The pointer address (as Python int) to store the corresponding expectation values on host. The returned values are stored in double (float64).
pauli_ops –

A host array of Pauli operators. It can be
- an int as the pointer address to the nested sequence
- a Python sequence of int, each of which is a pointer address to the corresponding Pauli string
- a nested Python sequence of Pauli
basis_bits –

A host array of basis index bits. It can be
- an int as the pointer address to the nested sequence
- a Python sequence of int, each of which is a pointer address to the corresponding basis bits
- a nested Python sequence of basis bits
n_basis_bits –

A host array of the length of each array in basis_bits. It can be
- an int as the pointer address to the array
- a Python sequence of int
n_pauli_op_arrays (uint32_t) – The number of Pauli operator arrays.