Functions for applying many-qubit rotations around Pauli Z axis, and phase flips and shifts. More...

Functions
void	applyControlledPhaseGadget (Qureg qureg, int control, int *targets, int numTargets, qreal angle)

void	applyMultiControlledPhaseGadget (Qureg qureg, int controls, int numControls, int targets, int numTargets, qreal angle)

void	applyMultiQubitPhaseFlip (Qureg qureg, int *targets, int numTargets)

void	applyMultiQubitPhaseShift (Qureg qureg, int *targets, int numTargets, qreal angle)

void	applyMultiStateControlledPhaseGadget (Qureg qureg, int controls, int states, int numControls, int *targets, int numTargets, qreal angle)

void	applyPhaseFlip (Qureg qureg, int target)

void	applyPhaseGadget (Qureg qureg, int *targets, int numTargets, qreal angle)

void	applyPhaseShift (Qureg qureg, int target, qreal angle)

void	applyTwoQubitPhaseFlip (Qureg qureg, int target1, int target2)

void	applyTwoQubitPhaseShift (Qureg qureg, int target1, int target2, qreal angle)

void	multiplyPhaseGadget (Qureg qureg, int *targets, int numTargets, qreal angle)

Detailed Description

Functions for applying many-qubit rotations around Pauli Z axis, and phase flips and shifts.

Function Documentation

◆ applyControlledPhaseGadget()

void applyControlledPhaseGadget	(	Qureg	qureg,
		int	control,
		int *	targets,
		int	numTargets,
		qreal	angle )

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

Definition at line 1154 of file operations.cpp.

                                                                                                     {
    validate_quregFields(qureg, __func__);
    validate_controlAndTargets(qureg, control, targets, numTargets, __func__);
 
    // harmlessly re-validates
    applyMultiStateControlledPhaseGadget(qureg, &control, nullptr, 1, targets, numTargets, angle);
}

◆ applyMultiControlledPhaseGadget()

void applyMultiControlledPhaseGadget	(	Qureg	qureg,
		int *	controls,
		int	numControls,
		int *	targets,
		int	numTargets,
		qreal	angle )

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

Definition at line 1162 of file operations.cpp.

                                                                                                                             {
    validate_quregFields(qureg, __func__);
    validate_controlsAndTargets(qureg, controls, numControls, targets, numTargets, __func__);
 
    // harmlessly re-validates
    applyMultiStateControlledPhaseGadget(qureg, controls, nullptr, numControls, targets, numTargets, angle);
}

◆ applyMultiQubitPhaseFlip()

void applyMultiQubitPhaseFlip	(	Qureg	qureg,
		int *	targets,
		int	numTargets )

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

Definition at line 1247 of file operations.cpp.

                                                                         {
    validate_quregFields(qureg, __func__);
    validate_targets(qureg, targets, numTargets, __func__);
 
    // treat as a (numTargets-1)-controlled 1-target Pauli Z
    DiagMatr1 matr = getDiagMatr1({1, -1});
 
    // harmlessly re-validates
    applyMultiStateControlledDiagMatr1(qureg, &targets[1], nullptr, numTargets-1, targets[0], matr);
}

Referenced by applyPhaseFlip(), and applyTwoQubitPhaseFlip().

◆ applyMultiQubitPhaseShift()

void applyMultiQubitPhaseShift	(	Qureg	qureg,
		int *	targets,
		int	numTargets,
		qreal	angle )

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

Definition at line 1213 of file operations.cpp.

                                                                                       {
    validate_quregFields(qureg, __func__);
    validate_targets(qureg, targets, numTargets, __func__);
 
    // treat as a (numTargets-1)-controlled 1-target diagonal matrix
    DiagMatr1 matr = getDiagMatr1({1, std::exp(1_i * angle)});
 
    // harmlessly re-validates
    applyMultiStateControlledDiagMatr1(qureg, &targets[1], nullptr, numTargets-1, targets[0], matr);
}

Referenced by applyPhaseShift(), and applyTwoQubitPhaseShift().

◆ applyMultiStateControlledPhaseGadget()

void applyMultiStateControlledPhaseGadget	(	Qureg	qureg,
		int *	controls,
		int *	states,
		int	numControls,
		int *	targets,
		int	numTargets,
		qreal	angle )

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

Definition at line 1170 of file operations.cpp.

                                                                                                                                               {
    validate_quregFields(qureg, __func__);
    validate_controlsAndTargets(qureg, controls, numControls, targets, numTargets, __func__);
    validate_controlStates(states, numControls, __func__);
 
    qreal phase = util_getPhaseFromGateAngle(angle);
    auto ctrlVec = util_getVector(controls, numControls);
    auto targVec = util_getVector(targets,  numTargets);
    auto stateVec = util_getVector(states,  numControls); // empty if states==nullptr
    localiser_statevec_anyCtrlPhaseGadget(qureg, ctrlVec, stateVec, targVec, phase);
 
    if (!qureg.isDensityMatrix)
        return;
 
    phase *= -1;
    ctrlVec = util_getBraQubits(ctrlVec, qureg);
    targVec = util_getBraQubits(targVec, qureg);
    localiser_statevec_anyCtrlPhaseGadget(qureg, ctrlVec, stateVec, targVec, phase);
}

Referenced by applyControlledPhaseGadget(), applyMultiControlledPhaseGadget(), and applyPhaseGadget().

◆ applyPhaseFlip()

void applyPhaseFlip	(	Qureg	qureg,
		int	target )

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

Definition at line 1230 of file operations.cpp.

                                             {
    validate_quregFields(qureg, __func__);
    validate_target(qureg, target, __func__);
 
    // harmlessly re-validates
    applyMultiQubitPhaseFlip(qureg, &target, 1);
}

◆ applyPhaseGadget()

void applyPhaseGadget	(	Qureg	qureg,
		int *	targets,
		int	numTargets,
		qreal	angle )

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

Definition at line 1146 of file operations.cpp.

                                                                              {
    validate_quregFields(qureg, __func__);
    validate_targets(qureg, targets, numTargets, __func__);
 
    // harmlessly re-validates
    applyMultiStateControlledPhaseGadget(qureg, nullptr, nullptr, 0, targets, numTargets, angle);
}

◆ applyPhaseShift()

void applyPhaseShift	(	Qureg	qureg,
		int	target,
		qreal	angle )

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

Definition at line 1196 of file operations.cpp.

                                                           {
    validate_quregFields(qureg, __func__);
    validate_target(qureg, target, __func__);
 
    // harmlessly re-validates
    applyMultiQubitPhaseShift(qureg, &target, 1, angle);
}

◆ applyTwoQubitPhaseFlip()

void applyTwoQubitPhaseFlip	(	Qureg	qureg,
		int	target1,
		int	target2 )

Applies a two-qubit phase flip upon qubit1 and qubit2 of qureg.

Diagram: This browser is not able to show SVG: try Firefox, Chrome, Safari, or Opera instead.

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

Definition at line 1238 of file operations.cpp.

                                                                   {
    validate_quregFields(qureg, __func__);
    validate_twoTargets(qureg, target1, target2, __func__);
 
    // harmlessly re-validates
    int targets[] = {target1, target2};
    applyMultiQubitPhaseFlip(qureg, targets, 2);
}

◆ applyTwoQubitPhaseShift()

void applyTwoQubitPhaseShift	(	Qureg	qureg,
		int	target1,
		int	target2,
		qreal	angle )

Applies a two-qubit phase flip upon qubit1 and qubit2 of qureg.

Diagram: This browser is not able to show SVG: try Firefox, Chrome, Safari, or Opera instead.

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

Definition at line 1204 of file operations.cpp.

                                                                                 {
    validate_quregFields(qureg, __func__);
    validate_twoTargets(qureg, target1, target2, __func__);
 
    // harmlessly re-validates
    int targets[] = {target1, target2};
    applyMultiQubitPhaseShift(qureg, targets, 2, angle);
}

Referenced by applyQuantumFourierTransform().

◆ multiplyPhaseGadget()

void multiplyPhaseGadget	(	Qureg	qureg,
		int *	targets,
		int	numTargets,
		qreal	angle )

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

Definition at line 1138 of file operations.cpp.

                                                                                 {
    validate_quregFields(qureg, __func__);
    validate_targets(qureg, targets, numTargets, __func__);
 
    qreal phase = util_getPhaseFromGateAngle(angle);
    localiser_statevec_anyCtrlPhaseGadget(qureg, {}, {}, util_getVector(targets,numTargets), phase);
}