#include <Group.hpp>

Inheritance diagram for geosx::dataRepository::Group:

[legend]

Public Types
using	subGroupMap = MappedVector< Group, Group *, keyType, indexType >
	The template specialization of MappedVector to use for the collection of sub-Group objects.

using	wrapperMap = MappedVector< WrapperBase, WrapperBase *, keyType, indexType >
	The template specialization of MappedVector to use for the collection wrappers objects.

Public Member Functions
virtual bool	registerCallback (void *func, const std::type_info &funcType)
	Register a callback function on the group. More...

Constructors/destructor
	Group (string const &name, Group *const parent)
	Constructor. More...

	Group (string const &name, conduit::Node &rootNode)
	Constructor. More...

	Group (Group &&source)=default
	Move constructor. More...

virtual	~Group ()
	Destructor, deletes all Groups and Wrappers owned by this Group.

	Group ()=delete
	Deleted default constructor.

	Group (Group const &)=delete
	Deleted copy constructor.

Group &	operator= (Group const &)=delete
	Deleted copy assignment operator. More...

Group &	operator= (Group &&)=delete
	Deleted move assignment operator. More...

Miscellaneous
void	printDataHierarchy (integer indent=0)
	Prints the data hierarchy recursively. More...

string	dumpInputOptions () const

Sub-group registration interface
template<typename T = Group>
T &	registerGroup (string const &name, std::unique_ptr< T > newObject)
	Register a new Group as a sub-group of current Group. More...

template<typename T = Group>
T &	registerGroup (string const &name, T *newObject)
	Register a new Group as a sub-group of current Group. More...

template<typename T = Group>
T &	registerGroup (string const &name)
	Register a new Group as a sub-group of current Group. More...

template<typename T = Group>
T &	registerGroup (subGroupMap::KeyIndex const &keyIndex)
	Register a new Group as a sub-group of current Group. More...

template<typename T = Group, typename TBASE = Group>
T &	registerGroup (string const &name, string const &catalogName)
	Register a new Group as a sub-group of current Group. More...

void	deregisterGroup (string const &name)
	Removes a child group from this group. More...

virtual Group *	createChild (string const &childKey, string const &childName)
	Creates a new sub-Group using the ObjectCatalog functionality. More...

Sub-group retrieval methods.
This collection of functions are used to get a sub-Group from the current group. Various methods for performing the lookup are provided (localIndex, string, KeyIndex), and each have their advantages and costs. The lowest cost lookup is the "localIndex" lookup. The KeyIndex lookup will add a cost for checking to make sure the index stored in KeyIndex is valid (a string compare, and a hash if it is incorrect). The string lookup is the full cost hash lookup every time that it is called. The template parameter specifies the "type" that the caller expects to lookup, and thus attempts to cast the pointer that is stored in m_subGroups to a pointer of the desired type. If this cast fails, then a `nullptr` is returned. If no template parameter is specified then a default type of Group is assumed.
template<typename T = Group, typename KEY = void>
T *	getGroupPointer (KEY const &key)
	Return a pointer to a sub-group of the current Group. More...

template<typename T = Group, typename KEY = void>
T const *	getGroupPointer (KEY const &key) const
	Return a pointer to a sub-group of the current Group. More...

template<typename T = Group, typename KEY = void>
T &	getGroup (KEY const &key)
	Return a reference to a sub-group of the current Group. More...

template<typename T = Group, typename KEY = void>
T const &	getGroup (KEY const &key) const
	Return a reference to a sub-group of the current Group. More...

template<typename T = Group>
T &	getGroupByPath (string const &path)
	Retrieve a group from the hierarchy using a path. More...

template<typename T = Group>
T const &	getGroupByPath (string const &path) const
	Retrieve a group from the hierarchy using a path. More...

subGroupMap &	getSubGroups ()
	Get the subgroups object. More...

subGroupMap const &	getSubGroups () const
	Get the subgroups object. More...

localIndex	numSubGroups () const
	return the number of sub groups in this Group More...

template<typename T = Group>
bool	hasGroup (string const &name) const
	Check whether a sub-group exists. More...

Functor-based subgroup iteration
These functions loop over sub-groups and executes a functor that uses the sub-group as an argument. The functor is only executed if the group can be cast to a certain type specified by the `ROUPTYPE/S` pack. The variadic list consisting of `GROUPTYPE/S` will be used recursively to check if the group is able to be cast to the one of these types. The first type in the `GROUPTYPE/S` list will be used to execute the functor, and the next sub-group will be processed.
template<typename GROUPTYPE = Group, typename ... GROUPTYPES, typename LAMBDA >
void	forSubGroups (LAMBDA &&lambda)
	Apply the given functor to subgroups that can be casted to one of specified types. More...

template<typename GROUPTYPE = Group, typename ... GROUPTYPES, typename LAMBDA >
void	forSubGroups (LAMBDA &&lambda) const
	Apply the given functor to subgroups that can be casted to one of specified types. More...

template<typename GROUPTYPE = Group, typename ... GROUPTYPES, typename LOOKUP_CONTAINER , typename LAMBDA >
void	forSubGroups (LOOKUP_CONTAINER const &subGroupKeys, LAMBDA &&lambda)

template<typename GROUPTYPE = Group, typename ... GROUPTYPES, typename LOOKUP_CONTAINER , typename LAMBDA >
void	forSubGroups (LOOKUP_CONTAINER const &subGroupKeys, LAMBDA &&lambda) const

Functor-based wrapper iteration
These functions loop over the wrappers contained in this group, and executes a functor that uses the Wrapper as an argument. The functor is only executed if the Wrapper can be casted to a certain type specified by the `TYPE/S` pack. The variadic list consisting of `TYPE/S` will be used recursively to check if the Wrapper is able to be casted to the one of these types. The first type in the `WRAPPERTYPE/S` list will be used to execute the functor, and the next Wrapper will be processed.
template<typename LAMBDA >
void	forWrappers (LAMBDA &&lambda)
	Apply the given functor to wrappers. More...

template<typename LAMBDA >
void	forWrappers (LAMBDA &&lambda) const
	Apply the given functor to wrappers. More...

template<typename TYPE , typename ... TYPES, typename LAMBDA >
void	forWrappers (LAMBDA &&lambda)
	Apply the given functor to wrappers that can be cast to one of specified types. More...

template<typename TYPE , typename ... TYPES, typename LAMBDA >
void	forWrappers (LAMBDA &&lambda) const
	Apply the given functor to wrappers that can be cast to one of specified types. More...

Initialization and data registration
void	initialize ()
	Run initialization functions on this and all subgroups. More...

virtual void	initializationOrder (string_array &order)
	Sets the initialization order for sub-Groups. More...

void	initializePostInitialConditions ()
	Initialization routine to be called after calling ApplyInitialConditions(). More...

void	postRestartInitializationRecursive ()
	Initialization routine to be called after calling reading a restart file. More...

void	processInputFileRecursive (xmlWrapper::xmlNode &targetNode)
	Recursively read values using ProcessInputFile() from the input file and put them into the wrapped values for this group. More...

void	postProcessInputRecursive ()
	Recursively call postProcessInput() to apply post processing after reading input values.

Wrapper registration interface
template<typename T , typename TBASE = T>
Wrapper< TBASE > &	registerWrapper (string const &name, wrapperMap::KeyIndex::index_type *const rkey=nullptr)
	Create and register a Wrapper around a new object. More...

template<typename T , typename TBASE = T>
Wrapper< TBASE > &	registerWrapper (Group::wrapperMap::KeyIndex const &viewKey)

template<typename T >
Wrapper< T > &	registerWrapper (string const &name, std::unique_ptr< T > newObject)
	Register a Wrapper around a given object and take ownership. More...

template<typename T >
Wrapper< T > &	registerWrapper (string const &name, T *newObject)
	Register a Wrapper around an existing object, does not take ownership of the object. More...

WrapperBase &	registerWrapper (string const &name, std::unique_ptr< WrapperBase > wrapper)
	Register and take ownership of an existing Wrapper. More...

void	deregisterWrapper (string const &name)
	Removes a Wrapper from this group. More...

Schema generation methods
void	generateDataStructureSkeleton (integer const level)
	Build a complete datastructure for schema generation. More...

virtual void	expandObjectCatalogs ()
	Expand any catalogs in the data structure.

virtual void	setSchemaDeviations (xmlWrapper::xmlNode schemaRoot, xmlWrapper::xmlNode schemaParent, integer documentationType)
	Inform the schema generator of any deviations between the xml and GEOS data structures. More...

Mesh data registration
virtual void	registerDataOnMeshRecursive (Group &meshBodies)
	Calls RegisterDataOnMesh() recursively. More...

virtual void	registerDataOnMesh (Group &meshBodies)
	Register data on mesh entities. More...

Packing/upacking methods
virtual localIndex	packSize (string_array const &wrapperNames, integer const recursive, bool onDevice, parallelDeviceEvents &events) const
	Get the size required to pack a list of wrappers. More...

virtual localIndex	packSize (string_array const &wrapperNames, arrayView1d< localIndex const > const &packList, integer const recursive, bool onDevice, parallelDeviceEvents &events) const
	Get the size required to pack a list of indices within a list of wrappers. More...

virtual localIndex	pack (buffer_unit_type *&buffer, string_array const &wrapperNames, integer const recursive, bool onDevice, parallelDeviceEvents &events) const
	Pack a list of wrappers to a buffer. More...

virtual localIndex	pack (buffer_unit_type *&buffer, string_array const &wrapperNames, arrayView1d< localIndex const > const &packList, integer const recursive, bool onDevice, parallelDeviceEvents &events) const
	Pack a list of indices within a list of wrappers. More...

virtual localIndex	unpack (buffer_unit_type const *&buffer, arrayView1d< localIndex > &packList, integer const recursive, bool onDevice, parallelDeviceEvents &events)
	Unpack a buffer. More...

Untyped wrapper retrieval methods
These functions query the collection of Wrapper objects for the given index/name/KeyIndex and returns a WrapperBase pointer to the object if it exists. If it is not found, nullptr is returned.
template<typename KEY >
WrapperBase const &	getWrapperBase (KEY const &key) const
	Return a reference to a WrapperBase stored in this group. More...

template<typename KEY >
WrapperBase &	getWrapperBase (KEY const &key)
	Return a reference to a WrapperBase stored in this group. More...

indexType	getWrapperIndex (string const &name) const

wrapperMap const &	wrappers () const
	Get access to the internal wrapper storage. More...

wrapperMap &	wrappers ()
	Get access to the internal wrapper storage. More...

indexType	numWrappers () const
	Return the number of wrappers. More...

Typed wrapper retrieval methods
These functions query the collection of Wrapper objects for the given index/key and returns a Wrapper<T> pointer to the object if it exists. The template parameter `T` is used to perform a cast on the WrapperBase pointer that is returned by the lookup, into a Wrapper<T> pointer. If the wrapper is not found, or the WrapperBase pointer cannot be cast to a Wrapper<T> pointer, then nullptr is returned.
template<typename LOOKUP_TYPE >
bool	hasWrapper (LOOKUP_TYPE const &lookup) const
	Check if a wrapper exists. More...

template<typename T , typename LOOKUP_TYPE >
Wrapper< T > const &	getWrapper (LOOKUP_TYPE const &index) const
	Retrieve a Wrapper stored in this group. More...

template<typename T , typename LOOKUP_TYPE >
Wrapper< T > &	getWrapper (LOOKUP_TYPE const &index)
	Retrieve a Wrapper stored in this group. More...

template<typename T , typename LOOKUP_TYPE >
Wrapper< T > const *	getWrapperPointer (LOOKUP_TYPE const &index) const
	Retrieve a Wrapper stored in this group. More...

template<typename T , typename LOOKUP_TYPE >
Wrapper< T > *	getWrapperPointer (LOOKUP_TYPE const &index)
	Retrieve a Wrapper stored in this group. More...

Wrapper data access methods.
These functions can be used to get referece/pointer access to the data stored by wrappers in this group. They are essentially just shortcuts for `Group::getWrapper()` and `Wrapper<T>::getReference()`. An additional template parameter can be provided to cast the return pointer or reference to a base class pointer or reference (e.g. Array to ArrayView).
template<typename T , typename LOOKUP_TYPE >
GEOSX_DECLTYPE_AUTO_RETURN	getReference (LOOKUP_TYPE const &lookup) const
	Look up a wrapper and get reference to wrapped object. More...

template<typename T , typename LOOKUP_TYPE >
T &	getReference (LOOKUP_TYPE const &lookup)
	Look up a wrapper and get reference to wrapped object. More...

Size/capacity management
virtual void	resize (localIndex const newSize)
	Resize the group and all contained wrappers that resize with parent. More...

virtual void	reserve (indexType const newsize)
	Set the new capacity and reserve it in all wrappers that resize with parent. More...

localIndex	capacity () const
	Get the "capacity" of the group, which determines the capacity of resizable wrappers. More...

localIndex	size () const
	Get the "size" of the group, which determines the number of elements in resizable wrappers. More...

Basic group properties
string const &	getName () const
	Get group name. More...

string	getPath () const
	Return the path of this Group in the data repository. More...

Group &	getParent ()
	Access the group's parent. More...

Group const &	getParent () const
	Access the group's parent. More...

localIndex	getIndexInParent () const
	Get the group's index withing its parent group. More...

integer	sizedFromParent () const
	Check whether this Group is resized when its parent is resized. More...

Group &	setSizedFromParent (int val)
	Set whether this wrapper is resized when its parent is resized. More...

RestartFlags	getRestartFlags () const
	Get flags that control restart output of this group. More...

void	setRestartFlags (RestartFlags flags)
	Set flags that control restart output of this group. More...

InputFlags	getInputFlags () const
	Get input flags for schema generation. More...

void	setInputFlags (InputFlags flags)
	Set input flags for schema generation. More...

Restart output methods
conduit::Node &	getConduitNode ()
	Return the Conduit node object associated with this group. More...

conduit::Node const &	getConduitNode () const
	Return the Conduit node object associated with this group. More...

void	prepareToWrite ()
	Register the group and its wrappers with Conduit.

void	finishWriting ()
	Write the group and its wrappers into Conduit.

void	loadFromConduit ()
	Read the group and its wrappers from Conduit.

void	enableLogLevelInput ()
	Enable verbosity input for object.

integer	getLogLevel () const

Static Public Member Functions
Functor application helpers
This function is useful when trying to apply a functor that passes a pointer to an container, but it is desired that the functor is only executed if the container can be casted to a certain type. The variadic list consisting of CASTTYPE/S will be used recursively to check if the container is able to be casted to the one of these types. The first type in the CASTTYPE/S list will be used to execute the functor, and the function will return true.
template<typename T0 , typename T1 , typename ... CASTTYPES, typename CONTAINERTYPE , typename LAMBDA >
static bool	applyLambdaToContainer (CONTAINERTYPE &container, LAMBDA &&lambda)
	Apply a given functor to a container if the container can be cast to one of the specified types. More...

Protected Member Functions
Overridable initialization hooks
These methods can be overridden by derived classes to customize input post processing and object initialization.
virtual void	postProcessInput ()

virtual void	initializePreSubGroups ()
	Called by Initialize() prior to initializing sub-Groups.

virtual void	initializePostSubGroups ()
	Called by Initialize() after to initializing sub-Groups.

virtual void	initializePostInitialConditionsPreSubGroups ()
	Called by InitializePostInitialConditions() prior to initializing sub-Groups.

virtual void	initializePostInitialConditionsPostSubGroups ()
	Called by InitializePostInitialConditions() after to initializing sub-Groups.

virtual void	postRestartInitialization ()
	Performs initialization required after reading from a restart file.

Static Factory Catalog Functions
using	CatalogInterface = dataRepository::CatalogInterface< Group, string const &, Group *const >
	Type alias for catalog interface used by this class. See CatalogInterface.

static CatalogInterface::CatalogType &	getCatalog ()
	Get the singleton catalog for this class. More...

Detailed Description

The Group class serves as a "node" in a hierarchy of the dataRepository. The data structure is built as a hierarchy of Group objects, or objects derived from group objects.

Definition at line 63 of file Group.hpp.

Constructor & Destructor Documentation

◆ Group() [1/3]

geosx::dataRepository::Group::Group	(	string const &	name,
		Group *const	parent
	)

explicit

Constructor.

Parameters

name	The name of this Group.
parent	The parent Group.

◆ Group() [2/3]

geosx::dataRepository::Group::Group	(	string const &	name,
		conduit::Node &	rootNode
	)

explicit

Constructor.

Parameters

name	The name of this Group.
rootNode	The root node of the data repository.

Note: This Group will not have a parent group.

◆ Group() [3/3]

geosx::dataRepository::Group::Group ( Group && source )

default

Move constructor.

Parameters

[in] source source Group

Member Function Documentation

◆ applyLambdaToContainer()

template<typename T0 , typename T1 , typename ... CASTTYPES, typename CONTAINERTYPE , typename LAMBDA >

static bool geosx::dataRepository::Group::applyLambdaToContainer	(	CONTAINERTYPE &	container,
		LAMBDA &&	lambda
	)

inlinestatic

Apply a given functor to a container if the container can be cast to one of the specified types.

Template Parameters

CASTTYPE	the first type that will be used in the attempted casting of container
CASTTYPES	a variadic list of types that will be used in the attempted casting of container
CONTAINERTYPE	the type of container
LAMBDA	the type of lambda function to call in the function

Parameters

[in]	container	a pointer to the container which will be passed to the lambda function
[in]	lambda	the lambda function to call in the function

Returns: a boolean to indicate whether the lambda was successfully applied to the container.

Definition at line 433 of file Group.hpp.

◆ capacity()

localIndex geosx::dataRepository::Group::capacity ( ) const

inline

Get the "capacity" of the group, which determines the capacity of resizable wrappers.

Returns: capacity of this group

Definition at line 1135 of file Group.hpp.

◆ createChild()

virtual Group* geosx::dataRepository::Group::createChild	(	string const &	childKey,
		string const &	childName
	)

virtual

Creates a new sub-Group using the ObjectCatalog functionality.

Parameters

[in]	childKey	The name of the new object type's key in the ObjectCatalog.
[in]	childName	The name of the new object in the collection of sub-Groups.

Returns: A pointer to the new Group created by this function.

Reimplemented in geosx::ElementRegionManager, geosx::InternalWellGenerator, geosx::PAMELAMeshGenerator, geosx::CellBlockManager, geosx::GeometricObjectManager, geosx::InternalMeshGenerator, geosx::FiniteVolumeManager, geosx::MeshManager, and geosx::OutputManager.

◆ deregisterGroup()

void geosx::dataRepository::Group::deregisterGroup ( string const & name )

Removes a child group from this group.

Parameters

name	the name of the child group to remove from this group.

◆ deregisterWrapper()

void geosx::dataRepository::Group::deregisterWrapper ( string const & name )

Removes a Wrapper from this group.

Parameters

name	the name of the Wrapper to remove from this group.

◆ dumpInputOptions()

string geosx::dataRepository::Group::dumpInputOptions ( ) const

Returns: a table formatted string containing all input options.

◆ forSubGroups() [1/4]

template<typename GROUPTYPE = Group, typename ... GROUPTYPES, typename LAMBDA >

void geosx::dataRepository::Group::forSubGroups ( LAMBDA && lambda )

inline

Apply the given functor to subgroups that can be casted to one of specified types.

Template Parameters

GROUPTYPE	the first type that will be used in the attempted casting of group.
GROUPTYPES	a variadic list of types that will be used in the attempted casting of group.
LAMBDA	the type of functor to call

Parameters

[in] lambda the functor to call on subgroups

Definition at line 469 of file Group.hpp.

◆ forSubGroups() [2/4]

template<typename GROUPTYPE = Group, typename ... GROUPTYPES, typename LAMBDA >

void geosx::dataRepository::Group::forSubGroups ( LAMBDA && lambda ) const

inline

Apply the given functor to subgroups that can be casted to one of specified types.

Template Parameters

GROUPTYPE	the first type that will be used in the attempted casting of group.
GROUPTYPES	a variadic list of types that will be used in the attempted casting of group.
LAMBDA	the type of functor to call

Parameters

[in] lambda the functor to call on subgroups

Definition at line 484 of file Group.hpp.

◆ forSubGroups() [3/4]

template<typename GROUPTYPE = Group, typename ... GROUPTYPES, typename LOOKUP_CONTAINER , typename LAMBDA >

void geosx::dataRepository::Group::forSubGroups	(	LOOKUP_CONTAINER const &	subGroupKeys,
		LAMBDA &&	lambda
	)

inline

Apply the given functor to subgroups that can be casted to one of specified types.

Template Parameters

GROUPTYPE	the first type that will be used in the attempted casting of group.
GROUPTYPES	a variadic list of types that will be used in the attempted casting of group.
LOOKUP_CONTAINER	type of container of subgroup lookup keys (names or indices), must support range-based for loop
LAMBDA	type of functor callable with an index in lookup container and a reference to casted subgroup

Parameters

[in]	subGroupKeys	container with subgroup lookup keys (e.g. names or indices) to apply the functor to
[in]	lambda	the functor to call

Definition at line 507 of file Group.hpp.

◆ forSubGroups() [4/4]

template<typename GROUPTYPE = Group, typename ... GROUPTYPES, typename LOOKUP_CONTAINER , typename LAMBDA >

void geosx::dataRepository::Group::forSubGroups	(	LOOKUP_CONTAINER const &	subGroupKeys,
		LAMBDA &&	lambda
	)		const

inline

Apply the given functor to subgroups that can be casted to one of specified types.

Template Parameters

GROUPTYPE	the first type that will be used in the attempted casting of group.
GROUPTYPES	a variadic list of types that will be used in the attempted casting of group.
LOOKUP_CONTAINER	type of container of subgroup lookup keys (names or indices), must support range-based for loop
LAMBDA	type of functor callable with an index in lookup container and a reference to casted subgroup

Parameters

[in]	subGroupKeys	container with subgroup lookup keys (e.g. names or indices) to apply the functor to
[in]	lambda	the functor to call

Definition at line 532 of file Group.hpp.

◆ forWrappers() [1/4]

template<typename LAMBDA >

void geosx::dataRepository::Group::forWrappers ( LAMBDA && lambda )

inline

Apply the given functor to wrappers.

Template Parameters

LAMBDA the type of functor to call

Parameters

[in] lambda the functor to call

Definition at line 564 of file Group.hpp.

◆ forWrappers() [2/4]

template<typename LAMBDA >

void geosx::dataRepository::Group::forWrappers ( LAMBDA && lambda ) const

inline

Apply the given functor to wrappers.

Template Parameters

LAMBDA the type of functor to call

Parameters

[in] lambda the functor to call

Definition at line 576 of file Group.hpp.

◆ forWrappers() [3/4]

template<typename TYPE , typename ... TYPES, typename LAMBDA >

void geosx::dataRepository::Group::forWrappers ( LAMBDA && lambda )

inline

Apply the given functor to wrappers that can be cast to one of specified types.

Template Parameters

TYPE	the first type that will be used in the attempted casting of Wrapper
TYPES	a variadic list of types that will be used in the attempted casting of Wrapper
LAMBDA	the type of functor to call

Parameters

[in] lambda the functor to call

Definition at line 592 of file Group.hpp.

◆ forWrappers() [4/4]

template<typename TYPE , typename ... TYPES, typename LAMBDA >

void geosx::dataRepository::Group::forWrappers ( LAMBDA && lambda ) const

inline

Apply the given functor to wrappers that can be cast to one of specified types.

Template Parameters

TYPE	the first type that will be used in the attempted casting of Wrapper
TYPES	a variadic list of types that will be used in the attempted casting of Wrapper
LAMBDA	the type of functor to call

Parameters

[in] lambda the functor to call

Definition at line 609 of file Group.hpp.

◆ generateDataStructureSkeleton()

void geosx::dataRepository::Group::generateDataStructureSkeleton ( integer const level )

inline

Build a complete datastructure for schema generation.

Parameters

level indent level for printing out the structure

Definition at line 768 of file Group.hpp.

◆ getCatalog()

static CatalogInterface::CatalogType& geosx::dataRepository::Group::getCatalog ( )

static

Get the singleton catalog for this class.

Returns: reference to the catalog object

◆ getConduitNode() [1/2]

conduit::Node& geosx::dataRepository::Group::getConduitNode ( )

inline

Return the Conduit node object associated with this group.

Returns: The Conduit node object associated with this group.

Definition at line 1257 of file Group.hpp.

◆ getConduitNode() [2/2]

conduit::Node const& geosx::dataRepository::Group::getConduitNode ( ) const

inline

Return the Conduit node object associated with this group.

Returns: The Conduit node object associated with this group.

Definition at line 1261 of file Group.hpp.

◆ getGroup() [1/2]

template<typename T = Group, typename KEY = void>

T& geosx::dataRepository::Group::getGroup ( KEY const & key )

inline

Return a reference to a sub-group of the current Group.

Template Parameters

T	The type of subgroup.
KEY	The type of the lookup.

Parameters

key	The key used to perform the lookup.

Returns: A reference to T that refers to the sub-group.

Exceptions

std::domain_error If the Group does not exist is thrown.

Definition at line 322 of file Group.hpp.

◆ getGroup() [2/2]

template<typename T = Group, typename KEY = void>

T const& geosx::dataRepository::Group::getGroup ( KEY const & key ) const

inline

Return a reference to a sub-group of the current Group.

Template Parameters

T	The type of subgroup.
KEY	The type of the lookup.

Parameters

key	The key used to perform the lookup.

Returns: A reference to T that refers to the sub-group.

Exceptions

std::domain_error If the Group does not exist is thrown.

Definition at line 333 of file Group.hpp.

◆ getGroupByPath() [1/2]

template<typename T = Group>

T& geosx::dataRepository::Group::getGroupByPath ( string const & path )

inline

Retrieve a group from the hierarchy using a path.

Template Parameters

T	type of subgroup

Parameters

[in] path a unix-style string (absolute, relative paths valid) to lookup the Group to return. Absolute paths search from the tree root, while relative - from current group.

Returns: A reference to T that refers to the sub-group.

Exceptions

std::domain_error If the Group doesn't exist.

Definition at line 350 of file Group.hpp.

◆ getGroupByPath() [2/2]

template<typename T = Group>

T const& geosx::dataRepository::Group::getGroupByPath ( string const & path ) const

inline

Retrieve a group from the hierarchy using a path.

Template Parameters

T	type of subgroup

Parameters

[in] path a unix-style string (absolute, relative paths valid) to lookup the Group to return. Absolute paths search from the tree root, while relative - from current group.

Returns: A reference to T that refers to the sub-group.

Exceptions

std::domain_error If the Group doesn't exist.

Definition at line 357 of file Group.hpp.

◆ getGroupPointer() [1/2]

template<typename T = Group, typename KEY = void>

T* geosx::dataRepository::Group::getGroupPointer ( KEY const & key )

inline

Return a pointer to a sub-group of the current Group.

Template Parameters

T	The type of subgroup.
KEY	The type of the lookup.

Parameters

key	The key used to perform the lookup.

Returns: A pointer to T that refers to the sub-group, if the Group does not exist or it has an incompatible type a nullptr is returned.

Definition at line 303 of file Group.hpp.

◆ getGroupPointer() [2/2]

template<typename T = Group, typename KEY = void>

T const* geosx::dataRepository::Group::getGroupPointer ( KEY const & key ) const

inline

Return a pointer to a sub-group of the current Group.

Template Parameters

T	The type of subgroup.
KEY	The type of the lookup.

Parameters

key	The key used to perform the lookup.

Returns: A pointer to T that refers to the sub-group, if the Group does not exist or it has an incompatible type a nullptr is returned.

Definition at line 310 of file Group.hpp.

◆ getIndexInParent()

localIndex geosx::dataRepository::Group::getIndexInParent ( ) const

inline

Get the group's index withing its parent group.

Returns: integral index of current group within its parent

Definition at line 1189 of file Group.hpp.

◆ getInputFlags()

InputFlags geosx::dataRepository::Group::getInputFlags ( ) const

inline

Get input flags for schema generation.

Returns: the current value of input flags

Definition at line 1225 of file Group.hpp.

◆ getLogLevel()

integer geosx::dataRepository::Group::getLogLevel ( ) const

inline

Returns: The verbosity level

Definition at line 1283 of file Group.hpp.

◆ getName()

string const& geosx::dataRepository::Group::getName ( ) const

inline

Get group name.

Returns: group name

Definition at line 1156 of file Group.hpp.

◆ getParent() [1/2]

Group& geosx::dataRepository::Group::getParent ( )

inline

Access the group's parent.

Returns: reference to parent Group

Exceptions

std::domain_error if the Group doesn't have a parent.

Definition at line 1170 of file Group.hpp.

◆ getParent() [2/2]

Group const& geosx::dataRepository::Group::getParent ( ) const

inline

Access the group's parent.

Returns: reference to parent Group

Exceptions

std::domain_error if the Group doesn't have a parent.

Definition at line 1179 of file Group.hpp.

◆ getPath()

string geosx::dataRepository::Group::getPath ( ) const

Return the path of this Group in the data repository.

Returns: The path of this group in the data repository.

◆ getReference() [1/2]

template<typename T , typename LOOKUP_TYPE >

GEOSX_DECLTYPE_AUTO_RETURN geosx::dataRepository::Group::getReference ( LOOKUP_TYPE const & lookup ) const

inline

Look up a wrapper and get reference to wrapped object.

Template Parameters

T	return value type
WRAPPEDTYPE	wrapped value type (by default, same as return)
LOOKUP_TYPE	type of value used for wrapper lookup

Parameters

lookup value for wrapper lookup

Returns: reference to T

Exceptions

A	std::domain_error if the Wrapper does not exist.

Definition at line 1100 of file Group.hpp.

◆ getReference() [2/2]

template<typename T , typename LOOKUP_TYPE >

T& geosx::dataRepository::Group::getReference ( LOOKUP_TYPE const & lookup )

inline

Look up a wrapper and get reference to wrapped object.

Template Parameters

T	return value type
WRAPPEDTYPE	wrapped value type (by default, same as return)
LOOKUP_TYPE	type of value used for wrapper lookup

Parameters

lookup value for wrapper lookup

Returns: reference to T

Exceptions

A	std::domain_error if the Wrapper does not exist.

Definition at line 1107 of file Group.hpp.

◆ getRestartFlags()

RestartFlags geosx::dataRepository::Group::getRestartFlags ( ) const

inline

Get flags that control restart output of this group.

Returns: the current value of restart flags

Definition at line 1213 of file Group.hpp.

◆ getSubGroups() [1/2]

subGroupMap& geosx::dataRepository::Group::getSubGroups ( )

inline

Get the subgroups object.

Returns: a reference to the sub-group map.

Definition at line 366 of file Group.hpp.

◆ getSubGroups() [2/2]

subGroupMap const& geosx::dataRepository::Group::getSubGroups ( ) const

inline

Get the subgroups object.

Returns: a reference to const that points to the sub-group map.

Definition at line 373 of file Group.hpp.

◆ getWrapper() [1/2]

template<typename T , typename LOOKUP_TYPE >

Wrapper< T > const& geosx::dataRepository::Group::getWrapper ( LOOKUP_TYPE const & index ) const

inline

Retrieve a Wrapper stored in this group.

Template Parameters

T	the object type contained in the Wrapper
LOOKUP_TYPE	the type of key used to perform the lookup

Parameters

[in] index a lookup value used to search the collection of wrappers

Returns: A reference to the Wrapper<T> that resulted from the lookup.

Exceptions

std::domain_error if the Wrapper doesn't exist.

Definition at line 1041 of file Group.hpp.

◆ getWrapper() [2/2]

template<typename T , typename LOOKUP_TYPE >

Wrapper< T >& geosx::dataRepository::Group::getWrapper ( LOOKUP_TYPE const & index )

inline

Retrieve a Wrapper stored in this group.

Template Parameters

T	the object type contained in the Wrapper
LOOKUP_TYPE	the type of key used to perform the lookup

Parameters

[in] index a lookup value used to search the collection of wrappers

Returns: A reference to the Wrapper<T> that resulted from the lookup.

Exceptions

std::domain_error if the Wrapper doesn't exist.

Definition at line 1051 of file Group.hpp.

◆ getWrapperBase() [1/2]

template<typename KEY >

WrapperBase const& geosx::dataRepository::Group::getWrapperBase ( KEY const & key ) const

inline

Return a reference to a WrapperBase stored in this group.

Template Parameters

KEY	The lookup type.

Parameters

key	The value used to lookup the wrapper.

Returns: A reference to the WrapperBase that resulted from the lookup.

Exceptions

std::domain_error if the wrapper doesn't exist.

Definition at line 961 of file Group.hpp.

◆ getWrapperBase() [2/2]

template<typename KEY >

WrapperBase& geosx::dataRepository::Group::getWrapperBase ( KEY const & key )

inline

Return a reference to a WrapperBase stored in this group.

Template Parameters

KEY	The lookup type.

Parameters

key	The value used to lookup the wrapper.

Returns: A reference to the WrapperBase that resulted from the lookup.

Exceptions

std::domain_error if the wrapper doesn't exist.

Definition at line 972 of file Group.hpp.

◆ getWrapperIndex()

indexType geosx::dataRepository::Group::getWrapperIndex ( string const & name ) const

inline

Parameters

name

Returns

Definition at line 984 of file Group.hpp.

◆ getWrapperPointer() [1/2]

template<typename T , typename LOOKUP_TYPE >

Wrapper< T > const* geosx::dataRepository::Group::getWrapperPointer ( LOOKUP_TYPE const & index ) const

inline

Retrieve a Wrapper stored in this group.

Template Parameters

T	the object type contained in the Wrapper
LOOKUP_TYPE	the type of key used to perform the lookup

Parameters

[in] index a lookup value used to search the collection of wrappers

Returns: A pointer to the Wrapper<T> that resulted from the lookup, if the Wrapper doesn't exist or has a different type a nullptr is returned.

Definition at line 1066 of file Group.hpp.

◆ getWrapperPointer() [2/2]

template<typename T , typename LOOKUP_TYPE >

Wrapper< T >* geosx::dataRepository::Group::getWrapperPointer ( LOOKUP_TYPE const & index )

inline

Retrieve a Wrapper stored in this group.

Template Parameters

T	the object type contained in the Wrapper
LOOKUP_TYPE	the type of key used to perform the lookup

Parameters

[in] index a lookup value used to search the collection of wrappers

Returns: A pointer to the Wrapper<T> that resulted from the lookup, if the Wrapper doesn't exist or has a different type a nullptr is returned.

Definition at line 1073 of file Group.hpp.

◆ hasGroup()

template<typename T = Group>

bool geosx::dataRepository::Group::hasGroup ( string const & name ) const

inline

Check whether a sub-group exists.

Parameters

name	the name of sub-group to search for

Returns: true if sub-group exists, false otherwise

Definition at line 388 of file Group.hpp.

◆ hasWrapper()

template<typename LOOKUP_TYPE >

bool geosx::dataRepository::Group::hasWrapper ( LOOKUP_TYPE const & lookup ) const

inline

Check if a wrapper exists.

Template Parameters

LOOKUP_TYPE the type of key used to perform the lookup.

Parameters

[in] lookup a lookup value used to search the collection of wrappers

Returns: true if wrapper exists (regardless of type), false otherwise

Definition at line 1029 of file Group.hpp.

◆ initializationOrder()

virtual void geosx::dataRepository::Group::initializationOrder ( string_array & order )

virtual

Sets the initialization order for sub-Groups.

Parameters

[out] order An array of strings that define the iteration order.

This function will fill the order array that is used to specify the order in which the Initialize() function loops over sub-Groups. If a custom order is required by a derived type, this function should be overridden with a implementation that specifies the desired order.

Reimplemented in geosx::DomainPartition.

◆ initialize()

void geosx::dataRepository::Group::initialize ( )

Run initialization functions on this and all subgroups.

Parameters

[in] root A group that is passed in to the initialization functions in order to facilitate the initialization.

This function will first call initializePreSubGroups() on this Group, then loop over all subgroups and call Initialize() on them, then call InitializePostSubGroups() on this Group.

Note: The order in which the sub-Groups are iterated over is defined by InitializationOrder().

◆ initializePostInitialConditions()

void geosx::dataRepository::Group::initializePostInitialConditions ( )

Initialization routine to be called after calling ApplyInitialConditions().

This function provides a capability for post-initial condition problem initialization. First the InitializePostInitialConditions_PreSubGroups() function is called on this Group. Then there is a loop over all subgroups and InitializePostInitialConditions() is called on them. Finally, the InitializePostInitialConditions_PostSubGroups() function is called this Group.

Note: The order in which the sub-Groups are iterated over is defined by InitializationOrder().

◆ numSubGroups()

localIndex geosx::dataRepository::Group::numSubGroups ( ) const

inline

return the number of sub groups in this Group

Returns: number of sub groups in this Group

Definition at line 380 of file Group.hpp.

◆ numWrappers()

indexType geosx::dataRepository::Group::numWrappers ( ) const

inline

Return the number of wrappers.

Returns: The number of wrappers.

Definition at line 1004 of file Group.hpp.

◆ operator=() [1/2]

Group& geosx::dataRepository::Group::operator= ( Group const & )

delete

Deleted copy assignment operator.

Returns

◆ operator=() [2/2]

Group& geosx::dataRepository::Group::operator= ( Group && )

delete

Deleted move assignment operator.

Returns

◆ pack() [1/2]

virtual localIndex geosx::dataRepository::Group::pack	(	buffer_unit_type *&	buffer,
		string_array const &	wrapperNames,
		integer const	recursive,
		bool	onDevice,
		parallelDeviceEvents &	events
	)		const

virtual

Pack a list of wrappers to a buffer.

Parameters

[in,out]	buffer	the buffer that will be packed.
[in]	wrapperNames	an array that contains the names of the wrappers to pack.
[in]	recursive	whether or not to perform a recursive pack.
[in]	onDevice	whether to use device-based packing functions (buffer must be either pinned or a device pointer)
[out]	events	a collection of events to poll for completion of async packing kernels ( device packing is incomplete until all events are finalized )

Returns: the size of data packed to the buffer.

This function takes in a reference to a pointer buffer, and packs data specified by wrapperNames, and recursive to that pointer location. The pointer is altered and returned to the new location corresponding the original value of buffer plus the size of data packed to the buffer.

◆ pack() [2/2]

virtual localIndex geosx::dataRepository::Group::pack	(	buffer_unit_type *&	buffer,
		string_array const &	wrapperNames,
		arrayView1d< localIndex const > const &	packList,
		integer const	recursive,
		bool	onDevice,
		parallelDeviceEvents &	events
	)		const

virtual

Pack a list of indices within a list of wrappers.

Parameters

[in,out]	buffer	the buffer that will be packed.
[in]	wrapperNames	an array that contains the names of the wrappers to pack.
[in]	packList	the list of indices to pack
[in]	recursive	whether or not to perform a recursive pack.
[in]	onDevice	whether to use device-based packing functions (buffer must be either pinned or a device pointer)
[out]	events	a collection of events to poll for completion of async packing kernels ( device packing is incomplete until all events are finalized )

Returns: the size of data packed to the buffer.

This function takes in a reference to a pointer buffer, and packs data specified by wrapperNames, packList, and recursive to that pointer location. The pointer is altered and returned to the new location corresponding the original value of buffer plus the size of data packed to the buffer.

Reimplemented in geosx::ObjectManagerBase.

◆ packSize() [1/2]

virtual localIndex geosx::dataRepository::Group::packSize	(	string_array const &	wrapperNames,
		integer const	recursive,
		bool	onDevice,
		parallelDeviceEvents &	events
	)		const

virtual

Get the size required to pack a list of wrappers.

Parameters

[in]	wrapperNames	an array that contains the names of the wrappers to pack.
[in]	recursive	whether or not to perform a recursive pack.
[in]	onDevice	whether to use device-based packing functions (buffer must be either pinned or a device pointer)
[out]	events	a collection of events to poll for completion of async packing kernels ( device packing is incomplete until all events are finalized )

Returns: the size of the buffer required to pack the wrappers.

◆ packSize() [2/2]

virtual localIndex geosx::dataRepository::Group::packSize	(	string_array const &	wrapperNames,
		arrayView1d< localIndex const > const &	packList,
		integer const	recursive,
		bool	onDevice,
		parallelDeviceEvents &	events
	)		const

virtual

Get the size required to pack a list of indices within a list of wrappers.

Parameters

[in]	wrapperNames	an array that contains the names of the wrappers to pack.
[in]	packList	the list of indices to pack
[in]	recursive	whether or not to perform a recursive pack.
[in]	onDevice	whether to use device-based packing functions (buffer must be either pinned or a device pointer)
[out]	events	a collection of events to poll for completion of async packing kernels ( device packing is incomplete until all events are finalized )

Returns: the size of the buffer required to pack the wrapper indices.

Reimplemented in geosx::ObjectManagerBase.

◆ postProcessInput()

virtual void geosx::dataRepository::Group::postProcessInput ( )

inlineprotectedvirtual

This function provides capability to post process input values prior to any other initialization operations.

Reimplemented in geosx::InternalWellGenerator, geosx::InternalMeshGenerator, geosx::BoundedPlane, geosx::Perforation, geosx::ThickPlane, geosx::InternalWellboreGenerator, geosx::PAMELAMeshGenerator, geosx::Box, and geosx::VTKOutput.

Definition at line 1300 of file Group.hpp.

◆ postRestartInitializationRecursive()

void geosx::dataRepository::Group::postRestartInitializationRecursive ( )

Initialization routine to be called after calling reading a restart file.

This functions recurses and calls postRestartInitialization() on nested sub-groups at any depth, providing a capability to add custom post-restart initialization.

◆ printDataHierarchy()

void geosx::dataRepository::Group::printDataHierarchy ( integer indent = 0 )

Prints the data hierarchy recursively.

Parameters

[in] indent The level of indentation to add to this level of output.

◆ processInputFileRecursive()

void geosx::dataRepository::Group::processInputFileRecursive ( xmlWrapper::xmlNode & targetNode )

Recursively read values using ProcessInputFile() from the input file and put them into the wrapped values for this group.

Parameters

[in] targetNode the XML node that to extract input values from.

◆ registerCallback()

virtual bool geosx::dataRepository::Group::registerCallback	(	void *	func,
		const std::type_info &	funcType
	)

inlinevirtual

Register a callback function on the group.

Parameters

func	the function to register
funcType	the type of the function to register

Returns: true if successful, false else

Definition at line 1241 of file Group.hpp.

◆ registerDataOnMesh()

virtual void geosx::dataRepository::Group::registerDataOnMesh ( Group & meshBodies )

inlinevirtual

Register data on mesh entities.

Parameters

[in,out] meshBodies the group of MeshBody objects to register data on.

This function is used to register data on mesh entities such as the NodeManager, FaceManager...etc.

Reimplemented in geosx::FluxApproximationBase, and geosx::HybridMimeticDiscretization.

Definition at line 820 of file Group.hpp.

◆ registerDataOnMeshRecursive()

virtual void geosx::dataRepository::Group::registerDataOnMeshRecursive ( Group & meshBodies )

virtual

Calls RegisterDataOnMesh() recursively.

Parameters

[in,out] meshBodies the group of MeshBody objects to register data on.

◆ registerGroup() [1/5]

template<typename T = Group>

T& geosx::dataRepository::Group::registerGroup	(	string const &	name,
		std::unique_ptr< T >	newObject
	)

inline

Register a new Group as a sub-group of current Group.

Template Parameters

T	The type of the Group to add/register. This should be a type that derives from Group.

Parameters

[in]	name	The name of the group to use as a string key.
[in]	newObject	A unique_ptr to the object that is being registered.

Returns: A pointer to the newly registered Group.

Registers a Group or class derived from Group as a subgroup of this Group and takes ownership.

Definition at line 186 of file Group.hpp.

◆ registerGroup() [2/5]

template<typename T = Group>

T& geosx::dataRepository::Group::registerGroup	(	string const &	name,
		T *	newObject
	)

inline

Register a new Group as a sub-group of current Group.

Template Parameters

T	The type of the Group to add/register. This should be a type that derives from Group.

Parameters

[in]	name	The name of the group to use as a string key.
[in]	newObject	A unique_ptr to the object that is being registered.

Returns: A pointer to the newly registered Group.

Registers a Group or class derived from Group as a subgroup of this Group but does not take ownership.

Definition at line 203 of file Group.hpp.

◆ registerGroup() [3/5]

template<typename T = Group>

T& geosx::dataRepository::Group::registerGroup ( string const & name )

inline

Register a new Group as a sub-group of current Group.

Template Parameters

T	The type of the Group to add/register. This should be a type that derives from Group.

Parameters

[in] name The name of the group to use as a string key.

Returns: A pointer to the newly registered Group.

Creates and registers a Group or class derived from Group as a subgroup of this Group.

Definition at line 217 of file Group.hpp.

◆ registerGroup() [4/5]

template<typename T = Group>

T& geosx::dataRepository::Group::registerGroup ( subGroupMap::KeyIndex const & keyIndex )

inline

Register a new Group as a sub-group of current Group.

Template Parameters

T	The type of the Group to add/register. This should be a type that derives from Group.

Parameters

keyIndex A KeyIndexT object that will be used to specify the name of the new group. The index of the KeyIndex will also be set.

Returns: A pointer to the newly registered Group, or nullptr if no group was registered.

Creates and registers a Group or class derived from Group as a subgroup of this Group.

Definition at line 231 of file Group.hpp.

◆ registerGroup() [5/5]

template<typename T = Group, typename TBASE = Group>

T& geosx::dataRepository::Group::registerGroup	(	string const &	name,
		string const &	catalogName
	)

inline

Register a new Group as a sub-group of current Group.

Template Parameters

T	The type of the Group to add/register. This should be a type that derives from Group.
TBASE	The type whose type catalog will be used to look up the new sub-group type

Parameters

[in]	name	The name of the group to use as a string key.
[in]	catalogName	The catalog name of the new type.

Returns: A pointer to the newly registered Group.

Creates and registers a Group or class derived from Group as a subgroup of this Group.

Definition at line 250 of file Group.hpp.

◆ registerWrapper() [1/5]

template<typename T , typename TBASE = T>

Wrapper< TBASE >& geosx::dataRepository::Group::registerWrapper	(	string const &	name,
		wrapperMap::KeyIndex::index_type *const	rkey = `nullptr`
	)

Create and register a Wrapper around a new object.

Template Parameters

T	The type of the object allocated.
TBASE	The type of the object that the Wrapper holds.

Parameters

[in]	name	the name of the wrapper to use as a string key
[out]	rkey	a pointer to a index type that will be filled with the new Wrapper index in this Group

Returns: A reference to the newly registered/created Wrapper

◆ registerWrapper() [2/5]

template<typename T , typename TBASE >

Wrapper< TBASE > & geosx::dataRepository::Group::registerWrapper ( Group::wrapperMap::KeyIndex const & viewKey )

Create and register a Wrapper around a new object.

Template Parameters

T	the type of the wrapped object
TBASE	the base type to cast the returned wrapper to

Parameters

[in] viewKey The KeyIndex that contains the name of the new Wrapper.

Returns: A reference to the newly registered/created Wrapper

Definition at line 1419 of file Group.hpp.

◆ registerWrapper() [3/5]

template<typename T >

Wrapper< T > & geosx::dataRepository::Group::registerWrapper	(	string const &	name,
		std::unique_ptr< T >	newObject
	)

Register a Wrapper around a given object and take ownership.

Template Parameters

T	the type of the wrapped object

Parameters

[in]	name	the name of the wrapper to use as a string key
[in]	newObject	an owning pointer to the object that is being registered

Returns: A reference to the newly registered/created Wrapper

Definition at line 1430 of file Group.hpp.

◆ registerWrapper() [4/5]

template<typename T >

Wrapper< T > & geosx::dataRepository::Group::registerWrapper	(	string const &	name,
		T *	newObject
	)

Register a Wrapper around an existing object, does not take ownership of the object.

Template Parameters

T	the type of the wrapped object

Parameters

[in]	name	the name of the wrapper to use as a string key
[in]	newObject	a pointer to the object that is being registered

Returns: A reference to the newly registered/created Wrapper

Definition at line 1446 of file Group.hpp.

◆ registerWrapper() [5/5]

WrapperBase& geosx::dataRepository::Group::registerWrapper	(	string const &	name,
		std::unique_ptr< WrapperBase >	wrapper
	)

Register and take ownership of an existing Wrapper.

Parameters

name	The name of the wrapper to use as a string key
wrapper	A pointer to the an existing wrapper.

Returns: An un-typed pointer to the newly registered/created wrapper

◆ reserve()

virtual void geosx::dataRepository::Group::reserve ( indexType const newsize )

virtual

Set the new capacity and reserve it in all wrappers that resize with parent.

Parameters

newsize the new capacity of the group

◆ resize()

virtual void geosx::dataRepository::Group::resize ( localIndex const newSize )

virtual

Resize the group and all contained wrappers that resize with parent.

Parameters

newSize the new size of the group

Reimplemented in geosx::FaceManager, geosx::NodeManager, geosx::EmbeddedSurfaceNodeManager, and geosx::EdgeManager.

◆ setInputFlags()

void geosx::dataRepository::Group::setInputFlags ( InputFlags flags )

inline

Set input flags for schema generation.

Parameters

flags the new value of input flags

Definition at line 1231 of file Group.hpp.

◆ setRestartFlags()

void geosx::dataRepository::Group::setRestartFlags ( RestartFlags flags )

inline

Set flags that control restart output of this group.

Parameters

flags the new value of restart flags

Definition at line 1219 of file Group.hpp.

◆ setSchemaDeviations()

virtual void geosx::dataRepository::Group::setSchemaDeviations	(	xmlWrapper::xmlNode	schemaRoot,
		xmlWrapper::xmlNode	schemaParent,
		integer	documentationType
	)

inlinevirtual

Inform the schema generator of any deviations between the xml and GEOS data structures.

Parameters

schemaRoot	XML node corresponding to the root
schemaParent	XML node for the parent node
documentationType	type of XML schema generated

Reimplemented in geosx::ElementRegionManager.

Definition at line 791 of file Group.hpp.

◆ setSizedFromParent()

Group& geosx::dataRepository::Group::setSizedFromParent ( int val )

inline

Set whether this wrapper is resized when its parent is resized.

Parameters

val	an int that is converted into a bool

Returns: a pointer to this Group

Definition at line 1204 of file Group.hpp.

◆ size()

localIndex geosx::dataRepository::Group::size ( ) const

inline

Get the "size" of the group, which determines the number of elements in resizable wrappers.

Returns: size of this group

Definition at line 1142 of file Group.hpp.

◆ sizedFromParent()

integer geosx::dataRepository::Group::sizedFromParent ( ) const

inline

Check whether this Group is resized when its parent is resized.

Returns: true if Group is resized with parent group, false otherwise

Definition at line 1196 of file Group.hpp.

◆ unpack()

virtual localIndex geosx::dataRepository::Group::unpack	(	buffer_unit_type const *&	buffer,
		arrayView1d< localIndex > &	packList,
		integer const	recursive,
		bool	onDevice,
		parallelDeviceEvents &	events
	)

virtual

Unpack a buffer.

Parameters

[in,out]	buffer	the buffer to unpack
[in,out]	packList	the list of indices that will be unpacked.
[in]	recursive	whether or not to perform a recursive unpack.
[in]	onDevice	whether to use device-based packing functions (buffer must be either pinned or a device pointer)
[out]	events	a collection of events to poll for completion of async packing kernels ( device packing is incomplete until all events are finalized )

Returns: the number of bytes unpacked.

This function takes a reference to a pointer to const buffer type, and unpacks data from that buffer into the current Group. If packList is non-empty, then a check is made to ensure that the data that is unpacked matches packList. If packList is empty, the values of the indices that are unpacked are stored and returned in packList.

Reimplemented in geosx::ObjectManagerBase.

◆ wrappers() [1/2]

wrapperMap const& geosx::dataRepository::Group::wrappers ( ) const

inline

Get access to the internal wrapper storage.

Returns: a reference to wrapper map

Definition at line 991 of file Group.hpp.

◆ wrappers() [2/2]

wrapperMap& geosx::dataRepository::Group::wrappers ( )

inline

Get access to the internal wrapper storage.

Returns: a reference to wrapper map

Definition at line 997 of file Group.hpp.

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

coreComponents/dataRepository/Group.hpp

Public Types

Public Member Functions

Static Public Member Functions

Protected Member Functions

Static Factory Catalog Functions

Detailed Description

Constructor & Destructor Documentation

◆ Group() [1/3]

◆ Group() [2/3]

◆ Group() [3/3]

Member Function Documentation

◆ applyLambdaToContainer()

◆ capacity()

◆ createChild()

◆ deregisterGroup()

◆ deregisterWrapper()

◆ dumpInputOptions()

◆ forSubGroups() [1/4]

◆ forSubGroups() [2/4]

◆ forSubGroups() [3/4]

◆ forSubGroups() [4/4]

◆ forWrappers() [1/4]

◆ forWrappers() [2/4]

◆ forWrappers() [3/4]

◆ forWrappers() [4/4]

◆ generateDataStructureSkeleton()

◆ getCatalog()

◆ getConduitNode() [1/2]

◆ getConduitNode() [2/2]

◆ getGroup() [1/2]

◆ getGroup() [2/2]

◆ getGroupByPath() [1/2]

◆ getGroupByPath() [2/2]

◆ getGroupPointer() [1/2]

◆ getGroupPointer() [2/2]

◆ getIndexInParent()

◆ getInputFlags()

◆ getLogLevel()

◆ getName()

◆ getParent() [1/2]

◆ getParent() [2/2]

◆ getPath()

◆ getReference() [1/2]

◆ getReference() [2/2]

◆ getRestartFlags()

◆ getSubGroups() [1/2]

◆ getSubGroups() [2/2]

◆ getWrapper() [1/2]

◆ getWrapper() [2/2]

◆ getWrapperBase() [1/2]

◆ getWrapperBase() [2/2]

◆ getWrapperIndex()

◆ getWrapperPointer() [1/2]

◆ getWrapperPointer() [2/2]

◆ hasGroup()

◆ hasWrapper()

◆ initializationOrder()

◆ initialize()

◆ initializePostInitialConditions()

◆ numSubGroups()

◆ numWrappers()

◆ operator=() [1/2]

◆ operator=() [2/2]

◆ pack() [1/2]

◆ pack() [2/2]

◆ packSize() [1/2]

◆ packSize() [2/2]

◆ postProcessInput()

◆ postRestartInitializationRecursive()

◆ printDataHierarchy()

◆ processInputFileRecursive()

◆ registerCallback()

◆ registerDataOnMesh()

◆ registerDataOnMeshRecursive()

◆ registerGroup() [1/5]

◆ registerGroup() [2/5]

◆ registerGroup() [3/5]

◆ registerGroup() [4/5]

◆ registerGroup() [5/5]

◆ registerWrapper() [1/5]