Amplitudes

Functions for overwriting Qureg amplitudes. More...

Functions
void	setDensityQuregAmps (Qureg qureg, qindex startRow, qindex startCol, qcomp **amps, qindex numRows, qindex numCols)
void	setDensityQuregAmps (Qureg qureg, qindex startRow, qindex startCol, std::vector< std::vector< qcomp > > amps)
void	setDensityQuregFlatAmps (Qureg qureg, qindex startInd, qcomp *amps, qindex numAmps)
void	setDensityQuregFlatAmps (Qureg qureg, qindex startInd, std::vector< qcomp > amps)
void	setQuregAmps (Qureg qureg, qindex startInd, qcomp *amps, qindex numAmps)
void	setQuregAmps (Qureg qureg, qindex startInd, std::vector< qcomp > amps)
void	setQuregToClone (Qureg outQureg, Qureg inQureg)
void	setQuregToMixture (Qureg out, qreal *probs, Qureg *in, int numIn)
void	setQuregToMixture (Qureg out, std::vector< qreal > probs, std::vector< Qureg > in)
void	setQuregToPartialTrace (Qureg out, Qureg in, int *traceOutQubits, int numTraceQubits)
void	setQuregToPartialTrace (Qureg out, Qureg in, std::vector< int > traceOutQubits)
void	setQuregToPauliStrSum (Qureg qureg, PauliStrSum sum)
void	setQuregToReducedDensityMatrix (Qureg out, Qureg in, int *retainQubits, int numRetainQubits)
void	setQuregToReducedDensityMatrix (Qureg out, Qureg in, std::vector< int > retainQubits)
qreal	setQuregToRenormalized (Qureg qureg)
void	setQuregToWeightedSum (Qureg out, qcomp *coeffs, Qureg *in, int numIn)
void	setQuregToWeightedSum (Qureg out, std::vector< qcomp > coeffs, std::vector< Qureg > in)

Detailed Description

Functions for overwriting Qureg amplitudes.

Function Documentation

setDensityQuregAmps() [1/2]

void setDensityQuregAmps	(	Qureg	qureg,
		qindex	startRow,
		qindex	startCol,
		qcomp **	amps,
		qindex	numRows,
		qindex	numCols )

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 156 of file initialisations.cpp.

                                                                                                                      {
    validate_quregFields(qureg, __func__);
    validate_quregIsDensityMatrix(qureg, __func__);
    validate_basisStateRowCols(qureg, startRow, startCol, numRows, numCols, __func__);
 
    localiser_densmatr_setAmps(amps, qureg, startRow, startCol, numRows, numCols);
}

Referenced by TEST_CASE().

setDensityQuregAmps() [2/2]

void setDensityQuregAmps	(	Qureg	qureg,
		qindex	startRow,
		qindex	startCol,
		std::vector< std::vector< qcomp > >	amps )

Warning

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

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!

Remarks

This function is only available in C++.

See also

setDensityQuregAmps()

setDensityQuregFlatAmps() [1/2]

void setDensityQuregFlatAmps	(	Qureg	qureg,
		qindex	startInd,
		qcomp *	amps,
		qindex	numAmps )

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 165 of file initialisations.cpp.

                                                                                        {
    validate_quregFields(qureg, __func__);
    validate_quregIsDensityMatrix(qureg, __func__);
    validate_basisStateIndices(qureg, startInd, numAmps, __func__); // validation msg correct for density-matrix
 
    localiser_statevec_setAmps(amps, qureg, startInd, numAmps);
}

Referenced by TEST_CASE().

setDensityQuregFlatAmps() [2/2]

void setDensityQuregFlatAmps	(	Qureg	qureg,
		qindex	startInd,
		std::vector< qcomp >	amps )

Warning

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

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!

Remarks

This function is only available in C++.

See also

setDensityQuregFlatAmps()

setQuregAmps() [1/2]

void setQuregAmps	(	Qureg	qureg,
		qindex	startInd,
		qcomp *	amps,
		qindex	numAmps )

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 147 of file initialisations.cpp.

                                                                             {
    validate_quregFields(qureg, __func__);
    validate_quregIsStateVector(qureg, __func__);
    validate_basisStateIndices(qureg, startInd, numAmps, __func__);
 
    localiser_statevec_setAmps(amps, qureg, startInd, numAmps);
}

Referenced by TEST_CASE(), and TEST_CASE().

setQuregAmps() [2/2]

void setQuregAmps	(	Qureg	qureg,
		qindex	startInd,
		std::vector< qcomp >	amps )

Warning

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

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!

Remarks

This function is only available in C++.

See also

setQuregAmps()

setQuregToClone()

void setQuregToClone	(	Qureg	outQureg,
		Qureg	inQureg )

Note

Documentation for this function or struct is under construction!

Warning

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

Definition at line 174 of file initialisations.cpp.

                                                    {
    validate_quregFields(outQureg, __func__);
    validate_quregFields(inQureg, __func__);
    validate_quregsCanBeCloned(outQureg, inQureg, __func__);
 
    // we invoke mixing/superposing, which involves superfluous
    // floating-point operators but is not expected to cause an
    // appreciable slowdown since simulation is often memory-bound
    (outQureg.isDensityMatrix)?
        localiser_densmatr_mixQureg(0, outQureg, 1, inQureg):
        localiser_statevec_setQuregToClone(outQureg, inQureg);
}

Referenced by createCloneQureg().

setQuregToMixture() [1/2]

void setQuregToMixture	(	Qureg	out,
		qreal *	probs,
		Qureg *	in,
		int	numIn )

Note

Documentation for this function or struct is under construction!

Warning

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

Definition at line 252 of file initialisations.cpp.

                                                                      {
    validate_quregFields(out, __func__);
    validate_quregIsDensityMatrix(out, __func__);
    validate_numQuregsInSum(numIn, __func__);
    validate_quregsCanBeMixed(out, in, numIn, __func__); // also validates all init & densmatr
    validate_probabilities(probs, numIn, __func__);
 
    // convert probs to complex (assume this alloc never fails)
    vector<qcomp> coeffVec(numIn);
    for (int i=0; i<numIn; i++)
        coeffVec[i] = getQcomp(probs[i], 0);
 
    auto inVec = util_getVector(in, numIn);
    localiser_statevec_setQuregToWeightedSum(out, coeffVec, inVec);
}

setQuregToMixture() [2/2]

void setQuregToMixture	(	Qureg	out,
		std::vector< qreal >	probs,
		std::vector< Qureg >	in )

Note

Documentation for this function or struct is under construction!

Remarks

This function is only available in C++.

See also

setQuregToMixture()

setQuregToPartialTrace() [1/2]

void setQuregToPartialTrace	(	Qureg	out,
		Qureg	in,
		int *	traceOutQubits,
		int	numTraceQubits )

Note

Documentation for this function or struct is under construction!

Warning

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

Definition at line 215 of file initialisations.cpp.

                                                                                          {
    validate_quregFields(in, __func__);
    validate_quregFields(out, __func__);
    validate_quregIsDensityMatrix(in, __func__);
    validate_quregIsDensityMatrix(out, __func__);
    validate_targets(in, traceOutQubits, numTraceQubits, __func__);
    validate_quregCanBeSetToReducedDensMatr(out, in, numTraceQubits, __func__);
 
    auto targets = util_getVector(traceOutQubits, numTraceQubits);
    localiser_densmatr_partialTrace(in, out, targets);
}

setQuregToPartialTrace() [2/2]

void setQuregToPartialTrace	(	Qureg	out,
		Qureg	in,
		std::vector< int >	traceOutQubits )

Warning

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

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!

Remarks

This function is only available in C++.

See also

setQuregToPartialTrace()

Definition at line 306 of file initialisations.cpp.

                                                                             {
    setQuregToPartialTrace(out, in, traceOutQubits.data(), traceOutQubits.size());
}

setQuregToPauliStrSum()

void setQuregToPauliStrSum	(	Qureg	qureg,
		PauliStrSum	sum )

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 202 of file initialisations.cpp.

                                                         {
    validate_quregFields(qureg, __func__);
    validate_quregIsDensityMatrix(qureg, __func__);
    validate_pauliStrSumFields(sum, __func__);
    validate_pauliStrSumTargets(sum, qureg, __func__);
 
    // sum is permitted to be non-Hermitian, since Hermiticity
    // is insufficient to ensure qureg would be physical/valid
 
    localiser_densmatr_setAmpsToPauliStrSum(qureg, sum);
}

Referenced by TEST_CASE().

setQuregToReducedDensityMatrix() [1/2]

void setQuregToReducedDensityMatrix	(	Qureg	out,
		Qureg	in,
		int *	retainQubits,
		int	numRetainQubits )

Note

Documentation for this function or struct is under construction!

Warning

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

Definition at line 228 of file initialisations.cpp.

                                                                                                 {
    validate_quregFields(in, __func__);
    validate_quregFields(out, __func__);
    validate_quregIsDensityMatrix(in, __func__);
    validate_quregIsDensityMatrix(out, __func__);
    validate_targets(in, retainQubits, numRetainQubits, __func__);
    validate_quregCanBeSetToReducedDensMatr(out, in, in.numQubits - numRetainQubits, __func__);
 
    auto traceQubits = util_getNonTargetedQubits(retainQubits, numRetainQubits, in.numQubits);
    localiser_densmatr_partialTrace(in, out, traceQubits);
}

setQuregToReducedDensityMatrix() [2/2]

void setQuregToReducedDensityMatrix	(	Qureg	out,
		Qureg	in,
		std::vector< int >	retainQubits )

Warning

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

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!

Remarks

This function is only available in C++.

See also

setQuregToReducedDensityMatrix()

Definition at line 310 of file initialisations.cpp.

                                                                                   {
    setQuregToReducedDensityMatrix(out, in, retainQubits.data(), retainQubits.size());
}

setQuregToRenormalized()

qreal setQuregToRenormalized

(

Qureg

qureg

)

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 188 of file initialisations.cpp.

                                          {
    validate_quregFields(qureg, __func__);
 
    qreal prob = calcTotalProb(qureg); // harmlessly re-validates
    validate_quregRenormProbIsNotZero(prob, __func__);
 
    qreal norm = (qureg.isDensityMatrix)? prob : std::sqrt(prob);
    qreal fac = 1 / norm;
    localiser_statevec_scaleAmps(qureg, fac);
 
    return fac;
}

Referenced by initRandomPureState(), and TEST_CASE().

setQuregToWeightedSum() [1/2]

void setQuregToWeightedSum	(	Qureg	out,
		qcomp *	coeffs,
		Qureg *	in,
		int	numIn )

Note

Documentation for this function or struct is under construction!

Warning

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

Definition at line 241 of file initialisations.cpp.

                                                                           {
    validate_quregFields(out, __func__);
    validate_numQuregsInSum(numIn, __func__);
    validate_quregsCanBeSummed(out, in, numIn, __func__); // also validates all init
 
    auto coeffVec = util_getVector(coeffs, numIn);
    auto inVec = util_getVector(in, numIn);
    localiser_statevec_setQuregToWeightedSum(out, coeffVec, inVec);
}

setQuregToWeightedSum() [2/2]

void setQuregToWeightedSum	(	Qureg	out,
		std::vector< qcomp >	coeffs,
		std::vector< Qureg >	in )

Note

Documentation for this function or struct is under construction!

Remarks

This function is only available in C++.

See also

setQuregToWeightedSum()