Pauli gadgets

Functions for applying many-qubit rotations around arbitrary PauliStr. More...

Functions
void	applyControlledPauliGadget (Qureg qureg, int control, PauliStr str, qreal angle)
void	applyMultiControlledPauliGadget (Qureg qureg, int *controls, int numControls, PauliStr str, qreal angle)
void	applyMultiStateControlledPauliGadget (Qureg qureg, int *controls, int *states, int numControls, PauliStr str, qreal angle)
void	applyPauliGadget (Qureg qureg, PauliStr str, qreal angle)
void	multiplyPauliGadget (Qureg qureg, PauliStr str, qreal angle)

Detailed Description

Functions for applying many-qubit rotations around arbitrary PauliStr.

Function Documentation

applyControlledPauliGadget()

void applyControlledPauliGadget	(	Qureg	qureg,
		int	control,
		PauliStr	str,
		qreal	angle )

Note

Documentation for this function or struct is under construction!

Definition at line 1092 of file operations.cpp.

                                                                                     {
    validate_quregFields(qureg, __func__);
    validate_controlAndPauliStrTargets(qureg, control, str, __func__);
    
    applyMultiStateControlledPauliGadget(qureg, &control, nullptr, 1, str, angle);
}

applyMultiControlledPauliGadget()

void applyMultiControlledPauliGadget	(	Qureg	qureg,
		int *	controls,
		int	numControls,
		PauliStr	str,
		qreal	angle )

Note

Documentation for this function or struct is under construction!

Definition at line 1099 of file operations.cpp.

                                                                                                             {
    validate_quregFields(qureg, __func__);
    validate_controlsAndPauliStrTargets(qureg, controls, numControls, str, __func__);
    
    applyMultiStateControlledPauliGadget(qureg, controls, nullptr, numControls, str, angle);
}

applyMultiStateControlledPauliGadget()

void applyMultiStateControlledPauliGadget	(	Qureg	qureg,
		int *	controls,
		int *	states,
		int	numControls,
		PauliStr	str,
		qreal	angle )

Note

Documentation for this function or struct is under construction!

Definition at line 1106 of file operations.cpp.

                                                                                                                               {
    validate_quregFields(qureg, __func__);
    validate_controlsAndPauliStrTargets(qureg, controls, numControls, str, __func__);
    validate_controlStates(states, numControls, __func__); // permits states==nullptr
 
    /// @todo
    /// CRUCIAL NOTE:
    /// exp(theta I..I) might be algorithmically ok (I'm not sure), but it WILL NOT
    /// effect a global phase change of theta (I think). Should validate against this
    /// sitaution just in case, or make the doc extremely explicit
 
    qreal phase = util_getPhaseFromGateAngle(angle);
    auto ctrlVec = util_getVector(controls, numControls);
    auto stateVec = util_getVector(states, numControls); // empty if states==nullptr
    localiser_statevec_anyCtrlPauliGadget(qureg, ctrlVec, stateVec, str, phase);
 
    if (!qureg.isDensityMatrix)
        return;
 
    // conj(e^iXZ) = e^(-iXZ), but conj(Y)=-Y, so odd-Y undoes phase negation
    phase *= paulis_hasOddNumY(str) ? 1 : -1;
    ctrlVec = util_getBraQubits(ctrlVec, qureg);
    str = paulis_getShiftedPauliStr(str, qureg.numQubits);
    localiser_statevec_anyCtrlPauliGadget(qureg, ctrlVec, stateVec, str, phase);
}

Referenced by applyControlledPauliGadget(), applyMultiControlledPauliGadget(), applyMultiStateControlledRotateX(), applyMultiStateControlledRotateY(), applyMultiStateControlledRotateZ(), and applyPauliGadget().

applyPauliGadget()

void applyPauliGadget	(	Qureg	qureg,
		PauliStr	str,
		qreal	angle )

Note

Documentation for this function or struct is under construction!

Definition at line 1085 of file operations.cpp.

                                                              {
    validate_quregFields(qureg, __func__);
    validate_pauliStrTargets(qureg, str, __func__);
    
    applyMultiStateControlledPauliGadget(qureg, nullptr, nullptr, 0, str, angle);
}

multiplyPauliGadget()

void multiplyPauliGadget	(	Qureg	qureg,
		PauliStr	str,
		qreal	angle )

Note

Documentation for this function or struct is under construction!

Definition at line 1077 of file operations.cpp.

                                                                 {
    validate_quregFields(qureg, __func__);
    validate_pauliStrTargets(qureg, str, __func__);
 
    qreal phase = util_getPhaseFromGateAngle(angle);
    localiser_statevec_anyCtrlPauliGadget(qureg, {}, {}, str, phase);
}