CompMatr

Functions for applying general many-target dense matrices, as CompMatr. More...

Functions
void	applyCompMatr (Qureg qureg, int *targets, int numTargets, CompMatr matrix)
void	applyControlledCompMatr (Qureg qureg, int control, int *targets, int numTargets, CompMatr matrix)
void	applyMultiControlledCompMatr (Qureg qureg, int *controls, int numControls, int *targets, int numTargets, CompMatr matrix)
void	applyMultiStateControlledCompMatr (Qureg qureg, int *controls, int *states, int numControls, int *targets, int numTargets, CompMatr matrix)

Detailed Description

Functions for applying general many-target dense matrices, as CompMatr.

Function Documentation

applyCompMatr()

void applyCompMatr	(	Qureg	qureg,
		int *	targets,
		int	numTargets,
		CompMatr	matrix )

Note

Documentation for this function or struct is under construction!

Applies an arbitrarily-sized dense unitary matrix to the targets (treated as increasing significance) of qureg.

Formulae

Let \( M = \) matrix. The qubits within targets are treated to be ordered least to most significant with respect to \( M \). That is, if \( M \) was hypothetically separable single-qubit matrices

\[ M \equiv \dots \otimes C \otimes B \otimes A \]

then this function would effect

\[ \hat{M}_{\text{targets}} \equiv A_{\text{targets}[0]} \cdot B_{\text{targets}[1]} \cdot C_{\text{targets}[2]} \cdot \dots \]

Remarks

This function is sometimes more efficient when targets are specified in increasing order.

See also

• applyCompMatr1()
• leftapplyCompMatr()
• rightapplyCompMatr()

Author

Tyson Jones

Definition at line 161 of file operations.cpp.

                                                                               {
 
    validateAndApplyAnyCtrlAnyTargUnitaryMatrix(qureg, nullptr, nullptr, 0, targets, numTargets, matrix, __func__);
}

Referenced by applyCompMatr().

applyControlledCompMatr()

void applyControlledCompMatr	(	Qureg	qureg,
		int	control,
		int *	targets,
		int	numTargets,
		CompMatr	matrix )

Note

Documentation for this function or struct is under construction!

Applies a singly-controlled arbitrarily-sized dense unitary matrix to the targets (treated as increasing significance) of qureg.

‍- See applyCompMatr() for information about targets and matrix.

• See applyControlledCompMatr1() for information about the control qubit.

Author

Tyson Jones

Definition at line 166 of file operations.cpp.

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

Referenced by applyControlledCompMatr().

applyMultiControlledCompMatr()

void applyMultiControlledCompMatr	(	Qureg	qureg,
		int *	controls,
		int	numControls,
		int *	targets,
		int	numTargets,
		CompMatr	matrix )

Note

Documentation for this function or struct is under construction!

Applies a multiply-controlled arbitrarily-sized dense unitary matrix upon the targets of qureg.

‍- See applyCompMatr() for information about targets and matrix.

• See applyMultiControlledCompMatr1() for information about controls.

Author

Tyson Jones

Definition at line 171 of file operations.cpp.

                                                                                                                              {
 
    validateAndApplyAnyCtrlAnyTargUnitaryMatrix(qureg, controls, nullptr, numControls, targets, numTargets, matrix, __func__);
}

Referenced by applyMultiControlledCompMatr().

applyMultiStateControlledCompMatr()

void applyMultiStateControlledCompMatr	(	Qureg	qureg,
		int *	controls,
		int *	states,
		int	numControls,
		int *	targets,
		int	numTargets,
		CompMatr	matrix )

Note

Documentation for this function or struct is under construction!

Applies an arbitrarily-controlled arbitrarily-sized dense unitary matrix upon the targets of qureg, conditioned upon the controls being in the corresponding states.

‍- See applyCompMatr() for information about targets and matrix.

• See applyMultiStateControlledCompMatr1() for information about controls and states.

Author

Tyson Jones

Definition at line 176 of file operations.cpp.

                                                                                                                                                {
 
    validateAndApplyAnyCtrlAnyTargUnitaryMatrix(qureg, controls, states, numControls, targets, numTargets, matrix, __func__);
}

Referenced by applyMultiStateControlledCompMatr().