GEOS
Public Member Functions | List of all members
geos::ParticleBlockABC Class Referenceabstract

#include <ParticleBlockABC.hpp>

Inheritance diagram for geos::ParticleBlockABC:
Inheritance graph
[legend]

Public Member Functions

 ParticleBlockABC (string const &name, Group *const parent)
 Constructor. More...
 
virtual ParticleType getParticleType () const =0
 Get the type of particle in this subregion. More...
 
virtual array1d< globalIndexgetParticleID () const =0
 Get the list of particle global IDs in this subregion. More...
 
virtual array1d< int > getParticleGroup () const =0
 Get the list of particle group numbers (for contact) in this subregion. More...
 
virtual array1d< int > getParticleSurfaceFlag () const =0
 Get the list of particle surface flag values in this subregion. More...
 
virtual array1d< real64getParticleDamage () const =0
 Get the list of particle damage values in this subregion. More...
 
virtual array1d< real64getParticleStrengthScale () const =0
 Get the list of particle strength scale values in this subregion. More...
 
virtual array2d< real64getParticleCenter () const =0
 Get the list of particle center locations in this subregion. More...
 
virtual array2d< real64getParticleVelocity () const =0
 Get the list of particle velocities in this subregion. More...
 
virtual array2d< real64getParticleMaterialDirection () const =0
 Get the list of particle material directions in this subregion. More...
 
virtual array1d< real64getParticleVolume () const =0
 Get the list of particle volumes in this subregion. More...
 
virtual array3d< real64getParticleRVectors () const =0
 Get the list of particle r-vectors in this subregion. More...
 
virtual bool hasRVectors () const =0
 Query whether this subregion has particles of a type that have r-vectors that depend on the deformation gradient. More...
 
virtual localIndex numParticles () const =0
 Get the number of particles. More...
 
virtual array1d< globalIndexlocalToGlobalMap () const =0
 Get local to global map. More...
 
template<typename LAMBDA >
void forExternalProperties (LAMBDA &&lambda)
 Helper function to apply a lambda function over all the external properties of the subregion. More...
 
- Public Member Functions inherited from geos::dataRepository::Group
template<typename LOG_LEVEL_INFO >
std::enable_if_t< geos::is_log_level_info< LOG_LEVEL_INFO >, void > addLogLevel ()
 Append a levelCondition and a log description to the description of the wrapped object given a log info struct. Must be called in constructor. More...
 
virtual bool registerCallback (void *func, const std::type_info &funcType)
 Register a callback function on the group. More...
 
virtual void reinit ()
 Performs re-initialization of certain variable depending on the solver being used.
 
 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.
 
Groupoperator= (Group const &)=delete
 Deleted copy assignment operator. More...
 
Groupoperator= (Group &&)=delete
 Deleted move assignment operator. More...
 
void printDataHierarchy (integer indent=0) const
 Prints the data hierarchy recursively. More...
 
string dumpInputOptions () const
 
string dumpSubGroupsNames () const
 
string dumpWrappersNames () const
 
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 GroupcreateChild (string const &childKey, string const &childName)
 Creates a new sub-Group using the ObjectCatalog functionality. More...
 
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...
 
subGroupMapgetSubGroups ()
 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...
 
std::vector< stringgetSubGroupsNames () const
 
template<typename T = Group>
bool hasGroup (string const &name) const
 Check whether a sub-group exists. More...
 
template<typename T >
bool hasSubGroupOfType () const
 Check whether a sub-group exists by type. More...
 
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 LAMBDA >
void forSubGroupsIndex (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 forSubGroupsIndex (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)
 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) const
 Apply the given functor to subgroups that can be casted to one of specified types. More...
 
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...
 
virtual void initialize_postMeshGeneration ()
 initialization post generation of the mesh.
 
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::xmlDocument &xmlDocument, xmlWrapper::xmlNode &targetNode)
 Recursively read values using ProcessInputFile() from the input file and put them into the wrapped values for this group. Also add the includes content to the xmlDocument when Include nodes are encountered. More...
 
void processInputFileRecursive (xmlWrapper::xmlDocument &xmlDocument, xmlWrapper::xmlNode &targetNode, xmlWrapper::xmlNodePos const &nodePos)
 Same as processInputFileRecursive(xmlWrapper::xmlDocument &, xmlWrapper::xmlNode &) but allow to reuse an existing xmlNodePos. More...
 
void postInputInitializationRecursive ()
 Recursively call postInputInitialization() to apply post processing after reading input values.
 
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)
 Create and register a Wrapper around a new object. More...
 
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...
 
WrapperBaseregisterWrapper (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...
 
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...
 
virtual void registerDataOnMeshRecursive (Group &meshBodies)
 Calls RegisterDataOnMesh() recursively. More...
 
virtual void registerDataOnMesh (Group &meshBodies)
 Register data on mesh entities. More...
 
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...
 
localIndex packSize (arrayView1d< localIndex const > const &packList, integer const recursive, bool onDevice, parallelDeviceEvents &events) const
 Get the size required to pack a list of indices for all registered 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...
 
localIndex pack (buffer_unit_type *&buffer, arrayView1d< localIndex const > const &packList, integer const recursive, bool onDevice, parallelDeviceEvents &events) const
 Pack a list of indices for all registered wrappers. More...
 
virtual localIndex unpack (buffer_unit_type const *&buffer, arrayView1d< localIndex > &packList, integer const recursive, bool onDevice, parallelDeviceEvents &events, MPI_Op op=MPI_REPLACE)
 Unpack a buffer. More...
 
template<typename KEY >
WrapperBase const & getWrapperBase (KEY const &key) const
 Return a reference to a WrapperBase stored in this group. More...
 
template<typename KEY >
WrapperBasegetWrapperBase (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...
 
wrapperMapwrappers ()
 Get access to the internal wrapper storage. More...
 
indexType numWrappers () const
 Return the number of wrappers. More...
 
std::vector< stringgetWrappersNames () const
 
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...
 
template<typename T , typename LOOKUP_TYPE >
GEOS_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...
 
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...
 
string const & getName () const
 Get group name. More...
 
string getPath () const
 Return the path of this Group in the data repository. Starts with '/' followed by the hierarchy of the children of the "Problem" in which the Group is. More...
 
DataContext const & getDataContext () const
 
template<typename KEY >
DataContext const & getWrapperDataContext (KEY key) const
 
GroupgetParent ()
 Access the group's parent. More...
 
Group const & getParent () const
 Access the group's parent. More...
 
bool hasParent () const
 
localIndex getIndexInParent () const
 Get the group's index within its parent group. More...
 
localIndex getSubGroupIndex (keyType const &key) const
 Get the index of a sub-Group within this group. More...
 
int sizedFromParent () const
 Check whether this Group is resized when its parent is resized. More...
 
GroupsetSizedFromParent (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...
 
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 ()
 
void setLogLevel (integer const logLevel)
 Set verbosity level. More...
 
integer getLogLevel () const
 

Additional Inherited Members

- Public Types inherited from geos::dataRepository::Group
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.
 
using CatalogInterface = dataRepository::CatalogInterface< Group, string const &, Group *const >
 Type alias for catalog interface used by this class. See CatalogInterface.
 
- Static Public Member Functions inherited from geos::dataRepository::Group
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...
 
static CatalogInterface::CatalogTypegetCatalog ()
 Get the singleton catalog for this Group. More...
 
- Protected Member Functions inherited from geos::dataRepository::Group
virtual void postInputInitialization ()
 
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.
 

Detailed Description

Abstract base class defining the information provided by any particle block implementation. Mainly particle type-related information (TODO put an example here), a local to global mapping and some kind of accessors to external properties.

The particles of ParticleBlockABC are all of the same kind.

It's noteworthy that the ParticleBlockABC is immutable oriented. The derived implementations need to have the modification/creation capabilities.

Definition at line 39 of file ParticleBlockABC.hpp.

Constructor & Destructor Documentation

◆ ParticleBlockABC()

geos::ParticleBlockABC::ParticleBlockABC ( string const &  name,
Group *const  parent 
)
inline

Constructor.

Parameters
nameThe name of this Group.
parentThe parent Group.

Definition at line 48 of file ParticleBlockABC.hpp.

Member Function Documentation

◆ forExternalProperties()

template<typename LAMBDA >
void geos::ParticleBlockABC::forExternalProperties ( LAMBDA &&  lambda)
inline

Helper function to apply a lambda function over all the external properties of the subregion.

Template Parameters
LAMBDAthe type of the lambda function
Parameters
lambdalambda function that is applied to the wrappers of external properties
Note
Unlike the other member functions of this class, this current member function is not abstract, mainly because it's a template method. The abstraction is delegated to private method getExternalProperties.
There is some constness concern for this member function.
See also
getExternalProperties()

Definition at line 149 of file ParticleBlockABC.hpp.

◆ getParticleCenter()

virtual array2d< real64 > geos::ParticleBlockABC::getParticleCenter ( ) const
pure virtual

Get the list of particle center locations in this subregion.

Returns
the list of particle center locations in this subregion.

Implemented in geos::ParticleBlock.

◆ getParticleDamage()

virtual array1d< real64 > geos::ParticleBlockABC::getParticleDamage ( ) const
pure virtual

Get the list of particle damage values in this subregion.

Returns
the list of particle damage values in this subregion.

Implemented in geos::ParticleBlock.

◆ getParticleGroup()

virtual array1d< int > geos::ParticleBlockABC::getParticleGroup ( ) const
pure virtual

Get the list of particle group numbers (for contact) in this subregion.

Returns
the list of particle group numbers (for contact) in this subregion.

Implemented in geos::ParticleBlock.

◆ getParticleID()

virtual array1d< globalIndex > geos::ParticleBlockABC::getParticleID ( ) const
pure virtual

Get the list of particle global IDs in this subregion.

Returns
the list of particle global IDs in this subregion.

Implemented in geos::ParticleBlock.

◆ getParticleMaterialDirection()

virtual array2d< real64 > geos::ParticleBlockABC::getParticleMaterialDirection ( ) const
pure virtual

Get the list of particle material directions in this subregion.

Returns
the list of particle material directions in this subregion.

Implemented in geos::ParticleBlock.

◆ getParticleRVectors()

virtual array3d< real64 > geos::ParticleBlockABC::getParticleRVectors ( ) const
pure virtual

Get the list of particle r-vectors in this subregion.

Returns
the list of particle r-vectors in this subregion.

Implemented in geos::ParticleBlock.

◆ getParticleStrengthScale()

virtual array1d< real64 > geos::ParticleBlockABC::getParticleStrengthScale ( ) const
pure virtual

Get the list of particle strength scale values in this subregion.

Returns
the list of particle strength scale values in this subregion.

Implemented in geos::ParticleBlock.

◆ getParticleSurfaceFlag()

virtual array1d< int > geos::ParticleBlockABC::getParticleSurfaceFlag ( ) const
pure virtual

Get the list of particle surface flag values in this subregion.

Returns
the list of particle surface flag values in this subregion.

Implemented in geos::ParticleBlock.

◆ getParticleType()

virtual ParticleType geos::ParticleBlockABC::getParticleType ( ) const
pure virtual

Get the type of particle in this subregion.

Returns
an enum specifying the type of particle in this subregion

Implemented in geos::ParticleBlock.

◆ getParticleVelocity()

virtual array2d< real64 > geos::ParticleBlockABC::getParticleVelocity ( ) const
pure virtual

Get the list of particle velocities in this subregion.

Returns
the list of particle velocities in this subregion.

Implemented in geos::ParticleBlock.

◆ getParticleVolume()

virtual array1d< real64 > geos::ParticleBlockABC::getParticleVolume ( ) const
pure virtual

Get the list of particle volumes in this subregion.

Returns
the list of particle volumes in this subregion.

Implemented in geos::ParticleBlock.

◆ hasRVectors()

virtual bool geos::ParticleBlockABC::hasRVectors ( ) const
pure virtual

Query whether this subregion has particles of a type that have r-vectors that depend on the deformation gradient.

Returns
a bool indicating whether particles on this subregion have r-vectors that depend on the deformation gradient

Implemented in geos::ParticleBlock.

◆ localToGlobalMap()

virtual array1d< globalIndex > geos::ParticleBlockABC::localToGlobalMap ( ) const
pure virtual

Get local to global map.

Returns
The mapping relationship as an array.

Implemented in geos::ParticleBlock.

◆ numParticles()

virtual localIndex geos::ParticleBlockABC::numParticles ( ) const
pure virtual

Get the number of particles.

Returns
number of particles in the particle block

Implemented in geos::ParticleBlock.


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