DiagMatr2

Functions for applying general two-qubit diagonal matrices, as DiagMatr2. More...

Functions
void	applyControlledDiagMatr2 (Qureg qureg, int control, int target1, int target2, DiagMatr2 matr)
void	applyDiagMatr2 (Qureg qureg, int target1, int target2, DiagMatr2 matr)
void	applyMultiControlledDiagMatr2 (Qureg qureg, int *controls, int numControls, int target1, int target2, DiagMatr2 matr)
void	applyMultiControlledDiagMatr2 (Qureg qureg, std::vector< int > controls, int target1, int target2, DiagMatr2 matr)
void	applyMultiStateControlledDiagMatr2 (Qureg qureg, int *controls, int *states, int numControls, int target1, int target2, DiagMatr2 matr)
void	applyMultiStateControlledDiagMatr2 (Qureg qureg, std::vector< int > controls, std::vector< int > states, int target1, int target2, DiagMatr2 matr)
void	multiplyDiagMatr2 (Qureg qureg, int target1, int target2, DiagMatr2 matr)

Detailed Description

Functions for applying general two-qubit diagonal matrices, as DiagMatr2.

Function Documentation

applyControlledDiagMatr2()

void applyControlledDiagMatr2	(	Qureg	qureg,
		int	control,
		int	target1,
		int	target2,
		DiagMatr2	matr )

Note

Documentation for this function or struct is under construction!

Definition at line 307 of file operations.cpp.

                                                                                                    {
 
    int targs[] = {target1, target2};
    validateAndApplyAnyCtrlAnyTargUnitaryMatrix(qureg, &control, nullptr, 1, targs, 2, matrix, __func__);
}

applyDiagMatr2()

void applyDiagMatr2	(	Qureg	qureg,
		int	target1,
		int	target2,
		DiagMatr2	matr )

Note

Documentation for this function or struct is under construction!

Definition at line 301 of file operations.cpp.

                                                                             {
 
    int targs[] = {target1, target2};
    validateAndApplyAnyCtrlAnyTargUnitaryMatrix(qureg, nullptr, nullptr, 0, targs, 2, matrix, __func__);
}

applyMultiControlledDiagMatr2() [1/2]

void applyMultiControlledDiagMatr2	(	Qureg	qureg,
		int *	controls,
		int	numControls,
		int	target1,
		int	target2,
		DiagMatr2	matr )

Note

Documentation for this function or struct is under construction!

Definition at line 313 of file operations.cpp.

                                                                                                                            {
 
    int targs[] = {target1, target2};
    validateAndApplyAnyCtrlAnyTargUnitaryMatrix(qureg, controls, nullptr, numControls, targs, 2, matrix, __func__);
}

Referenced by applyMultiControlledDiagMatr2().

applyMultiControlledDiagMatr2() [2/2]

void applyMultiControlledDiagMatr2	(	Qureg	qureg,
		std::vector< int >	controls,
		int	target1,
		int	target2,
		DiagMatr2	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 327 of file operations.cpp.

                                                                                                                {
 
    applyMultiControlledDiagMatr2(qureg, controls.data(), controls.size(), target1, target2, matr);
}

applyMultiStateControlledDiagMatr2() [1/2]

void applyMultiStateControlledDiagMatr2	(	Qureg	qureg,
		int *	controls,
		int *	states,
		int	numControls,
		int	target1,
		int	target2,
		DiagMatr2	matr )

Note

Documentation for this function or struct is under construction!

Definition at line 319 of file operations.cpp.

                                                                                                                                              {
 
    int targs[] = {target1, target2};
    validateAndApplyAnyCtrlAnyTargUnitaryMatrix(qureg, controls, states, numControls, targs, 2, matrix, __func__);
}

Referenced by applyMultiStateControlledDiagMatr2().

applyMultiStateControlledDiagMatr2() [2/2]

void applyMultiStateControlledDiagMatr2	(	Qureg	qureg,
		std::vector< int >	controls,
		std::vector< int >	states,
		int	target1,
		int	target2,
		DiagMatr2	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 332 of file operations.cpp.

                                                                                                                                         {
    validate_controlsMatchStates(controls.size(), states.size(), __func__);
 
    applyMultiStateControlledDiagMatr2(qureg, controls.data(), states.data(), controls.size(), target1, target2, matr);
}

multiplyDiagMatr2()

void multiplyDiagMatr2	(	Qureg	qureg,
		int	target1,
		int	target2,
		DiagMatr2	matr )

Note

Documentation for this function or struct is under construction!

Definition at line 292 of file operations.cpp.

                                                                                {
    validate_quregFields(qureg, __func__);
    validate_twoTargets(qureg, target1, target2, __func__);
    validate_matrixFields(matrix, __func__); // matrix can be non-unitary
 
    bool conj = false;
    localiser_statevec_anyCtrlTwoTargDiagMatr(qureg, {}, {}, target1, target2, matrix, conj);
}