FullStateDiagMatr

Functions for applying general all-qubit diagonal matrices, as FullStateDiagMatr. More...

Functions
void	applyFullStateDiagMatr (Qureg qureg, FullStateDiagMatr matrix)
void	applyFullStateDiagMatrPower (Qureg qureg, FullStateDiagMatr matrix, qcomp exponent)
void	multiplyFullStateDiagMatr (Qureg qureg, FullStateDiagMatr matrix)
void	multiplyFullStateDiagMatrPower (Qureg qureg, FullStateDiagMatr matrix, qcomp exponent)

Detailed Description

Functions for applying general all-qubit diagonal matrices, as FullStateDiagMatr.

Function Documentation

applyFullStateDiagMatr()

void applyFullStateDiagMatr	(	Qureg	qureg,
		FullStateDiagMatr	matrix )

Note

Documentation for this function or struct is under construction!

Attention

This function's input validation has not yet been unit tested, so erroneous usage may produce unexpected output. Please use with caution!

Definition at line 556 of file operations.cpp.

                                                                   {
    validate_quregFields(qureg, __func__);
    validate_matrixFields(matrix, __func__);
    validate_matrixAndQuregAreCompatible(matrix, qureg, false, __func__);
    validate_matrixIsUnitary(matrix, __func__);
 
    applyFullStateDiagMatrPower(qureg, matrix, 1); // harmlessly re-validates
}

Referenced by TEST_CASE().

applyFullStateDiagMatrPower()

void applyFullStateDiagMatrPower	(	Qureg	qureg,
		FullStateDiagMatr	matrix,
		qcomp	exponent )

Note

Documentation for this function or struct is under construction!

Attention

This function's input validation has not yet been unit tested, so erroneous usage may produce unexpected output. Please use with caution!

Definition at line 565 of file operations.cpp.

                                                                                        {
    validate_quregFields(qureg, __func__);
    validate_matrixFields(matrix, __func__);
    validate_matrixAndQuregAreCompatible(matrix, qureg, false, __func__);
    validate_matrixIsUnitary(matrix, __func__);
    validate_unitaryExponentIsReal(exponent, __func__);
    validate_matrixExpIsNonDiverging(matrix, exponent, __func__);
 
    bool onlyMultiply = false;
    (qureg.isDensityMatrix)?
        localiser_densmatr_allTargDiagMatr(qureg, matrix, exponent, onlyMultiply):
        localiser_statevec_allTargDiagMatr(qureg, matrix, exponent);
}

Referenced by applyFullStateDiagMatr(), and TEST_CASE().

multiplyFullStateDiagMatr()

void multiplyFullStateDiagMatr	(	Qureg	qureg,
		FullStateDiagMatr	matrix )

Note

Documentation for this function or struct is under construction!

Attention

This function's input validation has not yet been unit tested, so erroneous usage may produce unexpected output. Please use with caution!

Definition at line 536 of file operations.cpp.

                                                                      {
    validate_quregFields(qureg, __func__);
    validate_matrixFields(matrix, __func__);
    validate_matrixAndQuregAreCompatible(matrix, qureg, false, __func__); // matrix can be non-unitary
 
    multiplyFullStateDiagMatrPower(qureg, matrix, 1); // harmlessly re-validates
}

Referenced by TEST_CASE().

multiplyFullStateDiagMatrPower()

void multiplyFullStateDiagMatrPower	(	Qureg	qureg,
		FullStateDiagMatr	matrix,
		qcomp	exponent )

Note

Documentation for this function or struct is under construction!

Attention

This function's input validation has not yet been unit tested, so erroneous usage may produce unexpected output. Please use with caution!

Definition at line 544 of file operations.cpp.

                                                                                           {
    validate_quregFields(qureg, __func__);
    validate_matrixFields(matrix, __func__);
    validate_matrixAndQuregAreCompatible(matrix, qureg, false, __func__); // matrix can be non-unitary
    validate_matrixExpIsNonDiverging(matrix, exponent, __func__);
 
    bool onlyMultiply = true;
    (qureg.isDensityMatrix)?
        localiser_densmatr_allTargDiagMatr(qureg, matrix, exponent, onlyMultiply):
        localiser_statevec_allTargDiagMatr(qureg, matrix, exponent);
}

Referenced by multiplyFullStateDiagMatr(), and TEST_CASE().