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 tested, so erroneous usage may produce unexpected output. Please use with caution!

Definition at line 412 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 tested, so erroneous usage may produce unexpected output. Please use with caution!

Definition at line 421 of file operations.cpp.

                                                                                        {
    validate_quregFields(qureg, __func__);
    validate_matrixFields(matrix, __func__);
    validate_matrixAndQuregAreCompatible(matrix, qureg, false, __func__);
    validate_matrixIsUnitary(matrix, __func__);  // checks abs=1 (so no risk of 0^(-neg exp))
    validate_unitaryExponentIsReal(exponent, __func__); // checks matrix^exponent is approx unitary (abs=1)
    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 tested, so erroneous usage may produce unexpected output. Please use with caution!

Definition at line 392 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 tested, so erroneous usage may produce unexpected output. Please use with caution!

Definition at line 400 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().