Functions for effecting projectors which break the state normalisation. More...

Functions
void	applyMultiQubitProjector (Qureg qureg, int qubits, int outcomes, int numQubits)

void	applyQubitProjector (Qureg qureg, int target, int outcome)

Detailed Description

Functions for effecting projectors which break the state normalisation.

Function Documentation

◆ applyMultiQubitProjector()

void applyMultiQubitProjector	(	Qureg	qureg,
		int *	qubits,
		int *	outcomes,
		int	numQubits )

Note: Documentation for this function or struct is under construction!

Attention: This function's input validation has not yet been unit tested, so erroneous usage may produce unexpected output. Please use with caution!

Definition at line 1750 of file operations.cpp.

                                                                                      {
    validate_quregFields(qureg, __func__);
    validate_targets(qureg, qubits, numQubits, __func__);
    validate_measurementOutcomesAreValid(outcomes, numQubits, __func__);
 
    qreal prob = 1;
    auto qubitVec = util_getVector(qubits, numQubits);
    auto outcomeVec = util_getVector(outcomes, numQubits);
 
    (qureg.isDensityMatrix)?
        localiser_densmatr_multiQubitProjector(qureg, qubitVec, outcomeVec, prob):
        localiser_statevec_multiQubitProjector(qureg, qubitVec, outcomeVec, prob);
}

Referenced by applyMultiQubitProjector(), and TEST_CASE().

◆ applyQubitProjector()

void applyQubitProjector	(	Qureg	qureg,
		int	target,
		int	outcome )

Note: Documentation for this function or struct is under construction!

Attention: This function's input validation has not yet been unit tested, so erroneous usage may produce unexpected output. Please use with caution!

Definition at line 1738 of file operations.cpp.

                                                               {
    validate_quregFields(qureg, __func__);
    validate_target(qureg, target, __func__);
    validate_measurementOutcomeIsValid(outcome, __func__); 
    
    // we permit the outcome to be negligibly likely, leaving state = null
    qreal prob = 1;
    (qureg.isDensityMatrix)?
        localiser_densmatr_multiQubitProjector(qureg, {target}, {outcome}, prob):
        localiser_statevec_multiQubitProjector(qureg, {target}, {outcome}, prob);
}

Referenced by TEST_CASE().