GEOSX
Public Types | Public Member Functions | Static Public Member Functions | List of all members
geosx::TableFunction Class Reference

#include <TableFunction.hpp>

Inheritance diagram for geosx::TableFunction:
Inheritance graph
[legend]

Public Types

enum  InterpolationType : integer { Linear, Nearest, Upper, Lower }
 Enumerator of available interpolation types.
 
- Public Types inherited from geosx::FunctionBase
using CatalogInterface = dataRepository::CatalogInterface< FunctionBase, std::string const &, Group *const >
 Alias for the catalog interface.
 
- Public Types inherited from geosx::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, std::string const &, Group *const >
 Type alias for catalog interface used by this class. See CatalogInterface.
 

Public Member Functions

 TableFunction (const std::string &name, dataRepository::Group *const parent)
 The constructor. More...
 
virtual ~TableFunction () override
 The destructor.
 
template<typename T >
void parse_file (array1d< T > &target, string const &filename, char delimiter)
 Parse a table file. More...
 
virtual void InitializeFunction () override
 Initialize the table function.
 
void reInitializeFunction ()
 Build the maps used to evaluate the table function.
 
virtual void Evaluate (dataRepository::Group const *const group, real64 const time, SortedArrayView< localIndex const > const &set, real64_array &result) const override final
 Method to evaluate a function on a target object. More...
 
virtual real64 Evaluate (real64 const *const input) const override final
 Method to evaluate a function. More...
 
array1d< real64_array > const & getCoordinates () const
 Get the table axes definitions. More...
 
array1d< real64_array > & getCoordinates ()
 Get the table axes definitions. More...
 
array1d< real64 > const & getValues () const
 Get the table values. More...
 
array1d< real64 > & getValues ()
 Get the table values. More...
 
void setInterpolationMethod (InterpolationType const method)
 Set the interpolation method. More...
 
void setTableCoordinates (array1d< real64_array > coordinates)
 Set the table coordinates. More...
 
void setTableValues (real64_array values)
 Set the table values. More...
 
- Public Member Functions inherited from geosx::FunctionBase
 FunctionBase (const std::string &name, dataRepository::Group *const parent)
 Constructor. More...
 
virtual ~FunctionBase () override
 destructor
 
integer isFunctionOfTime () const
 Test to see if the function is a 1D function of time. More...
 
real64_array EvaluateStats (dataRepository::Group const *const group, real64 const time, SortedArray< localIndex > const &set) const
 This generates statistics by applying a function to an object. More...
 
void setInputVarNames (string_array inputVarNames)
 Set the input variable names. More...
 
- Public Member Functions inherited from geosx::dataRepository::Group
 Group (std::string const &name, Group *const parent)
 Constructor. More...
 
 Group (Group &&source)
 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 (Group const &&)=delete
 Deleted move constructor.
 
Groupoperator= (Group const &)=delete
 Deleted copy assignment operator. More...
 
Groupoperator= (Group &&)=delete
 Deleted move assignment operator. More...
 
virtual const std::type_info & get_typeid () const
 Get typeid for current group. More...
 
bool CheckTypeID (std::type_info const &typeToCheck) const
 Check a type_info against the type_info of this Group. More...
 
void PrintDataHierarchy (integer indent=0)
 Prints the data hierarchy recursively. More...
 
string dumpInputOptions () const
 
template<typename T = Group>
T * RegisterGroup (std::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 (std::string const &name, T *newObject)
 Register a new Group as a sub-group of current Group. More...
 
template<typename T = Group>
T * RegisterGroup (std::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 (std::string const &name, std::string const &catalogName)
 Register a new Group as a sub-group of current Group. More...
 
void deregisterGroup (std::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>
T * GetGroup (localIndex index)
 Retrieve a sub-group from the current Group using an index. More...
 
template<typename T = Group>
T const * GetGroup (localIndex index) const
 Retrieve a sub-group from the current Group using an index. More...
 
template<typename T = Group>
T * GetGroup (string const &name)
 Retrieve a sub-group from the current Group using a string. More...
 
template<typename T = Group>
T const * GetGroup (string const &name) const
 Retrieve a sub-group from the current Group using a string. More...
 
template<typename T = Group>
T & getGroupReference (string const &key)
 
template<typename T = Group>
T const & getGroupReference (string const &key) const
 
template<typename T = Group>
T & GetGroupReference (subGroupMap::KeyIndex const &key)
 
template<typename T = Group>
T const & GetGroupReference (subGroupMap::KeyIndex const &key) const
 
template<typename T = Group>
T * GetGroup (subGroupMap::KeyIndex const &key)
 Retrieve a sub-group from the current Group using a KeyIndexT. More...
 
template<typename T = Group>
T const * GetGroup (subGroupMap::KeyIndex const &key) const
 Retrieve a sub-group from the current Group using a KeyIndexT. 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...
 
bool hasGroup (std::string const &name) const
 Check whether a sub-group exists. 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 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
 
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...
 
void Initialize (Group *const group)
 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 (Group *const group)
 Initialization routine to be called after calling ApplyInitialConditions(). More...
 
void postRestartInitializationRecursive (Group *const domain)
 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.
 
template<typename T , typename TBASE = T>
Wrapper< TBASE > * registerWrapper (std::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 (std::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 (std::string const &name, T *newObject)
 Register a Wrapper around an existing object, does not take ownership of the object. More...
 
WrapperBaseregisterWrapper (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...
 
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 *const meshBodies)
 Calls RegisterDataOnMesh() recursively. More...
 
virtual void RegisterDataOnMesh (Group *const meshBodies)
 Register data on mesh entities. More...
 
virtual localIndex PackSize (string_array const &wrapperNames, integer const recursive, bool on_device=false) 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 on_device=false) 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 on_device=false) 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 on_device=false) 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 on_device=false)
 Unpack a buffer. More...
 
WrapperBase const * getWrapperBase (indexType const index) const
 Retrieve a WrapperBase stored in this group. More...
 
WrapperBasegetWrapperBase (indexType const index)
 Retrieve a WrapperBase stored in this group. More...
 
WrapperBase const * getWrapperBase (std::string const &name) const
 Retrieve a WrapperBase stored in this group. More...
 
WrapperBasegetWrapperBase (std::string const &name)
 Retrieve a WrapperBase stored in this group. More...
 
WrapperBase const * getWrapperBase (wrapperMap::KeyIndex const &keyIndex) const
 Retrieve a WrapperBase stored in this group. More...
 
WrapperBasegetWrapperBase (wrapperMap::KeyIndex const &keyIndex)
 Retrieve a WrapperBase stored in this group. More...
 
indexType getWrapperIndex (std::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...
 
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 >
Wrapper< T > const * getWrapper (char const *const key) const
 Retrieve a Wrapper stored in this group. More...
 
template<typename T >
Wrapper< T > * getWrapper (char const *const key)
 Retrieve a Wrapper stored in this group. More...
 
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...
 
template<typename T >
GEOSX_DECLTYPE_AUTO_RETURN getReference (char const *const name) const
 
template<typename T >
T & getReference (char const *const name)
 
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...
 
const string getName () const
 Get group name. More...
 
GroupgetParent ()
 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...
 
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 ()
 Get 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
 
template<typename T >
group_cast ()
 Downcast this Group. More...
 
template<typename T >
group_cast () const
 Downcast this Group. More...
 

Static Public Member Functions

static string CatalogName ()
 The catalog name interface. More...
 
- Static Public Member Functions inherited from geosx::FunctionBase
static string CatalogName ()
 Static Factory Catalog Functions. More...
 
static CatalogInterface::CatalogTypeGetCatalog ()
 return the catalog entry for the function More...
 
- Static Public Member Functions inherited from geosx::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 class. More...
 
template<typename T >
static T group_cast (Group *group)
 Downcast a Group *. More...
 
template<typename T >
static T group_cast (Group const *group)
 Downcast a Group const *. More...
 

Additional Inherited Members

- Protected Member Functions inherited from geosx::FunctionBase
template<typename LEAF >
void EvaluateT (dataRepository::Group const *const group, real64 const time, SortedArrayView< localIndex const > const &set, real64_array &result) const
 Method to apply an function with an arbitrary type of output. More...
 
virtual void PostProcessInput () override
 
- Protected Member Functions inherited from geosx::dataRepository::Group
virtual void InitializePreSubGroups (Group *const group)
 Called by Initialize() prior to initializing sub-Groups. More...
 
virtual void InitializePostSubGroups (Group *const group)
 Called by Initialize() after to initializing sub-Groups. More...
 
virtual void InitializePostInitialConditions_PreSubGroups (Group *const group)
 Called by InitializePostInitialConditions() prior to initializing sub-Groups. More...
 
virtual void InitializePostInitialConditions_PostSubGroups (Group *const group)
 Called by InitializePostInitialConditions() after to initializing sub-Groups. More...
 
virtual void postRestartInitialization (Group *const domain)
 Performs initialization required after reading from a restart file. More...
 
- Protected Attributes inherited from geosx::FunctionBase
string_array m_inputVarNames
 names for the input variables
 

Detailed Description

An interface for a dense table-based function

Definition at line 33 of file TableFunction.hpp.

Constructor & Destructor Documentation

◆ TableFunction()

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

The constructor.

Parameters
[in]namethe name of this object manager
[in]parentthe parent Group

Member Function Documentation

◆ CatalogName()

static string geosx::TableFunction::CatalogName ( )
inlinestatic

The catalog name interface.

Returns
name of the TableFunction in the FunctionBase catalog

Definition at line 53 of file TableFunction.hpp.

◆ Evaluate() [1/2]

virtual void geosx::TableFunction::Evaluate ( dataRepository::Group const *const  group,
real64 const  time,
SortedArrayView< localIndex const > const &  set,
real64_array result 
) const
inlinefinaloverridevirtual

Method to evaluate a function on a target object.

Parameters
groupa pointer to the object holding the function arguments
timecurrent time
setthe subset of nodes to apply the function to
resultan array to hold the results of the function

Implements geosx::FunctionBase.

Definition at line 83 of file TableFunction.hpp.

◆ Evaluate() [2/2]

virtual real64 geosx::TableFunction::Evaluate ( real64 const *const  input) const
finaloverridevirtual

Method to evaluate a function.

Parameters
inputa scalar input
Returns
the function result

Implements geosx::FunctionBase.

◆ getCoordinates() [1/2]

array1d< real64_array > const& geosx::TableFunction::getCoordinates ( ) const
inline

Get the table axes definitions.

Returns
a reference to an array of arrays that define each table axis

Definition at line 102 of file TableFunction.hpp.

◆ getCoordinates() [2/2]

array1d< real64_array >& geosx::TableFunction::getCoordinates ( )
inline

Get the table axes definitions.

Returns
a reference to an array of arrays that define each table axis

Definition at line 107 of file TableFunction.hpp.

◆ getValues() [1/2]

array1d< real64 > const& geosx::TableFunction::getValues ( ) const
inline

Get the table values.

Returns
a reference to the 1d array of table values. For ND arrays, values are stored in Fortran order.

Definition at line 113 of file TableFunction.hpp.

◆ getValues() [2/2]

array1d< real64 >& geosx::TableFunction::getValues ( )
inline

Get the table values.

Returns
a reference to the 1d array of table values. For ND arrays, values are stored in Fortran order.

Definition at line 118 of file TableFunction.hpp.

◆ parse_file()

template<typename T >
void geosx::TableFunction::parse_file ( array1d< T > &  target,
string const &  filename,
char  delimiter 
)

Parse a table file.

Template Parameters
TThe type for table or axis values.
Parameters
[in]targetThe place to store values.
[in]filenameThe name of the file to read.
[in]delimiterThe delimiter used for file entries.

◆ setInterpolationMethod()

void geosx::TableFunction::setInterpolationMethod ( InterpolationType const  method)
inline

Set the interpolation method.

Parameters
methodThe interpolation method

Definition at line 133 of file TableFunction.hpp.

◆ setTableCoordinates()

void geosx::TableFunction::setTableCoordinates ( array1d< real64_array coordinates)
inline

Set the table coordinates.

Parameters
coordinatesAn array of arrays containing table coordinate definitions

Definition at line 139 of file TableFunction.hpp.

◆ setTableValues()

void geosx::TableFunction::setTableValues ( real64_array  values)
inline

Set the table values.

Parameters
valuesAn array of table values in fortran order

Definition at line 145 of file TableFunction.hpp.


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