MFEM  v3.4
Finite element discretization library
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Friends Pages
Public Member Functions | Static Public Member Functions | Protected Member Functions | Protected Attributes | List of all members
mfem::ConduitDataCollection Class Reference

Data collection that uses the Conduit Mesh Blueprint specification. More...

#include <conduitdatacollection.hpp>

Inheritance diagram for mfem::ConduitDataCollection:
[legend]
Collaboration diagram for mfem::ConduitDataCollection:
[legend]

Public Member Functions

 ConduitDataCollection (const std::string &collection_name, Mesh *mesh=NULL)
 Constructor. The collection name is used when saving the data. More...
 
 ConduitDataCollection (MPI_Comm comm, const std::string &collection_name, Mesh *mesh=NULL)
 Construct a parallel ConduitDataCollection. More...
 
virtual ~ConduitDataCollection ()
 We will delete the mesh and fields if we own them. More...
 
void SetProtocol (const std::string &protocol)
 Set the Conduit relay i/o protocol to use. More...
 
virtual void Save ()
 Save the collection and a Conduit blueprint root file. More...
 
virtual void Load (int cycle=0)
 Load the collection based blueprint data. More...
 
- Public Member Functions inherited from mfem::DataCollection
 DataCollection (const std::string &collection_name, Mesh *mesh_=NULL)
 Initialize the collection with its name and Mesh. More...
 
virtual void RegisterField (const std::string &field_name, GridFunction *gf)
 Add a grid function to the collection. More...
 
virtual void DeregisterField (const std::string &field_name)
 Remove a grid function from the collection. More...
 
virtual void RegisterQField (const std::string &q_field_name, QuadratureFunction *qf)
 Add a QuadratureFunction to the collection. More...
 
virtual void DeregisterQField (const std::string &field_name)
 Remove a QuadratureFunction from the collection. More...
 
bool HasField (const std::string &name) const
 Check if a grid function is part of the collection. More...
 
GridFunctionGetField (const std::string &field_name)
 Get a pointer to a grid function in the collection. More...
 
MPI_Comm GetComm () const
 Return the associated MPI communicator or MPI_COMM_NULL. More...
 
ParGridFunctionGetParField (const std::string &field_name)
 Get a pointer to a parallel grid function in the collection. More...
 
bool HasQField (const std::string &q_field_name) const
 Check if a QuadratureFunction with the given name is in the collection. More...
 
QuadratureFunctionGetQField (const std::string &q_field_name)
 Get a pointer to a QuadratureFunction in the collection. More...
 
const FieldMapTypeGetFieldMap () const
 Get a const reference to the internal field map. More...
 
const QFieldMapTypeGetQFieldMap () const
 Get a const reference to the internal q-field map. More...
 
MeshGetMesh ()
 Get a pointer to the mesh in the collection. More...
 
virtual void SetMesh (Mesh *new_mesh)
 Set/change the mesh associated with the collection. More...
 
virtual void SetMesh (MPI_Comm comm, Mesh *new_mesh)
 Set/change the mesh associated with the collection. More...
 
void SetCycle (int c)
 Set time cycle (for time-dependent simulations) More...
 
void SetTime (double t)
 Set physical time (for time-dependent simulations) More...
 
void SetTimeStep (double ts)
 Set the simulation time step (for time-dependent simulations) More...
 
int GetCycle () const
 Get time cycle (for time-dependent simulations) More...
 
double GetTime () const
 Get physical time (for time-dependent simulations) More...
 
double GetTimeStep () const
 Get the simulation time step (for time-dependent simulations) More...
 
const std::string & GetCollectionName () const
 Get the name of the collection. More...
 
void SetOwnData (bool o)
 Set the ownership of collection data. More...
 
void SetPrecision (int prec)
 Set the precision (number of digits) used for the text output of doubles. More...
 
void SetPadDigits (int digits)
 Set the number of digits used for both the cycle and the MPI rank. More...
 
void SetPadDigitsCycle (int digits)
 Set the number of digits used for the cycle. More...
 
void SetPadDigitsRank (int digits)
 Set the number of digits used for the MPI rank in filenames. More...
 
virtual void SetFormat (int fmt)
 Set the desired output mesh and data format. More...
 
void SetPrefixPath (const std::string &prefix)
 Set the path where the DataCollection will be saved. More...
 
const std::string & GetPrefixPath () const
 Get the path where the DataCollection will be saved. More...
 
virtual void SaveMesh ()
 Save the mesh, creating the collection directory. More...
 
virtual void SaveField (const std::string &field_name)
 Save one field, assuming the collection directory already exists. More...
 
virtual void SaveQField (const std::string &q_field_name)
 Save one q-field, assuming the collection directory already exists. More...
 
virtual ~DataCollection ()
 Delete the mesh and fields if owned by the collection. More...
 
int Error () const
 Get the current error state. More...
 
void ResetError (int err=NO_ERROR)
 Reset the error state. More...
 

Static Public Member Functions

static void MeshToBlueprintMesh (Mesh *m, conduit::Node &out, const std::string &coordset_name="coords", const std::string &main_topology_name="main", const std::string &boundary_topology_name="boundary")
 Describes a MFEM mesh using the mesh blueprint. More...
 
static void GridFunctionToBlueprintField (GridFunction *gf, conduit::Node &out, const std::string &main_topology_name="main")
 Describes a MFEM grid function using the mesh blueprint. More...
 
static MeshBlueprintMeshToMesh (const conduit::Node &n_mesh, const std::string &main_toplogy_name="", bool zero_copy=false)
 Constructs and MFEM mesh from a Conduit Blueprint Description. More...
 
static GridFunctionBlueprintFieldToGridFunction (Mesh *mesh, const conduit::Node &n_field, bool zero_copy=false)
 Constructs and MFEM Grid Function from a Conduit Blueprint Description. More...
 

Protected Member Functions

std::string RootFileName ()
 Returns blueprint root file name for the current cycle. More...
 
std::string MeshFileName (int domain_id, const std::string &file_protocol="hdf5")
 Returns the mesh file name for a given domain at the current cycle. More...
 
std::string MeshDirectoryName ()
 Returns the mesh output directory for the current cycle. More...
 
std::string MeshFilePattern (const std::string &file_protocol="hdf5")
 Returns the mesh file pattern for the current cycle. More...
 
void SaveRootFile (int num_domains, const conduit::Node &n_mesh, const std::string &file_protocol)
 Saves root file for the current cycle. More...
 
void SaveMeshAndFields (int domain_id, const conduit::Node &n_mesh, const std::string &file_protocol)
 Saves all meshes and fields for the current cycle. More...
 
void LoadRootFile (conduit::Node &n_root_out)
 Loads contents of the root field for the current cycle into n_root_out. More...
 
void LoadMeshAndFields (int domain_id, const std::string &file_protocol)
 Loads all meshes and fields of a given domain id for the current cycle. More...
 
- Protected Member Functions inherited from mfem::DataCollection
void DeleteData ()
 Delete data owned by the DataCollection keeping field information. More...
 
void DeleteAll ()
 Delete data owned by the DataCollection including field information. More...
 
std::string GetMeshShortFileName () const
 
std::string GetMeshFileName () const
 
std::string GetFieldFileName (const std::string &field_name) const
 
void SaveOneField (const FieldMapIterator &it)
 Save one field to disk, assuming the collection directory exists. More...
 
void SaveOneQField (const QFieldMapIterator &it)
 Save one q-field to disk, assuming the collection directory exists. More...
 

Protected Attributes

std::string relay_protocol
 
- Protected Attributes inherited from mfem::DataCollection
std::string name
 Name of the collection, used as a directory name when saving. More...
 
std::string prefix_path
 A path where the directory with results is saved. If not empty, it has '/' at the end. More...
 
GFieldMap field_map
 
QFieldMap q_field_map
 
Meshmesh
 The (common) mesh for the collected fields. More...
 
int cycle
 Time cycle; for time-dependent simulations cycle >= 0, otherwise = -1. More...
 
double time
 Physical time (for time-dependent simulations) More...
 
double time_step
 Time step i.e. delta_t (for time-dependent simulations) More...
 
bool serial
 Serial or parallel run? False iff mesh is a ParMesh. More...
 
bool appendRankToFileName
 Append rank to any output file names. More...
 
int myid
 MPI rank (in parallel) More...
 
int num_procs
 Number of MPI ranks (in parallel) More...
 
MPI_Comm m_comm
 Associated MPI communicator. More...
 
int precision
 Precision (number of digits) used for the text output of doubles. More...
 
int pad_digits_cycle
 Number of digits used for the cycle and MPI rank in filenames. More...
 
int pad_digits_rank
 
int format
 Output mesh format: see the Format enumeration. More...
 
bool own_data
 Should the collection delete its mesh and fields. More...
 
int error
 Error state. More...
 

Additional Inherited Members

- Public Types inherited from mfem::DataCollection
enum  Format { SERIAL_FORMAT = 0, PARALLEL_FORMAT = 1 }
 Format constants to be used with SetFormat(). More...
 
enum  { NO_ERROR = 0, READ_ERROR = 1, WRITE_ERROR = 2 }
 Errors returned by Error() More...
 
typedef GFieldMap::MapType FieldMapType
 
typedef GFieldMap::iterator FieldMapIterator
 
typedef GFieldMap::const_iterator FieldMapConstIterator
 
typedef QFieldMap::MapType QFieldMapType
 
typedef QFieldMap::iterator QFieldMapIterator
 
typedef QFieldMap::const_iterator QFieldMapConstIterator
 
- Static Protected Member Functions inherited from mfem::DataCollection
static int create_directory (const std::string &dir_name, const Mesh *mesh, int myid)
 
- Static Protected Attributes inherited from mfem::DataCollection
static const int precision_default = 6
 Default value for precision. More...
 
static const int pad_digits_default = 6
 Default value for pad_digits_*. More...
 

Detailed Description

Data collection that uses the Conduit Mesh Blueprint specification.

ConduitDataCollection provides json, simple binary, and HDF5-based file formats for visualization or restart. It also provides methods that convert between MFEM Meshes and GridFunctions and Conduit Mesh Blueprint descriptions.

For more information, see:

Note
The ConduitDataCollection only wraps the mfem objects to save them and creates them on load, Conduit does not own any of the data. The SidreDataCollection provides more features, for example the SidreDataCollection allocates and will own the data backing the mfem objects in the data collection.

This class also provides public static methods that convert between MFEM Meshes and GridFunctions and Conduit Mesh Blueprint descriptions.

Those that describe MFEM data using Conduit (MFEM to Conduit Blueprint) try to zero-copy as much of data MFEM as possible. The Conduit node result will not own all of the data, however you can easily make a copy of the result node using Conduit's API when necessary.

Those that construct MFEM objects from Conduit Nodes (Conduit Blueprint to MFEM) provide a zero-copy option. Zero-copy is only possible if the blueprint data matches the data types provided by the MFEM API, for example: ints for connectivity arrays, doubles for field value arrays, allocations that match MFEM's striding options, etc. If these constraints are not met, MFEM objects that own the data are created and returned. In either case pointers to new MFEM object instances are returned, the zero-copy only applies to data backing the MFEM object instances.

Note
QuadratureFunctions (q-fields) are not supported.
AMR Meshes are not fully supported.
Warning
This class is still experimental, meaning that in future releases, it may not be backward compatible, and the output files generated by the current version may become unreadable.Data collection with Conduit I/O routines

Definition at line 69 of file conduitdatacollection.hpp.

Constructor & Destructor Documentation

mfem::ConduitDataCollection::ConduitDataCollection ( const std::string &  collection_name,
Mesh mesh = NULL 
)

Constructor. The collection name is used when saving the data.

If mesh is NULL, then the mesh can be set later by calling either SetMesh() or Load(). The latter works only in serial.

Definition at line 38 of file conduitdatacollection.cpp.

mfem::ConduitDataCollection::ConduitDataCollection ( MPI_Comm  comm,
const std::string &  collection_name,
Mesh mesh = NULL 
)

Construct a parallel ConduitDataCollection.

Definition at line 49 of file conduitdatacollection.cpp.

mfem::ConduitDataCollection::~ConduitDataCollection ( )
virtual

We will delete the mesh and fields if we own them.

Definition at line 64 of file conduitdatacollection.cpp.

Member Function Documentation

mfem::GridFunction * mfem::ConduitDataCollection::BlueprintFieldToGridFunction ( Mesh mesh,
const conduit::Node &  n_field,
bool  zero_copy = false 
)
static

Constructs and MFEM Grid Function from a Conduit Blueprint Description.

If zero_copy == true, tries to construct a grid function that points to the data described by the conduit node. This is only possible if the data in the node matches the data types needed for the MFEM API (doubles for field values, allocated in soa or aos ordering, etc). If these constraints are not met, a grid function that owns the data is created and returned.

Definition at line 512 of file conduitdatacollection.cpp.

mfem::Mesh * mfem::ConduitDataCollection::BlueprintMeshToMesh ( const conduit::Node &  n_mesh,
const std::string &  main_toplogy_name = "",
bool  zero_copy = false 
)
static

Constructs and MFEM mesh from a Conduit Blueprint Description.

main_topology_name is used to select which topology to use, when empty ("") the first topology entry will be used.

If zero_copy == true, tries to construct a mesh that points to the data described by the conduit node. This is only possible if the data in the node matches the data types needed for the MFEM API (ints for connectivity, doubles for field values, etc). If these constraints are not met, a mesh that owns the data is created and returned.

Definition at line 166 of file conduitdatacollection.cpp.

void mfem::ConduitDataCollection::GridFunctionToBlueprintField ( GridFunction gf,
conduit::Node &  out,
const std::string &  main_topology_name = "main" 
)
static

Describes a MFEM grid function using the mesh blueprint.

Sets up passed conduit::Node out to describe the given grid function using the mesh field blueprint.

Zero-copies as much data as possible.

main_toplogy_name is used to set the associated topology name. With the default setting, the resulting field is associated with the topology main.

Definition at line 824 of file conduitdatacollection.cpp.

void mfem::ConduitDataCollection::Load ( int  cycle = 0)
virtual

Load the collection based blueprint data.

Reimplemented from mfem::DataCollection.

Definition at line 121 of file conduitdatacollection.cpp.

void mfem::ConduitDataCollection::LoadMeshAndFields ( int  domain_id,
const std::string &  file_protocol 
)
protected

Loads all meshes and fields of a given domain id for the current cycle.

Definition at line 1091 of file conduitdatacollection.cpp.

void mfem::ConduitDataCollection::LoadRootFile ( conduit::Node &  n_root_out)
protected

Loads contents of the root field for the current cycle into n_root_out.

Definition at line 1000 of file conduitdatacollection.cpp.

std::string mfem::ConduitDataCollection::MeshDirectoryName ( )
protected

Returns the mesh output directory for the current cycle.

Definition at line 907 of file conduitdatacollection.cpp.

std::string mfem::ConduitDataCollection::MeshFileName ( int  domain_id,
const std::string &  file_protocol = "hdf5" 
)
protected

Returns the mesh file name for a given domain at the current cycle.

Definition at line 890 of file conduitdatacollection.cpp.

std::string mfem::ConduitDataCollection::MeshFilePattern ( const std::string &  file_protocol = "hdf5")
protected

Returns the mesh file pattern for the current cycle.

Definition at line 918 of file conduitdatacollection.cpp.

void mfem::ConduitDataCollection::MeshToBlueprintMesh ( Mesh m,
conduit::Node &  out,
const std::string &  coordset_name = "coords",
const std::string &  main_topology_name = "main",
const std::string &  boundary_topology_name = "boundary" 
)
static

Describes a MFEM mesh using the mesh blueprint.

Sets up passed conduit::Node to describe the given mesh using the mesh blueprint.

Zero-copies as much data as possible.

coordset_name, main_topology_name, and boundary_topology_name control the names used for the mesh blueprint entries.

With the default set of names, this method describes the mesh's coordinates with a coordinate set entry named coords. Describes the mesh with a topology entry named 'main'. If the mesh has nodes, these are described in a field entry named mesh_nodes. If the mesh has an attribute field, this is described in a field entry named mesh_attribute.

If the mesh has boundary info, this is described in a topology entry named boundary. If the boundary has an attribute field, this is described in a field entry named boundary_attribute.

Definition at line 644 of file conduitdatacollection.cpp.

std::string mfem::ConduitDataCollection::RootFileName ( )
protected

Returns blueprint root file name for the current cycle.

Definition at line 880 of file conduitdatacollection.cpp.

void mfem::ConduitDataCollection::Save ( )
virtual

Save the collection and a Conduit blueprint root file.

Reimplemented from mfem::DataCollection.

Definition at line 70 of file conduitdatacollection.cpp.

void mfem::ConduitDataCollection::SaveMeshAndFields ( int  domain_id,
const conduit::Node &  n_mesh,
const std::string &  file_protocol 
)
protected

Saves all meshes and fields for the current cycle.

Definition at line 991 of file conduitdatacollection.cpp.

void mfem::ConduitDataCollection::SaveRootFile ( int  num_domains,
const conduit::Node &  n_mesh,
const std::string &  file_protocol 
)
protected

Saves root file for the current cycle.

Definition at line 936 of file conduitdatacollection.cpp.

void mfem::ConduitDataCollection::SetProtocol ( const std::string &  protocol)

Set the Conduit relay i/o protocol to use.

Supported options: hdf5 (default), json, conduit_json, conduit_bin

Definition at line 155 of file conduitdatacollection.cpp.

Member Data Documentation

std::string mfem::ConduitDataCollection::relay_protocol
protected

Definition at line 109 of file conduitdatacollection.hpp.


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