qrisp.inplace_matrix_app

inplace_matrix_app(vector, matrix)

Performs inplace matrix application to a vector-valued QuantumArray. Note that due to reversibility reasons, the matrix can only contain integers and has to be invertible over \(\text{GL}(2^n)\). This is equal to the condition that the determinant is odd.

Parameters

vectorQuantumArray

The QuantumArray to apply the matrix to.

matrixnumpy.ndarray

The matrix to apply.

Raises

Exception

Tried to multiply matrix with Quantum Array with unfitting shape.

Examples

We perform an inplace matrix multiplication between a randomly chosen matrix and a randomly chosen vector

>>> from qrisp import QuantumFloat, QuantumArray, inplace_matrix_app
>>> qtype = QuantumFloat(4)
>>> q_vector = QuantumArray(qtype, 3)
>>> q_vector[:] = [1,0,2]
>>> matrix = np.array([[2., 2., 1.],
                       [2., 3., 1.],
                       [3., 1., 2.]])
>>> inplace_matrix_app(q_vector, matrix)
>>> print(q_vector)
{OutcomeArray([4, 4, 7]): 1.0}