/* * Copyright(C) 1999-2020, 2022, 2023 National Technology & Engineering Solutions * of Sandia, LLC (NTESS). Under the terms of Contract DE-NA0003525 with * NTESS, the U.S. Government retains certain rights in this software. * * See packages/seacas/LICENSE for details */ /***************************************************************************** * * exodusII_int.h - ExodusII header file for internal Exodus call use only * */ #pragma once #include #include "exodus_config.h" #if defined(EXODUS_THREADSAFE) #include #endif #include "netcdf.h" #if defined(NC_HAVE_META_H) #include "netcdf_meta.h" #endif #if defined(_WIN32) && defined(_MSC_VER) && _MSC_VER < 1900 #define PRId64 "I64d" #else #include #endif #include #include #include #ifndef __APPLE__ #if defined __STDC__ || defined __cplusplus #include #endif #endif #ifdef _MSC_VER #pragma warning(disable : 4127) #pragma warning(disable : 4706) #pragma warning(disable : 4701) #endif #if defined(__BORLANDC__) #pragma warn - 8004 /* "assigned a value that is never used" */ #endif #include #if defined(_MSC_VER) && _MSC_VER < 1900 #define __func__ __FUNCTION__ #define snprintf _snprintf #endif #define snprintf_nowarn(...) (snprintf(__VA_ARGS__) < 0 ? abort() : (void)0) #ifdef __cplusplus extern "C" { #endif /** * \defgroup Internal Internal Functions and Defines * \internal * * Variables and functions used internally in the library *@{ */ #define MAX_VAR_NAME_LENGTH 32 /**< Internal use only */ /* Default "filesize" for newly created files. * Set to 0 for normal filesize setting. * Set to 1 for EXODUS_LARGE_MODEL setting to be the default */ #define EXODUS_DEFAULT_SIZE 1 /* Used to map between root (file id) and group ids when using groups */ #define EX_FILE_ID_MASK (0xffff0000) /**< Must match FILE_ID_MASK in NetCDF nc4internal.h */ #define EX_GRP_ID_MASK (0x0000ffff) /**< Must match GRP_ID_MASK in NetCDF nc4internal.h */ void ex__reset_error_status(void); #if defined(EXODUS_THREADSAFE) #if !defined(exerrval) /* In both exodusII.h and exodusII_int.h */ typedef struct EX_errval { int errval; char last_pname[MAX_ERR_LENGTH]; char last_errmsg[MAX_ERR_LENGTH]; int last_err_num; } EX_errval_t; EXODUS_EXPORT EX_errval_t *ex_errval; #define exerrval ex_errval->errval #endif extern pthread_once_t EX_first_init_g; typedef struct EX_mutex_struct { pthread_mutex_t atomic_lock; /**< lock for atomicity of new mechanism */ pthread_mutexattr_t attribute; } EX_mutex_t; extern EX_mutex_t EX_g; extern int ex__mutex_lock(EX_mutex_t *mutex); extern int ex__mutex_unlock(EX_mutex_t *mutex, const char *func, int line); extern void ex__pthread_first_thread_init(void); extern EX_errval_t *exerrval_get(); #define EX_FUNC_ENTER() \ do { \ /* Initialize the thread-safe code */ \ pthread_once(&EX_first_init_g, ex__pthread_first_thread_init); \ \ /* Grab the mutex for the library */ \ ex__mutex_lock(&EX_g); \ ex_errval = exerrval_get(); \ exerrval = 0; \ ex_errval->last_err_num = 0; \ } while (0) #define EX_FUNC_ENTER_INT() \ do { \ /* Initialize the thread-safe code */ \ pthread_once(&EX_first_init_g, ex__pthread_first_thread_init); \ \ /* Grab the mutex for the library */ \ ex__mutex_lock(&EX_g); \ ex_errval = exerrval_get(); \ } while (0) #define EX_FUNC_LEAVE(error) \ do { \ ex__mutex_unlock(&EX_g, __func__, __LINE__); \ return error; \ } while (0) #define EX_FUNC_VOID() \ do { \ ex__mutex_unlock(&EX_g, __func__, __LINE__); \ return; \ } while (0) #define EX_FUNC_UNLOCK() \ do { \ ex__mutex_unlock(&EX_g, __func__, __LINE__); \ } while (0) #else /* Enable this to output tracing information from the API functions */ #if 0 EXODUS_EXPORT int indent; #define EX_FUNC_ENTER() \ do { \ ex__reset_error_status(); \ fprintf(stderr, "%d Enter: %s\n", indent, __func__); \ indent++; \ } while (0) #define EX_FUNC_ENTER_INT() \ do { \ fprintf(stderr, "%d Enter: %s\n", indent, __func__); \ indent++; \ } while (0) #define EX_FUNC_LEAVE(error) \ do { \ indent--; \ fprintf(stderr, "%d Leave: %s\n", indent, __func__); \ return error; \ } while (0) #define EX_FUNC_VOID() \ do { \ indent--; \ fprintf(stderr, "%d Leave: %s\n", indent, __func__); \ return; \ } while (0) #define EX_FUNC_UNLOCK() \ do { \ indent--; \ fprintf(stderr, "%d Unlock: %s\n", indent, __func__); \ } while (0) #else #define EX_FUNC_ENTER() \ do { \ ex__reset_error_status(); \ } while (0) #define EX_FUNC_ENTER_INT() #define EX_FUNC_LEAVE(error) return error #define EX_FUNC_VOID() return #define EX_FUNC_UNLOCK() #endif #endif #define EX_UNUSED(A) \ do { \ (void)(A); \ } while (0) /* * This file contains defined constants that are used internally in the * EXODUS API. * * The first group of constants refer to NetCDF variables, attributes, or * dimensions in which the EXODUS data are stored. Using the defined * constants will allow the names of the NetCDF entities to be changed easily * in the future if needed. The first three letters of the constant identify * the NetCDF entity as a variable (VAR), dimension (DIM), or attribute (ATT). * * NOTE: The entity name should not have any blanks in it. Blanks are * technically legal but some NetCDF utilities (ncgen in particular) * fail when they encounter a blank in a name. * */ #define ATT_TITLE "title" /**< the database title */ #define ATT_API_VERSION "api_version" /**< the EXODUS api vers number */ /*! the EXODUS api vers # used for db version 2.01 and earlier */ #define ATT_API_VERSION_BLANK "api version" #define ATT_VERSION "version" /**< the EXODUS file vers number */ #define ATT_FILESIZE "file_size" /**< 1=large, 0=normal */ /*! word size of floating point numbers in file */ #define ATT_FLT_WORDSIZE "floating_point_word_size" /*! word size of floating point numbers in file used for db version 2.01 and earlier */ #define ATT_FLT_WORDSIZE_BLANK "floating point word size" #define ATT_MAX_NAME_LENGTH "maximum_name_length" #define ATT_INT64_STATUS "int64_status" #define ATT_NEM_API_VERSION "nemesis_api_version" #define ATT_NEM_FILE_VERSION "nemesis_file_version" #define ATT_PROCESSOR_INFO "processor_info" #define ATT_LAST_WRITTEN_TIME "last_written_time" #define DIM_NUM_ASSEMBLY "num_assembly" /**< number of assemblies */ #define DIM_NUM_BLOB "num_blob" /**< number of blobs */ #define DIM_NUM_NODES "num_nodes" /**< number of nodes */ #define DIM_NUM_DIM "num_dim" /**< number of dimensions; 2- or 3-d*/ #define DIM_NUM_EDGE "num_edge" /**< number of edges (over all blks)*/ #define DIM_NUM_FACE "num_face" /**< number of faces (over all blks)*/ #define DIM_NUM_ELEM "num_elem" /**< number of elements */ #define DIM_NUM_EL_BLK "num_el_blk" /**< number of element blocks */ #define DIM_NUM_ED_BLK "num_ed_blk" /**< number of edge blocks */ #define DIM_NUM_FA_BLK "num_fa_blk" /**< number of face blocks */ #define VAR_COORD "coord" /**< nodal coordinates */ #define VAR_COORD_X "coordx" /**< X-dimension coordinate */ #define VAR_COORD_Y "coordy" /**< Y-dimension coordinate */ #define VAR_COORD_Z "coordz" /**< Z-dimension coordinate */ #define VAR_NAME_COOR "coor_names" /**< names of coordinates */ #define VAR_NAME_EL_BLK "eb_names" /**< names of element blocks */ #define VAR_NAME_NS "ns_names" /**< names of node sets */ #define VAR_NAME_SS "ss_names" /**< names of side sets */ #define VAR_NAME_EM "emap_names" /**< names of element maps */ #define VAR_NAME_EDM "edmap_names" /**< names of edge maps */ #define VAR_NAME_FAM "famap_names" /**< names of face maps */ #define VAR_NAME_NM "nmap_names" /**< names of node maps */ #define VAR_NAME_ED_BLK "ed_names" /**< names of edge blocks */ #define VAR_NAME_FA_BLK "fa_names" /**< names of face blocks */ #define VAR_NAME_ES "es_names" /**< names of edge sets */ #define VAR_NAME_FS "fs_names" /**< names of face sets */ #define VAR_NAME_ELS "els_names" /**< names of element sets */ #define VAR_STAT_EL_BLK "eb_status" /**< element block status */ #define VAR_STAT_ECONN "econn_status" /**< element block edge status */ #define VAR_STAT_FCONN "fconn_status" /**< element block face status */ #define VAR_STAT_ED_BLK "ed_status" /**< edge block status */ #define VAR_STAT_FA_BLK "fa_status" /**< face block status */ #define VAR_ID_EL_BLK "eb_prop1" /**< element block ids props */ #define VAR_ID_ED_BLK "ed_prop1" /**< edge block ids props */ #define VAR_ID_FA_BLK "fa_prop1" /**< face block ids props */ #define DIM_NUM_ENTITY_ASSEMBLY(num) ex__catstr("num_entity_assembly", num) #define VAR_ENTITY_ASSEMBLY(num) ex__catstr("assembly_entity", num) #define DIM_NUM_VALUES_BLOB(num) ex__catstr("num_values_blob", num) #define VAR_ENTITY_BLOB(num) ex__catstr("blob_entity", num) #define EX_ATTRIBUTE_TYPE "_type" #define EX_ATTRIBUTE_TYPENAME "_typename" #define EX_ATTRIBUTE_NAME "_name" #define EX_ATTRIBUTE_ID "_id" /*! element type names for each element block */ #define ATT_NAME_ELB "elem_type" /*! number of elements in element block num */ #define DIM_NUM_EL_IN_BLK(num) ex__catstr("num_el_in_blk", num) /*! number of nodes per element in element block num */ #define DIM_NUM_NOD_PER_EL(num) ex__catstr("num_nod_per_el", num) /*! number of attributes in element block num */ #define DIM_NUM_ATT_IN_BLK(num) ex__catstr("num_att_in_blk", num) /*! number of edges in edge block num */ #define DIM_NUM_ED_IN_EBLK(num) ex__catstr("num_ed_in_blk", num) /*! number of nodes per edge in edge block num */ #define DIM_NUM_NOD_PER_ED(num) ex__catstr("num_nod_per_ed", num) /*! number of edges per element in element block num */ #define DIM_NUM_EDG_PER_EL(num) ex__catstr("num_edg_per_el", num) /*! number of attributes in edge block num */ #define DIM_NUM_ATT_IN_EBLK(num) ex__catstr("num_att_in_eblk", num) /*! number of faces in face block num */ #define DIM_NUM_FA_IN_FBLK(num) ex__catstr("num_fa_in_blk", num) /*! number of nodes per face in face block num */ #define DIM_NUM_NOD_PER_FA(num) ex__catstr("num_nod_per_fa", num) /*! number of faces per element in element block num */ #define DIM_NUM_FAC_PER_EL(num) ex__catstr("num_fac_per_el", num) /*! number of attributes in face block num */ #define DIM_NUM_ATT_IN_FBLK(num) ex__catstr("num_att_in_fblk", num) /*! element connectivity for element block num */ #define VAR_CONN(num) ex__catstr("connect", num) /*! array containing number of entity per */ /* entity for n-sided face/element blocks */ #define VAR_EBEPEC(num) ex__catstr("ebepecnt", num) /*! list of attributes for element block num */ #define VAR_ATTRIB(num) ex__catstr("attrib", num) /*! list of attribute names for element block num */ #define VAR_NAME_ATTRIB(num) ex__catstr("attrib_name", num) /*! list of the numth property for all element blocks */ #define VAR_EB_PROP(num) ex__catstr("eb_prop", num) /*! edge connectivity for element block num */ #define VAR_ECONN(num) ex__catstr("edgconn", num) /*! edge connectivity for edge block num */ #define VAR_EBCONN(num) ex__catstr("ebconn", num) /*! list of attributes for edge block num */ #define VAR_EATTRIB(num) ex__catstr("eattrb", num) /*! list of attribute names for edge block num */ #define VAR_NAME_EATTRIB(num) ex__catstr("eattrib_name", num) #define VAR_NATTRIB "nattrb" #define VAR_NAME_NATTRIB "nattrib_name" #define DIM_NUM_ATT_IN_NBLK "num_att_in_nblk" #define VAR_NSATTRIB(num) ex__catstr("nsattrb", num) #define VAR_NAME_NSATTRIB(num) ex__catstr("nsattrib_name", num) #define DIM_NUM_ATT_IN_NS(num) ex__catstr("num_att_in_ns", num) #define VAR_SSATTRIB(num) ex__catstr("ssattrb", num) #define VAR_NAME_SSATTRIB(num) ex__catstr("ssattrib_name", num) #define DIM_NUM_ATT_IN_SS(num) ex__catstr("num_att_in_ss", num) #define VAR_ESATTRIB(num) ex__catstr("esattrb", num) #define VAR_NAME_ESATTRIB(num) ex__catstr("esattrib_name", num) #define DIM_NUM_ATT_IN_ES(num) ex__catstr("num_att_in_es", num) #define VAR_FSATTRIB(num) ex__catstr("fsattrb", num) #define VAR_NAME_FSATTRIB(num) ex__catstr("fsattrib_name", num) #define DIM_NUM_ATT_IN_FS(num) ex__catstr("num_att_in_fs", num) #define VAR_ELSATTRIB(num) ex__catstr("elsattrb", num) #define VAR_NAME_ELSATTRIB(num) ex__catstr("elsattrib_name", num) #define DIM_NUM_ATT_IN_ELS(num) ex__catstr("num_att_in_els", num) /*! list of the numth property for all edge blocks */ #define VAR_ED_PROP(num) ex__catstr("ed_prop", num) /*! face connectivity for element block num */ #define VAR_FCONN(num) ex__catstr("facconn", num) /*! face connectivity for face block num */ #define VAR_FBCONN(num) ex__catstr("fbconn", num) /*! array containing number of entity per entity for n-sided face/element blocks */ #define VAR_FBEPEC(num) ex__catstr("fbepecnt", num) /*! list of attributes for face block num */ #define VAR_FATTRIB(num) ex__catstr("fattrb", num) /*! list of attribute names for face block num */ #define VAR_NAME_FATTRIB(num) ex__catstr("fattrib_name", num) /*! list of the numth property for all face blocks */ #define VAR_FA_PROP(num) ex__catstr("fa_prop", num) /*! name attached to element block, node set, side set, element map, or map properties */ #define ATT_PROP_NAME "name" #define VAR_MAP "elem_map" /**< element order map */ #define DIM_NUM_SS "num_side_sets" /**< number of side sets */ #define VAR_SS_STAT "ss_status" /**< side set status */ #define VAR_SS_IDS "ss_prop1" /**< side set id properties */ /*! number of sides in side set num*/ #define DIM_NUM_SIDE_SS(num) ex__catstr("num_side_ss", num) /*! number of distribution factors in side set num */ #define DIM_NUM_DF_SS(num) ex__catstr("num_df_ss", num) /*! the distribution factors for each node in side set num */ #define VAR_FACT_SS(num) ex__catstr("dist_fact_ss", num) /*! list of elements in side set num */ #define VAR_ELEM_SS(num) ex__catstr("elem_ss", num) /*! list of sides in side set */ #define VAR_SIDE_SS(num) ex__catstr("side_ss", num) /*! list of the numth property for all side sets */ #define VAR_SS_PROP(num) ex__catstr("ss_prop", num) #define DIM_NUM_ES "num_edge_sets" /**< number of edge sets */ #define VAR_ES_STAT "es_status" /**< edge set status */ #define VAR_ES_IDS "es_prop1" /**< edge set id properties */ /*! number of edges in edge set num*/ #define DIM_NUM_EDGE_ES(num) ex__catstr("num_edge_es", num) /*! number of distribution factors in edge set num */ #define DIM_NUM_DF_ES(num) ex__catstr("num_df_es", num) /*! the distribution factors for each node in edge set num */ #define VAR_FACT_ES(num) ex__catstr("dist_fact_es", num) /*! list of edges in edge set num */ #define VAR_EDGE_ES(num) ex__catstr("edge_es", num) /*! list of orientations in the edge set. */ #define VAR_ORNT_ES(num) ex__catstr("ornt_es", num) /*! list of the numth property for all edge sets */ #define VAR_ES_PROP(num) ex__catstr("es_prop", num) #define DIM_NUM_FS "num_face_sets" /**< number of face sets */ #define VAR_FS_STAT "fs_status" /**< face set status */ #define VAR_FS_IDS "fs_prop1" /**< face set id properties */ /*! number of faces in side set num*/ #define DIM_NUM_FACE_FS(num) ex__catstr("num_face_fs", num) /*! number of distribution factors in face set num */ #define DIM_NUM_DF_FS(num) ex__catstr("num_df_fs", num) /*! the distribution factors for each node in face set num */ #define VAR_FACT_FS(num) ex__catstr("dist_fact_fs", num) /*! list of elements in face set num */ #define VAR_FACE_FS(num) ex__catstr("face_fs", num) /*! list of sides in side set */ #define VAR_ORNT_FS(num) ex__catstr("ornt_fs", num) /*! list of the numth property for all face sets */ #define VAR_FS_PROP(num) ex__catstr("fs_prop", num) #define DIM_NUM_ELS "num_elem_sets" /**< number of elem sets */ /*! number of elements in elem set num */ #define DIM_NUM_ELE_ELS(num) ex__catstr("num_ele_els", num) /*! number of distribution factors in element set num */ #define DIM_NUM_DF_ELS(num) ex__catstr("num_df_els", num) #define VAR_ELS_STAT "els_status" /**< elem set status */ #define VAR_ELS_IDS "els_prop1" /**< elem set id properties */ /*! list of elements in elem set num */ #define VAR_ELEM_ELS(num) ex__catstr("elem_els", num) /*! list of distribution factors in elem set num */ #define VAR_FACT_ELS(num) ex__catstr("dist_fact_els", num) /*! list of the numth property for all elem sets */ #define VAR_ELS_PROP(num) ex__catstr("els_prop", num) #define DIM_NUM_NS "num_node_sets" /**< number of node sets */ /*! number of nodes in node set num */ #define DIM_NUM_NOD_NS(num) ex__catstr("num_nod_ns", num) /*! number of distribution factors in node set num */ #define DIM_NUM_DF_NS(num) ex__catstr("num_df_ns", num) #define VAR_NS_STAT "ns_status" /**< node set status */ #define VAR_NS_IDS "ns_prop1" /**< node set id properties */ /*! list of nodes in node set num */ #define VAR_NODE_NS(num) ex__catstr("node_ns", num) /*! list of distribution factors in node set num */ #define VAR_FACT_NS(num) ex__catstr("dist_fact_ns", num) /*! list of the numth property for all node sets */ #define VAR_NS_PROP(num) ex__catstr("ns_prop", num) #define DIM_NUM_QA "num_qa_rec" /**< number of QA records */ #define VAR_QA_TITLE "qa_records" /**< QA records */ #define DIM_NUM_INFO "num_info" /**< number of information records */ #define VAR_INFO "info_records" /**< information records */ #define VAR_WHOLE_TIME "time_whole" /**< simulation times for whole time steps */ #define VAR_ASSEMBLY_TAB "assembly_var_tab" /**< assembly variable truth table */ #define VAR_BLOB_TAB "blob_var_tab" /**< blob variable truth table */ #define VAR_ELEM_TAB "elem_var_tab" /**< element variable truth table */ #define VAR_EBLK_TAB "edge_var_tab" /**< edge variable truth table */ #define VAR_FBLK_TAB "face_var_tab" /**< face variable truth table */ #define VAR_ELSET_TAB "elset_var_tab" /**< elemset variable truth table */ #define VAR_SSET_TAB "sset_var_tab" /**< sideset variable truth table */ #define VAR_FSET_TAB "fset_var_tab" /**< faceset variable truth table */ #define VAR_ESET_TAB "eset_var_tab" /**< edgeset variable truth table */ #define VAR_NSET_TAB "nset_var_tab" /**< nodeset variable truth table */ #define DIM_NUM_GLO_VAR "num_glo_var" /**< number of global variables */ #define VAR_NAME_GLO_VAR "name_glo_var" /**< names of global variables */ #define VAR_GLO_VAR "vals_glo_var" /**< values of global variables*/ #define DIM_NUM_NOD_VAR "num_nod_var" /**< number of nodal variables */ #define VAR_NAME_NOD_VAR "name_nod_var" /**< names of nodal variables */ #define VAR_NOD_VAR "vals_nod_var" /**< values of nodal variables \deprecated */ /*! values of nodal variables */ #define VAR_NOD_VAR_NEW(num) ex__catstr("vals_nod_var", num) #define DIM_NUM_ASSEMBLY_VAR "num_assembly_var" /**< number of assembly variables */ #define VAR_NAME_ASSEMBLY_VAR "name_assembly_var" /**< names of assembly variables*/ #define VAR_ASSEMBLY_VAR(num1, num2) ex__catstr2("vals_assembly_var", num1, "assembly", num2) #define DIM_NUM_BLOB_VAR "num_blob_var" /**< number of blob variables */ #define VAR_NAME_BLOB_VAR "name_blob_var" /**< names of blob variables*/ #define VAR_BLOB_VAR(num1, num2) ex__catstr2("vals_blob_var", num1, "blob", num2) #define DIM_NUM_ELE_VAR "num_elem_var" /**< number of element variables */ #define VAR_NAME_ELE_VAR "name_elem_var" /**< names of element variables*/ /*! values of element variable num1 in element block num2 */ #define VAR_ELEM_VAR(num1, num2) ex__catstr2("vals_elem_var", num1, "eb", num2) #define DIM_NUM_EDG_VAR "num_edge_var" /**< number of edge variables */ #define VAR_NAME_EDG_VAR "name_edge_var" /**< names of edge variables */ /*! values of edge variable num1 in edge block num2 */ #define VAR_EDGE_VAR(num1, num2) ex__catstr2("vals_edge_var", num1, "eb", num2) #define DIM_NUM_FAC_VAR "num_face_var" /**< number of face variables */ #define VAR_NAME_FAC_VAR "name_face_var" /**< names of face variables */ /*! values of face variable num1 in face block num2 */ #define VAR_FACE_VAR(num1, num2) ex__catstr2("vals_face_var", num1, "fb", num2) #define DIM_NUM_NSET_VAR "num_nset_var" /**< number of nodeset variables */ #define VAR_NAME_NSET_VAR "name_nset_var" /**< names of nodeset variables*/ /*! values of nodeset variable num1 in nodeset num2 */ #define VAR_NS_VAR(num1, num2) ex__catstr2("vals_nset_var", num1, "ns", num2) #define DIM_NUM_ESET_VAR "num_eset_var" /**< number of edgeset variables */ /*! values of edgeset variable num1 in edgeset num2 */ #define VAR_NAME_ESET_VAR "name_eset_var" /**< names of edgeset variables*/ #define VAR_ES_VAR(num1, num2) ex__catstr2("vals_eset_var", num1, "es", num2) #define DIM_NUM_FSET_VAR "num_fset_var" /**< number of faceset variables */ #define VAR_NAME_FSET_VAR "name_fset_var" /**< names of faceset variables*/ /*! values of faceset variable num1 in faceset num2 */ #define VAR_FS_VAR(num1, num2) ex__catstr2("vals_fset_var", num1, "fs", num2) #define DIM_NUM_SSET_VAR "num_sset_var" /**< number of sideset variables */ #define VAR_NAME_SSET_VAR "name_sset_var" /**< names of sideset variables*/ /*! values of sideset variable num1 in sideset num2 */ #define VAR_SS_VAR(num1, num2) ex__catstr2("vals_sset_var", num1, "ss", num2) #define DIM_NUM_ELSET_VAR "num_elset_var" /**< number of element set variables*/ #define VAR_NAME_ELSET_VAR "name_elset_var" /**< names of elemset variables*/ /*! values of elemset variable num1 in elemset num2 */ #define VAR_ELS_VAR(num1, num2) ex__catstr2("vals_elset_var", num1, "es", num2) /** * \defgroup ReductionVariables Variables controlling storage of reduction variables *@{ */ #define DIM_NUM_ASSEMBLY_RED_VAR "num_assembly_red_var" /**< number of assembly variables */ #define VAR_NAME_ASSEMBLY_RED_VAR "name_assembly_red_var" /**< names of assembly variables*/ #define VAR_ASSEMBLY_RED_VAR(num) ex__catstr("vals_red_var_assembly", num) #define DIM_NUM_BLOB_RED_VAR "num_blob_red_var" /**< number of blob variables */ #define VAR_NAME_BLOB_RED_VAR "name_blob_red_var" /**< names of blob variables*/ #define VAR_BLOB_RED_VAR(num) ex__catstr("vals_red_var_blob", num) #define DIM_NUM_ELE_RED_VAR "num_elem_red_var" /**< number of element variables */ #define VAR_NAME_ELE_RED_VAR "name_elem_red_var" /**< names of element variables*/ /*! values of element variable num in element block num */ #define VAR_ELEM_RED_VAR(num) ex__catstr("vals_red_var_eb", num) #define DIM_NUM_EDG_RED_VAR "num_edge_red_var" /**< number of edge variables */ #define VAR_NAME_EDG_RED_VAR "name_edge_red_var" /**< names of edge variables */ /*! values of edge variable num in edge block num */ #define VAR_EDGE_RED_VAR(num) ex__catstr("vals_red_var_edb", num) #define DIM_NUM_FAC_RED_VAR "num_face_red_var" /**< number of face variables */ #define VAR_NAME_FAC_RED_VAR "name_face_red_var" /**< names of face variables */ /*! values of face variable num in face block num */ #define VAR_FACE_RED_VAR(num) ex__catstr("vals_red_var_fb", num) #define DIM_NUM_NSET_RED_VAR "num_nset_red_var" /**< number of nodeset variables */ #define VAR_NAME_NSET_RED_VAR "name_nset_red_var" /**< names of nodeset variables*/ /*! values of nodeset variable num in nodeset num */ #define VAR_NS_RED_VAR(num) ex__catstr("vals_red_var_nset", num) #define DIM_NUM_ESET_RED_VAR "num_eset_red_var" /**< number of edgeset variables */ /*! values of edgeset variable num in edgeset num */ #define VAR_NAME_ESET_RED_VAR "name_eset_red_var" /**< names of edgeset variables*/ #define VAR_ES_RED_VAR(num) ex__catstr("vals_red_var_eset", num) #define DIM_NUM_FSET_RED_VAR "num_fset_red_var" /**< number of faceset variables */ #define VAR_NAME_FSET_RED_VAR "name_fset_red_var" /**< names of faceset variables*/ /*! values of faceset variable num in faceset num */ #define VAR_FS_RED_VAR(num) ex__catstr("vals_red_var_fset", num) #define DIM_NUM_SSET_RED_VAR "num_sset_red_var" /**< number of sideset variables */ #define VAR_NAME_SSET_RED_VAR "name_sset_red_var" /**< names of sideset variables*/ /*! values of sideset variable num in sideset num */ #define VAR_SS_RED_VAR(num) ex__catstr("vals_red_var_sset", num) #define DIM_NUM_ELSET_RED_VAR "num_elset_red_var" /**< number of element set variables*/ #define VAR_NAME_ELSET_RED_VAR "name_elset_red_var" /**< names of elemset variables*/ /*! values of elemset variable num in elemset num */ #define VAR_ELS_RED_VAR(num) ex__catstr("vals_red_var_elset", num) /** @}*/ /*! general dimension of length MAX_STR_LENGTH used for some string lengths */ #define DIM_STR "len_string" /*! general dimension of length MAX_NAME_LENGTH used for name lengths */ #define DIM_STR_NAME "len_name" /*! general dimension of length MAX_LINE_LENGTH used for long strings */ #define DIM_LIN "len_line" #define DIM_N4 "four" #define DIM_N1 "blob_entity" /*! unlimited (expandable) dimension for time steps*/ #define DIM_TIME "time_step" #define VAR_ELEM_NUM_MAP "elem_num_map" /**< element numbering map */ #define VAR_FACE_NUM_MAP "face_num_map" /**< face numbering map */ #define VAR_EDGE_NUM_MAP "edge_num_map" /**< edge numbering map */ #define VAR_NODE_NUM_MAP "node_num_map" /**< node numbering map */ #define DIM_NUM_EM "num_elem_maps" /**< number of element maps */ /*! the numth element map */ #define VAR_ELEM_MAP(num) ex__catstr("elem_map", num) /*! list of the numth property for all element maps */ #define VAR_EM_PROP(num) ex__catstr("em_prop", num) #define DIM_NUM_EDM "num_edge_maps" /**< number of edge maps */ /*! the numth edge map */ #define VAR_EDGE_MAP(num) ex__catstr("edge_map", num) /* list of the numth property for all edge maps */ #define VAR_EDM_PROP(num) ex__catstr("edm_prop", num) #define DIM_NUM_FAM "num_face_maps" /**< number of face maps */ /*! the numth face map */ #define VAR_FACE_MAP(num) ex__catstr("face_map", num) /*! list of the numth property for all face maps */ #define VAR_FAM_PROP(num) ex__catstr("fam_prop", num) #define DIM_NUM_NM "num_node_maps" /**< number of node maps */ /*! the numth node map */ #define VAR_NODE_MAP(num) ex__catstr("node_map", num) /*! list of the numth property for all node maps */ #define VAR_NM_PROP(num) ex__catstr("nm_prop", num) /*! list of the numth property for all assemblies */ #define VAR_ASSEMBLY_PROP(num) ex__catstr("assembly_prop", num) #define VAR_BLOB_PROP(num) ex__catstr("blob_prop", num) #define DIM_NUM_CFRAMES "num_cframes" #define DIM_NUM_CFRAME9 "num_cframes_9" #define VAR_FRAME_COORDS "frame_coordinates" #define VAR_FRAME_IDS "frame_ids" #define VAR_FRAME_TAGS "frame_tags" #define VAR_ELBLK_IDS_GLOBAL "el_blk_ids_global" #define VAR_ELBLK_CNT_GLOBAL "el_blk_cnt_global" #define VAR_NS_IDS_GLOBAL "ns_ids_global" #define VAR_NS_NODE_CNT_GLOBAL "ns_node_cnt_global" #define VAR_NS_DF_CNT_GLOBAL "ns_df_cnt_global" #define VAR_SS_IDS_GLOBAL "ss_ids_global" #define VAR_SS_SIDE_CNT_GLOBAL "ss_side_cnt_global" #define VAR_SS_DF_CNT_GLOBAL "ss_df_cnt_global" #define VAR_FILE_TYPE "nem_ftype" #define VAR_COMM_MAP "comm_map" #define VAR_NODE_MAP_INT "node_mapi" #define VAR_NODE_MAP_INT_IDX "node_mapi_idx" #define VAR_NODE_MAP_BOR "node_mapb" #define VAR_NODE_MAP_BOR_IDX "node_mapb_idx" #define VAR_NODE_MAP_EXT "node_mape" #define VAR_NODE_MAP_EXT_IDX "node_mape_idx" #define VAR_ELEM_MAP_INT "elem_mapi" #define VAR_ELEM_MAP_INT_IDX "elem_mapi_idx" #define VAR_ELEM_MAP_BOR "elem_mapb" #define VAR_ELEM_MAP_BOR_IDX "elem_mapb_idx" #define VAR_INT_N_STAT "int_n_stat" #define VAR_BOR_N_STAT "bor_n_stat" #define VAR_EXT_N_STAT "ext_n_stat" #define VAR_INT_E_STAT "int_e_stat" #define VAR_BOR_E_STAT "bor_e_stat" #define VAR_N_COMM_IDS "n_comm_ids" #define VAR_N_COMM_STAT "n_comm_stat" #define VAR_N_COMM_INFO_IDX "n_comm_info_idx" #define VAR_E_COMM_IDS "e_comm_ids" #define VAR_E_COMM_STAT "e_comm_stat" #define VAR_E_COMM_INFO_IDX "e_comm_info_idx" #define VAR_N_COMM_NIDS "n_comm_nids" #define VAR_N_COMM_PROC "n_comm_proc" #define VAR_N_COMM_DATA_IDX "n_comm_data_idx" #define VAR_E_COMM_EIDS "e_comm_eids" #define VAR_E_COMM_SIDS "e_comm_sids" #define VAR_E_COMM_PROC "e_comm_proc" #define VAR_E_COMM_DATA_IDX "e_comm_data_idx" #define DIM_NUM_INT_NODES "num_int_node" #define DIM_NUM_BOR_NODES "num_bor_node" #define DIM_NUM_EXT_NODES "num_ext_node" #define DIM_NUM_INT_ELEMS "num_int_elem" #define DIM_NUM_BOR_ELEMS "num_bor_elem" #define DIM_NUM_PROCS "num_processors" #define DIM_NUM_PROCS_F "num_procs_file" #define DIM_NUM_NODES_GLOBAL "num_nodes_global" #define DIM_NUM_ELEMS_GLOBAL "num_elems_global" #define DIM_NUM_NS_GLOBAL "num_ns_global" #define DIM_NUM_SS_GLOBAL "num_ss_global" #define DIM_NUM_ELBLK_GLOBAL "num_el_blk_global" #define DIM_NUM_N_CMAPS "num_n_cmaps" #define DIM_NUM_E_CMAPS "num_e_cmaps" #define DIM_NCNT_CMAP "ncnt_cmap" #define DIM_ECNT_CMAP "ecnt_cmap" enum ex__element_type { EX_EL_UNK = -1, /**< unknown entity */ EX_EL_NULL_ELEMENT = 0, EX_EL_TRIANGLE = 1, /**< Triangle entity */ EX_EL_QUAD = 2, /**< Quad entity */ EX_EL_HEX = 3, /**< Hex entity */ EX_EL_WEDGE = 4, /**< Wedge entity */ EX_EL_TETRA = 5, /**< Tetra entity */ EX_EL_TRUSS = 6, /**< Truss entity */ EX_EL_BEAM = 7, /**< Beam entity */ EX_EL_SHELL = 8, /**< Shell entity */ EX_EL_SPHERE = 9, /**< Sphere entity */ EX_EL_CIRCLE = 10, /**< Circle entity */ EX_EL_TRISHELL = 11, /**< Triangular Shell entity */ EX_EL_PYRAMID = 12 /**< Pyramid entity */ }; typedef enum ex__element_type ex__element_type; /* Internal structure declarations */ struct ex__file_item { int file_id; nc_type netcdf_type_code; int int64_status; int maximum_name_length; int time_varid; /* Store to avoid lookup each timestep */ unsigned int assembly_count; unsigned int blob_count; unsigned int compression_algorithm : 2; /**< GZIP/ZLIB, SZIP, more may be supported by NetCDF soon */ unsigned int compression_level : 6; /**< 0 (disabled) to 9 (maximum) compression level for gzip, 4..32 and even for szip; NetCDF-4 only */ unsigned int user_compute_wordsize : 1; /**< 0 for 4 byte or 1 for 8 byte reals */ unsigned int shuffle : 1; /**< 1 true, 0 false */ unsigned int file_type : 2; /**< 0 - classic, 1 -- 64 bit classic, 2 --NetCDF4, 3 --NetCDF4 classic */ unsigned int is_write : 1; /**< for output or append */ unsigned int is_parallel : 1; /**< 1 true, 0 false */ unsigned int is_hdf5 : 1; /**< 1 true, 0 false */ unsigned int is_pnetcdf : 1; /**< 1 true, 0 false */ unsigned int has_nodes : 1; /**< for input only at this time */ unsigned int has_edges : 1; /**< for input only at this time */ unsigned int has_faces : 1; /**< for input only at this time */ unsigned int has_elems : 1; /**< for input only at this time */ struct ex__file_item *next; }; struct ex__elem_blk_parm { char elem_type[33]; int64_t elem_blk_id; int64_t num_elem_in_blk; int num_nodes_per_elem; int num_sides; int num_nodes_per_side[6]; int num_attr; int64_t elem_ctr; ex__element_type elem_type_val; }; /* Used in exo_jack.c for fortran interface */ enum ex__coordinate_frame_type { EX_CF_RECTANGULAR = 1, EX_CF_CYLINDRICAL = 2, EX_CF_SPHERICAL = 3 }; typedef enum ex__coordinate_frame_type ex__coordinate_frame_type; struct ex__list_item { /* for use with ex_get_file_item */ int exo_id; int value; struct ex__list_item *next; }; struct ex__obj_stats { int64_t *id_vals; int *stat_vals; size_t num; int exoid; char valid_ids; char valid_stat; char sequential; struct ex__obj_stats *next; }; #ifndef EXODUS_EXPORT #define EXODUS_EXPORT extern #endif /* EXODUS_EXPORT */ EXODUS_EXPORT void ex__iqsort(int v[], int iv[], size_t N); EXODUS_EXPORT void ex__iqsort64(int64_t v[], int64_t iv[], int64_t N); EXODUS_EXPORT char *ex__catstr(const char * /*string*/, int /*num*/); EXODUS_EXPORT char *ex__catstr2(const char * /*string1*/, int /*num1*/, const char * /*string2*/, int /*num2*/); EXODUS_EXPORT char *ex__dim_num_entries_in_object(ex_entity_type /*obj_type*/, int /*idx*/); EXODUS_EXPORT char *ex__dim_num_objects(ex_entity_type obj_type); EXODUS_EXPORT char *ex__name_var_of_object(ex_entity_type /*obj_type*/, int /*i*/, int /*j*/); EXODUS_EXPORT char *ex__name_red_var_of_object(ex_entity_type /*obj_type*/, int /*indx*/); EXODUS_EXPORT char *ex__name_of_map(ex_entity_type /*map_type*/, int /*map_index*/); EXODUS_EXPORT int ex__conv_init(int exoid, int *comp_wordsize, int *io_wordsize, int file_wordsize, int int64_status, bool is_parallel, bool is_hdf5, bool is_pnetcdf, bool is_write); EXODUS_EXPORT void ex__conv_exit(int exoid); EXODUS_EXPORT nc_type nc_flt_code(int exoid); EXODUS_EXPORT int ex__comp_ws(int exoid); EXODUS_EXPORT int ex__get_cpu_ws(void); EXODUS_EXPORT int ex__is_parallel(int exoid); EXODUS_EXPORT struct ex__list_item **ex__get_counter_list(ex_entity_type obj_type); EXODUS_EXPORT int ex__get_file_item(int /*exoid*/, struct ex__list_item **/*list_ptr*/); EXODUS_EXPORT int ex__inc_file_item(int /*exoid*/, struct ex__list_item **/*list_ptr*/); EXODUS_EXPORT void ex__rm_file_item(int /*exoid*/, struct ex__list_item ** /*list_ptr*/); extern struct ex__obj_stats *exoII_eb; extern struct ex__obj_stats *exoII_ed; extern struct ex__obj_stats *exoII_fa; extern struct ex__obj_stats *exoII_ns; extern struct ex__obj_stats *exoII_es; extern struct ex__obj_stats *exoII_fs; extern struct ex__obj_stats *exoII_ss; extern struct ex__obj_stats *exoII_els; extern struct ex__obj_stats *exoII_em; extern struct ex__obj_stats *exoII_edm; extern struct ex__obj_stats *exoII_fam; extern struct ex__obj_stats *exoII_nm; struct ex__file_item *ex__find_file_item(int exoid); struct ex__file_item *ex__add_file_item(int exoid); struct ex__obj_stats *ex__get_stat_ptr(int exoid, struct ex__obj_stats **obj_ptr); EXODUS_EXPORT void ex__rm_stat_ptr(int exoid, struct ex__obj_stats **obj_ptr); EXODUS_EXPORT void ex__set_compact_storage(int exoid, int varid); EXODUS_EXPORT void ex__compress_variable(int exoid, int varid, int type); EXODUS_EXPORT int ex__id_lkup(int exoid, ex_entity_type id_type, ex_entity_id num); EXODUS_EXPORT int ex__check_valid_file_id( int exoid, const char *func); /** Return fatal error if exoid does not refer to valid file */ EXODUS_EXPORT int ex__check_multiple_open(const char *path, int mode, const char *func); EXODUS_EXPORT int ex__check_file_type(const char *path, int *type); EXODUS_EXPORT char *ex__canonicalize_filename(const char *path); EXODUS_EXPORT int ex__get_dimension(int exoid, const char *DIMENSION, const char *label, size_t *count, int *dimid, const char *routine); EXODUS_EXPORT int ex__get_nodal_var(int exoid, int time_step, int nodal_var_index, int64_t num_nodes, void *nodal_var_vals); EXODUS_EXPORT int ex__put_nodal_var(int exoid, int time_step, int nodal_var_index, int64_t num_nodes, const void *nodal_var_vals); EXODUS_EXPORT int ex__get_nodal_var_time(int exoid, int nodal_var_index, int64_t node_number, int beg_time_step, int end_time_step, void *nodal_var_vals); EXODUS_EXPORT int ex__get_partial_nodal_var(int exoid, int time_step, int nodal_var_index, int64_t start_node, int64_t num_nodes, void *var_vals); EXODUS_EXPORT int ex__put_partial_nodal_var(int exoid, int time_step, int nodal_var_index, int64_t start_node, int64_t num_nodes, const void *nodal_var_vals); EXODUS_EXPORT int ex__get_glob_vars(int exoid, int time_step, int num_glob_vars, void *glob_var_vals); EXODUS_EXPORT int ex__get_glob_var_time(int exoid, int glob_var_index, int beg_time_step, int end_time_step, void *glob_var_vals); EXODUS_EXPORT int ex__get_name(int exoid, int varid, size_t index, char *name, int name_size, ex_entity_type obj_type, const char *routine); EXODUS_EXPORT int ex__get_names(int exoid, int varid, size_t num_entity, char **names, ex_entity_type obj_type, const char *routine); EXODUS_EXPORT int ex__put_name(int exoid, int varid, size_t index, const char *name, ex_entity_type obj_type, const char *subtype, const char *routine); EXODUS_EXPORT int ex__put_names(int exoid, int varid, size_t num_entity, char *const *names, ex_entity_type obj_type, const char *subtype, const char *routine); EXODUS_EXPORT void ex__trim(char *name); EXODUS_EXPORT void ex__update_max_name_length(int exoid, int length); EXODUS_EXPORT int ex__leavedef(int exoid, /* NemesisI file ID */ const char *call_rout /* Name of calling function */ ); EXODUS_EXPORT int ex__check_version(int run_version); EXODUS_EXPORT int ex__handle_mode(unsigned int my_mode, int is_parallel, int run_version); EXODUS_EXPORT int ex__populate_header(int exoid, const char *path, int my_mode, int is_parallel, int *comp_ws, int *io_ws); EXODUS_EXPORT int ex__get_block_param(int exoid, ex_entity_id id, int ndim, struct ex__elem_blk_parm *elem_blk_parm); EXODUS_EXPORT int ex__get_file_type(int exoid, char *ftype); EXODUS_EXPORT int ex__put_nemesis_version(int exoid); EXODUS_EXPORT int ex__put_homogenous_block_params(int exoid, size_t block_count, const struct ex_block *blocks); EXODUS_EXPORT int ne__check_file_version(int exoid); EXODUS_EXPORT int ne__id_lkup(int exoid, /* NetCDF/Exodus file ID */ const char *ne_var_name, /* Nemesis variable name */ int64_t *idx, /* index variable for variable, length 2 */ ex_entity_id ne_var_id /* NetCDF variable ID */ ); /** * For output databases, the maximum length of any entity, variable, * property, attribute, or coordinate name to be written (not * including the NULL terminator). If a name is longer than this * value, a warning message will be output to stderr and the name * will be truncated. Must be set (via call to * ex_set_max_name_length()(exoid, int len) prior to calling ex_create(). * * For input databases, the size of the name arrays that the client * code will be passing to API routines that retrieve names (not * including the NULL terminator). This defaults to 32 for * compatibility with older clients. The value used at the time of * creation of the database can be queried by ex_inquire with the * #EX_INQ_DB_MAX_ALLOWED_NAME_LENGTH argument. The current value for this * variable can be queried with #EX_INQ_MAX_READ_NAME_LENGTH argument. * * Note that this is a global setting for all databases. If you are * accessing multiple databases, they will all use the same value. */ EXODUS_EXPORT int ex__default_max_name_length; /*! @} */ #ifdef __cplusplus } #endif