- Generated by
1.8.16
|
IOSS
2.0
|
An input or output Database. More...
#include <Ioss_DatabaseIO.h>
Public Member Functions | |
| bool | ok (bool write_message=false, std::string *error_message=nullptr, int *bad_count=nullptr) const |
| Check to see if database state is OK. More... | |
| virtual unsigned | entity_field_support () const =0 |
| bool | using_parallel_io () const |
| int64_t | node_global_to_local (int64_t global, bool must_exist) const |
| Get the local (process-specific) node number corresponding to a global node number. More... | |
| int64_t | element_global_to_local (int64_t global) const |
| virtual bool | node_major () const |
| virtual | ~DatabaseIO () |
| void | release_memory () |
| virtual void | finalize_database () |
| void | set_pfsname (const std::string &name) const |
| std::string | get_pfsname () const |
| void | set_dwname (const std::string &name) const |
| this will be the name in BB namespace More... | |
| std::string | get_dwname () const |
| std::string | get_dwPath () const |
We call this ONLY after we assure that using_dw() is TRUE \ returns mount point of Datawarp namespace, e.g: /opt/cray/....<jobid> More... | |
| void | check_setDW () const |
| bool | using_dw () const |
| std::string | get_filename () const |
| Get the file name associated with the database. More... | |
| virtual int | get_file_pointer () const |
| const std::string & | decoded_filename () const |
| Get a file-per-processor filename associated with the database. More... | |
| virtual const std::string | get_format () const =0 |
| bool | is_input () const |
| Determine whether the database is an input database. More... | |
| Ioss::DatabaseUsage | usage () const |
| Get the Ioss::DatabaseUsage type of the database. More... | |
| virtual bool | needs_shared_node_information () const |
| Determine whether the database needs information about process ownership of nodes. More... | |
| Ioss::IfDatabaseExistsBehavior | open_create_behavior () const |
| void | create_path (const std::string &filename) const |
| This function is used to create the path to an output directory (or history, restart, etc.) More... | |
| void | set_region (Region *region) |
| void | openDW (const std::string &filename) const |
| If we are planning to use BB(aka Burst Buffer) service, we will call simple C API provided by Cray DataWarp module. More... | |
| void | closeDW () const |
| Function which invokes stageout from BB to Disk, prior to completion of final close. More... | |
| void | openDatabase () const |
| void | closeDatabase () const |
| void | flush_database () const |
| bool | open_group (const std::string &group_name) |
| If a database type supports groups and if the database contains groups, open the specified group. More... | |
| bool | create_subgroup (const std::string &group_name) |
| If a database type supports groups, create the specified group as a child of the current group. More... | |
| bool | begin (Ioss::State state) |
| Set the database to the given State. More... | |
| bool | end (Ioss::State state) |
| Return the database to STATE_CLOSED. More... | |
| bool | begin_state (int state, double time) |
| bool | end_state (int state, double time) |
| void | read_meta_data () |
| void | get_step_times () |
| virtual bool | internal_edges_available () const |
| virtual bool | internal_faces_available () const |
| const std::vector< std::string > & | get_information_records () const |
| Get all information records (informative strings) for the database. More... | |
| void | add_information_records (const std::vector< std::string > &info) |
| Add multiple information records (informative strings) to the database. More... | |
| void | add_information_record (const std::string &info) |
| Add an information record (an informative string) to the database. More... | |
| const std::vector< std::string > & | get_qa_records () const |
| Get all QA records, each of which consists of 4 strings, from the database. More... | |
| void | add_qa_record (const std::string &code, const std::string &code_qa, const std::string &date, const std::string &time) |
| Add a QA record, which consists of 4 strings, to the database. More... | |
| bool | get_logging () const |
| void | set_logging (bool on_off) |
| template<typename T > | |
| int64_t | get_field (const T *reg, const Field &field, void *data, size_t data_size) const |
| template<typename T > | |
| int64_t | put_field (const T *reg, const Field &field, void *data, size_t data_size) const |
| bool | is_parallel_consistent () const |
| void | set_parallel_consistency (bool on_off) |
| bool | get_use_generic_canonical_name () const |
| void | set_use_generic_canonical_name (bool yes_no) |
| bool | ignore_database_names () const |
| void | ignore_database_names (bool yes_no) |
| virtual int | maximum_symbol_length () const |
| Get the length of the longest name in the database file. More... | |
| virtual void | set_maximum_symbol_length (int) |
| char | get_field_separator () const |
| bool | get_field_recognition () const |
| void | set_field_separator (char separator) |
| Set the character used to separate a field suffix from the field basename when recognizing vector, tensor fields. More... | |
| void | set_field_recognition (bool yes_no) |
| void | set_lower_case_variable_names (bool true_false) const |
| void | set_surface_split_type (Ioss::SurfaceSplitType split_type) |
| Ioss::SurfaceSplitType | get_surface_split_type () const |
| void | set_block_omissions (const std::vector< std::string > &omissions, const std::vector< std::string > &inclusions={}) |
| void | get_block_adjacencies (const Ioss::ElementBlock *eb, std::vector< std::string > &block_adjacency) const |
| void | compute_block_membership (Ioss::SideBlock *efblock, std::vector< std::string > &block_membership) const |
| AxisAlignedBoundingBox | get_bounding_box (const Ioss::ElementBlock *eb) const |
| AxisAlignedBoundingBox | get_bounding_box (const Ioss::StructuredBlock *sb) const |
| virtual int | int_byte_size_db () const =0 |
| int | int_byte_size_api () const |
| Returns 4 or 8. More... | |
| virtual void | set_int_byte_size_api (Ioss::DataSize size) const |
| Returns 4 or 8. More... | |
| Region * | get_region () const |
| void | set_cycle_count (int count) const |
| int | get_cycle_count () const |
| void | set_overlay_count (int count) const |
| int | get_overlay_count () const |
| void | set_file_per_state (bool yes_no) const |
| bool | get_file_per_state () const |
| void | set_time_scale_factor (double factor) |
| const Ioss::ParallelUtils & | util () const |
| const Ioss::PropertyManager & | get_property_manager () const |
| int | parallel_rank () const |
| Get the processor that this mesh database is on. More... | |
| int | parallel_size () const |
| bool | is_parallel () const |
| void | progress (const std::string &output) const |
Protected Member Functions | |
| DatabaseIO (Region *region, std::string filename, Ioss::DatabaseUsage db_usage, MPI_Comm communicator, const Ioss::PropertyManager &props) | |
| void | set_common_side_topology () const |
| template<typename T > | |
| void | create_groups (const std::string &property_name, EntityType type, const std::string &type_name, const T *set_type) |
| template<typename T > | |
| void | create_group (EntityType type, const std::string &type_name, const std::vector< std::string > &group_spec, const T *set_type) |
| void | handle_groups () |
| void | check_side_topology () const |
| virtual void | openDatabase__ () const |
| virtual void | closeDatabase__ () const |
| virtual void | flush_database__ () const |
| template<> | |
| void | create_group (EntityType type, const std::string &, const std::vector< std::string > &group_spec, const SideSet *) |
Protected Attributes | |
| Ioss::PropertyManager | properties |
| ElementTopology * | commonSideTopology {nullptr} |
| std::string | originalDBFilename |
| std::string | DBFilename |
| std::string | decodedFilename |
| std::string | bbName {} |
| std::string | pfsName {} |
| std::string | dwPath {} |
| Ioss::State | dbState {STATE_INVALID} |
| int | myProcessor {0} |
| number of processor this database is for More... | |
| int64_t | nodeCount {0} |
| int64_t | elementCount {0} |
| TopoContainer | sideTopology |
| Used to speed up faceblock/edgeblock calculations. More... | |
| int | cycleCount {0} |
| int | overlayCount {0} |
| double | timeScaleFactor {1.0} |
| Ioss::SurfaceSplitType | splitType {SPLIT_BY_TOPOLOGIES} |
| Ioss::DatabaseUsage | dbUsage |
| Ioss::DataSize | dbIntSizeAPI {USE_INT32_API} |
| bool | filePerState {false} |
| bool | usingDataWarp {false} |
| bool | isParallel {false} |
| true if running in parallel More... | |
| bool | lowerCaseVariableNames {true} |
| bool | usingParallelIO {false} |
| std::vector< std::string > | blockOmissions |
| std::vector< std::string > | blockInclusions |
| std::vector< std::string > | informationRecords |
| std::vector< std::string > | qaRecords |
| Ioss::Map | nodeMap {"node", DBFilename, myProcessor} |
| Ioss::Map | edgeMap {"edge", DBFilename, myProcessor} |
| Ioss::Map | faceMap {"face", DBFilename, myProcessor} |
| Ioss::Map | elemMap {"element", DBFilename, myProcessor} |
| std::vector< std::vector< bool > > | blockAdjacency |
Private Member Functions | |
| virtual bool | ok__ (bool, std::string *, int *bad_count) const |
| virtual int64_t | node_global_to_local__ (int64_t global, bool must_exist) const |
| virtual int64_t | element_global_to_local__ (int64_t global) const |
| virtual void | release_memory__ () |
| virtual bool | open_group__ (const std::string &) |
| virtual bool | create_subgroup__ (const std::string &) |
| virtual bool | begin__ (Ioss::State state)=0 |
| virtual bool | end__ (Ioss::State state)=0 |
| virtual void | read_meta_data__ ()=0 |
| virtual void | get_step_times__ () |
| virtual bool | begin_state__ (int state, double time) |
| virtual bool | end_state__ (int state, double time) |
| void | get_block_adjacencies__ (const Ioss::ElementBlock *eb, std::vector< std::string > &block_adjacency) const |
| virtual void | compute_block_membership__ (Ioss::SideBlock *, std::vector< std::string > &) const |
| void | compute_block_adjacencies () const |
| void | verify_and_log (const GroupingEntity *ge, const Field &field, int in_out) const |
| virtual int64_t | get_field_internal (const Region *reg, const Field &field, void *data, size_t data_size) const =0 |
| virtual int64_t | get_field_internal (const NodeBlock *nb, const Field &field, void *data, size_t data_size) const =0 |
| virtual int64_t | get_field_internal (const EdgeBlock *nb, const Field &field, void *data, size_t data_size) const =0 |
| virtual int64_t | get_field_internal (const FaceBlock *nb, const Field &field, void *data, size_t data_size) const =0 |
| virtual int64_t | get_field_internal (const ElementBlock *eb, const Field &field, void *data, size_t data_size) const =0 |
| virtual int64_t | get_field_internal (const SideBlock *fb, const Field &field, void *data, size_t data_size) const =0 |
| virtual int64_t | get_field_internal (const NodeSet *ns, const Field &field, void *data, size_t data_size) const =0 |
| virtual int64_t | get_field_internal (const EdgeSet *ns, const Field &field, void *data, size_t data_size) const =0 |
| virtual int64_t | get_field_internal (const FaceSet *ns, const Field &field, void *data, size_t data_size) const =0 |
| virtual int64_t | get_field_internal (const ElementSet *ns, const Field &field, void *data, size_t data_size) const =0 |
| virtual int64_t | get_field_internal (const SideSet *fs, const Field &field, void *data, size_t data_size) const =0 |
| virtual int64_t | get_field_internal (const CommSet *cs, const Field &field, void *data, size_t data_size) const =0 |
| virtual int64_t | get_field_internal (const StructuredBlock *, const Field &, void *, size_t) const |
| virtual int64_t | put_field_internal (const Region *reg, const Field &field, void *data, size_t data_size) const =0 |
| virtual int64_t | put_field_internal (const NodeBlock *nb, const Field &field, void *data, size_t data_size) const =0 |
| virtual int64_t | put_field_internal (const EdgeBlock *nb, const Field &field, void *data, size_t data_size) const =0 |
| virtual int64_t | put_field_internal (const FaceBlock *nb, const Field &field, void *data, size_t data_size) const =0 |
| virtual int64_t | put_field_internal (const ElementBlock *eb, const Field &field, void *data, size_t data_size) const =0 |
| virtual int64_t | put_field_internal (const SideBlock *fb, const Field &field, void *data, size_t data_size) const =0 |
| virtual int64_t | put_field_internal (const NodeSet *ns, const Field &field, void *data, size_t data_size) const =0 |
| virtual int64_t | put_field_internal (const EdgeSet *ns, const Field &field, void *data, size_t data_size) const =0 |
| virtual int64_t | put_field_internal (const FaceSet *ns, const Field &field, void *data, size_t data_size) const =0 |
| virtual int64_t | put_field_internal (const ElementSet *ns, const Field &field, void *data, size_t data_size) const =0 |
| virtual int64_t | put_field_internal (const SideSet *fs, const Field &field, void *data, size_t data_size) const =0 |
| virtual int64_t | put_field_internal (const CommSet *cs, const Field &field, void *data, size_t data_size) const =0 |
| virtual int64_t | put_field_internal (const StructuredBlock *, const Field &, void *, size_t) const |
| DatabaseIO ()=delete | |
| DatabaseIO (const DatabaseIO &)=delete | |
| DatabaseIO & | operator= (const DatabaseIO &)=delete |
Private Attributes | |
| std::map< std::string, AxisAlignedBoundingBox > | elementBlockBoundingBoxes |
| Ioss::ParallelUtils | util_ |
| Region * | region_ {nullptr} |
| char | fieldSeparator {'_'} |
| bool | enableFieldRecognition {true} |
| bool | isInput |
| bool | isParallelConsistent |
| bool | singleProcOnly |
| bool | doLogging {false} |
| bool | useGenericCanonicalName |
| bool | ignoreDatabaseNames {false} |
| bool | blockAdjacenciesCalculated {false} |
| bool | m_timeStateInOut {false} |
| bool | m_enableTracing {false} |
| std::chrono::time_point< std::chrono::high_resolution_clock > | m_stateStart |
Friends | |
| class | SerializeIO |
An input or output Database.
|
virtualdefault |
|
protected |
|
privatedelete |
|
privatedelete |
| void Ioss::DatabaseIO::add_information_record | ( | const std::string & | info | ) |
Add an information record (an informative string) to the database.
| [in] | info | The string to add. |
| void Ioss::DatabaseIO::add_information_records | ( | const std::vector< std::string > & | info | ) |
Add multiple information records (informative strings) to the database.
| [in] | info | The strings to add. |
| void Ioss::DatabaseIO::add_qa_record | ( | const std::string & | code, |
| const std::string & | code_qa, | ||
| const std::string & | date, | ||
| const std::string & | time | ||
| ) |
Add a QA record, which consists of 4 strings, to the database.
The 4 function parameters correspond to the 4 QA record strings.
| [in] | code | A descriptive code name, such as the application that modified the database. |
| [in] | code_qa | A descriptive string, such as the version of the application that modified the database. |
| [in] | date | A relevant date, such as the date the database was modified. |
| [in] | time | A relevant time, such as the time the database was modified. |
|
inline |
Set the database to the given State.
All transitions must begin from the 'STATE_CLOSED' state or be to the 'STATE_CLOSED' state (There are no nested begin/end pairs at this time.)
The database state is automatically set when Region::begin_mode is called for its associated region, so it may not be necessary to call this method directly.
| [in] | state | The new State to which the database should be set. |
|
privatepure virtual |
| bool Ioss::DatabaseIO::begin_state | ( | int | state, |
| double | time | ||
| ) |
|
privatevirtual |
Reimplemented in Ioad::DatabaseIO, Ioex::DatabaseIO, Iocgns::ParallelDatabaseIO, Iohb::DatabaseIO, Iogs::DatabaseIO, Iogn::DatabaseIO, Iocgns::DatabaseIO, and Iovs::DatabaseIO.
| void Ioss::DatabaseIO::check_setDW | ( | ) | const |
Determine whether Cray Datawarp module is loaded and we have BB capacity allocated for this job ( i.e: DW_JOB_STRIPED is set) && IOSS property to use DATAWARP is set to Y/YES (i.e environmental variable ENABLE_DATAWARP) . If we are using DW then set some pathnames for writing directly to BB instead of PFS(i.e Lustre)
Check whether user wants to use Cray DataWarp. It will be enabled if: the DW_JOB_STRIPED or DW_JOB_PRIVATE environment variable is set by the queuing system during runtime and the IOSS property ENABLE_DATAWARP set to YES.
We currently only want output files to be directed to BB.
|
protected |
Check the topology of all face/element pairs in the model and fill the "TopoContainer faceTopology" variable with the unique pairs. This information is used for the faceblock/facesets and edgeblock/edgesets. If the 'topo_dimension' is 2, then face/element pairs are generated; if 'topo_dimension' is 1, then edge/element pairs are generated.
|
inline |
|
protectedvirtual |
Reimplemented in Ioex::DatabaseIO, Iocgns::ParallelDatabaseIO, and Iocgns::DatabaseIO.
| void Ioss::DatabaseIO::closeDW | ( | ) | const |
Function which invokes stageout from BB to Disk, prior to completion of final close.
This function gets called inside closeDatabase__(), which checks if Cray Datawarp (DW) is in use, if so, we want to call a stageout before actual close of this file.
|
private |
|
inline |
|
inlineprivatevirtual |
Reimplemented in Ioad::DatabaseIO, Ioex::DatabaseIO, and Iopg::DatabaseIO.
|
protected |
|
protected |
|
protected |
| void Ioss::DatabaseIO::create_path | ( | const std::string & | filename | ) | const |
This function is used to create the path to an output directory (or history, restart, etc.)
|
inline |
If a database type supports groups, create the specified group as a child of the current group.
The name of the group must not contain a '/' character. If the command is successful, then the group will be the active group for all subsequent writes to the database.
| [in] | group_name | The name of the subgroup to create. |
|
inlineprivatevirtual |
Reimplemented in Ioex::DatabaseIO.
| const std::string & Ioss::DatabaseIO::decoded_filename | ( | ) | const |
Get a file-per-processor filename associated with the database.
\ returns The file-per-processor name for a file on this processor.
|
inline |
|
inlineprivatevirtual |
Reimplemented in Iohb::DatabaseIO, Iocgns::ParallelDatabaseIO, and Iocgns::DatabaseIO.
|
inline |
Return the database to STATE_CLOSED.
The database is automatically set to STATE_CLOSED when Region::end_mode is called for its associated region, so it may not be necessary to call this method directly.
| [in] | state | The State to end, i.e. the current state. |
|
privatepure virtual |
| bool Ioss::DatabaseIO::end_state | ( | int | state, |
| double | time | ||
| ) |
|
privatevirtual |
Reimplemented in Ioad::DatabaseIO, Ioex::DatabaseIO, Iocgns::ParallelDatabaseIO, Iohb::DatabaseIO, Iocgns::DatabaseIO, and Iovs::DatabaseIO.
|
pure virtual |
|
inlinevirtual |
Reimplemented in Iocgns::ParallelDatabaseIO, and Iocgns::DatabaseIO.
|
inline |
|
inlineprotectedvirtual |
Reimplemented in Ioex::DatabaseIO, Iocgns::ParallelDatabaseIO, Iocgns::DatabaseIO, and Iohb::DatabaseIO.
|
inline |
|
private |
| AxisAlignedBoundingBox Ioss::DatabaseIO::get_bounding_box | ( | const Ioss::ElementBlock * | eb | ) | const |
| AxisAlignedBoundingBox Ioss::DatabaseIO::get_bounding_box | ( | const Ioss::StructuredBlock * | sb | ) | const |
|
inline |
|
inline |
|
inline |
We call this ONLY after we assure that using_dw() is TRUE \ returns mount point of Datawarp namespace, e.g: /opt/cray/....<jobid>
|
inline |
|
privatepure virtual |
|
privatepure virtual |
|
inlineprivatevirtual |
|
inline |
|
inline |
|
inline |
|
inlinevirtual |
For the database types that support it, return an integer handle through which a client can directly access the underlying file. Please use sparingly and with discretion. Basically, a kluge
Reimplemented in Ioex::DatabaseIO, Iocgns::DatabaseIO, Iocgns::ParallelDatabaseIO, Iopx::DatabaseIO, and Iofx::DatabaseIO.
|
inline |
Get the file name associated with the database.
|
pure virtual |
Return a string specifying underlying format of database (exodus, cgns, ...)
Implemented in Ioex::DatabaseIO, Iogs::DatabaseIO, Iogn::DatabaseIO, Iohb::DatabaseIO, Iocgns::DatabaseIO, Iopg::DatabaseIO, Iocgns::ParallelDatabaseIO, Iovs::DatabaseIO, and Ioad::DatabaseIO.
|
inline |
Get all information records (informative strings) for the database.
|
inline |
|
inline |
|
inline |
|
inline |
|
inline |
Get all QA records, each of which consists of 4 strings, from the database.
The 4 strings that make up a database QA record are:
|
inline |
The owning region of this database.
|
inline |
|
inlineprivatevirtual |
Reimplemented in Ioex::DatabaseIO, Iocgns::ParallelDatabaseIO, Iocgns::DatabaseIO, Iogs::DatabaseIO, Iogn::DatabaseIO, Iopx::DatabaseIO, and Iofx::DatabaseIO.
|
inline |
|
inline |
|
protected |
|
inline |
|
inline |
| int Ioss::DatabaseIO::int_byte_size_api | ( | ) | const |
Returns 4 or 8.
|
pure virtual |
|
inlinevirtual |
|
inlinevirtual |
|
inline |
Determine whether the database is an input database.
|
inline |
|
inline |
Determine whether application will make field data get/put calls parallel consistently.
True is default and required for parallel-io databases. Even if false, metadata operations must be called by all processors.
|
inlinevirtual |
Get the length of the longest name in the database file.
Reimplemented in Ioex::DatabaseIO, Iodw::DatabaseIO, and Iopg::DatabaseIO.
|
inlinevirtual |
Determine whether the database needs information about process ownership of nodes.
Reimplemented in Iocgns::ParallelDatabaseIO, and Iopx::DatabaseIO.
|
inline |
Get the local (process-specific) node number corresponding to a global node number.
| [in] | global | The global node number |
| [in] | must_exist | If true, error will occur if the global node number is not mapped to any local node number on the current process. |
|
inlineprivatevirtual |
Reimplemented in Iohb::DatabaseIO, Iocgns::ParallelDatabaseIO, and Iocgns::DatabaseIO.
|
inlinevirtual |
If there is a single block of nodes in the model, then it is considered a node_major() database. If instead the nodes are local to each element block or structured block, then it is not a node_major database. Exodus is node major, CGNS is not.
Reimplemented in Iocgns::ParallelDatabaseIO, and Iocgns::DatabaseIO.
|
inline |
Check to see if database state is OK.
| [in] | write_message | If true, then output a warning message indicating the problem. |
| [in,out] | error_message | If non-null on input, then a warning message on output. |
| [in,out] | bad_count | If non-null on input, then count of the number of processors where the file does not exist on output. If ok returns false, but *bad_count==0, then the routine does not support this argument. |
|
inlineprivatevirtual |
Reimplemented in Ioex::DatabaseIO.
| IfDatabaseExistsBehavior Ioss::DatabaseIO::open_create_behavior | ( | ) | const |
|
inline |
If a database type supports groups and if the database contains groups, open the specified group.
If the group_name begins with '/', it specifies the absolute path name from the root with '/' separating groups. Otherwise, the group_name specifies a child group of the currently active group. If group_name == "/" then the root group is opened.
| [in] | group_name | The name of the group to open. |
|
inlineprivatevirtual |
Reimplemented in Ioex::DatabaseIO.
|
inline |
|
protectedvirtual |
Reimplemented in Ioex::DatabaseIO, Iocgns::ParallelDatabaseIO, and Iocgns::DatabaseIO.
| void Ioss::DatabaseIO::openDW | ( | const std::string & | filename | ) | const |
If we are planning to use BB(aka Burst Buffer) service, we will call simple C API provided by Cray DataWarp module.
Note: We would only like to use BB during write to avoid cache coherency issues during read. dwPath is the DW namespace which gets set during runtime from environment variable DW_JOB_STRIPED. Afterword, using_dw() function is used extensively for filename redirection for all related subsequent functions(e.g: get_filename, get_file_ptr etc) once burst buffer is found and set to be used.
In this wrapper function we check if user intends to use Cray DataWarp(aka DW), which provides ability to use NVMe based flash storage available across all compute nodes accessible via high speed NIC.
|
privatedelete |
|
inline |
Get the processor that this mesh database is on.
|
inline |
|
inline |
|
inline |
|
privatepure virtual |
|
privatepure virtual |
|
inlineprivatevirtual |
|
inline |
|
privatepure virtual |
|
inline |
|
inlineprivatevirtual |
Reimplemented in Iopx::DatabaseIO, and Iocgns::ParallelDatabaseIO.
| void Ioss::DatabaseIO::set_block_omissions | ( | const std::vector< std::string > & | omissions, |
| const std::vector< std::string > & | inclusions = {} |
||
| ) |
|
protected |
Utility function that may be used by derived classes. Determines whether all elements in the model have the same side topology. This can be used to speed-up certain algorithms since they don't have to check each side (or group of sides) individually.
|
inline |
The overlay_count specifies the number of restart outputs which will be overlaid on top of the currently written step before advancing to the next step on the restart database.
For example, if restarts are being output every 0.1 seconds and the overlay count is specified as 2, then restart will write time 0.1 to step 1 of the database. It will then write 0.2 and 0.3 also to step 1. It will then increment the database step and write 0.4 to step 2; overlay 0.5 and 0.6 on step 2... At the end of the analysis, assuming it runs to completion, the database would have times 0.3, 0.6, 0.9, ... However, if there were a problem during the analysis, the last step on the database would contain an intermediate step.
The cycle_count specifies the number of restart steps which will be written to the restart database before previously written steps are overwritten.
For example, if the cycle count is 5 and restart is written every 0.1 seconds, the restart system will write data at times 0.1, 0.2, 0.3, 0.4, 0.5 to the database.
It will then overwrite the first step with data from time 0.6, the second with time 0.7. At time 0.8, the database would contain data at times 0.6, 0.7, 0.8, 0.4, 0.5. Note that time will not necessarily be monotonically increasing on a database that specifies the cycle count.
The cycle count and overlay count can both be used at the same time also. The basic formula is:
db_step = (((output_step - 1) / overlay) % cycle) + 1
where "output_step" is the step that this would have been on the database in a normal write (1,2,3,....) and "db_step" is the step number that this will be written to.
If you only want the last step available on the database, use set_cycle_count(1)
|
inline |
this will be the name in BB namespace
|
inline |
| void Ioss::DatabaseIO::set_field_separator | ( | char | separator | ) |
Set the character used to separate a field suffix from the field basename when recognizing vector, tensor fields.
| [in] | separator | The separator character. |
|
inline |
|
virtual |
Returns 4 or 8.
Set the number of bytes used to represent an integer.
| [in] | size | The number of bytes. This is 4 for INT32 or 8 for INT64. |
Reimplemented in Ioex::DatabaseIO.
|
inline |
|
inline |
|
inlinevirtual |
Reimplemented in Ioex::DatabaseIO.
|
inline |
|
inline |
|
inline |
|
inline |
|
inline |
|
inline |
|
inline |
|
inline |
Get the Ioss::DatabaseUsage type of the database.
|
inline |
Set if Cray Datawarp exists and allocated space is found , i.e PATH to DW name space
|
inline |
|
inline |
|
private |
|
friend |
|
mutableprotected |
bbName is a temporary swizzled name which resides inside Burst Buffer namespace. This is a private trivial mapped name vs original DBFilename (which resides in permanent storage backed by parallel filesystem. dwPath is global BB mountpoint for current job with requested capacity via SLURM #DW directive. usingDataWarp – a boolean, for convenience of use so that we don't have to do getenv() calls to see if BB present.
|
mutableprivate |
|
mutableprotected |
|
protected |
|
protected |
|
protected |
|
mutableprotected |
Typically used for restart output, but can be used for all output... Maximum number of states on the output file. Overwrite the existing steps in a cyclic manner once exceed this count. Note that this breaks the convention that times be monotonically increasing on an exodusII file. Used by derived classes if they support this capability...
|
protected |
|
mutableprotected |
|
mutableprotected |
|
protected |
|
mutableprotected |
|
private |
|
mutableprotected |
|
mutableprotected |
|
mutableprivate |
|
protected |
|
mutableprotected |
|
private |
|
mutableprotected |
|
private |
|
mutableprotected |
EXPERIMENTAL If this is true, then each state (timestep) output will be directed to a separate file. Currently this is only implemented for the exodus (parallel or serial, single file or fpp) database type.
|
private |
|
protected |
|
private |
|
protected |
true if running in parallel
|
private |
|
mutableprotected |
|
private |
|
private |
|
private |
|
protected |
number of processor this database is for
|
protected |
|
mutableprotected |
|
protected |
Filename that this Database is connected with. Derived DatabaseIO classes may need to change this if the passed in filename is not the same as the filename actually used E.g., the Ioex_DatabaseIO (exodusII) changes if this is a parallel run since the passed in filename is just the basename, not the processor-specific filename.
|
mutableprotected |
|
mutableprotected |
|
protected |
The properties member data contains properties that can be used to set database-specific options. Examples include compression, name lengths, integer sizes, floating point sizes. By convention, the property name is all uppercase. Some existing properties recognized by the Exodus DatabaseIO class are:
| Property | Value |
|---|---|
| COMPRESSION_LEVEL | In the range [0..9]. A value of 0 indicates no compression |
| COMPRESSION_SHUFFLE | (true/false) to enable/disable hdf5's shuffle compression |
algorithm. | FILE_TYPE | netcdf4 | MAXIMUM_NAME_LENGTH | Maximum length of names that will be returned/passed via api call. | INTEGER_SIZE_DB | 4 or 8 indicating byte size of integers stored on the database. | INTEGER_SIZE_API | 4 or 8 indicating byte size of integers used in api functions. | LOGGING | (true/false) to enable/disable logging of field input/output
|
protected |
|
private |
|
protected |
Used to speed up faceblock/edgeblock calculations.
|
private |
|
protected |
|
protected |
Scale the time read/written from/to the file by the specified scaleFactor. If the datbase times are 0.1, 0.2, 0.3 and the scaleFactor is 20, then the application will think that the times read are 20, 40, 60.
If specified for an output database, then the analysis time is divided by the scaleFactor time prior to output.
|
private |
|
mutableprotected |
|
protected |
|
private |
1.8.16