#include <FusionState.h>

Inheritance diagram for Simulators::Private::FusionState:

Collaboration diagram for Simulators::Private::FusionState:

Public Types
using	Matrix8cd = Eigen::Matrix<std::complex<double>, 8, 8>

Public Member Functions
	FusionState (std::shared_ptr< ISimulator > immediate)
size_t	AllocateQubits (size_t n) override
	Allocates qubits.
std::vector< double >	AllProbabilities () override
	Returns the probabilities of all possible outcomes.
std::complex< double >	Amplitude (Types::qubit_t outcome) override
	Returns the amplitude of the specified state.
std::complex< double >	AmplitudeRaw (Types::qubit_t outcome) override
	Gets the amplitude.
void	ApplyAmplitudeDamping (Types::qubit_t qubit, double gamma)
void	ApplyBitFlipNoise (Types::qubit_t qubit, double probability)
void	ApplyBitPhaseFlipNoise (Types::qubit_t qubit, double probability)
virtual void	ApplyCCX (Types::qubit_t qubit0, Types::qubit_t qubit1, Types::qubit_t qubit2)=0
	Applies a controlled controlled not gate to the qubits.
virtual void	ApplyCH (Types::qubit_t ctrl_qubit, Types::qubit_t tgt_qubit)=0
	Applies a CH gate to the qubits.
void	ApplyChannel (const Types::qubits_vector &targets, const QuantumChannel::KrausOperators &krausOperators)
	Alias matching the channel terminology used by QCSim's dense backend.
void	ApplyCorrelatedPhaseFlipNoise (Types::qubit_t qubit0, Types::qubit_t qubit1, double probability)
void	ApplyCorrelatedPhaseFlipNoise (Types::qubit_t qubit0, Types::qubit_t qubit1, double probability, double correlation)
virtual void	ApplyCP (Types::qubit_t ctrl_qubit, Types::qubit_t tgt_qubit, double lambda)=0
	Applies a CP gate to the qubits.
virtual void	ApplyCRx (Types::qubit_t ctrl_qubit, Types::qubit_t tgt_qubit, double theta)=0
	Applies a CRx gate to the qubits.
virtual void	ApplyCRy (Types::qubit_t ctrl_qubit, Types::qubit_t tgt_qubit, double theta)=0
	Applies a CRy gate to the qubits.
virtual void	ApplyCRz (Types::qubit_t ctrl_qubit, Types::qubit_t tgt_qubit, double theta)=0
	Applies a CRz gate to the qubits.
virtual void	ApplyCSwap (Types::qubit_t ctrl_qubit, Types::qubit_t qubit0, Types::qubit_t qubit1)=0
	Applies a controlled swap gate to the qubits.
virtual void	ApplyCSx (Types::qubit_t ctrl_qubit, Types::qubit_t tgt_qubit)=0
	Applies a CSx gate to the qubits.
virtual void	ApplyCSxDAG (Types::qubit_t ctrl_qubit, Types::qubit_t tgt_qubit)=0
	Applies a CSx dagger gate to the qubits.
virtual void	ApplyCU (Types::qubit_t ctrl_qubit, Types::qubit_t tgt_qubit, double theta, double phi, double lambda, double gamma)=0
	Applies a controlled U gate to the qubits.
virtual void	ApplyCX (Types::qubit_t ctrl_qubit, Types::qubit_t tgt_qubit)=0
	Applies a CX gate to the qubits.
virtual void	ApplyCY (Types::qubit_t ctrl_qubit, Types::qubit_t tgt_qubit)=0
	Applies a CY gate to the qubits.
virtual void	ApplyCZ (Types::qubit_t ctrl_qubit, Types::qubit_t tgt_qubit)=0
	Applies a CZ gate to the qubits.
void	ApplyDephasingNoise (Types::qubit_t qubit, double probability)
	Noise.h dephasing is a stochastic phase flip, not phase damping.
void	ApplyDepolarizingMixingNoise (Types::qubit_t qubit, double mixingProbability)
	Depolarizing replacement (1-p)rho + p I/2, fully mixed at p=1.
void	ApplyDepolarizingNoise (Types::qubit_t qubit, double errorProbability)
	Depolarizing noise using total nonidentity-Pauli probability p.
void	ApplyGeneralizedAmplitudeDamping (Types::qubit_t qubit, double gamma, double excitedStatePopulation)
virtual void	ApplyGenericOneQubitGate (Types::qubit_t qubit, const Eigen::Matrix2cd &gate)=0
	Apply a generic one-qubit gate to the specified qubit.
virtual void	ApplyGenericThreeQubitGate (Types::qubit_t, Types::qubit_t, Types::qubit_t, const Matrix8cd &)
virtual void	ApplyGenericTwoQubitGate (Types::qubit_t qubit0, Types::qubit_t qubit1, const Eigen::Matrix4cd &gate)=0
	Apply a generic two-qubit gate to the specified qubits.
virtual void	ApplyH (Types::qubit_t qubit)=0
	Applies a Hadamard gate to the qubit.
virtual void	ApplyK (Types::qubit_t qubit)=0
	Applies a K gate to the qubit.
void	ApplyKrausChannel (const Types::qubits_vector &targets, const QuantumChannel::KrausOperators &krausOperators)
	Apply an arbitrary CPTP map supplied in Kraus form.
virtual void	ApplyNop ()=0
	Applies a nop.
void	ApplyOperator (const Types::qubits_vector &qubits, const Eigen::MatrixXcd &matrix, bool normalize=false) override
virtual void	ApplyP (Types::qubit_t qubit, double lambda)=0
	Applies a phase shift gate to the qubit.
void	ApplyPauliChannel (const Types::qubits_vector &targets, const std::vector< double > &probabilities)
	Apply an arbitrary one- or two-qubit Pauli channel.
void	ApplyPauliChannel (Types::qubit_t qubit, double px, double py, double pz)
	Apply a single-qubit Pauli channel specified by X/Y/Z probabilities.
void	ApplyPhaseDamping (Types::qubit_t qubit, double gamma)
	Phase damping with coherence multiplier sqrt(1-gamma).
void	ApplyPhaseDampingFromTime (Types::qubit_t qubit, double duration, double tPhi)
	Pure phase damping for a physical duration and T_phi.
void	ApplyPhaseFlipNoise (Types::qubit_t qubit, double probability)
void	ApplyQuantumChannel (const Types::qubits_vector &qs, const QuantumChannel &channel) override
	Applies a local CPTP quantum channel to one or two qubits.
void	ApplyReset (const Types::qubits_vector &qs) override
	Performs a reset of the specified qubits.
virtual void	ApplyRx (Types::qubit_t qubit, double theta)=0
	Applies a Rx gate to the qubit.
virtual void	ApplyRy (Types::qubit_t qubit, double theta)=0
	Applies a Ry gate to the qubit.
virtual void	ApplyRz (Types::qubit_t qubit, double theta)=0
	Applies a Rz gate to the qubit.
virtual void	ApplyS (Types::qubit_t qubit)=0
	Applies a S gate to the qubit.
virtual void	ApplySDG (Types::qubit_t qubit)=0
	Applies a S dagger gate to the qubit.
virtual void	ApplySwap (Types::qubit_t qubit0, Types::qubit_t qubit1)=0
	Applies a swap gate to the qubits.
virtual void	ApplySx (Types::qubit_t qubit)=0
	Applies a Sx gate to the qubit.
virtual void	ApplySxDAG (Types::qubit_t qubit)=0
	Applies a Sx dagger gate to the qubit.
virtual void	ApplyT (Types::qubit_t qubit)=0
	Applies a T gate to the qubit.
void	ApplyT1Relaxation (Types::qubit_t qubit, double gamma)
	Alias for the exact T1 amplitude-damping channel.
void	ApplyT1RelaxationFromTime (Types::qubit_t qubit, double duration, double t1)
	Exact T1 relaxation for a physical duration and time constant.
virtual void	ApplyTDG (Types::qubit_t qubit)=0
	Applies a T dagger gate to the qubit.
void	ApplyThermalRelaxation (Types::qubit_t qubit, double duration, double t1, double t2, double excitedStatePopulation=0.0)
void	ApplyTwoQubitDepolarizingMixingNoise (Types::qubit_t qubit0, Types::qubit_t qubit1, double mixingProbability)
void	ApplyTwoQubitDepolarizingNoise (Types::qubit_t qubit0, Types::qubit_t qubit1, double errorProbability)
virtual void	ApplyU (Types::qubit_t qubit, double theta, double phi, double lambda, double gamma)=0
	Applies a U gate to the qubit.
virtual void	ApplyX (Types::qubit_t qubit)=0
	Applies a not gate to the qubit.
virtual void	ApplyY (Types::qubit_t qubit)=0
	Applies a Y gate to the qubit.
virtual void	ApplyZ (Types::qubit_t qubit)=0
	Applies a Z gate to the qubit.
void	Clear () override
	Clears the state.
void	ClearObservers ()
	Clears all observers.
virtual std::unique_ptr< ISimulator >	Clone ()=0
	Clones the simulator.
virtual std::unique_ptr< ISimulator >	CloneForExecution (uint64_t seed)
void	Configure (const char key, const char value) override
	Configures the state.
std::complex< double >	DensityMatrixElementBits (const std::vector< bool > &row, const std::vector< bool > &col) const override
double	DensityMatrixHermiticityResidual () const override
std::complex< double >	DensityMatrixOverlap (const IState &other) const override
double	DensityMatrixPurity () const override
std::complex< double >	DensityMatrixTrace () const override
	Mixed-state diagnostics.
std::complex< double >	DensityMatrixTraceOfSquare () const override
double	ExpectationValue (const std::string &pauli) override
	Returns the expected value of a Pauli string.
std::complex< double >	ExpectationValueComplex (const std::string &pauli, bool normalized=true) const override
std::complex< double >	ExpectationValueOperators (const Types::qubits_vector &qubits, const std::vector< Eigen::MatrixXcd > &matrices) override
std::vector< double >	ExpectationValues (const std::vector< std::string > &paulis) override
std::vector< std::complex< double > >	ExpectationValuesComplex (const std::vector< std::string > &paulis, bool normalized=true) const override
double	FidelityWithStatevector (const Eigen::VectorXcd &psi) const override
void	Flush () override
	Flushes the applied operations.
void	FlushPendingGates () override
const std::unordered_map< std::string, std::string > &	GetConfigMap () const override
std::string	GetConfiguration (const char *key) const override
	Returns configuration value.
size_t	GetCurrentMaxBondDimension () const override
	Returns the maximum bond dimension reached.
Eigen::MatrixXcd	GetDensityMatrix (bool normalized=true) const override
size_t	GetExecutedMaxBondDimension () const override
virtual unsigned	GetGateFusionMaxQubits () const
GateFusionStatistics	GetGateFusionStatistics () const override
long long	GetGatesCounter () const override
	Returns the gates counter.
int	GetGpuDevice () const override
double	getGrowthFactorGate () const override
double	getGrowthFactorSwap () const override
bool	GetMultithreading () const override
	Get the multithreading flag.
size_t	GetNumberOfQubits () const override
	Returns the number of qubits.
std::shared_ptr< ISimulator >	getptr ()
	Get a shared pointer to this object.
SimulationType	GetSimulationType () const override
	Returns the type of simulation.
std::vector< std::complex< double > >	GetStateVector () override
SimulatorType	GetType () const override
	Returns the type of simulator.
const std::vector< std::shared_ptr< Circuits::IOperation< double > > > &	GetUpcomingRoutingOperations () const override
void	HermitizeDensityMatrix () override
void	IncrementGatesCounter () override
	Increments the gates counter.
void	Initialize () override
	Initializes the state.
void	InitializeState (size_t n, AER::Vector< std::complex< double > > &value) override
	Initializes the state.
void	InitializeState (size_t n, Eigen::VectorXcd &value) override
	Initializes the state.
void	InitializeState (size_t n, std::vector< std::complex< double > > &value) override
	Initializes the state.
void	InitializeToBasisState (size_t n, const std::vector< bool > &value) override
	Initializes the state to a computational basis state.
void	InitializeToBasisState (size_t n, Types::qubit_t value) override
	Initializes the state to a computational basis state.
void	InitializeToMixtureOfBasisStates (size_t n, const std::vector< std::pair< std::vector< bool >, double > > &value) override
	Initializes the state to a classical mixture of computational basis states.
void	InitializeToMixtureOfBasisStates (size_t n, const std::vector< std::pair< Types::qubit_t, double > > &value) override
	Initializes the state to a classical mixture of computational basis states.
bool	IsDensityMatrixHermitian (double eps=1e-10) const override
bool	IsGateFusionEnabled () const override
bool	IsQcsim () const override
	Returns if the simulator is a qcsim simulator.
bool	IsRoutingLookaheadEnabled () const override
size_t	Measure (const Types::qubits_vector &qs) override
	Performs a measurement on the specified qubits.
std::vector< bool >	MeasureMany (const Types::qubits_vector &qs) override
	Performs a measurement on the specified qubits.
Types::qubit_t	MeasureNoCollapse () override
	Measures all the qubits without collapsing the state.
std::vector< bool >	MeasureNoCollapseMany () override
	Measures all the qubits without collapsing the state.
void	MoveAtBeginningOfChain (const Types::qubits_vector &qubits) override
Eigen::MatrixXcd	PartialTrace (const Types::qubits_vector &qs) const override
std::vector< double >	Probabilities (const Types::qubits_vector &qs) override
	Returns the probabilities of the specified outcomes.
double	Probability (Types::qubit_t outcome) override
	Returns the probability of the specified outcome.
double	ProbabilityBits (const std::vector< bool > &bits) override
	MPO extensions: bit vectors are q0-first; matrices use logical basis order.
std::complex< double >	ProjectOnZero () override
	Projects the state onto the zero state.
double	RandomUniform ()
	Uniform random number in [0, 1) from the auxiliary stream.
void	ReCanonicalize () override
	Restore the canonical form of a matrix-product state or operator.
void	RegisterObserver (const std::shared_ptr< ISimulatorObserver > &observer)
	Registers an observer.
void	Reset () override
	Just resets the state to 0.
void	RestoreDensityMatrixTrace () override
void	RestoreInternalDestructiveSavedState () override
	Restores the state from the internally saved state.
void	RestoreState () override
	Restores the state from the internally saved state.
std::unordered_map< Types::qubit_t, Types::qubit_t >	SampleCounts (const Types::qubits_vector &qs, size_t shots=1000) override
	Returns the counts of the outcomes of measurement of the specified qubits, for repeated measurements.
std::unordered_map< std::vector< bool >, Types::qubit_t >	SampleCountsMany (const Types::qubits_vector &qs, size_t shots=1000) override
	Returns the counts of the outcomes of measurement of the specified qubits, for repeated measurements.
void	SaveState () override
	Saves the state to internal storage.
void	SaveStateToInternalDestructive () override
	Saves the state to internal storage.
void	SetAutomaticLookaheadDepth (int value) override
virtual void	SetGatesCounter (long long int)
	Sets the gates counter.
void	SetGatesCounter (long long counter) override
void	setGrowthFactorGate (double value) override
void	setGrowthFactorSwap (double value) override
virtual void	SetInitialQubitsMap (const std::vector< long long int > &initialMap)
	Sets the initial qubits map, if possible.
void	SetInitialQubitsMap (const std::vector< long long > &value) override
void	SetLookaheadDepth (int value) override
	Sets the lookahead depth for swap optimization.
void	SetLookaheadDepthWithHeuristic (int value) override
	Sets the lookahead depth for swap optimization.
void	SetMultithreading (bool value=true) override
	Enable/disable multithreading.
void	SetSeed (uint64_t seed) override
	Seed every random stream owned by this simulator.
void	SetUpcomingGates (const std::vector< std::shared_ptr< Circuits::IOperation< double > > > &gates) override
	Supplies upcoming gates for lookahead swap optimization.
void	SetUseOptimalMeetingPosition (bool value) override
	Enables or disables optimal meeting position for MPS swaps.
bool	SupportsMPSSwapOptimization () const override
	Returns if the simulator supports MPS swap optimization.
bool	SupportsQuantumChannels () const override
	Returns whether this state retains channel ensembles directly.
bool	SwapGatesRelabelQubits () const override
void	Trim () override
	Compress a matrix-product state or operator to its configured limits.
void	UnregisterObserver (const std::shared_ptr< ISimulatorObserver > &observer)
	Unregisters an observer.

Static Public Member Functions
static uint64_t	DeriveSeed (uint64_t seed, uint64_t stream)

Protected Types
using	Cache = GateFusion<FusionGate>
using	Operation = std::shared_ptr<Circuits::IOperation<double>>

Protected Member Functions
void	CloneInto (FusionState &copy, const uint64_t *executionSeed=nullptr)
void	ConsumeBoundary (Circuits::OperationType type)
virtual size_t	DefaultGateFusionMinQubits () const
void	DontNotify ()
	Stops notifying observers.
virtual bool	InitializationPreservesSnapshots () const
bool	NotificationsEnabled () const noexcept
void	Notify ()
	Starts notifying observers.
void	NotifyObservers (const Types::qubits_vector &affectedQubits)
	Notifies observers.
virtual bool	PreserveStructuredGates () const
void	SeedAuxiliaryRng (uint64_t seed)
	Shared by SetSeed and backend Configure("seed") implementations.
void	SubmitGate (const FusionGate &gate)
virtual bool	UsesDestructiveStateStorage () const

Protected Attributes
std::shared_ptr< ISimulator >	immediate_

Detailed Description

Definition at line 12 of file FusionState.h.

Member Typedef Documentation

◆ Cache

using Simulators::Private::FusionState::Cache = GateFusion<FusionGate>

protected

Definition at line 719 of file FusionState.h.

◆ Matrix8cd

using Simulators::ISimulator::Matrix8cd = Eigen::Matrix<std::complex<double>, 8, 8>

inherited

Definition at line 43 of file Simulator.h.

◆ Operation

using Simulators::Private::FusionState::Operation = std::shared_ptr<Circuits::IOperation<double>>

protected

Definition at line 720 of file FusionState.h.

Constructor & Destructor Documentation

◆ FusionState()

Simulators::Private::FusionState::FusionState ( std::shared_ptr< ISimulator > immediate )

inlineexplicit

Definition at line 15 of file FusionState.h.

References immediate_, and Simulators::IState::SeedAuxiliaryRng().

Referenced by CloneInto(), DensityMatrixOverlap(), and GetUpcomingRoutingOperations().

Member Function Documentation

◆ AllocateQubits()

size_t Simulators::Private::FusionState::AllocateQubits ( size_t num_qubits )

inlineoverridevirtual

Allocates qubits.

This function is called to allocate qubits.

Parameters

num_qubits The number of qubits to allocate.

Returns: The index of the first qubit allocated.

Implements Simulators::IState.

Definition at line 185 of file FusionState.h.

References Flush(), and immediate_.

◆ AllProbabilities()

std::vector< double > Simulators::Private::FusionState::AllProbabilities ( )

inlineoverridevirtual

Returns the probabilities of all possible outcomes.

Use it to obtain the probabilities of all possible outcomes.

See also: IState::Probability; IState::Amplitude; IState::Probabilities

Returns: A vector with the probabilities of all possible outcomes.

Implements Simulators::IState.

Definition at line 380 of file FusionState.h.

References immediate_.

◆ Amplitude()

std::complex< double > Simulators::Private::FusionState::Amplitude ( Types::qubit_t outcome )

inlineoverridevirtual

Returns the amplitude of the specified state.

Use it to obtain the amplitude of the specified state.

See also: IState::Probability; IState::Probabilities

Parameters

outcome The outcome to obtain the amplitude for.

Returns: The amplitude of the specified outcome.

Implements Simulators::IState.

Definition at line 362 of file FusionState.h.

References immediate_.

◆ AmplitudeRaw()

std::complex< double > Simulators::Private::FusionState::AmplitudeRaw ( Types::qubit_t outcome )

inlineoverridevirtual

Gets the amplitude.

Gets the amplitude, from the internal storage if needed. This is needed only for the composite simulator, for an optimization for qiskit aer.

Implements Simulators::IState.

Definition at line 368 of file FusionState.h.

References immediate_.

◆ ApplyAmplitudeDamping()

void Simulators::IState::ApplyAmplitudeDamping	(	Types::qubit_t	qubit,
		double	gamma )

inlineinherited

Definition at line 747 of file State.h.

References Simulators::QuantumChannel::AmplitudeDamping(), and ApplyQuantumChannel().

Referenced by ApplyT1Relaxation(), and ApplyT1RelaxationFromTime().

◆ ApplyBitFlipNoise()

void Simulators::IState::ApplyBitFlipNoise	(	Types::qubit_t	qubit,
		double	probability )

inlineinherited

Definition at line 714 of file State.h.

References ApplyQuantumChannel(), and Simulators::QuantumChannel::BitFlip().

◆ ApplyBitPhaseFlipNoise()

void Simulators::IState::ApplyBitPhaseFlipNoise	(	Types::qubit_t	qubit,
		double	probability )

inlineinherited

Definition at line 719 of file State.h.

References ApplyQuantumChannel(), and Simulators::QuantumChannel::BitPhaseFlip().

◆ ApplyCCX()

virtual void Simulators::ISimulator::ApplyCCX	(	Types::qubit_t	qubit0,
		Types::qubit_t	qubit1,
		Types::qubit_t	qubit2 )

pure virtualinherited

Applies a controlled controlled not gate to the qubits.

Applies a controlled controlled not gate to the specified qubits

Parameters

qubit0	The first control qubit
qubit1	The second control qubit
qubit2	The target qubit

Referenced by Simulators::FusionGate::Apply(), and ApplyCCX().

◆ ApplyCH()

virtual void Simulators::ISimulator::ApplyCH	(	Types::qubit_t	ctrl_qubit,
		Types::qubit_t	tgt_qubit )

pure virtualinherited

Applies a CH gate to the qubits.

Applies a controlled Hadamard gate to the specified qubits

Parameters

ctrl_qubit	The control qubit
tgt_qubit	The target qubit

Referenced by Simulators::FusionGate::Apply(), and ApplyCH().

◆ ApplyChannel()

void Simulators::IState::ApplyChannel	(	const Types::qubits_vector &	targets,
		const QuantumChannel::KrausOperators &	krausOperators )

inlineinherited

Alias matching the channel terminology used by QCSim's dense backend.

Definition at line 697 of file State.h.

References ApplyKrausChannel().

◆ ApplyCorrelatedPhaseFlipNoise() [1/2]

void Simulators::IState::ApplyCorrelatedPhaseFlipNoise	(	Types::qubit_t	qubit0,
		Types::qubit_t	qubit1,
		double	probability )

inlineinherited

Definition at line 800 of file State.h.

References ApplyQuantumChannel(), and Simulators::QuantumChannel::CorrelatedPhaseFlip().

◆ ApplyCorrelatedPhaseFlipNoise() [2/2]

void Simulators::IState::ApplyCorrelatedPhaseFlipNoise	(	Types::qubit_t	qubit0,
		Types::qubit_t	qubit1,
		double	probability,
		double	correlation )

inlineinherited

Definition at line 805 of file State.h.

References ApplyQuantumChannel(), and Simulators::QuantumChannel::CorrelatedPhaseFlip().

◆ ApplyCP()

virtual void Simulators::ISimulator::ApplyCP	(	Types::qubit_t	ctrl_qubit,
		Types::qubit_t	tgt_qubit,
		double	lambda )

pure virtualinherited

Applies a CP gate to the qubits.

Applies a controlled phase gate to the specified qubits

Parameters

ctrl_qubit	The control qubit
tgt_qubit	The target qubit
lambda	The phase shift angle.

Referenced by Simulators::FusionGate::Apply(), and ApplyCP().

◆ ApplyCRx()

virtual void Simulators::ISimulator::ApplyCRx	(	Types::qubit_t	ctrl_qubit,
		Types::qubit_t	tgt_qubit,
		double	theta )

pure virtualinherited

Applies a CRx gate to the qubits.

Applies a controlled x rotation gate to the specified qubits

Parameters

ctrl_qubit	The control qubit
tgt_qubit	The target qubit
theta	The rotation angle.

Referenced by Simulators::FusionGate::Apply(), and ApplyCRx().

◆ ApplyCRy()

virtual void Simulators::ISimulator::ApplyCRy	(	Types::qubit_t	ctrl_qubit,
		Types::qubit_t	tgt_qubit,
		double	theta )

pure virtualinherited

Applies a CRy gate to the qubits.

Applies a controlled y rotation gate to the specified qubits

Parameters

ctrl_qubit	The control qubit
tgt_qubit	The target qubit
theta	The rotation angle.

Referenced by Simulators::FusionGate::Apply(), and ApplyCRy().

◆ ApplyCRz()

virtual void Simulators::ISimulator::ApplyCRz	(	Types::qubit_t	ctrl_qubit,
		Types::qubit_t	tgt_qubit,
		double	theta )

pure virtualinherited

Applies a CRz gate to the qubits.

Applies a controlled z rotation gate to the specified qubits

Parameters

ctrl_qubit	The control qubit
tgt_qubit	The target qubit
theta	The rotation angle.

Referenced by Simulators::FusionGate::Apply(), and ApplyCRz().

◆ ApplyCSwap()

virtual void Simulators::ISimulator::ApplyCSwap	(	Types::qubit_t	ctrl_qubit,
		Types::qubit_t	qubit0,
		Types::qubit_t	qubit1 )

pure virtualinherited

Applies a controlled swap gate to the qubits.

Applies a controlled swap gate to the specified qubits

Parameters

ctrl_qubit	The control qubit
qubit0	The first qubit
qubit1	The second qubit

Referenced by Simulators::FusionGate::Apply(), and ApplyCSwap().

◆ ApplyCSx()

virtual void Simulators::ISimulator::ApplyCSx	(	Types::qubit_t	ctrl_qubit,
		Types::qubit_t	tgt_qubit )

pure virtualinherited

Applies a CSx gate to the qubits.

Applies a controlled squared root not gate to the specified qubits

Parameters

ctrl_qubit	The control qubit
tgt_qubit	The target qubit

Referenced by Simulators::FusionGate::Apply(), and ApplyCSX().

◆ ApplyCSxDAG()

virtual void Simulators::ISimulator::ApplyCSxDAG	(	Types::qubit_t	ctrl_qubit,
		Types::qubit_t	tgt_qubit )

pure virtualinherited

Applies a CSx dagger gate to the qubits.

Applies a controlled squared root not dagger gate to the specified qubits

Parameters

ctrl_qubit	The control qubit
tgt_qubit	The target qubit

Referenced by Simulators::FusionGate::Apply(), and ApplyCSXDG().

◆ ApplyCU()

virtual void Simulators::ISimulator::ApplyCU	(	Types::qubit_t	ctrl_qubit,
		Types::qubit_t	tgt_qubit,
		double	theta,
		double	phi,
		double	lambda,
		double	gamma )

pure virtualinherited

Applies a controlled U gate to the qubits.

Applies a controlled U gate to the specified qubits

Parameters

ctrl_qubit	The control qubit
tgt_qubit	The target qubit
theta	Theta parameter for the U gate
phi	Phi parameter for the U gate
lambda	Lambda parameter for the U gate
gamma	Gamma parameter for the U gate

Referenced by Simulators::FusionGate::Apply(), and ApplyCU().

◆ ApplyCX()

virtual void Simulators::ISimulator::ApplyCX	(	Types::qubit_t	ctrl_qubit,
		Types::qubit_t	tgt_qubit )

pure virtualinherited

Applies a CX gate to the qubits.

Applies a controlled X gate to the specified qubits

Parameters

ctrl_qubit	The control qubit
tgt_qubit	The target qubit

Referenced by Simulators::FusionGate::Apply(), and ApplyCX().

◆ ApplyCY()

virtual void Simulators::ISimulator::ApplyCY	(	Types::qubit_t	ctrl_qubit,
		Types::qubit_t	tgt_qubit )

pure virtualinherited

Applies a CY gate to the qubits.

Applies a controlled Y gate to the specified qubits

Parameters

ctrl_qubit	The control qubit
tgt_qubit	The target qubit

Referenced by Simulators::FusionGate::Apply(), and ApplyCY().

◆ ApplyCZ()

virtual void Simulators::ISimulator::ApplyCZ	(	Types::qubit_t	ctrl_qubit,
		Types::qubit_t	tgt_qubit )

pure virtualinherited

Applies a CZ gate to the qubits.

Applies a controlled Z gate to the specified qubits

Parameters

ctrl_qubit	The control qubit
tgt_qubit	The target qubit

Referenced by Simulators::FusionGate::Apply(), and ApplyCZ().

◆ ApplyDephasingNoise()

void Simulators::IState::ApplyDephasingNoise	(	Types::qubit_t	qubit,
		double	probability )

inlineinherited

Noise.h dephasing is a stochastic phase flip, not phase damping.

Definition at line 730 of file State.h.

References ApplyPhaseFlipNoise().

◆ ApplyDepolarizingMixingNoise()

void Simulators::IState::ApplyDepolarizingMixingNoise	(	Types::qubit_t	qubit,
		double	mixingProbability )

inlineinherited

Depolarizing replacement (1-p)rho + p I/2, fully mixed at p=1.

Definition at line 742 of file State.h.

References ApplyQuantumChannel(), and Simulators::QuantumChannel::DepolarizingMixing().

◆ ApplyDepolarizingNoise()

void Simulators::IState::ApplyDepolarizingNoise	(	Types::qubit_t	qubit,
		double	errorProbability )

inlineinherited

Depolarizing noise using total nonidentity-Pauli probability p.

Definition at line 736 of file State.h.

References ApplyQuantumChannel(), and Simulators::QuantumChannel::Depolarizing().

◆ ApplyGeneralizedAmplitudeDamping()

void Simulators::IState::ApplyGeneralizedAmplitudeDamping	(	Types::qubit_t	qubit,
		double	gamma,
		double	excitedStatePopulation )

inlineinherited

Definition at line 790 of file State.h.

References ApplyQuantumChannel(), and Simulators::QuantumChannel::GeneralizedAmplitudeDamping().

◆ ApplyGenericOneQubitGate()

virtual void Simulators::ISimulator::ApplyGenericOneQubitGate	(	Types::qubit_t	qubit,
		const Eigen::Matrix2cd &	gate )

pure virtualinherited

Apply a generic one-qubit gate to the specified qubit.

Parameters

qubit	The qubit to apply the gate to.
gate	The 2x2 matrix representing the gate.

Referenced by Simulators::FusionGate::Apply().

◆ ApplyGenericThreeQubitGate()

virtual void Simulators::ISimulator::ApplyGenericThreeQubitGate	(	Types::qubit_t	,
		Types::qubit_t	,
		Types::qubit_t	,
		const Matrix8cd &	)

inlinevirtualinherited

Definition at line 67 of file Simulator.h.

Referenced by Simulators::FusionGate::Apply().

◆ ApplyGenericTwoQubitGate()

virtual void Simulators::ISimulator::ApplyGenericTwoQubitGate	(	Types::qubit_t	qubit0,
		Types::qubit_t	qubit1,
		const Eigen::Matrix4cd &	gate )

pure virtualinherited

Apply a generic two-qubit gate to the specified qubits.

Parameters

qubit0	The first qubit to apply the gate to.
qubit1	The second qubit to apply the gate to.
gate	The 4x4 matrix representing the gate.

Referenced by Simulators::FusionGate::Apply().

◆ ApplyH()

virtual void Simulators::ISimulator::ApplyH ( Types::qubit_t qubit )

pure virtualinherited

Applies a Hadamard gate to the qubit.

Applies a Hadamard gate to the specified qubit

Parameters

qubit The qubit to apply the gate to.

Referenced by Simulators::FusionGate::Apply(), and ApplyH().

◆ ApplyK()

virtual void Simulators::ISimulator::ApplyK ( Types::qubit_t qubit )

pure virtualinherited

Applies a K gate to the qubit.

Applies a K (Hy) gate to the specified qubit

Parameters

qubit The qubit to apply the gate to.

Referenced by Simulators::FusionGate::Apply(), and ApplyK().

◆ ApplyKrausChannel()

void Simulators::IState::ApplyKrausChannel	(	const Types::qubits_vector &	targets,
		const QuantumChannel::KrausOperators &	krausOperators )

inlineinherited

Apply an arbitrary CPTP map supplied in Kraus form.

Definition at line 691 of file State.h.

References ApplyQuantumChannel().

Referenced by ApplyChannel().

◆ ApplyNop()

virtual void Simulators::ISimulator::ApplyNop ( )

pure virtualinherited

Applies a nop.

Applies a nop (no operation). Typically does (almost) nothing. Equivalent to an identity. For qiskit aer it will send the 'nop' to the qiskit aer simulator.

◆ ApplyOperator()

void Simulators::Private::FusionState::ApplyOperator	(	const Types::qubits_vector &	qubits,
		const Eigen::MatrixXcd &	matrix,
		bool	normalize = false )

inlineoverridevirtual

Reimplemented from Simulators::IState.

Definition at line 474 of file FusionState.h.

References Flush(), immediate_, and Simulators::IState::NotifyObservers().

◆ ApplyP()

virtual void Simulators::ISimulator::ApplyP	(	Types::qubit_t	qubit,
		double	lambda )

pure virtualinherited

Applies a phase shift gate to the qubit.

Applies a specified phase shift gate to the qubit

Parameters

qubit	The qubit to apply the gate to.
lambda	The phase shift angle.

Referenced by Simulators::FusionGate::Apply(), and ApplyP().

◆ ApplyPauliChannel() [1/2]

void Simulators::IState::ApplyPauliChannel	(	const Types::qubits_vector &	targets,
		const std::vector< double > &	probabilities )

inlineinherited

Apply an arbitrary one- or two-qubit Pauli channel.

Definition at line 703 of file State.h.

References ApplyQuantumChannel(), and Simulators::QuantumChannel::Pauli().

◆ ApplyPauliChannel() [2/2]

void Simulators::IState::ApplyPauliChannel	(	Types::qubit_t	qubit,
		double	px,
		double	py,
		double	pz )

inlineinherited

Apply a single-qubit Pauli channel specified by X/Y/Z probabilities.

Definition at line 709 of file State.h.

References ApplyQuantumChannel(), and Simulators::QuantumChannel::Pauli().

◆ ApplyPhaseDamping()

void Simulators::IState::ApplyPhaseDamping	(	Types::qubit_t	qubit,
		double	gamma )

inlineinherited

Phase damping with coherence multiplier sqrt(1-gamma).

Definition at line 770 of file State.h.

References ApplyQuantumChannel(), and Simulators::QuantumChannel::PhaseDamping().

Referenced by ApplyPhaseDampingFromTime().

◆ ApplyPhaseDampingFromTime()

void Simulators::IState::ApplyPhaseDampingFromTime	(	Types::qubit_t	qubit,
		double	duration,
		double	tPhi )

inlineinherited

Pure phase damping for a physical duration and T_phi.

gamma=1-exp(-2 duration/T_phi), so coherences decay as exp(-duration/T_phi).

Definition at line 780 of file State.h.

References ApplyPhaseDamping().

◆ ApplyPhaseFlipNoise()

void Simulators::IState::ApplyPhaseFlipNoise	(	Types::qubit_t	qubit,
		double	probability )

inlineinherited

Definition at line 724 of file State.h.

References ApplyQuantumChannel(), and Simulators::QuantumChannel::PhaseFlip().

Referenced by ApplyDephasingNoise().

◆ ApplyQuantumChannel()

void Simulators::Private::FusionState::ApplyQuantumChannel	(	const Types::qubits_vector &	targets,
		const QuantumChannel &	channel )

inlineoverridevirtual

Applies a local CPTP quantum channel to one or two qubits.

The order of target qubits has the same matrix convention as ApplyGenericTwoQubitGate: targets[0] is the least-significant local basis bit. Backends that do not represent mixed states exactly throw.

Reimplemented from Simulators::IState.

Definition at line 265 of file FusionState.h.

References ConsumeBoundary(), Flush(), immediate_, Circuits::kQuantumChannel, and Simulators::IState::NotifyObservers().

◆ ApplyReset()

void Simulators::Private::FusionState::ApplyReset ( const Types::qubits_vector & qubits )

inlineoverridevirtual

Performs a reset of the specified qubits.

Measures the qubits and for those that are 1, applies X on them

Parameters

qubits A vector with the qubits to be reset.

Implements Simulators::IState.

Definition at line 257 of file FusionState.h.

References ConsumeBoundary(), Flush(), immediate_, Circuits::kReset, and Simulators::IState::NotifyObservers().

◆ ApplyRx()

virtual void Simulators::ISimulator::ApplyRx	(	Types::qubit_t	qubit,
		double	theta )

pure virtualinherited

Applies a Rx gate to the qubit.

Applies an x rotation gate to the specified qubit

Parameters

qubit	The qubit to apply the gate to.
theta	The rotation angle.

Referenced by Simulators::FusionGate::Apply(), and ApplyRx().

◆ ApplyRy()

virtual void Simulators::ISimulator::ApplyRy	(	Types::qubit_t	qubit,
		double	theta )

pure virtualinherited

Applies a Ry gate to the qubit.

Applies a y rotation gate to the specified qubit

Parameters

qubit	The qubit to apply the gate to.
theta	The rotation angle.

Referenced by Simulators::FusionGate::Apply(), and ApplyRy().

◆ ApplyRz()

virtual void Simulators::ISimulator::ApplyRz	(	Types::qubit_t	qubit,
		double	theta )

pure virtualinherited

Applies a Rz gate to the qubit.

Applies a z rotation gate to the specified qubit

Parameters

qubit	The qubit to apply the gate to.
theta	The rotation angle.

Referenced by Simulators::FusionGate::Apply(), and ApplyRz().

◆ ApplyS()

virtual void Simulators::ISimulator::ApplyS ( Types::qubit_t qubit )

pure virtualinherited

Applies a S gate to the qubit.

Applies a S gate to the specified qubit

Parameters

qubit The qubit to apply the gate to.

Referenced by Simulators::FusionGate::Apply(), and ApplyS().

◆ ApplySDG()

virtual void Simulators::ISimulator::ApplySDG ( Types::qubit_t qubit )

pure virtualinherited

Applies a S dagger gate to the qubit.

Applies a S dagger gate to the specified qubit

Parameters

qubit The qubit to apply the gate to.

Referenced by Simulators::FusionGate::Apply(), and ApplySDG().

◆ ApplySwap()

virtual void Simulators::ISimulator::ApplySwap	(	Types::qubit_t	qubit0,
		Types::qubit_t	qubit1 )

pure virtualinherited

Applies a swap gate to the qubits.

Applies a swap gate to the specified qubits

Parameters

qubit0	The first qubit
qubit1	The second qubit

Referenced by Simulators::FusionGate::Apply(), and ApplySwap().

◆ ApplySx()

virtual void Simulators::ISimulator::ApplySx ( Types::qubit_t qubit )

pure virtualinherited

Applies a Sx gate to the qubit.

Applies a Sx gate to the specified qubit

Parameters

qubit The qubit to apply the gate to.

Referenced by Simulators::FusionGate::Apply(), and ApplySX().

◆ ApplySxDAG()

virtual void Simulators::ISimulator::ApplySxDAG ( Types::qubit_t qubit )

pure virtualinherited

Applies a Sx dagger gate to the qubit.

Applies a Sx dagger gate to the specified qubit

Parameters

qubit The qubit to apply the gate to.

Referenced by Simulators::FusionGate::Apply(), and ApplySXDG().

◆ ApplyT()

virtual void Simulators::ISimulator::ApplyT ( Types::qubit_t qubit )

pure virtualinherited

Applies a T gate to the qubit.

Applies a T gate to the specified qubit

Parameters

qubit The qubit to apply the gate to.

Referenced by Simulators::FusionGate::Apply(), and ApplyT().

◆ ApplyT1Relaxation()

void Simulators::IState::ApplyT1Relaxation	(	Types::qubit_t	qubit,
		double	gamma )

inlineinherited

Alias for the exact T1 amplitude-damping channel.

Definition at line 753 of file State.h.

References ApplyAmplitudeDamping().

◆ ApplyT1RelaxationFromTime()

void Simulators::IState::ApplyT1RelaxationFromTime	(	Types::qubit_t	qubit,
		double	duration,
		double	t1 )

inlineinherited

Exact T1 relaxation for a physical duration and time constant.

Definition at line 759 of file State.h.

References ApplyAmplitudeDamping().

◆ ApplyTDG()

virtual void Simulators::ISimulator::ApplyTDG ( Types::qubit_t qubit )

pure virtualinherited

Applies a T dagger gate to the qubit.

Applies a T dagger gate to the specified qubit

Parameters

qubit The qubit to apply the gate to.

Referenced by Simulators::FusionGate::Apply(), and ApplyTDG().

◆ ApplyThermalRelaxation()

void Simulators::IState::ApplyThermalRelaxation	(	Types::qubit_t	qubit,
		double	duration,
		double	t1,
		double	t2,
		double	excitedStatePopulation = 0.0 )

inlineinherited

Definition at line 795 of file State.h.

References ApplyQuantumChannel(), and Simulators::QuantumChannel::ThermalRelaxation().

◆ ApplyTwoQubitDepolarizingMixingNoise()

void Simulators::IState::ApplyTwoQubitDepolarizingMixingNoise	(	Types::qubit_t	qubit0,
		Types::qubit_t	qubit1,
		double	mixingProbability )

inlineinherited

Definition at line 815 of file State.h.

References ApplyQuantumChannel(), and Simulators::QuantumChannel::TwoQubitDepolarizingMixing().

◆ ApplyTwoQubitDepolarizingNoise()

void Simulators::IState::ApplyTwoQubitDepolarizingNoise	(	Types::qubit_t	qubit0,
		Types::qubit_t	qubit1,
		double	errorProbability )

inlineinherited

Definition at line 810 of file State.h.

References ApplyQuantumChannel(), and Simulators::QuantumChannel::TwoQubitDepolarizing().

◆ ApplyU()

virtual void Simulators::ISimulator::ApplyU	(	Types::qubit_t	qubit,
		double	theta,
		double	phi,
		double	lambda,
		double	gamma )

pure virtualinherited

Applies a U gate to the qubit.

Applies a U gate to the specified qubit

Parameters

qubit	The qubit to apply the gate to.
theta	The first parameter.
phi	The second parameter.
lambda	The third parameter.
gamma	The fourth parameter.

Referenced by Simulators::FusionGate::Apply(), and ApplyU().

◆ ApplyX()

virtual void Simulators::ISimulator::ApplyX ( Types::qubit_t qubit )

pure virtualinherited

Applies a not gate to the qubit.

Applies a not (X) gate to the specified qubit

Parameters

qubit The qubit to apply the gate to.

Referenced by Simulators::FusionGate::Apply(), ApplyX(), InitializeToBasisState(), and InitializeToBasisState().

◆ ApplyY()

virtual void Simulators::ISimulator::ApplyY ( Types::qubit_t qubit )

pure virtualinherited

Applies a Y gate to the qubit.

Applies a not (Y) gate to the specified qubit

Parameters

qubit The qubit to apply the gate to.

Referenced by Simulators::FusionGate::Apply(), and ApplyY().

◆ ApplyZ()

virtual void Simulators::ISimulator::ApplyZ ( Types::qubit_t qubit )

pure virtualinherited

Applies a Z gate to the qubit.

Applies a not (Z) gate to the specified qubit

Parameters

qubit The qubit to apply the gate to.

Referenced by Simulators::FusionGate::Apply(), and ApplyZ().

◆ Clear()

void Simulators::Private::FusionState::Clear ( )

inlineoverridevirtual

Clears the state.

Sets the number of allocated qubits to 0 and clears the state. After this qubits allocation is required then calling IState::AllocateQubits in order to use the simulator.

Implements Simulators::IState.

Definition at line 172 of file FusionState.h.

References immediate_.

◆ ClearObservers()

void Simulators::IState::ClearObservers ( )

inlineinherited

Clears all observers.

Definition at line 995 of file State.h.

◆ Clone()

virtual std::unique_ptr< ISimulator > Simulators::ISimulator::Clone ( )

pure virtualinherited

Clones the simulator.

Clones the simulator, including the state, the configuration and the internally saved state, if any. Does not copy the observers. Should be used mainly internally, to optimise multiple shots execution, copying the state from the simulator used for timing.

Returns: A unique pointer to the cloned simulator.

Referenced by CloneForExecution().

◆ CloneForExecution()

virtual std::unique_ptr< ISimulator > Simulators::ISimulator::CloneForExecution ( uint64_t seed )

inlinevirtualinherited

Definition at line 426 of file Simulator.h.

References Clone().

◆ CloneInto()

void Simulators::Private::FusionState::CloneInto	(	FusionState &	copy,
		const uint64_t *	executionSeed = nullptr )

inlineprotected

Definition at line 723 of file FusionState.h.

References FusionState(), Flush(), Simulators::ISimulator::GetGateFusionMaxQubits(), GetSimulationType(), GetType(), immediate_, IsGateFusionEnabled(), Simulators::kMatrixProductOperator, Simulators::kMatrixProductState, Simulators::kQCSim, Simulators::IState::SeedAuxiliaryRng(), and Simulators::GateFusion< Gate >::SetWidth().

◆ Configure()

void Simulators::Private::FusionState::Configure	(	const char *	key,
		const char *	value )

inlineoverridevirtual

Configures the state.

This function is called to configure the simulator. Currently only aer supports configuration, qcsim will gracefully ignore this.

Parameters

key	The key of the configuration option.
value	The value of the configuration.

Implements Simulators::IState.

Definition at line 40 of file FusionState.h.

References Flush(), Simulators::ISimulator::GetGateFusionMaxQubits(), immediate_, IsGateFusionEnabled(), IsRoutingLookaheadEnabled(), and Simulators::IState::SeedAuxiliaryRng().

◆ ConsumeBoundary()

void Simulators::Private::FusionState::ConsumeBoundary ( Circuits::OperationType type )

inlineprotected

Definition at line 837 of file FusionState.h.

References GetType(), and immediate_.

Referenced by ApplyQuantumChannel(), ApplyReset(), Measure(), and MeasureMany().

◆ DefaultGateFusionMinQubits()

virtual size_t Simulators::Private::FusionState::DefaultGateFusionMinQubits ( ) const

inlineprotectedvirtual

Definition at line 695 of file FusionState.h.

Referenced by IsGateFusionEnabled().

◆ DensityMatrixElementBits()

std::complex< double > Simulators::Private::FusionState::DensityMatrixElementBits	(	const std::vector< bool > &	row,
		const std::vector< bool > &	col ) const

inlineoverridevirtual

Reimplemented from Simulators::IState.

Definition at line 448 of file FusionState.h.

References immediate_.

◆ DensityMatrixHermiticityResidual()

double Simulators::Private::FusionState::DensityMatrixHermiticityResidual ( ) const

inlineoverridevirtual

Reimplemented from Simulators::IState.

Definition at line 509 of file FusionState.h.

References immediate_.

◆ DensityMatrixOverlap()

std::complex< double > Simulators::Private::FusionState::DensityMatrixOverlap ( const IState & other ) const

inlineoverridevirtual

Reimplemented from Simulators::IState.

Definition at line 273 of file FusionState.h.

References FusionState(), and immediate_.

◆ DensityMatrixPurity()

double Simulators::Private::FusionState::DensityMatrixPurity ( ) const

inlineoverridevirtual

Reimplemented from Simulators::IState.

Definition at line 497 of file FusionState.h.

References immediate_.

◆ DensityMatrixTrace()

std::complex< double > Simulators::Private::FusionState::DensityMatrixTrace ( ) const

inlineoverridevirtual

Mixed-state diagnostics.

Implemented by density-matrix and MPO backends.

Reimplemented from Simulators::IState.

Definition at line 491 of file FusionState.h.

References immediate_.

◆ DensityMatrixTraceOfSquare()

std::complex< double > Simulators::Private::FusionState::DensityMatrixTraceOfSquare ( ) const

inlineoverridevirtual

Reimplemented from Simulators::IState.

Definition at line 503 of file FusionState.h.

References immediate_.

◆ DeriveSeed()

uint64_t Simulators::IState::DeriveSeed	(	uint64_t	seed,
		uint64_t	stream )

inlinestaticinherited

Definition at line 162 of file State.h.

References Utils::RandomStream::Derive().

Referenced by Circuits::Circuit< Time >::CloneForExecution(), Circuits::Random< Time >::CloneForExecution(), Network::ExecuteJob< Time >::DoWork(), Network::SimpleDisconnectedNetwork< Time, Controller >::ExecuteLogicalShotBlocks(), Network::SimpleDisconnectedNetwork< Time, Controller >::RepeatedExecute(), Network::SimpleDisconnectedNetwork< Time, Controller >::RepeatedExecuteOnHost(), and SeedAuxiliaryRng().

◆ DontNotify()

void Simulators::IState::DontNotify ( )

inlineprotectedinherited

Stops notifying observers.

Use it to stop notifying observers until Notify is called.

Definition at line 1175 of file State.h.

◆ ExpectationValue()

double Simulators::Private::FusionState::ExpectationValue ( const std::string & pauliString )

inlineoverridevirtual

Returns the expected value of a Pauli string.

Use it to obtain the expected value of a Pauli string. The Pauli string is a string of characters representing the Pauli operators, e.g. "XIZY". The length of the string should be less or equal to the number of qubits (if it's less, it's completed with I).

Parameters

pauliString The Pauli string to obtain the expected value for.

Returns: The expected value of the specified Pauli string.

Implements Simulators::IState.

Definition at line 424 of file FusionState.h.

References immediate_.

◆ ExpectationValueComplex()

std::complex< double > Simulators::Private::FusionState::ExpectationValueComplex	(	const std::string &	pauli,
		bool	normalized = true ) const

inlineoverridevirtual

Reimplemented from Simulators::IState.

Definition at line 460 of file FusionState.h.

References immediate_.

◆ ExpectationValueOperators()

std::complex< double > Simulators::Private::FusionState::ExpectationValueOperators	(	const Types::qubits_vector &	qubits,
		const std::vector< Eigen::MatrixXcd > &	matrices )

inlineoverridevirtual

Reimplemented from Simulators::IState.

Definition at line 392 of file FusionState.h.

References immediate_.

◆ ExpectationValues()

std::vector< double > Simulators::Private::FusionState::ExpectationValues ( const std::vector< std::string > & paulis )

inlineoverridevirtual

Reimplemented from Simulators::IState.

Definition at line 416 of file FusionState.h.

References immediate_.

◆ ExpectationValuesComplex()

std::vector< std::complex< double > > Simulators::Private::FusionState::ExpectationValuesComplex	(	const std::vector< std::string > &	paulis,
		bool	normalized = true ) const

inlineoverridevirtual

Reimplemented from Simulators::IState.

Definition at line 466 of file FusionState.h.

References immediate_.

◆ FidelityWithStatevector()

double Simulators::Private::FusionState::FidelityWithStatevector ( const Eigen::VectorXcd & psi ) const

inlineoverridevirtual

Reimplemented from Simulators::IState.

Definition at line 527 of file FusionState.h.

References immediate_.

◆ Flush()

void Simulators::Private::FusionState::Flush ( )

inlineoverridevirtual

Flushes the applied operations.

This function is called to flush the applied operations. qcsim applies them right away, so this has no effect on it, but qiskit aer does not.

Implements Simulators::IState.

Definition at line 95 of file FusionState.h.

References FlushPendingGates(), and immediate_.

Referenced by AllocateQubits(), ApplyOperator(), ApplyQuantumChannel(), ApplyReset(), CloneInto(), Configure(), HermitizeDensityMatrix(), Measure(), MeasureMany(), MoveAtBeginningOfChain(), ReCanonicalize(), RestoreDensityMatrixTrace(), RestoreInternalDestructiveSavedState(), RestoreState(), SaveState(), SaveStateToInternalDestructive(), setGrowthFactorGate(), setGrowthFactorSwap(), SetInitialQubitsMap(), SetMultithreading(), SetSeed(), SetUpcomingGates(), and Trim().

◆ FlushPendingGates()

void Simulators::Private::FusionState::FlushPendingGates ( )

inlineoverridevirtual

Reimplemented from Simulators::ISimulator.

Definition at line 90 of file FusionState.h.

Referenced by Flush(), SetGatesCounter(), and SubmitGate().

◆ GetConfigMap()

const std::unordered_map< std::string, std::string > & Simulators::Private::FusionState::GetConfigMap ( ) const

inlineoverridevirtual

Implements Simulators::IState.

Definition at line 76 of file FusionState.h.

References immediate_.

◆ GetConfiguration()

std::string Simulators::Private::FusionState::GetConfiguration ( const char * key ) const

inlineoverridevirtual

Returns configuration value.

This function is called get a configuration value.

Parameters

key	The key of the configuration value.

Returns: The configuration value as a string.

Implements Simulators::IState.

Definition at line 69 of file FusionState.h.

References immediate_.

◆ GetCurrentMaxBondDimension()

size_t Simulators::Private::FusionState::GetCurrentMaxBondDimension ( ) const

inlineoverridevirtual

Returns the maximum bond dimension reached.

Returns the maximum bond dimension reached during execution, if applicable (mps simulator, either qcsim or gpu).

Reimplemented from Simulators::IState.

Definition at line 285 of file FusionState.h.

References immediate_.

◆ GetDensityMatrix()

Eigen::MatrixXcd Simulators::Private::FusionState::GetDensityMatrix ( bool normalized = true ) const

inlineoverridevirtual

Reimplemented from Simulators::IState.

Definition at line 454 of file FusionState.h.

References immediate_.

◆ GetExecutedMaxBondDimension()

size_t Simulators::Private::FusionState::GetExecutedMaxBondDimension ( ) const

inlineoverridevirtual

Reimplemented from Simulators::IState.

Definition at line 291 of file FusionState.h.

References immediate_.

◆ GetGateFusionMaxQubits()

virtual unsigned Simulators::ISimulator::GetGateFusionMaxQubits ( ) const

inlinevirtualinherited

Definition at line 46 of file Simulator.h.

Referenced by Simulators::Private::FusionState::CloneInto(), Simulators::Private::FusionState::Configure(), Simulators::Private::FusionState::IsGateFusionEnabled(), and Simulators::Private::FusionState::SubmitGate().

◆ GetGateFusionStatistics()

GateFusionStatistics Simulators::Private::FusionState::GetGateFusionStatistics ( ) const

inlineoverridevirtual

Reimplemented from Simulators::ISimulator.

Definition at line 22 of file FusionState.h.

◆ GetGatesCounter()

long long Simulators::Private::FusionState::GetGatesCounter ( ) const

inlineoverridevirtual

Returns the gates counter.

Usually does nothing, except for MPS simulators that support swap optimization.

Returns: The number of gates executed in the circuit.

Reimplemented from Simulators::IState.

Definition at line 128 of file FusionState.h.

◆ GetGpuDevice()

int Simulators::Private::FusionState::GetGpuDevice ( ) const

inlineoverridevirtual

Reimplemented from Simulators::ISimulator.

Definition at line 311 of file FusionState.h.

References immediate_.

◆ getGrowthFactorGate()

double Simulators::Private::FusionState::getGrowthFactorGate ( ) const

inlineoverridevirtual

Reimplemented from Simulators::IState.

Definition at line 351 of file FusionState.h.

References immediate_.

◆ getGrowthFactorSwap()

double Simulators::Private::FusionState::getGrowthFactorSwap ( ) const

inlineoverridevirtual

Reimplemented from Simulators::IState.

Definition at line 346 of file FusionState.h.

References immediate_.

◆ GetMultithreading()

bool Simulators::Private::FusionState::GetMultithreading ( ) const

inlineoverridevirtual

Get the multithreading flag.

Returns the multithreading flag.

Returns: The multithreading flag.

Implements Simulators::IState.

Definition at line 321 of file FusionState.h.

References immediate_.

◆ GetNumberOfQubits()

size_t Simulators::Private::FusionState::GetNumberOfQubits ( ) const

inlineoverridevirtual

Returns the number of qubits.

This function is called to obtain the number of the allocated qubits.

Returns: The number of qubits.

Implements Simulators::IState.

Definition at line 296 of file FusionState.h.

References immediate_.

Referenced by Initialize(), IsGateFusionEnabled(), and SubmitGate().

◆ getptr()

std::shared_ptr< ISimulator > Simulators::ISimulator::getptr ( )

inlineinherited

Get a shared pointer to this object.

Returns a shared pointer to this object. The object needs to be already wrapped in a shared pointer.

Returns: A shared pointer to this object.

Definition at line 440 of file Simulator.h.

◆ GetSimulationType()

SimulationType Simulators::Private::FusionState::GetSimulationType ( ) const

inlineoverridevirtual

Returns the type of simulation.

Returns: The type of simulation.

See also: SimulationType

Implements Simulators::IState.

Definition at line 306 of file FusionState.h.

References immediate_.

Referenced by CloneInto(), and GetUpcomingRoutingOperations().

◆ GetStateVector()

std::vector< std::complex< double > > Simulators::Private::FusionState::GetStateVector ( )

inlineoverridevirtual

Reimplemented from Simulators::IState.

Definition at line 386 of file FusionState.h.

References immediate_.

◆ GetType()

SimulatorType Simulators::Private::FusionState::GetType ( ) const

inlineoverridevirtual

Returns the type of simulator.

Returns: The type of simulator.

See also: SimulatorType

Implements Simulators::IState.

Definition at line 301 of file FusionState.h.

References immediate_.

Referenced by CloneInto(), and ConsumeBoundary().

◆ GetUpcomingRoutingOperations()

const std::vector< std::shared_ptr< Circuits::IOperation< double > > > & Simulators::Private::FusionState::GetUpcomingRoutingOperations ( ) const

inlineoverridevirtual

Reimplemented from Simulators::IState.

Definition at line 111 of file FusionState.h.

References FusionState(), GetSimulationType(), IsGateFusionEnabled(), Simulators::kMatrixProductOperator, and Simulators::kMatrixProductState.

◆ HermitizeDensityMatrix()

void Simulators::Private::FusionState::HermitizeDensityMatrix ( )

inlineoverridevirtual

Reimplemented from Simulators::IState.

Definition at line 539 of file FusionState.h.

References Flush(), and immediate_.

◆ IncrementGatesCounter()

void Simulators::Private::FusionState::IncrementGatesCounter ( )

inlineoverridevirtual

Increments the gates counter.

Usually does nothing, except for MPS simulators that support swap optimization. Increments the position in the circuit from where the execution should continue. Useful for classically controlled gates, for the case when the controlled gate is not executed.

Reimplemented from Simulators::IState.

Definition at line 152 of file FusionState.h.

References SetGatesCounter().

◆ InitializationPreservesSnapshots()

virtual bool Simulators::Private::FusionState::InitializationPreservesSnapshots ( ) const

inlineprotectedvirtual

Definition at line 705 of file FusionState.h.

Referenced by Initialize().

◆ Initialize()

void Simulators::Private::FusionState::Initialize ( )

inlineoverridevirtual

Initializes the state.

This function is called when the simulator is initialized. Call it after the qubits allocation.

See also: IState::AllocateQubits

Implements Simulators::IState.

Definition at line 157 of file FusionState.h.

References GetNumberOfQubits(), immediate_, and InitializationPreservesSnapshots().

◆ InitializeState() [1/3]

void Simulators::Private::FusionState::InitializeState	(	size_t	num_qubits,
		AER::Vector< std::complex< double > > &	amplitudes )

inlineoverridevirtual

Initializes the state.

This function is called when the simulator is initialized. Call it only on a non-initialized state. This is good only for a statevector simulator and should be used only by calling from a composite simulator.

Parameters

num_qubits	The number of qubits to initialize the state with.
amplitudes	A vector with the amplitudes to initialize the state with.

Implements Simulators::IState.

Definition at line 619 of file FusionState.h.

References immediate_.

◆ InitializeState() [2/3]

void Simulators::Private::FusionState::InitializeState	(	size_t	num_qubits,
		Eigen::VectorXcd &	amplitudes )

inlineoverridevirtual

Initializes the state.

This function is called when the simulator is initialized. Call it only on a non-initialized state. This is good only for a statevector simulator and should be used only by calling from a composite simulator.

Parameters

num_qubits	The number of qubits to initialize the state with.
amplitudes	A vector with the amplitudes to initialize the state with.

Implements Simulators::IState.

Definition at line 631 of file FusionState.h.

References immediate_.

◆ InitializeState() [3/3]

void Simulators::Private::FusionState::InitializeState	(	size_t	num_qubits,
		std::vector< std::complex< double > > &	amplitudes )

inlineoverridevirtual

Initializes the state.

This function is called when the simulator is initialized. Call it only on a non-initialized state. This is good only for a statevector simulator and should be used only by calling from a composite simulator.

Parameters

num_qubits	The number of qubits to initialize the state with.
amplitudes	A vector with the amplitudes to initialize the state with.

Implements Simulators::IState.

Definition at line 607 of file FusionState.h.

References immediate_.

◆ InitializeToBasisState() [1/2]

void Simulators::Private::FusionState::InitializeToBasisState	(	size_t	num_qubits,
		const std::vector< bool > &	basisState )

inlineoverridevirtual

Initializes the state to a computational basis state.

Same as the Types::qubit_t overload, but the basis state is given as one bool per qubit so it is not limited to 64 qubits.

Parameters

num_qubits	The number of qubits to initialize the state with.
basisState	The computational basis state, entry i selects qubit i.

Reimplemented from Simulators::IState.

Definition at line 655 of file FusionState.h.

References immediate_.

◆ InitializeToBasisState() [2/2]

void Simulators::Private::FusionState::InitializeToBasisState	(	size_t	num_qubits,
		Types::qubit_t	basisState )

inlineoverridevirtual

Initializes the state to a computational basis state.

Call it only on a non-initialized state, it allocates the qubits and initializes the state itself. Every simulator supports this: backends with a direct primitive (density matrix, matrix product operator, matrix product state, statevector) use it; ISimulator provides a generic fallback (reset to |0...0>, then apply X on every set bit) for the rest.

Don't use it for more than 64 qubits, as the basis state is packed in a single Types::qubit_t; use the std::vector<bool> overload instead, which the matrix product operator and matrix product state backends (the only ones that can scale that far) support natively.

Parameters

num_qubits	The number of qubits to initialize the state with.
basisState	The computational basis state, bit i selects qubit i.

Reimplemented from Simulators::IState.

Definition at line 643 of file FusionState.h.

References immediate_.

◆ InitializeToMixtureOfBasisStates() [1/2]

void Simulators::Private::FusionState::InitializeToMixtureOfBasisStates	(	size_t	num_qubits,
		const std::vector< std::pair< std::vector< bool >, double > > &	mixture )

inlineoverridevirtual

Initializes the state to a classical mixture of computational basis states.

Same as the Types::qubit_t-keyed overload, but each basis state is given as one bool per qubit so it is not limited to 64 qubits. Currently only the matrix product operator backend supports this.

Parameters

num_qubits	The number of qubits to initialize the state with.
mixture	The mixture, as pairs of (basis state, weight).

Reimplemented from Simulators::IState.

Definition at line 679 of file FusionState.h.

References immediate_.

◆ InitializeToMixtureOfBasisStates() [2/2]

void Simulators::Private::FusionState::InitializeToMixtureOfBasisStates	(	size_t	num_qubits,
		const std::vector< std::pair< Types::qubit_t, double > > &	mixture )

inlineoverridevirtual

Initializes the state to a classical mixture of computational basis states.

Sets the state to rho = sum_k weights[k] |states[k]><states[k]|. Call it only on a non-initialized state, it allocates the qubits and initializes the state itself. Weights are normalized so the trace is 1; only backends that can represent a mixed state support this - currently the density matrix and matrix product operator backends. Other backends throw, and there is no generic fallback: unlike a basis state, a mixture cannot be reached with unitary gates alone.

Don't use it for more than 64 qubits, as each basis state is packed in a single Types::qubit_t; use the std::vector<bool>-keyed overload instead for the matrix product operator backend, which can scale that far.

Parameters

num_qubits	The number of qubits to initialize the state with.
mixture	The mixture, as pairs of (basis state, weight).

Reimplemented from Simulators::IState.

Definition at line 667 of file FusionState.h.

References immediate_.

◆ IsDensityMatrixHermitian()

bool Simulators::Private::FusionState::IsDensityMatrixHermitian ( double eps = 1e-10 ) const

inlineoverridevirtual

Reimplemented from Simulators::IState.

Definition at line 515 of file FusionState.h.

References immediate_.

◆ IsGateFusionEnabled()

bool Simulators::Private::FusionState::IsGateFusionEnabled ( ) const

inlineoverridevirtual

Reimplemented from Simulators::ISimulator.

Definition at line 30 of file FusionState.h.

References DefaultGateFusionMinQubits(), Simulators::ISimulator::GetGateFusionMaxQubits(), and GetNumberOfQubits().

Referenced by CloneInto(), Configure(), GetUpcomingRoutingOperations(), and SubmitGate().

◆ IsQcsim()

bool Simulators::Private::FusionState::IsQcsim ( ) const

inlineoverridevirtual

Returns if the simulator is a qcsim simulator.

Returns if the simulator is a qcsim simulator. This is just a helper function to ease things up: qcsim has different functionality exposed sometimes so it's good to know if we deal with qcsim or with qiskit aer.

Returns: True if the simulator is a qcsim simulator, false otherwise.

Implements Simulators::IState.

Definition at line 316 of file FusionState.h.

References immediate_.

◆ IsRoutingLookaheadEnabled()

bool Simulators::Private::FusionState::IsRoutingLookaheadEnabled ( ) const

inlineoverridevirtual

Reimplemented from Simulators::IState.

Definition at line 336 of file FusionState.h.

References immediate_.

Referenced by Configure(), setGrowthFactorGate(), and setGrowthFactorSwap().

◆ Measure()

size_t Simulators::Private::FusionState::Measure ( const Types::qubits_vector & qubits )

inlineoverridevirtual

Performs a measurement on the specified qubits.

Don't use it if the number of qubits is larger than the number of bits in the size_t type (usually 64), as the outcome will be undefined

Parameters

qubits A vector with the qubits to be measured.

Returns: The outcome of the measurements, the first qubit result is the least significant bit.

Implements Simulators::IState.

Definition at line 239 of file FusionState.h.

References ConsumeBoundary(), Flush(), immediate_, Circuits::kMeasurement, and Simulators::IState::NotifyObservers().

◆ MeasureMany()

std::vector< bool > Simulators::Private::FusionState::MeasureMany ( const Types::qubits_vector & qubits )

inlineoverridevirtual

Performs a measurement on the specified qubits.

Parameters

qubits A vector with the qubits to be measured.

Returns: The outcome of the measurements

Implements Simulators::IState.

Definition at line 248 of file FusionState.h.

References ConsumeBoundary(), Flush(), immediate_, Circuits::kMeasurement, and Simulators::IState::NotifyObservers().

◆ MeasureNoCollapse()

Types::qubit_t Simulators::Private::FusionState::MeasureNoCollapse ( )

inlineoverridevirtual

Measures all the qubits without collapsing the state.

Measures all the qubits without collapsing the state, allowing to perform multiple shots. This is to be used only internally, only for the statevector simulators (or those based on them, as the composite ones). For the qiskit aer case, SaveStateToInternalDestructive is needed to be called before this. If one wants to use the simulator after such measurement(s), RestoreInternalDestructiveSavedState should be called at the end.

Don't use this for more qubits than the size of Types::qubit_t, as the result is packed in a limited number of bits (e.g. 64 bits for uint64_t)

Returns: The result of the measurements, the first qubit result is the least significant bit.

Implements Simulators::IState.

Definition at line 430 of file FusionState.h.

References immediate_.

◆ MeasureNoCollapseMany()

std::vector< bool > Simulators::Private::FusionState::MeasureNoCollapseMany ( )

inlineoverridevirtual

Measures all the qubits without collapsing the state.

Measures all the qubits without collapsing the state, allowing to perform multiple shots. This is to be used only internally, only for the statevector simulators (or those based on them, as the composite ones). For the qiskit aer case, SaveStateToInternalDestructive is needed to be called before this. If one wants to use the simulator after such measurement(s), RestoreInternalDestructiveSavedState should be called at the end.

Use this for more qubits than the size of Types::qubit_t

Returns: The result of the measurements

Implements Simulators::IState.

Definition at line 436 of file FusionState.h.

References immediate_.

◆ MoveAtBeginningOfChain()

void Simulators::Private::FusionState::MoveAtBeginningOfChain ( const Types::qubits_vector & qubits )

inlineoverridevirtual

Reimplemented from Simulators::IState.

Definition at line 482 of file FusionState.h.

References Flush(), and immediate_.

◆ NotificationsEnabled()

bool Simulators::IState::NotificationsEnabled ( ) const

inlineprotectednoexceptinherited

Definition at line 1209 of file State.h.

◆ Notify()

void Simulators::IState::Notify ( )

inlineprotectedinherited

Starts notifying observers.

Use it to allow notifying observers.

Definition at line 1185 of file State.h.

◆ NotifyObservers()

void Simulators::IState::NotifyObservers ( const Types::qubits_vector & affectedQubits )

inlineprotectedinherited

Notifies observers.

Called when the state changes, to notify observers about it.

Parameters

affectedQubits A vector with the qubits that were affected by the change.

Definition at line 1197 of file State.h.

Referenced by Simulators::Private::FusionState::ApplyOperator(), Simulators::Private::FusionState::ApplyQuantumChannel(), Simulators::Private::FusionState::ApplyReset(), Simulators::Private::FusionState::Measure(), Simulators::Private::FusionState::MeasureMany(), and Simulators::Private::FusionState::SubmitGate().

◆ PartialTrace()

Eigen::MatrixXcd Simulators::Private::FusionState::PartialTrace ( const Types::qubits_vector & qs ) const

inlineoverridevirtual

Reimplemented from Simulators::IState.

Definition at line 521 of file FusionState.h.

References immediate_.

◆ PreserveStructuredGates()

virtual bool Simulators::Private::FusionState::PreserveStructuredGates ( ) const

inlineprotectedvirtual

Definition at line 714 of file FusionState.h.

◆ Probabilities()

std::vector< double > Simulators::Private::FusionState::Probabilities ( const Types::qubits_vector & qubits )

inlineoverridevirtual

Returns the probabilities of the specified outcomes.

Use it to obtain the probabilities of the specified outcomes.

See also: IState::Probability; IState::Amplitude

Parameters

qubits A vector with the qubits configuration outcomes.

Returns: A vector with the probabilities for the specified qubit configurations.

Implements Simulators::IState.

Definition at line 398 of file FusionState.h.

References immediate_.

◆ Probability()

double Simulators::Private::FusionState::Probability ( Types::qubit_t outcome )

inlineoverridevirtual

Returns the probability of the specified outcome.

Use it to obtain the probability to obtain the specified outcome, if all qubits are measured.

See also: IState::Amplitude; IState::Probabilities

Parameters

outcome The outcome to obtain the probability for.

Returns: The probability of the specified outcome.

Implements Simulators::IState.

Definition at line 356 of file FusionState.h.

References immediate_.

◆ ProbabilityBits()

double Simulators::Private::FusionState::ProbabilityBits ( const std::vector< bool > & )

inlineoverridevirtual

MPO extensions: bit vectors are q0-first; matrices use logical basis order.

Element queries return the raw operator. Dense output and complex Pauli expectations are trace-normalized unless normalized is false. ApplyOperator computes A rho A^dagger; normalize also restores unit trace.

Reimplemented from Simulators::IState.

Definition at line 442 of file FusionState.h.

References immediate_.

◆ ProjectOnZero()

std::complex< double > Simulators::Private::FusionState::ProjectOnZero ( )

inlineoverridevirtual

Projects the state onto the zero state.

Use it to project the state onto the zero state. For most simulator is the same as calling Amplitude(0), but for some simulators it can be optimized to be faster than calling Amplitude(0). This for now is done for qcsim mps and gpu mps.

See also: IState::Amplitude; IState::Probability

Returns: The inner product result as a complex number.

Implements Simulators::IState.

Definition at line 374 of file FusionState.h.

References immediate_.

◆ RandomUniform()

double Simulators::IState::RandomUniform ( )

inlineinherited

Uniform random number in [0, 1) from the auxiliary stream.

Used for classical post-processing that happens during execution, such as readout-error flips applied when a measurement writes its bit. Each simulator instance owns its own stream, so the per-job clones in the multi-shot thread pool never share state. Deterministic after SetSeed or Configure("seed") on the built-in backends.

Definition at line 157 of file State.h.

◆ ReCanonicalize()

void Simulators::Private::FusionState::ReCanonicalize ( )

inlineoverridevirtual

Restore the canonical form of a matrix-product state or operator.

Reimplemented from Simulators::IState.

Definition at line 551 of file FusionState.h.

References Flush(), and immediate_.

◆ RegisterObserver()

void Simulators::IState::RegisterObserver ( const std::shared_ptr< ISimulatorObserver > & observer )

inlineinherited

Registers an observer.

Registers an observer that will be notified when the state changes.

See also: ISimulatorObserver

Parameters

observer A smart pointer to an observer.

Definition at line 972 of file State.h.

◆ Reset()

void Simulators::Private::FusionState::Reset ( )

inlineoverridevirtual

Just resets the state to 0.

Does not destroy the internal state, just resets it to zero (as a 'reset' op on each qubit would do).

Implements Simulators::IState.

Definition at line 164 of file FusionState.h.

References immediate_.

◆ RestoreDensityMatrixTrace()

void Simulators::Private::FusionState::RestoreDensityMatrixTrace ( )

inlineoverridevirtual

Reimplemented from Simulators::IState.

Definition at line 533 of file FusionState.h.

References Flush(), and immediate_.

◆ RestoreInternalDestructiveSavedState()

void Simulators::Private::FusionState::RestoreInternalDestructiveSavedState ( )

inlineoverridevirtual

Restores the state from the internally saved state.

Restores the state from the internally saved state, if needed. This does something only for qiskit aer.

Implements Simulators::IState.

Definition at line 223 of file FusionState.h.

References Flush(), and immediate_.

◆ RestoreState()

void Simulators::Private::FusionState::RestoreState ( )

inlineoverridevirtual

Restores the state from the internally saved state.

Restores the state from the internally saved state, if needed. To be used in order to recover the state after doing measurements, for multiple shots executions. In the first phase, only qcsim will implement this.

Implements Simulators::IState.

Definition at line 198 of file FusionState.h.

References Flush(), and immediate_.

◆ SampleCounts()

std::unordered_map< Types::qubit_t, Types::qubit_t > Simulators::Private::FusionState::SampleCounts	(	const Types::qubits_vector &	qubits,
		size_t	shots = 1000 )

inlineoverridevirtual

Returns the counts of the outcomes of measurement of the specified qubits, for repeated measurements.

Use it to obtain the counts of the outcomes of the specified qubits measurements. The state is not collapsed, so the measurement can be repeated 'shots' times.

Don't use it if the number of qubits is larger than the number of bits in the Types::qubit_t type (usually 64), as the outcome will be undefined.

Parameters

qubits	A vector with the qubits to be measured.
shots	The number of shots to perform.

Returns: A map with the counts for the otcomes of measurements of the specified qubits.

Implements Simulators::IState.

Definition at line 404 of file FusionState.h.

References immediate_.

◆ SampleCountsMany()

std::unordered_map< std::vector< bool >, Types::qubit_t > Simulators::Private::FusionState::SampleCountsMany	(	const Types::qubits_vector &	qubits,
		size_t	shots = 1000 )

inlineoverridevirtual

Returns the counts of the outcomes of measurement of the specified qubits, for repeated measurements.

Use it to obtain the counts of the outcomes of the specified qubits measurements. The state is not collapsed, so the measurement can be repeated 'shots' times.

Parameters

qubits	A vector with the qubits to be measured.
shots	The number of shots to perform.

Returns: A map with the counts for the otcomes of measurements of the specified qubits.

Implements Simulators::IState.

Definition at line 410 of file FusionState.h.

References immediate_.

◆ SaveState()

void Simulators::Private::FusionState::SaveState ( )

inlineoverridevirtual

Saves the state to internal storage.

Saves the state to internal storage, if needed. Calling this will not destroy the internal state, unlike the 'Destructive' variant. To be used in order to recover the state after doing measurements, for multiple shots executions. In the first phase, only qcsim will implement this.

Implements Simulators::IState.

Definition at line 191 of file FusionState.h.

References Flush(), and immediate_.

◆ SaveStateToInternalDestructive()

void Simulators::Private::FusionState::SaveStateToInternalDestructive ( )

inlineoverridevirtual

Saves the state to internal storage.

Saves the state to internal storage, if needed. Calling this should consider as the simulator is gone to uninitialized. Either do not use it except for getting amplitudes, or reinitialize the simulator after calling it. This is needed only for the composite simulator, for an optimization for qiskit aer.

Implements Simulators::IState.

Definition at line 215 of file FusionState.h.

References Flush(), immediate_, and UsesDestructiveStateStorage().

◆ SeedAuxiliaryRng()

void Simulators::IState::SeedAuxiliaryRng ( uint64_t seed )

inlineprotectedinherited

Shared by SetSeed and backend Configure("seed") implementations.

Definition at line 1164 of file State.h.

References DeriveSeed().

Referenced by Simulators::Private::FusionState::FusionState(), Simulators::Private::FusionState::CloneInto(), Simulators::Private::FusionState::Configure(), SetSeed(), and Simulators::Private::FusionState::SetSeed().

◆ SetAutomaticLookaheadDepth()

void Simulators::Private::FusionState::SetAutomaticLookaheadDepth ( int value )

inlineoverridevirtual

Reimplemented from Simulators::IState.

Definition at line 579 of file FusionState.h.

References immediate_.

◆ SetGatesCounter() [1/2]

virtual void Simulators::IState::SetGatesCounter ( long long int )

inlinevirtualinherited

Sets the gates counter.

Usually does nothing, except for MPS simulators that support swap optimization.

Parameters

counter The position in the circuit from where the execution should continue.

Definition at line 442 of file State.h.

◆ SetGatesCounter() [2/2]

void Simulators::Private::FusionState::SetGatesCounter ( long long counter )

inlineoverride

Definition at line 133 of file FusionState.h.

References FlushPendingGates(), and immediate_.

Referenced by IncrementGatesCounter().

◆ setGrowthFactorGate()

void Simulators::Private::FusionState::setGrowthFactorGate ( double value )

inlineoverridevirtual

Reimplemented from Simulators::IState.

Definition at line 598 of file FusionState.h.

References Flush(), immediate_, and IsRoutingLookaheadEnabled().

◆ setGrowthFactorSwap()

void Simulators::Private::FusionState::setGrowthFactorSwap ( double value )

inlineoverridevirtual

Reimplemented from Simulators::IState.

Definition at line 589 of file FusionState.h.

References Flush(), immediate_, and IsRoutingLookaheadEnabled().

◆ SetInitialQubitsMap() [1/2]

virtual void Simulators::IState::SetInitialQubitsMap ( const std::vector< long long int > & initialMap )

inlinevirtualinherited

Sets the initial qubits map, if possible.

This will do nothing for most simulators, but for the MPS simulator it will set the initial qubits if it supports it - that is, for qcsim and the gpu simulator it can set the mapping of the qubits to the positions in the chain, which can be used to optimize the swapping cost.

Definition at line 350 of file State.h.

◆ SetInitialQubitsMap() [2/2]

void Simulators::Private::FusionState::SetInitialQubitsMap ( const std::vector< long long > & value )

inlineoverride

Definition at line 563 of file FusionState.h.

References Flush(), and immediate_.

◆ SetLookaheadDepth()

void Simulators::Private::FusionState::SetLookaheadDepth ( int )

inlineoverridevirtual

Sets the lookahead depth for swap optimization.

Controls how many upcoming 2-qubit gates are considered when choosing the swap meeting position. 0 means no lookahead (immediate cost only). Only effective for MPS simulators. Requires upcoming gates to be supplied via SetUpcomingGates.

Reimplemented from Simulators::IState.

Definition at line 574 of file FusionState.h.

References immediate_.

◆ SetLookaheadDepthWithHeuristic()

void Simulators::Private::FusionState::SetLookaheadDepthWithHeuristic ( int )

inlineoverridevirtual

Sets the lookahead depth for swap optimization.

Controls how many upcoming 2-qubit gates are considered when choosing the swap meeting position. 0 means no lookahead (immediate cost only). Only effective for MPS simulators. Requires upcoming gates to be supplied via SetUpcomingGates. This value sets a number of gates to lookahead without much cost increase.

Reimplemented from Simulators::IState.

Definition at line 584 of file FusionState.h.

References immediate_.

◆ SetMultithreading()

void Simulators::Private::FusionState::SetMultithreading ( bool multithreading = true )

inlineoverridevirtual

Enable/disable multithreading.

Enable/disable multithreading. Default is enabled.

Parameters

multithreading A flag to indicate if multithreading should be enabled.

Implements Simulators::IState.

Definition at line 557 of file FusionState.h.

References Flush(), and immediate_.

◆ SetSeed()

void Simulators::Private::FusionState::SetSeed ( uint64_t seed )

inlineoverridevirtual

Seed every random stream owned by this simulator.

Reimplemented from Simulators::IState.

Definition at line 83 of file FusionState.h.

References Flush(), immediate_, and Simulators::IState::SeedAuxiliaryRng().

◆ SetUpcomingGates()

void Simulators::Private::FusionState::SetUpcomingGates ( const std::vector< std::shared_ptr< Circuits::IOperation< double > > > & )

inlineoverridevirtual

Supplies upcoming gates for lookahead swap optimization.

The simulator uses these to evaluate swap costs for future gates when choosing where to meet. Only effective for MPS simulators with lookahead depth > 0.

Reimplemented from Simulators::IState.

Definition at line 103 of file FusionState.h.

References Flush().

◆ SetUseOptimalMeetingPosition()

void Simulators::Private::FusionState::SetUseOptimalMeetingPosition ( bool )

inlineoverridevirtual

Enables or disables optimal meeting position for MPS swaps.

When enabled, the MPS simulator uses actual bond dimensions to find the cheapest meeting position for non-adjacent qubit swaps instead of the default heuristic. Does nothing for non-MPS simulators.

Reimplemented from Simulators::IState.

Definition at line 569 of file FusionState.h.

References immediate_.

◆ SubmitGate()

void Simulators::Private::FusionState::SubmitGate ( const FusionGate & gate )

inlineprotected

Definition at line 755 of file FusionState.h.

References Simulators::FusionGate::Apply(), Simulators::FusionGate::Expand(), FlushPendingGates(), Simulators::FusionGate::FromCircuit(), Simulators::FusionGate::generic, Simulators::ISimulator::GetGateFusionMaxQubits(), GetNumberOfQubits(), immediate_, IsGateFusionEnabled(), Circuits::kConditionalGate, Simulators::FusionGate::kind, Simulators::IState::NotifyObservers(), Simulators::FusionGate::params, and Simulators::FusionGate::qubits.

◆ SupportsMPSSwapOptimization()

bool Simulators::Private::FusionState::SupportsMPSSwapOptimization ( ) const

inlineoverridevirtual

Returns if the simulator supports MPS swap optimization.

Used to check if the simulator supports MPS swap optimization.

Returns: True if the simulator supports MPS swap optimization, false otherwise.

Reimplemented from Simulators::IState.

Definition at line 326 of file FusionState.h.

References immediate_.

◆ SupportsQuantumChannels()

bool Simulators::Private::FusionState::SupportsQuantumChannels ( ) const

inlineoverridevirtual

Returns whether this state retains channel ensembles directly.

This is true for QCSim density-matrix/MPO states and Aer density-matrix states. MPO results remain subject to configured bond truncation. A statevector or MPS can sample Kraus trajectories, but does not retain the resulting ensemble in a single state.

Reimplemented from Simulators::IState.

Definition at line 341 of file FusionState.h.

References immediate_.

◆ SwapGatesRelabelQubits()

bool Simulators::Private::FusionState::SwapGatesRelabelQubits ( ) const

inlineoverridevirtual

Reimplemented from Simulators::IState.

Definition at line 331 of file FusionState.h.

References immediate_.

◆ Trim()

void Simulators::Private::FusionState::Trim ( )

inlineoverridevirtual

Compress a matrix-product state or operator to its configured limits.

Reimplemented from Simulators::IState.

Definition at line 545 of file FusionState.h.

References Flush(), and immediate_.

◆ UnregisterObserver()

void Simulators::IState::UnregisterObserver ( const std::shared_ptr< ISimulatorObserver > & observer )

inlineinherited

Unregisters an observer.

Unegisters an observer.

See also: ISimulatorObserver

Parameters

observer A smart pointer to an observer.

Definition at line 985 of file State.h.

◆ UsesDestructiveStateStorage()

virtual bool Simulators::Private::FusionState::UsesDestructiveStateStorage ( ) const

inlineprotectedvirtual

Definition at line 700 of file FusionState.h.

Referenced by SaveStateToInternalDestructive().

Member Data Documentation

◆ immediate_

std::shared_ptr<ISimulator> Simulators::Private::FusionState::immediate_

protected

Definition at line 721 of file FusionState.h.

Referenced by FusionState(), AllocateQubits(), AllProbabilities(), Amplitude(), AmplitudeRaw(), ApplyOperator(), ApplyQuantumChannel(), ApplyReset(), Clear(), CloneInto(), Configure(), ConsumeBoundary(), DensityMatrixElementBits(), DensityMatrixHermiticityResidual(), DensityMatrixOverlap(), DensityMatrixPurity(), DensityMatrixTrace(), DensityMatrixTraceOfSquare(), ExpectationValue(), ExpectationValueComplex(), ExpectationValueOperators(), ExpectationValues(), ExpectationValuesComplex(), FidelityWithStatevector(), Flush(), GetConfigMap(), GetConfiguration(), GetCurrentMaxBondDimension(), GetDensityMatrix(), GetExecutedMaxBondDimension(), GetGpuDevice(), getGrowthFactorGate(), getGrowthFactorSwap(), GetMultithreading(), GetNumberOfQubits(), GetSimulationType(), GetStateVector(), GetType(), HermitizeDensityMatrix(), Initialize(), InitializeState(), InitializeState(), InitializeState(), InitializeToBasisState(), InitializeToBasisState(), InitializeToMixtureOfBasisStates(), InitializeToMixtureOfBasisStates(), IsDensityMatrixHermitian(), IsQcsim(), IsRoutingLookaheadEnabled(), Measure(), MeasureMany(), MeasureNoCollapse(), MeasureNoCollapseMany(), MoveAtBeginningOfChain(), PartialTrace(), Probabilities(), Probability(), ProbabilityBits(), ProjectOnZero(), ReCanonicalize(), Reset(), RestoreDensityMatrixTrace(), RestoreInternalDestructiveSavedState(), RestoreState(), SampleCounts(), SampleCountsMany(), SaveState(), SaveStateToInternalDestructive(), SetAutomaticLookaheadDepth(), SetGatesCounter(), setGrowthFactorGate(), setGrowthFactorSwap(), SetInitialQubitsMap(), SetLookaheadDepth(), SetLookaheadDepthWithHeuristic(), SetMultithreading(), SetSeed(), SetUseOptimalMeetingPosition(), SubmitGate(), SupportsMPSSwapOptimization(), SupportsQuantumChannels(), SwapGatesRelabelQubits(), and Trim().

The documentation for this class was generated from the following file:

FusionState.h

Public Types

Public Member Functions

Static Public Member Functions

Protected Types

Protected Member Functions

Protected Attributes

Detailed Description

Member Typedef Documentation

◆ Cache

◆ Matrix8cd

◆ Operation

Constructor & Destructor Documentation

◆ FusionState()

Member Function Documentation

◆ AllocateQubits()

◆ AllProbabilities()

◆ Amplitude()

◆ AmplitudeRaw()

◆ ApplyAmplitudeDamping()

◆ ApplyBitFlipNoise()

◆ ApplyBitPhaseFlipNoise()

◆ ApplyCCX()

◆ ApplyCH()

◆ ApplyChannel()

◆ ApplyCorrelatedPhaseFlipNoise() [1/2]

◆ ApplyCorrelatedPhaseFlipNoise() [2/2]

◆ ApplyCP()

◆ ApplyCRx()

◆ ApplyCRy()

◆ ApplyCRz()

◆ ApplyCSwap()

◆ ApplyCSx()

◆ ApplyCSxDAG()

◆ ApplyCU()

◆ ApplyCX()

◆ ApplyCY()

◆ ApplyCZ()

◆ ApplyDephasingNoise()

◆ ApplyDepolarizingMixingNoise()

◆ ApplyDepolarizingNoise()

◆ ApplyGeneralizedAmplitudeDamping()

◆ ApplyGenericOneQubitGate()

◆ ApplyGenericThreeQubitGate()

◆ ApplyGenericTwoQubitGate()

◆ ApplyH()

◆ ApplyK()

◆ ApplyKrausChannel()

◆ ApplyNop()

◆ ApplyOperator()

◆ ApplyP()

◆ ApplyPauliChannel() [1/2]

◆ ApplyPauliChannel() [2/2]

◆ ApplyPhaseDamping()

◆ ApplyPhaseDampingFromTime()

◆ ApplyPhaseFlipNoise()

◆ ApplyQuantumChannel()

◆ ApplyReset()

◆ ApplyRx()

◆ ApplyRy()

◆ ApplyRz()

◆ ApplyS()

◆ ApplySDG()

◆ ApplySwap()

◆ ApplySx()

◆ ApplySxDAG()

◆ ApplyT()

◆ ApplyT1Relaxation()

◆ ApplyT1RelaxationFromTime()

◆ ApplyTDG()

◆ ApplyThermalRelaxation()

◆ ApplyTwoQubitDepolarizingMixingNoise()

◆ ApplyTwoQubitDepolarizingNoise()

◆ ApplyU()

◆ ApplyX()

◆ ApplyY()

◆ ApplyZ()

◆ Clear()

◆ ClearObservers()

◆ Clone()

◆ CloneForExecution()