Swap

Functions for applying the two-qubit SWAP and related gates. More...

Functions
void	applyControlledSqrtSwap (Qureg qureg, int control, int qubit1, int qubit2)
void	applyControlledSwap (Qureg qureg, int control, int qubit1, int qubit2)
void	applyMultiControlledSqrtSwap (Qureg qureg, int *controls, int numControls, int qubit1, int qubit2)
void	applyMultiControlledSwap (Qureg qureg, int *controls, int numControls, int qubit1, int qubit2)
void	applyMultiStateControlledSqrtSwap (Qureg qureg, int *controls, int *states, int numControls, int qubit1, int qubit2)
void	applyMultiStateControlledSwap (Qureg qureg, int *controls, int *states, int numControls, int qubit1, int qubit2)
void	applySqrtSwap (Qureg qureg, int qubit1, int qubit2)
void	applySwap (Qureg qureg, int qubit1, int qubit2)

Detailed Description

Functions for applying the two-qubit SWAP and related gates.

Function Documentation

applyControlledSqrtSwap()

void applyControlledSqrtSwap	(	Qureg	qureg,
		int	control,
		int	qubit1,
		int	qubit2 )

Note

Documentation for this function or struct is under construction!

Definition at line 723 of file operations.cpp.

                                                                                 {
    validate_quregFields(qureg, __func__);
    validate_controlAndTwoTargets(qureg, control, target1, target2, __func__);
 
    // harmlessly re-validates
    applyMultiStateControlledSqrtSwap(qureg, &control, nullptr, 1, target1, target2);
}

applyControlledSwap()

void applyControlledSwap	(	Qureg	qureg,
		int	control,
		int	qubit1,
		int	qubit2 )

Note

Documentation for this function or struct is under construction!

Definition at line 660 of file operations.cpp.

                                                                           {
    validate_quregFields(qureg, __func__);
    validate_controlAndTwoTargets(qureg, control, qubit1, qubit2, __func__);
 
    // harmlessly re-valdiates
    applyMultiStateControlledSwap(qureg, &control, nullptr, 1, qubit1, qubit2);
}

applyMultiControlledSqrtSwap()

void applyMultiControlledSqrtSwap	(	Qureg	qureg,
		int *	controls,
		int	numControls,
		int	qubit1,
		int	qubit2 )

Note

Documentation for this function or struct is under construction!

Definition at line 731 of file operations.cpp.

                                                                                                         {
    validate_quregFields(qureg, __func__);
    validate_controlsAndTwoTargets(qureg, controls, numControls, target1, target2, __func__);
 
    // harmlessly re-validates
    applyMultiStateControlledSqrtSwap(qureg, controls, nullptr, numControls, target1, target2);
}

Referenced by applyMultiControlledSqrtSwap().

applyMultiControlledSwap()

void applyMultiControlledSwap	(	Qureg	qureg,
		int *	controls,
		int	numControls,
		int	qubit1,
		int	qubit2 )

Note

Documentation for this function or struct is under construction!

Definition at line 668 of file operations.cpp.

                                                                                                   {
    validate_quregFields(qureg, __func__);
    validate_controlsAndTwoTargets(qureg, controls, numControls, qubit1, qubit2, __func__);
 
    // harmlessly re-valdiates
    applyMultiStateControlledSwap(qureg, controls, nullptr, numControls, qubit1, qubit2);
}

Referenced by applyMultiControlledSwap().

applyMultiStateControlledSqrtSwap()

void applyMultiStateControlledSqrtSwap	(	Qureg	qureg,
		int *	controls,
		int *	states,
		int	numControls,
		int	qubit1,
		int	qubit2 )

Note

Documentation for this function or struct is under construction!

See also

applyMultiStateControlledCompMatr1()

Definition at line 739 of file operations.cpp.

                                                                                                                           {
    validate_quregFields(qureg, __func__);
    validate_controlsAndTwoTargets(qureg, controls, numControls, target1, target2, __func__);
    validate_controlStates(states, numControls, __func__); // permits states==nullptr
 
    /// @todo
    /// this function exacts sqrtSwap as a dense 2-qubit matrix,
    /// where as bespoke communication and simulation strategy is
    /// clearly possible which we have not supported because the gate
    /// is somewhat esoteric. As such, we must validate mixed-amps fit
 
    validate_mixedAmpsFitInNode(qureg, 2, __func__); // to throw SqrtSwap error, not generic CompMatr2 error
 
    CompMatr2 matr = getCompMatr2({
        {1, 0, 0, 0},
        {0, .5+.5_i, .5-.5_i, 0},
        {0, .5-.5_i, .5+.5_i, 0},
        {0, 0, 0, 1}});
 
    applyMultiStateControlledCompMatr2(qureg, controls, states, numControls, target1, target2, matr);
}

Referenced by applyControlledSqrtSwap(), applyMultiControlledSqrtSwap(), and applySqrtSwap().

applyMultiStateControlledSwap()

void applyMultiStateControlledSwap	(	Qureg	qureg,
		int *	controls,
		int *	states,
		int	numControls,
		int	qubit1,
		int	qubit2 )

Note

Documentation for this function or struct is under construction!

See also

applyMultiStateControlledCompMatr1()

Definition at line 676 of file operations.cpp.

                                                                                                                     {
    validate_quregFields(qureg, __func__);
    validate_controlsAndTwoTargets(qureg, controls, numControls, qubit1, qubit2, __func__);
    validate_controlStates(states, numControls, __func__); // permits states==nullptr
 
    auto ctrlVec = util_getVector(controls, numControls);
    auto stateVec = util_getVector(states, numControls); // empty if states==nullptr
    localiser_statevec_anyCtrlSwap(qureg, ctrlVec, stateVec, qubit1, qubit2);
 
    if (!qureg.isDensityMatrix)
        return;
 
    ctrlVec = util_getBraQubits(ctrlVec, qureg);
    qubit1 = util_getBraQubit(qubit1, qureg);
    qubit2 = util_getBraQubit(qubit2, qureg);
    localiser_statevec_anyCtrlSwap(qureg, ctrlVec, stateVec, qubit1, qubit2);
}

Referenced by applyControlledSwap(), applyMultiControlledSwap(), applyMultiStateControlledSwap(), and applySwap().

applySqrtSwap()

void applySqrtSwap	(	Qureg	qureg,
		int	qubit1,
		int	qubit2 )

Note

Documentation for this function or struct is under construction!

Definition at line 715 of file operations.cpp.

                                                          {
    validate_quregFields(qureg, __func__);
    validate_twoTargets(qureg,target1, target2, __func__);
 
    // harmlessly re-validates
    applyMultiStateControlledSqrtSwap(qureg, nullptr, nullptr, 0, target1, target2);
}

applySwap()

void applySwap	(	Qureg	qureg,
		int	qubit1,
		int	qubit2 )

Applies a SWAP gate between qubit1 and qubit2 of qureg.

Diagram

Note

Documentation for this function or struct is under construction!

Definition at line 652 of file operations.cpp.

                                                    {
    validate_quregFields(qureg, __func__);
    validate_twoTargets(qureg, qubit1, qubit2, __func__);
 
    // harmlessly re-valdiates
    applyMultiStateControlledSwap(qureg, nullptr, nullptr, 0, qubit1, qubit2);
}

Referenced by applyQuantumFourierTransform().