#include <RobotAPI/libraries/armem/server/wm/memory_definitions.h>

Inheritance diagram for CoreSegment:

Public Member Functions
template<class... Args>
ProviderSegment &	addProviderSegment (const std::string &name, Args... args)

	CoreSegmentBase ()

	CoreSegmentBase (const CoreSegmentBase &other)=default

	CoreSegmentBase (const MemoryID &id, aron::type::ObjectPtr aronType=nullptr, const std::vector< PredictionEngine > &predictionEngines={})

	CoreSegmentBase (const std::string &name, aron::type::ObjectPtr aronType=nullptr, const std::vector< PredictionEngine > &predictionEngines={})

	CoreSegmentBase (const std::string &name, const MemoryID &parentID, aron::type::ObjectPtr aronType=nullptr, const std::vector< PredictionEngine > &predictionEngines={})

	CoreSegmentBase (CoreSegmentBase &&other)=default

template<class FunctionT>
auto	doLocked (FunctionT &&function) const
	Execute function under shared (read) lock.

template<class FunctionT>
auto	doLockedExclusive (FunctionT &&function)
	Execute function under exclusive (write) lock.

const CoreSegmentLockStatistics &	getLockStatistics () const
	Get lock statistics for this core segment.

void	resetLockStatistics ()
	Reset lock statistics.

Public Member Functions inherited from CoreSegmentBase< ProviderSegment, CoreSegment >
ProviderSegmentT &	addProviderSegment (const ProviderSegmentT &providerSegment)
	Copy and insert a provider segment.

ProviderSegmentT &	addProviderSegment (const ProviderSegmentT &providerSegment)
	Copy and insert a provider segment.

ProviderSegmentT &	addProviderSegment (const std::string &name, Args... args)
	Insert a provider segment in-place.

ProviderSegmentT &	addProviderSegment (const std::string &name, Args... args)
	Insert a provider segment in-place.

ProviderSegmentT &	addProviderSegment (const std::string &name, aron::type::ObjectPtr providerSegmentType=nullptr, const std::vector< PredictionEngine > &predictionEngines={})
	Add an empty provider segment with the given name, optional provider segment type and prediction engines.

ProviderSegmentT &	addProviderSegment (const std::string &name, aron::type::ObjectPtr providerSegmentType=nullptr, const std::vector< PredictionEngine > &predictionEngines={})
	Add an empty provider segment with the given name, optional provider segment type and prediction engines.

ProviderSegmentT &	addProviderSegment (ProviderSegmentT &&providerSegment)
	Move and insert a provider segment.

ProviderSegmentT &	addProviderSegment (ProviderSegmentT &&providerSegment)
	Move and insert a provider segment.

void	append (const OtherDerivedT &other)

void	append (const OtherDerivedT &other)

	CoreSegmentBase ()

	CoreSegmentBase ()

	CoreSegmentBase (const CoreSegmentBase &other)=default

	CoreSegmentBase (const CoreSegmentBase &other)=default

	CoreSegmentBase (const MemoryID &id, aron::type::ObjectPtr aronType=nullptr, const std::vector< PredictionEngine > &predictionEngines={})

	CoreSegmentBase (const MemoryID &id, aron::type::ObjectPtr aronType=nullptr, const std::vector< PredictionEngine > &predictionEngines={})

	CoreSegmentBase (const std::string &name, aron::type::ObjectPtr aronType=nullptr, const std::vector< PredictionEngine > &predictionEngines={})

	CoreSegmentBase (const std::string &name, aron::type::ObjectPtr aronType=nullptr, const std::vector< PredictionEngine > &predictionEngines={})

	CoreSegmentBase (const std::string &name, const MemoryID &parentID, aron::type::ObjectPtr aronType=nullptr, const std::vector< PredictionEngine > &predictionEngines={})

	CoreSegmentBase (const std::string &name, const MemoryID &parentID, aron::type::ObjectPtr aronType=nullptr, const std::vector< PredictionEngine > &predictionEngines={})

	CoreSegmentBase (CoreSegmentBase &&other)=default

	CoreSegmentBase (CoreSegmentBase &&other)=default

bool	equalsDeep (const DerivedT &other) const

bool	equalsDeep (const DerivedT &other) const

EntityT *	findEntity (const std::string &entityName)

EntityT *	findEntity (const std::string &entityName)

const EntityT *	findEntity (const std::string &entityName) const

const EntityT *	findEntity (const std::string &entityName) const

ProviderSegmentT *	findProviderSegment (const MemoryID &providerSegmentID)

ProviderSegmentT *	findProviderSegment (const MemoryID &providerSegmentID)

const ProviderSegmentT *	findProviderSegment (const MemoryID &providerSegmentID) const

const ProviderSegmentT *	findProviderSegment (const MemoryID &providerSegmentID) const

ProviderSegmentT *	findProviderSegment (const std::string &name)

ProviderSegmentT *	findProviderSegment (const std::string &name)

const ProviderSegmentT *	findProviderSegment (const std::string &name) const

const ProviderSegmentT *	findProviderSegment (const std::string &name) const

bool	forEachInstanceIn (const MemoryID &id, InstanceFunctionT &&func)

bool	forEachInstanceIn (const MemoryID &id, InstanceFunctionT &&func)

bool	forEachInstanceIn (const MemoryID &id, InstanceFunctionT &&func) const

bool	forEachInstanceIn (const MemoryID &id, InstanceFunctionT &&func) const

bool	forEachProviderSegment (ProviderSegmentFunctionT &&func)

bool	forEachProviderSegment (ProviderSegmentFunctionT &&func)

bool	forEachProviderSegment (ProviderSegmentFunctionT &&func) const

bool	forEachProviderSegment (ProviderSegmentFunctionT &&func) const

std::string	getKeyString () const

std::string	getKeyString () const

ProviderSegmentT &	getProviderSegment (const MemoryID &providerSegmentID)

ProviderSegmentT &	getProviderSegment (const MemoryID &providerSegmentID)

const ProviderSegmentT &	getProviderSegment (const MemoryID &providerSegmentID) const

const ProviderSegmentT &	getProviderSegment (const MemoryID &providerSegmentID) const

ProviderSegmentT &	getProviderSegment (const std::string &name)

ProviderSegmentT &	getProviderSegment (const std::string &name)

const ProviderSegmentT &	getProviderSegment (const std::string &name) const

const ProviderSegmentT &	getProviderSegment (const std::string &name) const

std::vector< std::string >	getProviderSegmentNames () const

std::vector< std::string >	getProviderSegmentNames () const

bool	hasEntity (const std::string &entityName) const

bool	hasEntity (const std::string &entityName) const

bool	hasProviderSegment (const MemoryID &providerSegmentID) const

bool	hasProviderSegment (const MemoryID &providerSegmentID) const

bool	hasProviderSegment (const std::string &name) const

bool	hasProviderSegment (const std::string &name) const

std::string &	name ()

std::string &	name ()

const std::string &	name () const

const std::string &	name () const

CoreSegmentBase &	operator= (const CoreSegmentBase &other)=default

CoreSegmentBase &	operator= (const CoreSegmentBase &other)=default

CoreSegmentBase &	operator= (CoreSegmentBase &&other)=default

CoreSegmentBase &	operator= (CoreSegmentBase &&other)=default

UpdateResult	update (const EntityUpdate &update)
	Updates an entity's history.

UpdateResult	update (const EntityUpdate &update)
	Updates an entity's history.

Public Member Functions inherited from MemoryContainerBase< _ContainerT, _DerivedT >
ContainerT::iterator	begin ()

ContainerT::const_iterator	begin () const

void	clear ()

bool	empty () const

ContainerT::iterator	end ()

ContainerT::const_iterator	end () const

template<class ChildFunctionT>
bool	forEachChild (ChildFunctionT &&func)

template<class ChildFunctionT>
bool	forEachChild (ChildFunctionT &&func) const

	MemoryContainerBase ()

	MemoryContainerBase (const MemoryContainerBase &other)=default

	MemoryContainerBase (const MemoryID &id)

	MemoryContainerBase (MemoryContainerBase &&other)=default

MemoryContainerBase &	operator= (const MemoryContainerBase &other)=default

MemoryContainerBase &	operator= (MemoryContainerBase &&other)=default

std::size_t	size () const

Public Member Functions inherited from MemoryItem
MemoryID &	id ()

const MemoryID &	id () const

	MemoryItem ()

	MemoryItem (const MemoryID &id)

	MemoryItem (const MemoryItem &other)=default

	MemoryItem (MemoryItem &&other)=default

MemoryItem &	operator= (const MemoryItem &other)=default

MemoryItem &	operator= (MemoryItem &&other)=default

Public Member Functions inherited from AronTyped
aron::type::ObjectPtr &	aronType ()

aron::type::ObjectPtr	aronType () const

	AronTyped (aron::type::ObjectPtr aronType=nullptr)

bool	hasAronType () const

void	setAronType (aron::type::ObjectPtr aronType)

Public Member Functions inherited from PredictiveContainer< DerivedT >
std::map< MemoryID, std::vector< PredictionEngine > >	getAllPredictionEngines () const

Public Member Functions inherited from Predictive< DerivedT >
void	addPredictionEngine (const PredictionEngine &engine)

std::map< MemoryID, std::vector< PredictionEngine > >	getAllPredictionEngines () const

const std::vector< PredictionEngine > &	predictionEngines () const

	Predictive (const std::vector< PredictionEngine > &engines={})

void	setPredictionEngines (const std::vector< PredictionEngine > &engines)

Public Member Functions inherited from ForEachEntityInstanceMixin< DerivedT >
template<class InstanceFunctionT>
bool	forEachInstance (InstanceFunctionT &&func)

template<class InstanceFunctionT>
bool	forEachInstance (InstanceFunctionT &&func) const

template<class AronDtoFunctionT>
bool	forEachInstanceAs (AronDtoFunctionT &&func) const
	Call `func` on the data of each instance converted to Aron DTO class.

template<class EntityInstanceBaseAronDtoFunctionT>
bool	forEachInstanceWithDataAs (EntityInstanceBaseAronDtoFunctionT &&func) const
	Call `func` on each instance with its data converted to Aron DTO class.

Public Member Functions inherited from ForEachEntitySnapshotMixin< DerivedT >
template<class SnapshotFunctionT>
bool	forEachSnapshot (SnapshotFunctionT &&func)

template<class SnapshotFunctionT>
bool	forEachSnapshot (SnapshotFunctionT &&func) const

Public Member Functions inherited from ForEachEntityMixin< DerivedT >
template<class FunctionT>
bool	forEachEntity (FunctionT &&func)

template<class FunctionT>
bool	forEachEntity (FunctionT &&func) const

Public Member Functions inherited from GetFindInstanceMixin< DerivedT >
auto *	findInstance (const MemoryID &instanceID)
	Find an entity instance.

const auto *	findInstance (const MemoryID &instanceID) const

auto &	getInstance (const MemoryID &instanceID)
	Retrieve an entity instance.

const auto &	getInstance (const MemoryID &instanceID) const

bool	hasInstance (const MemoryID &instanceID) const
	Indicate whether this container has an instance with the given ID.

bool	hasInstances () const
	Indicate whether this container contains at least one entity instance.

Public Member Functions inherited from GetFindSnapshotMixin< DerivedT >
auto *	findLatestInstance (const MemoryID &entityID, int instanceIndex=0)
	Find the latest entity instance in the given entity.

const auto *	findLatestInstance (const MemoryID &entityID, int instanceIndex=0) const

auto *	findLatestInstance (int instanceIndex=0)

const auto *	findLatestInstance (int instanceIndex=0) const
	Find the latest entity instance.

auto *	findLatestSnapshot ()

const auto *	findLatestSnapshot () const
	Find the latest entity snapshot.

auto *	findLatestSnapshot (const MemoryID &entityID)
	Find the latest entity snapshot in the given entity.

const auto *	findLatestSnapshot (const MemoryID &entityID) const

auto *	findSnapshot (const MemoryID &snapshotID)
	Find an entity snapshot.

const auto *	findSnapshot (const MemoryID &snapshotID) const

auto &	getSnapshot (const MemoryID &snapshotID)
	Retrieve an entity snapshot.

const auto &	getSnapshot (const MemoryID &snapshotID) const

bool	hasSnapshot (const MemoryID &snapshotID) const
	Indicates whether a snapshot with the given ID exists.

bool	hasSnapshots () const
	Indicate whether this container contains at least one entity snapshot.

Public Member Functions inherited from GetLatestInstanceMixin< DerivedT >
auto &	getLatestInstance (int instanceIndex=0)
	Retrieve the latest entity instance.

const auto &	getLatestInstance (int instanceIndex=0) const

Public Member Functions inherited from GetLatestSnapshotMixin< DerivedT >
auto &	getLatestSnapshot (int snapshotIndex=0)
	Retrieve the latest entity snapshot.

const auto &	getLatestSnapshot (int snapshotIndex=0) const

Public Member Functions inherited from GetFindEntityMixin< DerivedT >
auto *	findEntity (const MemoryID &entityID)
	Find an entity.

const auto *	findEntity (const MemoryID &entityID) const

auto &	getEntity (const MemoryID &entityID)
	Retrieve an entity.

const auto &	getEntity (const MemoryID &entityID) const

bool	hasEntity (const MemoryID &entityID) const

Public Member Functions inherited from MaxHistorySizeParent< CoreSegment >
void	setMaxHistorySize (long maxSize)
	Sets the maximum history size of entities in this container.

void	setTruncateMaxBatchSize (size_t batchSize)
	Sets the maximum batch size for truncation.

void	setUnlimitedHistoryWarningThreshold (size_t threshold)
	Sets the warning threshold for unlimited history growth.

Public Member Functions inherited from MaxHistorySize
long	getMaxHistorySize () const

size_t	getTruncateMaxBatchSize () const

size_t	getUnlimitedHistoryWarningThreshold () const

void	setMaxHistorySize (long maxSize, const std::string &additionalInfo="")
	Set the maximum number of snapshots to be contained in an entity.

void	setTruncateMaxBatchSize (size_t batchSize)
	Set the maximum number of snapshots to remove per truncate() call.

void	setUnlimitedHistoryWarningThreshold (size_t threshold)
	Set the threshold for warning about unlimited history growth.

Public Member Functions inherited from FindInstanceDataMixin< CoreSegment >
aron::data::DictPtr	findLatestInstanceData (const MemoryID &entityID, int instanceIndex=0) const

std::optional< AronDtoT >	findLatestInstanceDataAs (const MemoryID &entityID, int instanceIndex=0) const

Public Member Functions inherited from PredictionContainer< CoreSegment >
std::vector< PredictionResult >	dispatchPredictions (const std::vector< PredictionRequest > &requests)

PredictionResult	dispatchTargetedPrediction (const PredictionRequest &request, const MemoryID &target)
	Semantics: This container or one of its children (target) is responsible for performing the prediction.

	PredictionContainer (const std::map< PredictionEngine, Predictor > &predictors={})

Public Member Functions inherited from Prediction< CoreSegment >
void	addPredictor (const PredictionEngine &engine, Predictor &&predictor)

std::vector< PredictionResult >	dispatchPredictions (const std::vector< PredictionRequest > &requests)
	Resolves mapping of requests to predictors and dispatches them.

PredictionResult	dispatchTargetedPrediction (const PredictionRequest &request, const MemoryID &target)
	Dispatches a single prediction request (assuming resolution was done by the caller).

	Prediction (const std::map< PredictionEngine, Predictor > &predictors={})

void	setPredictors (const std::map< PredictionEngine, Predictor > &predictors)

Additional Inherited Members
Public Types inherited from CoreSegmentBase< ProviderSegment, CoreSegment >
using	ChildT

typedef std::map< std::string, ProviderSegment >	ContainerT

using	ContainerT

typedef CoreSegment	DerivedT

using	DerivedT

using	EntityInstanceT

using	EntitySnapshotT

using	EntityT

using	ProviderSegmentT

Public Types inherited from MemoryContainerBase< _ContainerT, _DerivedT >
using	ContainerT = _ContainerT

using	DerivedT = _DerivedT

Static Public Member Functions inherited from CoreSegmentBase< ProviderSegment, CoreSegment >
static std::string	getLevelName ()

static std::string	getLevelName ()

Protected Member Functions inherited from CoreSegmentBase< ProviderSegment, CoreSegment >
std::pair< bool, ProviderSegmentT * >	_addProviderSegmentIfMissing (const std::string &providerSegmentName)

std::pair< bool, ProviderSegmentT * >	_addProviderSegmentIfMissing (const std::string &providerSegmentName)

Protected Member Functions inherited from MemoryContainerBase< _ContainerT, _DerivedT >
template<class ChildT, class KeyT, class... ChildArgs>
ChildT &	_addChild (const KeyT &key, ChildArgs... childArgs)

void	_checkContainerName (const std::string &gottenName, const std::string &actualName, bool emptyOk=true) const

DerivedT &	_derived ()

const DerivedT &	_derived () const

ContainerT &	container ()

const ContainerT &	container () const

Protected Member Functions inherited from MemoryItem
	~MemoryItem ()

Static Protected Member Functions inherited from CoreSegmentBase< ProviderSegment, CoreSegment >
static auto *	_findEntity (ParentT &&parent, const std::string &entityName)

static auto *	_findEntity (ParentT &&parent, const std::string &entityName)

Protected Attributes inherited from MemoryContainerBase< _ContainerT, _DerivedT >
ContainerT	_container

Protected Attributes inherited from MemoryItem
MemoryID	_id

Protected Attributes inherited from AronTyped
aron::type::ObjectPtr	_aronType
	The expected Aron type. May be nullptr, in which case no type information is available.

Protected Attributes inherited from MaxHistorySize
long	_maxHistorySize = 120000
	Maximum size of entity histories.

size_t	_truncateMaxBatchSize = 100
	Maximum number of snapshots to remove per truncate() call.

size_t	_unlimitedHistoryWarningThreshold = 500000
	Threshold for warning about unlimited history growth.

Detailed Description

base::CoreSegmentBase

Definition at line 132 of file memory_definitions.h.

Member Function Documentation

◆ addProviderSegment()

template<class... Args>

ProviderSegment & addProviderSegment	(	const std::string &	name,
		Args...	args )

inline

Definition at line 148 of file memory_definitions.h.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ CoreSegmentBase() [1/6]

CoreSegmentBase ( )

inline

Definition at line 70 of file CoreSegmentBase.h.

◆ CoreSegmentBase() [2/6]

CoreSegmentBase ( const CoreSegmentBase & other )

default

◆ CoreSegmentBase() [3/6]

CoreSegmentBase	(	const MemoryID &	id,
		aron::type::ObjectPtr	aronType = nullptr,
		const std::vector< PredictionEngine > &	predictionEngines = {} )

inlineexplicit

Definition at line 89 of file CoreSegmentBase.h.

◆ CoreSegmentBase() [4/6]

CoreSegmentBase	(	const std::string &	name,
		aron::type::ObjectPtr	aronType = nullptr,
		const std::vector< PredictionEngine > &	predictionEngines = {} )

inlineexplicit

Definition at line 74 of file CoreSegmentBase.h.

◆ CoreSegmentBase() [5/6]

CoreSegmentBase	(	const std::string &	name,
		const MemoryID &	parentID,
		aron::type::ObjectPtr	aronType = nullptr,
		const std::vector< PredictionEngine > &	predictionEngines = {} )

inlineexplicit

Definition at line 81 of file CoreSegmentBase.h.

◆ CoreSegmentBase() [6/6]

CoreSegmentBase ( CoreSegmentBase && other )

default

◆ doLocked()

template<class FunctionT>

auto doLocked ( FunctionT && function ) const

inline

Execute function under shared (read) lock.

Multiple readers can hold the lock simultaneously. Use this for read-only operations (queries, GUI, etc.) Tracks lock acquisition time for debugging.

Definition at line 175 of file memory_definitions.h.

Here is the caller graph for this function:

◆ doLockedExclusive()

template<class FunctionT>

auto doLockedExclusive ( FunctionT && function )

inline

Execute function under exclusive (write) lock.

Only one writer can hold the lock, and no readers. Use this for write operations (update, add, clear, etc.) Tracks lock acquisition time for debugging.

Definition at line 208 of file memory_definitions.h.

Here is the caller graph for this function:

◆ getLockStatistics()

const CoreSegmentLockStatistics & getLockStatistics ( ) const

inline

Get lock statistics for this core segment.

Definition at line 234 of file memory_definitions.h.

◆ resetLockStatistics()

void resetLockStatistics ( )

inline

Reset lock statistics.

Definition at line 237 of file memory_definitions.h.

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

RobotAPI/libraries/armem/server/wm/memory_definitions.h

Public Member Functions

Additional Inherited Members

Detailed Description

Member Function Documentation

◆ addProviderSegment()

◆ CoreSegmentBase() [1/6]

◆ CoreSegmentBase() [2/6]

◆ CoreSegmentBase() [3/6]

◆ CoreSegmentBase() [4/6]

◆ CoreSegmentBase() [5/6]

◆ CoreSegmentBase() [6/6]

◆ doLocked()

◆ doLockedExclusive()

◆ getLockStatistics()

◆ resetLockStatistics()