Functions for applying general one-qubit diagonal matrices, as DiagMatr1. More...

Functions
void	applyControlledDiagMatr1 (Qureg qureg, int control, int target, DiagMatr1 matr)

void	applyDiagMatr1 (Qureg qureg, int target, DiagMatr1 matr)

void	applyMultiControlledDiagMatr1 (Qureg qureg, int *controls, int numControls, int target, DiagMatr1 matr)

void	applyMultiControlledDiagMatr1 (Qureg qureg, std::vector< int > controls, int target, DiagMatr1 matr)

void	applyMultiStateControlledDiagMatr1 (Qureg qureg, int controls, int states, int numControls, int target, DiagMatr1 matr)

void	applyMultiStateControlledDiagMatr1 (Qureg qureg, std::vector< int > controls, std::vector< int > states, int target, DiagMatr1 matr)

void	multiplyDiagMatr1 (Qureg qureg, int target, DiagMatr1 matr)

Detailed Description

Functions for applying general one-qubit diagonal matrices, as DiagMatr1.

Function Documentation

◆ applyControlledDiagMatr1()

void applyControlledDiagMatr1	(	Qureg	qureg,
		int	control,
		int	target,
		DiagMatr1	matr )

Note: Documentation for this function or struct is under construction!

Definition at line 256 of file operations.cpp.

                                                                                      {
 
    validateAndApplyAnyCtrlAnyTargUnitaryMatrix(qureg, &control, nullptr, 1, &target, 1, matrix, __func__);
}

◆ applyDiagMatr1()

void applyDiagMatr1	(	Qureg	qureg,
		int	target,
		DiagMatr1	matr )

Note: Documentation for this function or struct is under construction!

Definition at line 251 of file operations.cpp.

                                                               {
 
    validateAndApplyAnyCtrlAnyTargUnitaryMatrix(qureg, nullptr, nullptr, 0, &target, 1, matrix, __func__);
}

◆ applyMultiControlledDiagMatr1() [1/2]

void applyMultiControlledDiagMatr1	(	Qureg	qureg,
		int *	controls,
		int	numControls,
		int	target,
		DiagMatr1	matr )

Note: Documentation for this function or struct is under construction!

Definition at line 261 of file operations.cpp.

                                                                                                              {
 
    validateAndApplyAnyCtrlAnyTargUnitaryMatrix(qureg, controls, nullptr, numControls, &target, 1, matrix, __func__);
}

Referenced by applyMultiControlledDiagMatr1().

◆ applyMultiControlledDiagMatr1() [2/2]

void applyMultiControlledDiagMatr1	(	Qureg	qureg,
		std::vector< int >	controls,
		int	target,
		DiagMatr1	matr )

Warning: This function has not yet been unit tested and may contain bugs. Please use with caution!

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

Note: Documentation for this function or struct is under construction!

Remarks: This function is only available in C++.

Definition at line 273 of file operations.cpp.

                                                                                                  {
 
    applyMultiControlledDiagMatr1(qureg, controls.data(), controls.size(), target, matr);
}

◆ applyMultiStateControlledDiagMatr1() [1/2]

void applyMultiStateControlledDiagMatr1	(	Qureg	qureg,
		int *	controls,
		int *	states,
		int	numControls,
		int	target,
		DiagMatr1	matr )

Note: Documentation for this function or struct is under construction!

Definition at line 266 of file operations.cpp.

                                                                                                                                {
 
    validateAndApplyAnyCtrlAnyTargUnitaryMatrix(qureg, controls, states, numControls, &target, 1, matrix, __func__);
}

Referenced by applyMultiQubitPhaseFlip(), applyMultiQubitPhaseShift(), applyMultiStateControlledDiagMatr1(), and applyMultiStateControlledPauliZ().

◆ applyMultiStateControlledDiagMatr1() [2/2]

void applyMultiStateControlledDiagMatr1	(	Qureg	qureg,
		std::vector< int >	controls,
		std::vector< int >	states,
		int	target,
		DiagMatr1	matr )

Warning: This function has not yet been unit tested and may contain bugs. Please use with caution!

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

Note: Documentation for this function or struct is under construction!

Remarks: This function is only available in C++.

Definition at line 278 of file operations.cpp.

                                                                                                                           {
    validate_controlsMatchStates(controls.size(), states.size(), __func__);
 
    applyMultiStateControlledDiagMatr1(qureg, controls.data(), states.data(), controls.size(), target, matr);
}

◆ multiplyDiagMatr1()

void multiplyDiagMatr1	(	Qureg	qureg,
		int	target,
		DiagMatr1	matr )

Note: Documentation for this function or struct is under construction!

Definition at line 242 of file operations.cpp.

                                                                  {
    validate_quregFields(qureg, __func__);
    validate_target(qureg, target, __func__);
    validate_matrixFields(matrix, __func__); // matrix can be non-unitary
 
    bool conj = false;
    localiser_statevec_anyCtrlOneTargDiagMatr(qureg, {}, {}, target, matrix, conj);
}