The state class that stores the classical state of a quantum circuit execution. More...

#include <Operations.h>

Collaboration diagram for Circuits::OperationState:

Public Member Functions
	OperationState (const OperationState &other)
	Construct a new Operation State object.

	OperationState (const std::vector< bool > &b)
	Construct a new Operation State object.

	OperationState (OperationState &&other) noexcept
	Construct a new Operation State object.

	OperationState (size_t numBits=0)
	Construct a new Operation State object.

	OperationState (std::vector< bool > &&b)
	Construct a new Operation State object.

void	AllocateBits (size_t numBits)
	Allocate more bits.

void	Clear ()
	Clear the classical state.

const std::vector< bool > &	GetAllBits () const
	Get the classical bits.

std::vector< bool >	GetAllBitsCopy () const
	Get the classical bits.

bool	GetBit (size_t index) const
	Get the classical bit at the specified index.

std::vector< bool >	GetBits (const std::vector< size_t > &indices) const
	Get the classical bits at the specified indices.

size_t	GetNumBits () const
	Get the number of classical bits.

OperationState &	operator= (const OperationState &other)
	Assign the bits.

OperationState &	operator= (const std::vector< bool > &b)
	Assign the bits.

OperationState &	operator= (OperationState &&other) noexcept
	Assign the bits.

OperationState &	operator= (std::vector< bool > &&b)
	Assign the bits.

void	Remap (const std::unordered_map< Types::qubit_t, Types::qubit_t > &mapping, bool ignoreNotMapped=false, size_t newSize=0)
	Convert the state using the provided mapping.

void	RemapWithVector (const std::vector< Types::qubit_t > &mapping, bool ignoreNotMapped=false, size_t newSize=0)
	Convert the state using the provided mapping.

void	Reset (bool value=false)
	Set the classical bits with the specified value.

void	SetBit (size_t index, bool value=true)
	Set the classical bit at the specified index.

void	SetResults (const std::vector< size_t > &indices, size_t results)
	Set the classical bits at the specified indices.

void	SetResultsInOrder (const std::vector< bool > &results)
	Set the classical bits.

void	Swap (OperationState &results)
	Set results.

Detailed Description

The state class that stores the classical state of a quantum circuit execution.

Contains the classical state (such as measurement results and classical values for conditions) of a quantum circuit execution.

Definition at line 63 of file Operations.h.

Constructor & Destructor Documentation

◆ OperationState() [1/5]

Circuits::OperationState::OperationState ( size_t numBits = 0 )

inline

Construct a new Operation State object.

Pass the number of bits to allocate. If not specified, the default is 0, they can be allocated later.

Parameters

numBits The number of bits to allocate.

Definition at line 72 of file Operations.h.

References AllocateBits().

◆ OperationState() [2/5]

Circuits::OperationState::OperationState ( const OperationState & other )

inline

Construct a new Operation State object.

Copy constructor.

Parameters

other The OperationState object to copy.

Definition at line 81 of file Operations.h.

◆ OperationState() [3/5]

Circuits::OperationState::OperationState ( OperationState && other )

inlinenoexcept

Construct a new Operation State object.

Move constructor.

Parameters

other The OperationState object to move.

Definition at line 90 of file Operations.h.

◆ OperationState() [4/5]

Circuits::OperationState::OperationState ( const std::vector< bool > & b )

inline

Construct a new Operation State object.

Construct a new Operation State object with the specified bits.

Parameters

bits	The bits to set.

Definition at line 99 of file Operations.h.

◆ OperationState() [5/5]

Circuits::OperationState::OperationState ( std::vector< bool > && b )

inline

Construct a new Operation State object.

Construct a new Operation State object with the specified bits.

Parameters

bits	The bits to set.

Definition at line 107 of file Operations.h.

Member Function Documentation

◆ AllocateBits()

void Circuits::OperationState::AllocateBits ( size_t numBits )

inline

Allocate more bits.

Allocate more bits, the number of classical bits is increased by the number of bits specified.

Parameters

numBits The number of bits to suplementary allocate.

Definition at line 160 of file Operations.h.

Referenced by OperationState(), Network::SimpleDisconnectedNetwork< Time, Controller >::CreateSimulator(), Network::ExecuteJob< Time >::DoWork(), Network::ExecuteJob< Time >::DoWorkNoLock(), and Estimators::SimulatorsEstimatorInterface< Time >::ExecuteUpToMeasurements().

◆ Clear()

void Circuits::OperationState::Clear ( )

inline

Clear the classical state.

Clear the classical state, the number of allocated bits is reset to 0.

Definition at line 169 of file Operations.h.

Referenced by Network::SimpleDisconnectedNetwork< Time, Controller >::CreateSimulator(), Network::SimpleDisconnectedNetwork< Time, Controller >::RepeatedExecute(), and Network::SimpleDisconnectedNetwork< Time, Controller >::RepeatedExecuteOnHost().

◆ GetAllBits()

const std::vector< bool > & Circuits::OperationState::GetAllBits ( ) const

inline

Get the classical bits.

Get the values of the classical bits.

Returns: The classical bit values reference.

Definition at line 214 of file Operations.h.

Referenced by Network::SimpleDisconnectedNetwork< Time, Controller >::ConvertBackResults(), Network::ExecuteJob< Time >::DoWork(), and Network::ExecuteJob< Time >::DoWorkNoLock().

◆ GetAllBitsCopy()

std::vector< bool > Circuits::OperationState::GetAllBitsCopy ( ) const

inline

Get the classical bits.

Get the values of the classical bits.

Returns: A copy of the classical bit values.

Definition at line 222 of file Operations.h.

◆ GetBit()

bool Circuits::OperationState::GetBit ( size_t index ) const

inline

Get the classical bit at the specified index.

Get the value of the classical bit at the specified index.

Parameters

index The index of the bit to get.

Returns: The classical bit value at the specified index.

Definition at line 186 of file Operations.h.

◆ GetBits()

std::vector< bool > Circuits::OperationState::GetBits ( const std::vector< size_t > & indices ) const

inline

Get the classical bits at the specified indices.

Get the values of the classical bits at the specified indices.

Parameters

indices The indices of the bits to get.

Returns: The classical bit values at the specified indices.

Definition at line 199 of file Operations.h.

Referenced by Circuits::EqualCondition::IsConditionMet().

◆ GetNumBits()

size_t Circuits::OperationState::GetNumBits ( ) const

inline

Get the number of classical bits.

Get the number of allocated classical bits.

Returns: The number of classical bits.

Definition at line 177 of file Operations.h.

◆ operator=() [1/4]

OperationState & Circuits::OperationState::operator= ( const OperationState & other )

inline

Assign the bits.

Parameters

other The OperationState object to copy.

Definition at line 115 of file Operations.h.

◆ operator=() [2/4]

OperationState & Circuits::OperationState::operator= ( const std::vector< bool > & b )

inline

Assign the bits.

Parameters

bits	The bits to set.

Definition at line 137 of file Operations.h.

◆ operator=() [3/4]

OperationState & Circuits::OperationState::operator= ( OperationState && other )

inlinenoexcept

Assign the bits.

Parameters

other The OperationState object to move.

Definition at line 126 of file Operations.h.

◆ operator=() [4/4]

OperationState & Circuits::OperationState::operator= ( std::vector< bool > && b )

inline

Assign the bits.

Parameters

bits	The bits to set.

Definition at line 148 of file Operations.h.

◆ Remap()

void Circuits::OperationState::Remap	(	const std::unordered_map< Types::qubit_t, Types::qubit_t > &	mapping,
		bool	ignoreNotMapped = `false`,
		size_t	newSize = `0`
	)

inline

Convert the state using the provided mapping.

Set the values of the classical bits.

Parameters

mapping	The mapping of the bits.
ignoreNotMapped	If true, the bits that are not in the mapping are ignored. The size of the state will be the size of the mapping.
newSize	The new size of the state. If zero, the size of the state is used. Ignored if ignoreNotMapped is true.
offset	The offset to add to the remapping.

Definition at line 297 of file Operations.h.

Referenced by Network::SimpleDisconnectedNetwork< Time, Controller >::ConvertBackResults(), and Network::SimpleDisconnectedNetwork< Time, Controller >::ConvertBackState().

◆ RemapWithVector()

void Circuits::OperationState::RemapWithVector	(	const std::vector< Types::qubit_t > &	mapping,
		bool	ignoreNotMapped = `false`,
		size_t	newSize = `0`
	)

inline

Convert the state using the provided mapping.

Set the values of the classical bits.

Parameters

mapping	The mapping of the bits.
ignoreNotMapped	If true, the bits that are not in the mapping are ignored. The size of the state will be the size of the mapping.
newSize	The new size of the state. If zero, the size of the state is used. Ignored if ignoreNotMapped is true.
offset	The offset to add to the remapping.

Definition at line 327 of file Operations.h.

◆ Reset()

void Circuits::OperationState::Reset ( bool value = false )

inline

Set the classical bits with the specified value.

Set the values of the classical bits with the specified value. If not specified, the default value is false.

Parameters

value The value assigned to the classical bits.

Definition at line 244 of file Operations.h.

Referenced by Network::ExecuteJob< Time >::DoWork(), Network::ExecuteJob< Time >::DoWorkNoLock(), Circuits::Circuit< Time >::Execute(), and Circuits::Circuit< Time >::ExecuteMeasurements().

◆ SetBit()

void Circuits::OperationState::SetBit	(	size_t	index,
		bool	value = `true`
	)

inline

Set the classical bit at the specified index.

Set the value of the classical bit at the specified index.

Parameters

index	The index of the bit to set.
value	The value to set the bit to.

Definition at line 231 of file Operations.h.

Referenced by Circuits::Random< Time >::Execute(), and Circuits::MeasurementOperation< Time >::SetStateFromSample().

◆ SetResults()

void Circuits::OperationState::SetResults	(	const std::vector< size_t > &	indices,
		size_t	results
	)

inline

Set the classical bits at the specified indices.

Set the values of the classical bits at the specified indices to the values specified in results. Each bit in results specifies a value.

Parameters

indices	The indices of the bits to set.
results	The value that contains the values for the bits.

Definition at line 268 of file Operations.h.

◆ SetResultsInOrder()

void Circuits::OperationState::SetResultsInOrder ( const std::vector< bool > & results )

inline

Set the classical bits.

Set the values of the classical bits to the values specified in results. Each bit in results specifies a value.

Parameters

results A vector of bools that contains the values for the bits.

Definition at line 253 of file Operations.h.

Referenced by Network::SimpleDisconnectedNetwork< Time, Controller >::Execute(), Network::SimpleDisconnectedNetwork< Time, Controller >::ExecuteExpectations(), Network::SimpleDisconnectedNetwork< Time, Controller >::ExecuteOnHost(), Network::SimpleDisconnectedNetwork< Time, Controller >::ExecuteOnHostAmplitudes(), Network::SimpleDisconnectedNetwork< Time, Controller >::ExecuteOnHostExpectations(), and Network::SimpleDisconnectedNetwork< Time, Controller >::ExecuteOnHostProjectOnZero().

◆ Swap()

void Circuits::OperationState::Swap ( OperationState & results )

inline

Set results.

Set the values of the classical bits. Destroys the source, it's implemented for increasing performance.

Parameters

results The new values.

Definition at line 283 of file Operations.h.

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

Operations.h

Public Member Functions

Detailed Description

Constructor & Destructor Documentation

◆ OperationState() [1/5]

◆ OperationState() [2/5]

◆ OperationState() [3/5]

◆ OperationState() [4/5]

◆ OperationState() [5/5]

Member Function Documentation

◆ AllocateBits()

◆ Clear()

◆ GetAllBits()

◆ GetAllBitsCopy()

◆ GetBit()

◆ GetBits()

◆ GetNumBits()

◆ operator=() [1/4]

◆ operator=() [2/4]

◆ operator=() [3/4]

◆ operator=() [4/4]

◆ Remap()

◆ RemapWithVector()

◆ Reset()

◆ SetBit()

◆ SetResults()

◆ SetResultsInOrder()

◆ Swap()