FullStateDiagMatr

Functions for pre- or post-multiplying general full-state diagonal matrices (FullStateDiagMatr), or powers thereof, upon density matrices. More...

Functions
void	leftapplyFullStateDiagMatr (Qureg qureg, FullStateDiagMatr matrix)
void	leftapplyFullStateDiagMatrPower (Qureg qureg, FullStateDiagMatr matrix, qcomp exponent)
void	rightapplyFullStateDiagMatr (Qureg qureg, FullStateDiagMatr matrix)
void	rightapplyFullStateDiagMatrPower (Qureg qureg, FullStateDiagMatr matrix, qcomp exponent)

Detailed Description

Functions for pre- or post-multiplying general full-state diagonal matrices (FullStateDiagMatr), or powers thereof, upon density matrices.

Function Documentation

leftapplyFullStateDiagMatr()

void leftapplyFullStateDiagMatr	(	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!

See also

• leftapplyCompMatr1()

Definition at line 301 of file multiplication.cpp.

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

Referenced by TEST_CASE().

leftapplyFullStateDiagMatrPower()

void leftapplyFullStateDiagMatrPower	(	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

• leftapplyCompMatr1()
• applyFullStateDiagMatr()

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

Referenced by leftapplyFullStateDiagMatr(), and TEST_CASE().

rightapplyFullStateDiagMatr()

void rightapplyFullStateDiagMatr	(	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!

See also

• rightapplyCompMatr1()
• applyFullStateDiagMatr()

Definition at line 325 of file multiplication.cpp.

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

Referenced by TEST_CASE().

rightapplyFullStateDiagMatrPower()

void rightapplyFullStateDiagMatrPower	(	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

• rightapplyCompMatr1()
• applyFullStateDiagMatr()

Definition at line 334 of file multiplication.cpp.

                                                                                             {
    validate_quregFields(qureg, __func__);
    validate_quregIsDensityMatrix(qureg, __func__);
    validate_matrixFields(matrix, __func__);
    validate_matrixAndQuregAreCompatible(matrix, qureg, false, __func__); // matrix can be non-unitary
    validate_matrixExpIsNonDiverging(matrix, exponent, __func__);
 
    // rho -> rho matrix^exponent
    bool leftMultiply = false;
    bool rightMultiply = true;
    bool rightConj = false;
    localiser_densmatr_allTargDiagMatr(qureg, matrix, exponent, leftMultiply, rightMultiply, rightConj);
}

Referenced by rightapplyFullStateDiagMatr(), and TEST_CASE().