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

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

void	applyMultiQubitProjector (Qureg qureg, std::vector< int > qubits, std::vector< int > outcomes)

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

Detailed Description

Functions for effecting projectors which break the state normalisation.

Function Documentation

◆ applyMultiQubitProjector() [1/2]

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().

◆ applyMultiQubitProjector() [2/2]

void applyMultiQubitProjector	(	Qureg	qureg,
		std::vector< int >	qubits,
		std::vector< int >	outcomes )

Warning: This function has not yet been unit tested and may contain bugs. Please use with caution!

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

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

Remarks: This function is only available in C++.

Definition at line 1766 of file operations.cpp.

                                                                                     {
    validate_measurementOutcomesMatchTargets(qubits.size(), outcomes.size(), __func__);
 
    applyMultiQubitProjector(qureg, qubits.data(), outcomes.data(), outcomes.size());
}

◆ 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().