Pauli

Functions for applying the individual one-qubit Pauli operators. More...

Functions
void	applyControlledPauliX (Qureg qureg, int control, int target)
void	applyControlledPauliY (Qureg qureg, int control, int target)
void	applyControlledPauliZ (Qureg qureg, int control, int target)
void	applyMultiControlledPauliX (Qureg qureg, int *controls, int numControls, int target)
void	applyMultiControlledPauliY (Qureg qureg, int *controls, int numControls, int target)
void	applyMultiControlledPauliZ (Qureg qureg, int *controls, int numControls, int target)
void	applyMultiStateControlledPauliX (Qureg qureg, int *controls, int *states, int numControls, int target)
void	applyMultiStateControlledPauliY (Qureg qureg, int *controls, int *states, int numControls, int target)
void	applyMultiStateControlledPauliZ (Qureg qureg, int *controls, int *states, int numControls, int target)
void	applyPauliX (Qureg qureg, int target)
void	applyPauliY (Qureg qureg, int target)
void	applyPauliZ (Qureg qureg, int target)

Detailed Description

Functions for applying the individual one-qubit Pauli operators.

Function Documentation

applyControlledPauliX()

void applyControlledPauliX	(	Qureg	qureg,
		int	control,
		int	target )

Note

Documentation for this function or struct is under construction!

Applies a singly-controlled Pauli X operator (or NOT gate) upon the target qubit of qureg.

‍- See applyPauliX() for information about the base operation.

• See applyControlledCompMatr1() for information about control.

Author

Tyson Jones

Definition at line 809 of file operations.cpp.

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

applyControlledPauliY()

void applyControlledPauliY	(	Qureg	qureg,
		int	control,
		int	target )

Note

Documentation for this function or struct is under construction!

Applies a singly-controlled Pauli Y operator upon the target qubit of qureg.

‍- See applyPauliY() for information about the base operation.

• See applyControlledCompMatr1() for information about control.

Author

Tyson Jones

Definition at line 817 of file operations.cpp.

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

applyControlledPauliZ()

void applyControlledPauliZ	(	Qureg	qureg,
		int	control,
		int	target )

Note

Documentation for this function or struct is under construction!

Applies a singly-controlled Pauli Z operator upon the target qubit of qureg.

‍- See applyPauliZ() for information about the base operation.

• See applyControlledCompMatr1() for information about control.

Author

Tyson Jones

Definition at line 825 of file operations.cpp.

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

applyMultiControlledPauliX()

void applyMultiControlledPauliX	(	Qureg	qureg,
		int *	controls,
		int	numControls,
		int	target )

Note

Documentation for this function or struct is under construction!

Applies a multiply-controlled Pauli X operator (or NOT gate) upon the target qubit of qureg.

‍- See applyPauliX() for information about the base operation.

• See applyMultiControlledCompMatr1() for information about controls.

Author

Tyson Jones

Definition at line 833 of file operations.cpp.

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

Referenced by applyMultiControlledPauliX().

applyMultiControlledPauliY()

void applyMultiControlledPauliY	(	Qureg	qureg,
		int *	controls,
		int	numControls,
		int	target )

Note

Documentation for this function or struct is under construction!

Applies a multiply-controlled Pauli Y operator (or NOT gate) upon the target qubit of qureg.

‍- See applyPauliY() for information about the base operation.

• See applyMultiControlledCompMatr1() for information about controls.

Author

Tyson Jones

Definition at line 841 of file operations.cpp.

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

Referenced by applyMultiControlledPauliY().

applyMultiControlledPauliZ()

void applyMultiControlledPauliZ	(	Qureg	qureg,
		int *	controls,
		int	numControls,
		int	target )

Note

Documentation for this function or struct is under construction!

Applies a multiply-controlled Pauli Z operator (or NOT gate) upon the target qubit of qureg.

‍- See applyPauliZ() for information about the base operation.

• See applyMultiControlledCompMatr1() for information about controls.

Author

Tyson Jones

Definition at line 849 of file operations.cpp.

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

Referenced by applyMultiControlledPauliZ().

applyMultiStateControlledPauliX()

void applyMultiStateControlledPauliX	(	Qureg	qureg,
		int *	controls,
		int *	states,
		int	numControls,
		int	target )

Note

Documentation for this function or struct is under construction!

Applies an arbitrarily-controlled Pauli X operator (or NOT gate) upon the target qubit of qureg, conditioned upon controls being in the corresponding states.

‍- See applyPauliX() for information about the base operation.

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

Author

Tyson Jones

Definition at line 857 of file operations.cpp.

                                                                                                            {
    validate_quregFields(qureg, __func__);
    validate_controlsAndTarget(qureg, controls, numControls, target, __func__);
    validate_controlStates(states, numControls, __func__); // permits states==nullptr
 
    // note that for the single-target scenario, we do not call the backend of
    // applyMultiStateControlledPauliStr() since it contains sub-optimal logic
    // which sees the factor of every amplitude dynamically evaluated (based on
    // index parity, etc); the dense-matrix element lookup is faster
 
    /// @todo
    /// a bespoke all-pauli-X function (like in QuEST v3) will be faster still 
    /// since it avoids all superfluous flops; check worthwhile for multi-qubit
 
    // harmlessly re-validates, including hardcoded matrix unitarity
    static const CompMatr1 matrix = util_getPauliX();
    validateAndApplyAnyCtrlAnyTargUnitaryMatrix(qureg, controls, states, numControls, &target, 1, matrix, __func__);
}

Referenced by applyControlledPauliX(), applyMultiControlledPauliX(), applyMultiStateControlledPauliX(), and applyPauliX().

applyMultiStateControlledPauliY()

void applyMultiStateControlledPauliY	(	Qureg	qureg,
		int *	controls,
		int *	states,
		int	numControls,
		int	target )

Note

Documentation for this function or struct is under construction!

Applies an arbitrarily-controlled Pauli Y operator upon the target qubit of qureg, conditioned upon controls being in the corresponding states.

‍- See applyPauliY() for information about the base operation.

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

Author

Tyson Jones

Definition at line 876 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, including hardcoded matrix unitarity
    static const CompMatr1 matrix = util_getPauliY();
    validateAndApplyAnyCtrlAnyTargUnitaryMatrix(qureg, controls, states, numControls, &target, 1, matrix, __func__);
}

Referenced by applyControlledPauliY(), applyMultiControlledPauliY(), applyMultiStateControlledPauliY(), and applyPauliY().

applyMultiStateControlledPauliZ()

void applyMultiStateControlledPauliZ	(	Qureg	qureg,
		int *	controls,
		int *	states,
		int	numControls,
		int	target )

Note

Documentation for this function or struct is under construction!

Applies an arbitrarily-controlled Pauli Z operator upon the target qubit of qureg, conditioned upon controls being in the corresponding states.

‍- See applyPauliZ() for information about the base operation.

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

Author

Tyson Jones

Definition at line 886 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, including hardcoded matrix unitarity
    static const DiagMatr1 matrix = util_getPauliZ();
    validateAndApplyAnyCtrlAnyTargUnitaryMatrix(qureg, controls, states, numControls, &target, 1, matrix, __func__);
}

Referenced by applyControlledPauliZ(), applyMultiControlledPauliZ(), applyMultiStateControlledPauliZ(), and applyPauliZ().

applyPauliX()

void applyPauliX	(	Qureg	qureg,
		int	target )

Note

Documentation for this function or struct is under construction!

Definition at line 785 of file operations.cpp.

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

applyPauliY()

void applyPauliY	(	Qureg	qureg,
		int	target )

Note

Documentation for this function or struct is under construction!

Definition at line 793 of file operations.cpp.

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

applyPauliZ()

void applyPauliZ	(	Qureg	qureg,
		int	target )

Note

Documentation for this function or struct is under construction!

Definition at line 801 of file operations.cpp.

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