PauliStr

Functions for applying a tensor product of Pauli operators, as a PauliStr. More...

Functions
void	applyControlledPauliStr (Qureg qureg, int control, PauliStr str)
void	applyMultiControlledPauliStr (Qureg qureg, int *controls, int numControls, PauliStr str)
void	applyMultiStateControlledPauliStr (Qureg qureg, int *controls, int *states, int numControls, PauliStr str)
void	applyPauliStr (Qureg qureg, PauliStr str)

Detailed Description

Functions for applying a tensor product of Pauli operators, as a PauliStr.

Function Documentation

applyControlledPauliStr()

void applyControlledPauliStr	(	Qureg	qureg,
		int	control,
		PauliStr	str )

Note

Documentation for this function or struct is under construction!

Applies a singly-controlled tensor product of Pauli operators str upon qureg.

‍- See applyPauliStr() for information about str.

• See applyControlledCompMatr1() for information about control.

Author

Tyson Jones

Definition at line 947 of file operations.cpp.

                                                                     {
    validate_quregFields(qureg, __func__);
    validate_controlAndPauliStrTargets(qureg, control, str, __func__);
 
    // harmlessly re-validates
    applyMultiStateControlledPauliStr(qureg, &control, nullptr, 1, str);
}

applyMultiControlledPauliStr()

void applyMultiControlledPauliStr	(	Qureg	qureg,
		int *	controls,
		int	numControls,
		PauliStr	str )

Note

Documentation for this function or struct is under construction!

Applies a multiply-controlled tensor product of Pauli operators str upon qureg.

‍- See applyPauliStr() for information about str.

• See applyMultiControlledCompMatr1() for information about controls.

Author

Tyson Jones

Definition at line 955 of file operations.cpp.

                                                                                             {
    validate_quregFields(qureg, __func__);
    validate_controlsAndPauliStrTargets(qureg, controls, numControls, str, __func__);
 
    // harmlessly re-validates
    applyMultiStateControlledPauliStr(qureg, controls, nullptr, numControls, str);
}

Referenced by applyMultiControlledPauliStr().

applyMultiStateControlledPauliStr()

void applyMultiStateControlledPauliStr	(	Qureg	qureg,
		int *	controls,
		int *	states,
		int	numControls,
		PauliStr	str )

Note

Documentation for this function or struct is under construction!

Applies an arbitrarily-controlled tensor product of Pauli operators str upon qureg, conditioned upon controls being in the corresponding states.

‍- See applyPauliStr() for information about str.

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

Author

Tyson Jones

Definition at line 963 of file operations.cpp.

                                                                                                               {
    validate_quregFields(qureg, __func__);
    validate_controlsAndPauliStrTargets(qureg, controls, numControls, str, __func__);
    validate_controlStates(states, numControls, __func__); // permits states==nullptr
 
    qcomp factor = 1;
    auto ctrlList = lists_getList64(controls, numControls);
    auto stateList = util_getList64OrAllOnes(states, numControls);
 
    // when there are no control qubits, we can merge the density matrix's 
    // operation sinto a single tensor, i.e. +- (shift(str) (x) str), to 
    // avoid superfluous re-enumeration of the state
    if (qureg.isDensityMatrix && numControls == 0) {
        factor = paulis_getSignOfPauliStrConj(str);
        ctrlList = util_getConcatenated(ctrlList, util_getBraQubits(ctrlList, qureg));
        stateList = util_getConcatenated(stateList, stateList); 
        str = paulis_getKetAndBraPauliStr(str, qureg);
    }
 
    localiser_statevec_anyCtrlPauliTensor(qureg, ctrlList, stateList, str, factor);
 
    // but density-matrix control qubits require two distinct operations
    if (qureg.isDensityMatrix && numControls > 0) {
        factor = paulis_getSignOfPauliStrConj(str);
        ctrlList = util_getBraQubits(ctrlList, qureg);
        str = paulis_getShiftedPauliStr(str, qureg.numQubits);
        localiser_statevec_anyCtrlPauliTensor(qureg, ctrlList, stateList, str, factor);
    }
}

Referenced by applyControlledPauliStr(), applyMultiControlledPauliStr(), applyMultiStateControlledMultiQubitNot(), applyMultiStateControlledPauliStr(), and applyPauliStr().

applyPauliStr()

void applyPauliStr	(	Qureg	qureg,
		PauliStr	str )

Note

Documentation for this function or struct is under construction!

Definition at line 939 of file operations.cpp.

                                              {
    validate_quregFields(qureg, __func__);
    validate_pauliStrTargets(qureg, str, __func__);
 
    // harmlessly re-validates
    applyMultiStateControlledPauliStr(qureg, nullptr, nullptr, 0, str);
}