DiagMatr

Functions for pre- or post-multiplying general any-target diagonal matrices (as DiagMatr), or powers thereof, upon density matrices. More...

Functions
void	leftapplyDiagMatr (Qureg qureg, int *targets, int numTargets, DiagMatr matrix)
void	leftapplyDiagMatrPower (Qureg qureg, int *targets, int numTargets, DiagMatr matrix, qcomp exponent)
void	rightapplyDiagMatr (Qureg qureg, int *targets, int numTargets, DiagMatr matrix)
void	rightapplyDiagMatrPower (Qureg qureg, int *targets, int numTargets, DiagMatr matrix, qcomp exponent)

Detailed Description

Functions for pre- or post-multiplying general any-target diagonal matrices (as DiagMatr), or powers thereof, upon density matrices.

Function Documentation

leftapplyDiagMatr()

void leftapplyDiagMatr	(	Qureg	qureg,
		int *	targets,
		int	numTargets,
		DiagMatr	matrix )

Note

Documentation for this function or struct is under construction!

See also

leftapplyCompMatr1()

Definition at line 206 of file multiplication.cpp.

                                                                                   {
    validate_quregFields(qureg, __func__);
    validate_targets(qureg, targets, numTargets, __func__);
    validate_matrixDimMatchesTargets(matrix, numTargets, __func__); // also validates fields and is-sync
 
    bool conj = false;
    qcomp exponent = 1;
    auto qubits = util_getVector(targets, numTargets);
    localiser_statevec_anyCtrlAnyTargDiagMatr(qureg, {}, {}, qubits, matrix, exponent, conj);
}

Referenced by leftapplyDiagMatr().

leftapplyDiagMatrPower()

void leftapplyDiagMatrPower	(	Qureg	qureg,
		int *	targets,
		int	numTargets,
		DiagMatr	matrix,
		qcomp	exponent )

Note

Documentation for this function or struct is under construction!

See also

• leftapplyCompMatr1()
• applyDiagMatrPower()

Definition at line 249 of file multiplication.cpp.

                                                                                                        {
    validate_quregFields(qureg, __func__);
    validate_targets(qureg, targets, numTargets, __func__);
    validate_matrixDimMatchesTargets(matrix, numTargets, __func__); // also validates fields and is-sync, but not unitarity
    validate_matrixExpIsNonDiverging(matrix, exponent, __func__); // harmlessly re-validates fields and is-sync
 
    bool conj = false;
    auto qubits = util_getVector(targets, numTargets);
    localiser_statevec_anyCtrlAnyTargDiagMatr(qureg, {}, {}, qubits, matrix, exponent, conj);
}

Referenced by leftapplyDiagMatrPower().

rightapplyDiagMatr()

void rightapplyDiagMatr	(	Qureg	qureg,
		int *	targets,
		int	numTargets,
		DiagMatr	matrix )

Note

Documentation for this function or struct is under construction!

See also

rightapplyCompMatr1()

Definition at line 217 of file multiplication.cpp.

                                                                                    {
    validate_quregFields(qureg, __func__);
    validate_quregIsDensityMatrix(qureg, __func__);
    validate_targets(qureg, targets, numTargets, __func__);
    validate_matrixDimMatchesTargets(matrix, numTargets, __func__); // also validates fields and is-sync
 
    bool conj = false;
    qcomp exponent = 1;
    auto qubits = util_getBraQubits(util_getVector(targets, numTargets), qureg);
    localiser_statevec_anyCtrlAnyTargDiagMatr(qureg, {}, {}, qubits, matrix, exponent, conj);
}

Referenced by rightapplyDiagMatr().

rightapplyDiagMatrPower()

void rightapplyDiagMatrPower	(	Qureg	qureg,
		int *	targets,
		int	numTargets,
		DiagMatr	matrix,
		qcomp	exponent )

Note

Documentation for this function or struct is under construction!

See also

• rightapplyCompMatr1()
• applyDiagMatrPower()

Definition at line 260 of file multiplication.cpp.

                                                                                                         {
    validate_quregFields(qureg, __func__);
    validate_quregIsDensityMatrix(qureg, __func__);
    validate_targets(qureg, targets, numTargets, __func__);
    validate_matrixDimMatchesTargets(matrix, numTargets, __func__); // also validates fields and is-sync, but not unitarity
    validate_matrixExpIsNonDiverging(matrix, exponent, __func__); // harmlessly re-validates fields and is-sync
 
    bool conj = false;
    auto qubits = util_getBraQubits(util_getVector(targets, numTargets), qureg);
    localiser_statevec_anyCtrlAnyTargDiagMatr(qureg, {}, {}, qubits, matrix, exponent, conj);
}

Referenced by rightapplyDiagMatrPower().