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)

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 458 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!

See also

• applyDiagMatrPower

Definition at line 467 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__);
 
    // rho -> matrix^exponent rho conj(matrix^exponent)
    bool leftMultiply = true;
    bool rightMultiply = true;
    bool rightConj = true;
 
    (qureg.isDensityMatrix)?
        localiser_densmatr_allTargDiagMatr(qureg, matrix, exponent, leftMultiply, rightMultiply, rightConj):
        localiser_statevec_allTargDiagMatr(qureg, matrix, exponent);
}

Referenced by applyFullStateDiagMatr(), and TEST_CASE().