Rotations

Functions for applying one-qubit rotations around Pauli and arbitrary axis. More...

Functions
void	applyControlledRotateAroundAxis (Qureg qureg, int ctrl, int targ, qreal angle, qreal axisX, qreal axisY, qreal axisZ)
void	applyControlledRotateX (Qureg qureg, int control, int target, qreal angle)
void	applyControlledRotateY (Qureg qureg, int control, int target, qreal angle)
void	applyControlledRotateZ (Qureg qureg, int control, int target, qreal angle)
void	applyMultiControlledRotateAroundAxis (Qureg qureg, int *ctrls, int numCtrls, int targ, qreal angle, qreal axisX, qreal axisY, qreal axisZ)
void	applyMultiControlledRotateX (Qureg qureg, int *controls, int numControls, int target, qreal angle)
void	applyMultiControlledRotateY (Qureg qureg, int *controls, int numControls, int target, qreal angle)
void	applyMultiControlledRotateZ (Qureg qureg, int *controls, int numControls, int target, qreal angle)
void	applyMultiStateControlledRotateAroundAxis (Qureg qureg, int *ctrls, int *states, int numCtrls, int targ, qreal angle, qreal axisX, qreal axisY, qreal axisZ)
void	applyMultiStateControlledRotateX (Qureg qureg, int *controls, int *states, int numControls, int target, qreal angle)
void	applyMultiStateControlledRotateY (Qureg qureg, int *controls, int *states, int numControls, int target, qreal angle)
void	applyMultiStateControlledRotateZ (Qureg qureg, int *controls, int *states, int numControls, int target, qreal angle)
void	applyRotateAroundAxis (Qureg qureg, int targ, qreal angle, qreal axisX, qreal axisY, qreal axisZ)
void	applyRotateX (Qureg qureg, int target, qreal angle)
void	applyRotateY (Qureg qureg, int target, qreal angle)
void	applyRotateZ (Qureg qureg, int target, qreal angle)

Detailed Description

Functions for applying one-qubit rotations around Pauli and arbitrary axis.

Function Documentation

applyControlledRotateAroundAxis()

void applyControlledRotateAroundAxis	(	Qureg	qureg,
		int	ctrl,
		int	targ,
		qreal	angle,
		qreal	axisX,
		qreal	axisY,
		qreal	axisZ )

Note

Documentation for this function or struct is under construction!

Definition at line 1033 of file operations.cpp.

                                                                                                                          {
    validate_quregFields(qureg, __func__);
    validate_controlAndTarget(qureg, ctrl, targ, __func__);
    validate_rotationAxisNotZeroVector(axisX, axisY, axisZ, __func__);
 
    applyMultiStateControlledRotateAroundAxis(qureg, &ctrl, nullptr, 1, targ, angle, axisX, axisY, axisZ);
}

applyControlledRotateX()

void applyControlledRotateX	(	Qureg	qureg,
		int	control,
		int	target,
		qreal	angle )

Note

Documentation for this function or struct is under construction!

Definition at line 944 of file operations.cpp.

                                                                               {
    validate_quregFields(qureg, __func__);
    validate_controlAndTarget(qureg, control, target, __func__);
 
    // harmlessly re-validates
    applyMultiStateControlledRotateX(qureg, &control, nullptr, 1, target, angle);
}

applyControlledRotateY()

void applyControlledRotateY	(	Qureg	qureg,
		int	control,
		int	target,
		qreal	angle )

Note

Documentation for this function or struct is under construction!

Definition at line 952 of file operations.cpp.

                                                                               {
    validate_quregFields(qureg, __func__);
    validate_controlAndTarget(qureg, control, target, __func__);
 
    // harmlessly re-validates
    applyMultiStateControlledRotateY(qureg, &control, nullptr, 1, target, angle);
}

applyControlledRotateZ()

void applyControlledRotateZ	(	Qureg	qureg,
		int	control,
		int	target,
		qreal	angle )

Note

Documentation for this function or struct is under construction!

Definition at line 960 of file operations.cpp.

                                                                               {
    validate_quregFields(qureg, __func__);
    validate_controlAndTarget(qureg, control, target, __func__);
 
    // harmlessly re-validates
    applyMultiStateControlledRotateZ(qureg, &control, nullptr, 1, target, angle);
}

applyMultiControlledRotateAroundAxis()

void applyMultiControlledRotateAroundAxis	(	Qureg	qureg,
		int *	ctrls,
		int	numCtrls,
		int	targ,
		qreal	angle,
		qreal	axisX,
		qreal	axisY,
		qreal	axisZ )

Note

Documentation for this function or struct is under construction!

Definition at line 1041 of file operations.cpp.

                                                                                                                                               {
    validate_quregFields(qureg, __func__);
    validate_controlsAndTarget(qureg, ctrls, numCtrls, targ, __func__);
    validate_rotationAxisNotZeroVector(axisX, axisY, axisZ, __func__);
 
    applyMultiStateControlledRotateAroundAxis(qureg, ctrls, nullptr, numCtrls, targ, angle, axisX, axisY, axisZ);
}

applyMultiControlledRotateX()

void applyMultiControlledRotateX	(	Qureg	qureg,
		int *	controls,
		int	numControls,
		int	target,
		qreal	angle )

Note

Documentation for this function or struct is under construction!

Definition at line 968 of file operations.cpp.

                                                                                                       {
    validate_quregFields(qureg, __func__);
    validate_controlsAndTarget(qureg, controls, numControls, target, __func__);
 
    // harmlessly re-validates
    applyMultiStateControlledRotateX(qureg, controls, nullptr, numControls, target, angle);
}

applyMultiControlledRotateY()

void applyMultiControlledRotateY	(	Qureg	qureg,
		int *	controls,
		int	numControls,
		int	target,
		qreal	angle )

Note

Documentation for this function or struct is under construction!

Definition at line 976 of file operations.cpp.

                                                                                                       {
    validate_quregFields(qureg, __func__);
    validate_controlsAndTarget(qureg, controls, numControls, target, __func__);
 
    // harmlessly re-validates
    applyMultiStateControlledRotateY(qureg, controls, nullptr, numControls, target, angle);
}

applyMultiControlledRotateZ()

void applyMultiControlledRotateZ	(	Qureg	qureg,
		int *	controls,
		int	numControls,
		int	target,
		qreal	angle )

Note

Documentation for this function or struct is under construction!

Definition at line 984 of file operations.cpp.

                                                                                                       {
    validate_quregFields(qureg, __func__);
    validate_controlsAndTarget(qureg, controls, numControls, target, __func__);
 
    // harmlessly re-validates
    applyMultiStateControlledRotateZ(qureg, controls, nullptr, numControls, target, angle);
}

applyMultiStateControlledRotateAroundAxis()

void applyMultiStateControlledRotateAroundAxis	(	Qureg	qureg,
		int *	ctrls,
		int *	states,
		int	numCtrls,
		int	targ,
		qreal	angle,
		qreal	axisX,
		qreal	axisY,
		qreal	axisZ )

Note

Documentation for this function or struct is under construction!

Definition at line 1049 of file operations.cpp.

                                                                                                                                                                 {
    validate_quregFields(qureg, __func__);
    validate_controlsAndTarget(qureg, ctrls, numCtrls, targ, __func__);
    validate_controlStates(states, numCtrls, __func__); // permits states==nullptr
    validate_rotationAxisNotZeroVector(axisX, axisY, axisZ, __func__);
 
    // defer division of vector norm to improve numerical accuracy
    qreal norm = std::sqrt(std::pow(axisX,2) + std::pow(axisY,2) + std::pow(axisZ,2)); // != 0
 
    // treat as generic 1-qubit matrix
    qreal c = std::cos(angle/2);
    qreal s = std::sin(angle/2);
    qcomp u11 = c - (s * axisZ * 1_i) / norm;
    qcomp u12 =   - (s * (axisY + axisX * 1_i)) / norm;
    qcomp u21 =     (s * (axisY - axisX * 1_i)) / norm;
    qcomp u22 = c + (s * axisZ * 1_i) / norm;
    auto matr = getCompMatr1({{u11,u12},{u21,u22}});
 
    // harmlessly re-validates, and checks unitarity of matr
    applyMultiStateControlledCompMatr1(qureg, ctrls, states, numCtrls, targ, matr);
}

Referenced by applyControlledRotateAroundAxis(), applyMultiControlledRotateAroundAxis(), and applyRotateAroundAxis().

applyMultiStateControlledRotateX()

void applyMultiStateControlledRotateX	(	Qureg	qureg,
		int *	controls,
		int *	states,
		int	numControls,
		int	target,
		qreal	angle )

Note

Documentation for this function or struct is under construction!

Definition at line 992 of file operations.cpp.

                                                                                                                         {
    validate_quregFields(qureg, __func__);
    validate_controlsAndTarget(qureg, controls, numControls, target, __func__);
    validate_controlStates(states, numControls, __func__); // permits states==nullptr
 
    // harmlessly re-validates
    applyMultiStateControlledPauliGadget(qureg, controls, states, numControls, getPauliStr("X", {target}), angle);
}

Referenced by applyControlledRotateX(), applyMultiControlledRotateX(), and applyRotateX().

applyMultiStateControlledRotateY()

void applyMultiStateControlledRotateY	(	Qureg	qureg,
		int *	controls,
		int *	states,
		int	numControls,
		int	target,
		qreal	angle )

Note

Documentation for this function or struct is under construction!

Definition at line 1001 of file operations.cpp.

                                                                                                                         {
    validate_quregFields(qureg, __func__);
    validate_controlsAndTarget(qureg, controls, numControls, target, __func__);
    validate_controlStates(states, numControls, __func__); // permits states==nullptr
 
    // harmlessly re-validates
    applyMultiStateControlledPauliGadget(qureg, controls, states, numControls, getPauliStr("Y", {target}), angle);
}

Referenced by applyControlledRotateY(), applyMultiControlledRotateY(), and applyRotateY().

applyMultiStateControlledRotateZ()

void applyMultiStateControlledRotateZ	(	Qureg	qureg,
		int *	controls,
		int *	states,
		int	numControls,
		int	target,
		qreal	angle )

Note

Documentation for this function or struct is under construction!

Definition at line 1010 of file operations.cpp.

                                                                                                                         {
    validate_quregFields(qureg, __func__);
    validate_controlsAndTarget(qureg, controls, numControls, target, __func__);
    validate_controlStates(states, numControls, __func__); // permits states==nullptr
 
    // harmlessly re-validates
    applyMultiStateControlledPauliGadget(qureg, controls, states, numControls, getPauliStr("Z", {target}), angle);
}

Referenced by applyControlledRotateZ(), applyMultiControlledRotateZ(), and applyRotateZ().

applyRotateAroundAxis()

void applyRotateAroundAxis	(	Qureg	qureg,
		int	targ,
		qreal	angle,
		qreal	axisX,
		qreal	axisY,
		qreal	axisZ )

Note

Documentation for this function or struct is under construction!

Definition at line 1025 of file operations.cpp.

                                                                                                      {
    validate_quregFields(qureg, __func__);
    validate_target(qureg, targ, __func__);
    validate_rotationAxisNotZeroVector(axisX, axisY, axisZ, __func__);
 
    applyMultiStateControlledRotateAroundAxis(qureg, nullptr, nullptr, 0, targ, angle, axisX, axisY, axisZ);
}

applyRotateX()

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

Note

Documentation for this function or struct is under construction!

Definition at line 920 of file operations.cpp.

                                                        {
    validate_quregFields(qureg, __func__);
    validate_target(qureg, target, __func__);
 
    // harmlessly re-validates
    applyMultiStateControlledRotateX(qureg, nullptr, nullptr, 0, target, angle);
}

applyRotateY()

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

Note

Documentation for this function or struct is under construction!

Definition at line 928 of file operations.cpp.

                                                        {
    validate_quregFields(qureg, __func__);
    validate_target(qureg, target, __func__);
 
    // harmlessly re-validates
    applyMultiStateControlledRotateY(qureg, nullptr, nullptr, 0, target, angle);
}

applyRotateZ()

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

Note

Documentation for this function or struct is under construction!

Definition at line 936 of file operations.cpp.

                                                        {
    validate_quregFields(qureg, __func__);
    validate_target(qureg, target, __func__);
 
    // harmlessly re-validates
    applyMultiStateControlledRotateZ(qureg, nullptr, nullptr, 0, target, angle);
}