Exodus 7.10

Data Structures | Macros | Typedefs | Enumerations | Functions | Variables
exodusII.h File Reference
`#include "exodus_config.h"`
`#include "netcdf.h"`
`#include <stddef.h>`
`#include <stdint.h>`
`#include <stdlib.h>`

Go to the source code of this file.

## Data Structures
struct | ex_init_params
struct | ex_block
struct | ex_set
struct | ex_block_params
struct | ex_set_specs
struct | ex_var_params

## Macros
#define | EX_API_VERS 7.21f
#define | EX_API_VERS_NODOT 721
#define | EX_VERS EX_API_VERS
#define | NEMESIS_API_VERSION EX_API_VERS
#define | NEMESIS_API_VERSION_NODOT EX_API_VERS_NODOT
#define | NEMESIS_FILE_VERSION 2.6
#define | EX_TRUE -1
#define | EX_FALSE 0
#define | EX_WRITE 0x0001
#define | EX_READ 0x0002
#define | EX_NOCLOBBER 0x0004
#define | EX_CLOBBER 0x0008
#define | EX_NORMAL_MODEL 0x0010
#define | EX_64BIT_OFFSET 0x0020
#define | EX_LARGE_MODEL EX_64BIT_OFFSET
#define | EX_64BIT_DATA 0x400000
#define | EX_NETCDF4 0x0040
#define | EX_NOSHARE 0x0080
#define | EX_SHARE 0x0100
#define | EX_NOCLASSIC 0x0200
#define | EX_DISKLESS 0x100000
#define | EX_MMAP 0x200000
#define | EX_MAPS_INT64_DB 0x0400
#define | EX_IDS_INT64_DB 0x0800
#define | EX_BULK_INT64_DB 0x1000
#define | EX_ALL_INT64_DB (EX_MAPS_INT64_DB | EX_IDS_INT64_DB | EX_BULK_INT64_DB)
#define | EX_MAPS_INT64_API 0x2000
#define | EX_IDS_INT64_API 0x4000
#define | EX_BULK_INT64_API 0x8000
#define | EX_INQ_INT64_API 0x10000
#define | EX_ALL_INT64_API
#define | EX_MPIIO 0x20000
#define | EX_MPIPOSIX 0x40000
#define | EX_PNETCDF 0x80000
#define | EX_INVALID_ID -1
#define | MAX_STR_LENGTH 32L
#define | MAX_NAME_LENGTH MAX_STR_LENGTH
#define | MAX_LINE_LENGTH 80L
#define | MAX_ERR_LENGTH 256
#define | EXODUS_EXPORT extern
#define | ex_create(path, mode, comp_ws, io_ws) ex_create_int(path, mode, comp_ws, io_ws, EX_API_VERS_NODOT)
#define | ex_open(path, mode, comp_ws, io_ws, version) ex_open_int(path, mode, comp_ws, io_ws, version, EX_API_VERS_NODOT)
#define | SEACAS_DEPRECATED
#define | EX_MEMFAIL 1000
#define | EX_BADFILEMODE 1001
#define | EX_BADFILEID 1002
#define | EX_WRONGFILETYPE 1003
#define | EX_LOOKUPFAIL 1004
#define | EX_BADPARAM 1005
#define | EX_INTERNAL 1006
#define | EX_MSG -1000
#define | EX_PRTLASTMSG -1001
#define | EX_NOTROOTID -1002
#define | EX_LASTERR -1003
#define | EX_NULLENTITY -1006
#define | EX_DUPLICATEID -1007
#define | EX_FATAL -1 /* fatal error flag def */
#define | EX_NOERR 0 /* no error flag def */
#define | EX_WARN 1 /* warning flag def */

## Typedefs
typedef enum ex_inquiry | ex_inquiry
typedef enum ex_option_type | ex_option_type
typedef enum ex_entity_type | ex_entity_type
typedef enum ex_options | ex_options
typedef int64_t | ex_entity_id
typedef void | void_int
typedef struct ex_init_params | ex_init_params
typedef struct ex_block | ex_block
typedef struct ex_set | ex_set
typedef struct ex_block_params | ex_block_params
typedef struct ex_set_specs | ex_set_specs
typedef struct ex_var_params | ex_var_params

## Enumerations
enum | ex_inquiry { EX_INQ_FILE_TYPE = 1, EX_INQ_API_VERS = 2, EX_INQ_DB_VERS = 3, EX_INQ_TITLE = 4, EX_INQ_DIM = 5, EX_INQ_NODES = 6, EX_INQ_ELEM = 7, EX_INQ_ELEM_BLK = 8, EX_INQ_NODE_SETS = 9, EX_INQ_NS_NODE_LEN = 10, EX_INQ_SIDE_SETS = 11, EX_INQ_SS_NODE_LEN = 12, EX_INQ_SS_ELEM_LEN = 13, EX_INQ_QA = 14, EX_INQ_INFO = 15, EX_INQ_TIME = 16, EX_INQ_EB_PROP = 17, EX_INQ_NS_PROP = 18, EX_INQ_SS_PROP = 19, EX_INQ_NS_DF_LEN = 20, EX_INQ_SS_DF_LEN = 21, EX_INQ_LIB_VERS = 22, EX_INQ_EM_PROP = 23, EX_INQ_NM_PROP = 24, EX_INQ_ELEM_MAP = 25, EX_INQ_NODE_MAP = 26, EX_INQ_EDGE = 27, EX_INQ_EDGE_BLK = 28, EX_INQ_EDGE_SETS = 29, EX_INQ_ES_LEN = 30, EX_INQ_ES_DF_LEN = 31, EX_INQ_EDGE_PROP = 32, EX_INQ_ES_PROP = 33, EX_INQ_FACE = 34, EX_INQ_FACE_BLK = 35, EX_INQ_FACE_SETS = 36, EX_INQ_FS_LEN = 37, EX_INQ_FS_DF_LEN = 38, EX_INQ_FACE_PROP = 39, EX_INQ_FS_PROP = 40, EX_INQ_ELEM_SETS = 41, EX_INQ_ELS_LEN = 42, EX_INQ_ELS_DF_LEN = 43, EX_INQ_ELS_PROP = 44, EX_INQ_EDGE_MAP = 45, EX_INQ_FACE_MAP = 46, EX_INQ_COORD_FRAMES = 47, EX_INQ_DB_MAX_ALLOWED_NAME_LENGTH, EX_INQ_DB_MAX_USED_NAME_LENGTH = 49, EX_INQ_MAX_READ_NAME_LENGTH = 50, EX_INQ_DB_FLOAT_SIZE = 51, EX_INQ_NUM_CHILD_GROUPS = 52, EX_INQ_GROUP_PARENT, EX_INQ_GROUP_ROOT, EX_INQ_GROUP_NAME_LEN = 55, EX_INQ_GROUP_NAME = 56, EX_INQ_FULL_GROUP_NAME_LEN = 57, EX_INQ_FULL_GROUP_NAME = 58, EX_INQ_THREADSAFE = 59, EX_INQ_INVALID = -1 }
enum | ex_option_type { EX_OPT_MAX_NAME_LENGTH, EX_OPT_COMPRESSION_TYPE, EX_OPT_COMPRESSION_LEVEL, EX_OPT_COMPRESSION_SHUFFLE, EX_OPT_INTEGER_SIZE_API, EX_OPT_INTEGER_SIZE_DB }
enum | ex_entity_type { EX_NODAL = 14, EX_NODE_BLOCK = 14, EX_NODE_SET = 2, EX_EDGE_BLOCK = 6, EX_EDGE_SET = 7, EX_FACE_BLOCK = 8, EX_FACE_SET = 9, EX_ELEM_BLOCK = 1, EX_ELEM_SET = 10, EX_SIDE_SET = 3, EX_ELEM_MAP = 4, EX_NODE_MAP = 5, EX_EDGE_MAP = 11, EX_FACE_MAP = 12, EX_GLOBAL = 13, EX_COORDINATE = 15, EX_INVALID = -1 }
enum | ex_options { EX_DEFAULT = 0, EX_VERBOSE = 1, EX_DEBUG = 2, EX_ABORT = 4, EX_NULLVERBOSE = 8 }

## Functions
int | ex_close (int exoid)
int | ex_copy (int in_exoid, int out_exoid)
int | ex_copy_transient (int in_exoid, int out_exoid)
int | ex_create_int (const char *path, int cmode, int *comp_ws, int *io_ws, int run_version)
int | ex_create_group (int parent_id, const char *group_name)
int | ex_get_group_id (int parent_id, const char *group_name, int *group_id)
int | ex_get_group_ids (int parent_id, int *num_groups, int *group_ids)
int | ex_get_all_times (int exoid, void *time_values)
int | ex_get_coord_names (int exoid, char **coord_names)
int | ex_get_coord (int exoid, void *x_coor, void *y_coor, void *z_coor)
int | ex_get_partial_coord_component (int exoid, int64_t start_node_num, int64_t num_nodes, int component, void *coor)
int | ex_get_partial_coord (int exoid, int64_t start_node_num, int64_t num_nodes, void *x_coor, void *y_coor, void *z_coor)
int | ex_get_ids (int exoid, ex_entity_type obj_type, void_int *ids)
int | ex_get_coordinate_frames (int exoid, int *nframes, void_int *cf_ids, void *pt_coordinates, char *tags)
int | ex_get_info (int exoid, char **info)
int | ex_put_init_ext (int exoid, const ex_init_params *model)
int | ex_get_init_ext (int exoid, ex_init_params *info)
int | ex_get_init (int exoid, char *title, void_int *num_dim, void_int *num_nodes, void_int *num_elem, void_int *num_elem_blk, void_int *num_node_sets, void_int *num_side_sets)
int | ex_put_init (int exoid, const char *title, int64_t num_dim, int64_t num_nodes, int64_t num_elem, int64_t num_elem_blk, int64_t num_node_sets, int64_t num_side_sets)
int | ex_get_map (int exoid, void_int *elem_map)
int | ex_get_map_param (int exoid, int *num_node_maps, int *num_elem_maps)
int | ex_get_name (int exoid, ex_entity_type obj_type, ex_entity_id entity_id, char *name)
int | ex_get_names (int exoid, ex_entity_type obj_type, char **names)
int | ex_get_prop_array (int exoid, ex_entity_type obj_type, const char *prop_name, void_int *values)
int | ex_get_prop (int exoid, ex_entity_type obj_type, ex_entity_id obj_id, const char *prop_name, void_int *value)
int | ex_get_partial_num_map (int exoid, ex_entity_type map_type, ex_entity_id map_id, int64_t ent_start, int64_t ent_count, void_int *map)
int | ex_get_prop_names (int exoid, ex_entity_type obj_type, char **prop_names)
int | ex_get_qa (int exoid, char *qa_record[][4])
int | ex_get_time (int exoid, int time_step, void *time_value)
int | ex_get_variable_names (int exoid, ex_entity_type obj_type, int num_vars, char *var_names[])
int | ex_get_variable_name (int exoid, ex_entity_type obj_type, int var_num, char *var_name)
int | ex_get_variable_param (int exoid, ex_entity_type obj_type, int *num_vars)
int | ex_get_object_truth_vector (int exoid, ex_entity_type obj_type, ex_entity_id entity_id, int num_var, int *var_vec)
int | ex_get_truth_table (int exoid, ex_entity_type obj_type, int num_blk, int num_var, int *var_tab)
int | ex_open_int (const char *path, int mode, int *comp_ws, int *io_ws, float *version, int run_version)
int | ex_add_attr (int exoid, ex_entity_type obj_type, ex_entity_id obj_id, int64_t num_attr_per_entry)
int | ex_put_attr_param (int exoid, ex_entity_type obj_type, ex_entity_id obj_id, int num_attrs)
int | ex_get_attr_param (int exoid, ex_entity_type obj_type, ex_entity_id obj_id, int *num_attrs)
int | ex_put_all_var_param (int exoid, int num_g, int num_n, int num_e, int *elem_var_tab, int num_m, int *nset_var_tab, int num_s, int *sset_var_tab)
int | ex_put_concat_elem_block (int exoid, const void_int *elem_blk_id, char *elem_type[], const void_int *num_elem_this_blk, const void_int *num_nodes_per_elem, const void_int *num_attr_this_blk, int define_maps)
int | ex_put_coord_names (int exoid, char *coord_names[])
int | ex_put_coord (int exoid, const void *x_coor, const void *y_coor, const void *z_coor)
int | ex_put_partial_coord_component (int exoid, int64_t start_node_num, int64_t num_nodes, int component, const void *coor)
int | ex_put_partial_coord (int exoid, int64_t start_node_num, int64_t num_nodes, const void *x_coor, const void *y_coor, const void *z_coor)
int | ex_put_map (int exoid, const void_int *elem_map)
int | ex_put_id_map (int exoid, ex_entity_type map_type, const void_int *map)
int | ex_put_partial_id_map (int exoid, ex_entity_type map_type, int64_t start_entity_num, int64_t num_entities, const void_int *map)
int | ex_get_id_map (int exoid, ex_entity_type map_type, void_int *map)
int | ex_get_partial_id_map (int exoid, ex_entity_type map_type, int64_t start_entity_num, int64_t num_entities, void_int *map)
int | ex_put_coordinate_frames (int exoid, int nframes, const void_int *cf_ids, void *pt_coordinates, const char *tags)
int | ex_put_info (int exoid, int num_info, char *info[])
int | ex_put_map_param (int exoid, int num_node_maps, int num_elem_maps)
int | ex_put_name (int exoid, ex_entity_type obj_type, ex_entity_id entity_id, const char *name)
int | ex_put_names (int exoid, ex_entity_type obj_type, char *names[])
int | ex_put_partial_one_attr (int exoid, ex_entity_type obj_type, ex_entity_id obj_id, int64_t start_num, int64_t num_ent, int attrib_index, const void *attrib)
int | ex_put_prop (int exoid, ex_entity_type obj_type, ex_entity_id obj_id, const char *prop_name, ex_entity_id value)
int | ex_put_prop_array (int exoid, ex_entity_type obj_type, const char *prop_name, const void_int *values)
int | ex_put_prop_names (int exoid, ex_entity_type obj_type, int num_props, char **prop_names)
int | ex_put_qa (int exoid, int num_qa_records, char *qa_record[][4])
int | ex_put_time (int exoid, int time_step, const void *time_value)
int | ex_put_variable_name (int exoid, ex_entity_type obj_type, int var_num, const char *var_name)
int | ex_put_variable_names (int exoid, ex_entity_type obj_type, int num_vars, char *var_names[])
int | ex_put_variable_param (int exoid, ex_entity_type obj_type, int num_vars)
int | ex_put_truth_table (int exoid, ex_entity_type obj_type, int num_blk, int num_var, int *var_tab)
int | ex_update (int exoid)
int | ex_get_num_props (int exoid, ex_entity_type obj_type)
int | ex_large_model (int exoid)
size_t | ex_header_size (int exoid)
void | ex_err (const char *module_name, const char *message, int err_num)
void | ex_err_fn (int exoid, const char *module_name, const char *message, int err_num)
void | ex_set_err (const char *module_name, const char *message, int err_num)
const char * | ex_strerror (int err_num)
void | ex_get_err (const char **msg, const char **func, int *err_num)
int | ex_opts (int options)
int | ex_inquire (int exoid, int req_info, void_int *, float *, char *)
int64_t | ex_inquire_int (int exoid, int req_info)
int | ex_int64_status (int exoid)
int | ex_set_int64_status (int exoid, int mode)
void | ex_print_config (void)
int | ex_set_max_name_length (int exoid, int length)
int | ex_set_option (int exoid, ex_option_type option, int option_value)
int | ex_put_num_map (int exoid, ex_entity_type map_type, ex_entity_id map_id, const void_int *map)
int | ex_get_num_map (int exoid, ex_entity_type map_type, ex_entity_id map_id, void_int *map)
int | ex_put_block (int exoid, ex_entity_type blk_type, ex_entity_id blk_id, const char *entry_descrip, int64_t num_entries_this_blk, int64_t num_nodes_per_entry, int64_t num_edges_per_entry, int64_t num_faces_per_entry, int64_t num_attr_per_entry)
int | ex_get_block (int exoid, ex_entity_type blk_type, ex_entity_id blk_id, char *elem_type, void_int *num_entries_this_blk, void_int *num_nodes_per_entry, void_int *num_edges_per_entry, void_int *num_faces_per_entry, void_int *num_attr_per_entry)
int | ex_get_block_param (int exoid, ex_block *block)
int | ex_put_block_param (int exoid, ex_block block)
int | ex_get_block_params (int exoid, size_t block_count, struct ex_block **blocks)
int | ex_put_block_params (int exoid, size_t block_count, const struct ex_block *blocks)
int | ex_put_concat_all_blocks (int exoid, const ex_block_params *param)
int | ex_put_entity_count_per_polyhedra (int exoid, ex_entity_type blk_type, ex_entity_id blk_id, const int *entity_counts)
int | ex_get_entity_count_per_polyhedra (int exoid, ex_entity_type blk_type, ex_entity_id blk_id, int *entity_counts)
int | ex_put_conn (int exoid, ex_entity_type blk_type, ex_entity_id blk_id, const void_int *node_conn, const void_int *elem_edge_conn, const void_int *elem_face_conn)
int | ex_get_conn (int exoid, ex_entity_type blk_type, ex_entity_id blk_id, void_int *nodeconn, void_int *edgeconn, void_int *faceconn)
int | ex_get_partial_conn (int exoid, ex_entity_type blk_type, ex_entity_id blk_id, int64_t start_num, int64_t num_ent, void_int *nodeconn, void_int *edgeconn, void_int *faceconn)
int | ex_put_partial_conn (int exoid, ex_entity_type blk_type, ex_entity_id blk_id, int64_t start_num, int64_t num_ent, const void_int *nodeconn, const void_int *edgeconn, const void_int *faceconn)
int | ex_put_attr (int exoid, ex_entity_type blk_type, ex_entity_id blk_id, const void *attrib)
int | ex_put_partial_attr (int exoid, ex_entity_type blk_type, ex_entity_id blk_id, int64_t start_entity, int64_t num_entity, const void *attrib)
int | ex_get_attr (int exoid, ex_entity_type obj_type, ex_entity_id obj_id, void *attrib)
int | ex_get_partial_attr (int exoid, ex_entity_type obj_type, ex_entity_id obj_id, int64_t start_num, int64_t num_ent, void *attrib)
int | ex_put_one_attr (int exoid, ex_entity_type obj_type, ex_entity_id obj_id, int attrib_index, const void *attrib)
int | ex_get_one_attr (int exoid, ex_entity_type obj_type, ex_entity_id obj_id, int attrib_index, void *attrib)
int | ex_get_partial_one_attr (int exoid, ex_entity_type obj_type, ex_entity_id obj_id, int64_t start_num, int64_t num_ent, int attrib_index, void *attrib)
int | ex_put_attr_names (int exoid, ex_entity_type blk_type, ex_entity_id blk_id, char **names)
int | ex_get_attr_names (int exoid, ex_entity_type obj_type, ex_entity_id obj_id, char **names)
int | ex_put_set_param (int exoid, ex_entity_type set_type, ex_entity_id set_id, int64_t num_entries_in_set, int64_t num_dist_fact_in_set)
int | ex_get_set_param (int exoid, ex_entity_type set_type, ex_entity_id set_id, void_int *num_entry_in_set, void_int *num_dist_fact_in_set)
int | ex_put_set (int exoid, ex_entity_type set_type, ex_entity_id set_id, const void_int *set_entry_list, const void_int *set_extra_list)
int | ex_get_partial_set (int exoid, ex_entity_type set_type, ex_entity_id set_id, int64_t offset, int64_t num_to_get, void_int *set_entry_list, void_int *set_extra_list)
int | ex_put_partial_set (int exoid, ex_entity_type set_type, ex_entity_id set_id, int64_t offset, int64_t num_to_put, const void_int *set_entry_list, const void_int *set_extra_list)
int | ex_get_set (int exoid, ex_entity_type set_type, ex_entity_id set_id, void_int *set_entry_list, void_int *set_extra_list)
int | ex_put_set_dist_fact (int exoid, ex_entity_type set_type, ex_entity_id set_id, const void *set_dist_fact)
int | ex_get_set_dist_fact (int exoid, ex_entity_type set_type, ex_entity_id set_id, void *set_dist_fact)
int | ex_get_partial_set_dist_fact (int exoid, ex_entity_type set_type, ex_entity_id set_id, int64_t offset, int64_t num_to_put, void *set_dist_fact)
int | ex_put_concat_sets (int exoid, ex_entity_type set_type, const struct ex_set_specs *set_specs)
int | ex_get_concat_sets (int exoid, ex_entity_type set_type, struct ex_set_specs *set_specs)
int | ex_put_sets (int exoid, size_t set_count, const struct ex_set *sets)
int | ex_get_sets (int exoid, size_t set_count, struct ex_set *sets)
int | ex_put_all_var_param_ext (int exoid, const ex_var_params *vp)
int | ex_put_var (int exoid, int time_step, ex_entity_type var_type, int var_index, ex_entity_id obj_id, int64_t num_entries_this_obj, const void *var_vals)
int | ex_put_partial_var (int exoid, int time_step, ex_entity_type var_type, int var_index, ex_entity_id obj_id, int64_t start_index, int64_t num_entities, const void *var_vals)
int | ex_get_var (int exoid, int time_step, ex_entity_type var_type, int var_index, ex_entity_id obj_id, int64_t num_entry_this_obj, void *var_vals)
int | ex_get_partial_var (int exoid, int time_step, ex_entity_type var_type, int var_index, ex_entity_id obj_id, int64_t start_index, int64_t num_entities, void *var_vals)
int | ex_get_var_time (int exoid, ex_entity_type var_type, int var_index, int64_t id, int beg_time_step, int end_time_step, void *var_vals)
int | ex_cvt_nodes_to_sides (int exoid, void_int *num_elem_per_set, void_int *num_nodes_per_set, void_int *side_sets_elem_index, void_int *side_sets_node_index, void_int *side_sets_elem_list, void_int *side_sets_node_list, void_int *side_sets_side_list)
int | ex_put_partial_num_map (int exoid, ex_entity_type map_type, ex_entity_id map_id, int64_t ent_start, int64_t ent_count, const void_int *map)
int | ex_put_partial_set_dist_fact (int exoid, ex_entity_type set_type, ex_entity_id set_id, int64_t offset, int64_t num_to_put, const void *set_dist_fact)
int | ex_get_concat_side_set_node_count (int exoid, int *side_set_node_cnt_list)
int | ex_get_side_set_node_list_len (int exoid, ex_entity_id side_set_id, void_int *side_set_node_list_len)
int | ex_get_side_set_node_count (int exoid, ex_entity_id side_set_id, int *side_set_node_cnt_list)
int | ex_get_side_set_node_list (int exoid, ex_entity_id side_set_id, void_int *side_set_node_cnt_list, void_int *side_set_node_list)
int | ex_get_init_info (int exoid, int *num_proc, int *num_proc_in_f, char *ftype)
int | ex_put_init_info (int exoid, int num_proc, int num_proc_in_f, char *ftype)
int | ex_get_init_global (int exoid, void_int *num_nodes_g, void_int *num_elems_g, void_int *num_elem_blks_g, void_int *num_node_sets_g, void_int *num_side_sets_g)
int | ex_put_init_global (int exoid, int64_t num_nodes_g, int64_t num_elems_g, int64_t num_elem_blks_g, int64_t num_node_sets_g, int64_t num_side_sets_g)
int | ex_get_loadbal_param (int exoid, void_int *num_int_nodes, void_int *num_bor_nodes, void_int *num_ext_nodes, void_int *num_int_elems, void_int *num_bor_elems, void_int *num_node_cmaps, void_int *num_elem_cmaps, int processor)
int | ex_put_loadbal_param (int exoid, int64_t num_int_nodes, int64_t num_bor_nodes, int64_t num_ext_nodes, int64_t num_int_elems, int64_t num_bor_elems, int64_t num_node_cmaps, int64_t num_elem_cmaps, int processor)
int | ex_put_loadbal_param_cc (int exoid, void_int *num_int_nodes, void_int *num_bor_nodes, void_int *num_ext_nodes, void_int *num_int_elems, void_int *num_bor_elems, void_int *num_node_cmaps, void_int *num_elem_cmaps)
int | ex_get_ns_param_global (int exoid, void_int *global_ids, void_int *node_cnts, void_int *df_cnts)
int | ex_put_ns_param_global (int exoid, void_int *global_ids, void_int *node_cnts, void_int *df_cnts)
int | ex_get_ss_param_global (int exoid, void_int *global_ids, void_int *side_cnts, void_int *df_cnts)
int | ex_put_ss_param_global (int exoid, void_int *global_ids, void_int *side_cnts, void_int *df_cnts)
int | ex_get_eb_info_global (int exoid, void_int *el_blk_ids, void_int *el_blk_cnts)
int | ex_put_eb_info_global (int exoid, void_int *el_blk_ids, void_int *el_blk_cnts)
int | ex_get_elem_type (int exoid, ex_entity_id elem_blk_id, char *elem_type)
int | ex_get_processor_node_maps (int exoid, void_int *node_mapi, void_int *node_mapb, void_int *node_mape, int processor)
int | ex_put_processor_node_maps (int exoid, void_int *node_mapi, void_int *node_mapb, void_int *node_mape, int proc_id)
int | ex_get_processor_elem_maps (int exoid, void_int *elem_mapi, void_int *elem_mapb, int processor)
int | ex_put_processor_elem_maps (int exoid, void_int *elem_mapi, void_int *elem_mapb, int processor)
int | ex_get_cmap_params (int exoid, void_int *node_cmap_ids, void_int *node_cmap_node_cnts, void_int *elem_cmap_ids, void_int *elem_cmap_elem_cnts, int processor)
int | ex_put_cmap_params (int exoid, void_int *node_cmap_ids, void_int *node_cmap_node_cnts, void_int *elem_cmap_ids, void_int *elem_cmap_elem_cnts, int64_t processor)
int | ex_put_cmap_params_cc (int exoid, void_int *node_cmap_ids, void_int *node_cmap_node_cnts, void_int *node_proc_ptrs, void_int *elem_cmap_ids, void_int *elem_cmap_elem_cnts, void_int *elem_proc_ptrs)
int | ex_get_node_cmap (int exoid, ex_entity_id map_id, void_int *node_ids, void_int *proc_ids, int processor)
int | ex_put_node_cmap (int exoid, ex_entity_id map_id, void_int *node_ids, void_int *proc_ids, int processor)
int | ex_get_elem_cmap (int exoid, ex_entity_id map_id, void_int *elem_ids, void_int *side_ids, void_int *proc_ids, int processor)
int | ex_put_elem_cmap (int exoid, ex_entity_id map_id, void_int *elem_ids, void_int *side_ids, void_int *proc_ids, int processor)
char * | ex_copy_string (char *dest, char const *source, size_t elements)
SEACAS_DEPRECATED int | ex_get_glob_vars (int exoid, int time_step, int num_glob_vars, void *glob_var_vals)
SEACAS_DEPRECATED int | ex_get_glob_var_time (int exoid, int glob_var_index, int beg_time_step, int end_time_step, void *glob_var_vals)
SEACAS_DEPRECATED int | ex_get_concat_node_sets (int exoid, void_int *node_set_ids, void_int *num_nodes_per_set, void_int *num_df_per_set, void_int *node_sets_node_index, void_int *node_sets_df_index, void_int *node_sets_node_list, void *node_sets_dist_fact)
SEACAS_DEPRECATED int | ex_get_concat_side_sets (int exoid, void_int *side_set_ids, void_int *num_elem_per_set, void_int *num_dist_per_set, void_int *side_sets_elem_index, void_int *side_sets_dist_index, void_int *side_sets_elem_list, void_int *side_sets_side_list, void *side_sets_dist_fact)
SEACAS_DEPRECATED int | ex_get_elem_attr (int exoid, ex_entity_id elem_blk_id, void *attrib)
SEACAS_DEPRECATED int | ex_get_elem_attr_names (int exoid, ex_entity_id elem_blk_id, char **names)
SEACAS_DEPRECATED int | ex_get_elem_blk_ids (int exoid, void_int *ids)
SEACAS_DEPRECATED int | ex_get_elem_block (int exoid, ex_entity_id elem_blk_id, char *elem_type, void_int *num_elem_this_blk, void_int *num_nodes_per_elem, void_int *num_attr)
SEACAS_DEPRECATED int | ex_get_elem_conn (int exoid, ex_entity_id elem_blk_id, void_int *connect)
SEACAS_DEPRECATED int | ex_get_elem_map (int exoid, ex_entity_id map_id, void_int *elem_map)
SEACAS_DEPRECATED int | ex_get_elem_num_map (int exoid, void_int *elem_map)
SEACAS_DEPRECATED int | ex_get_nodal_var (int exoid, int time_step, int nodal_var_index, int64_t num_nodes, void *nodal_var_vals)
SEACAS_DEPRECATED int | ex_put_nodal_var (int exoid, int time_step, int nodal_var_index, int64_t num_nodes, const void *nodal_var_vals)
SEACAS_DEPRECATED 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)
SEACAS_DEPRECATED 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)
SEACAS_DEPRECATED 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)
SEACAS_DEPRECATED int | ex_get_elem_var (int exoid, int time_step, int elem_var_index, ex_entity_id elem_blk_id, int64_t num_elem_this_blk, void *elem_var_vals)
SEACAS_DEPRECATED int | ex_get_elem_var_tab (int exoid, int num_elem_blk, int num_elem_var, int *elem_var_tab)
SEACAS_DEPRECATED int | ex_get_elem_var_time (int exoid, int elem_var_index, int64_t elem_number, int beg_time_step, int end_time_step, void *elem_var_vals)
SEACAS_DEPRECATED int | ex_get_node_map (int exoid, ex_entity_id map_id, void_int *node_map)
SEACAS_DEPRECATED int | ex_get_node_num_map (int exoid, void_int *node_map)
SEACAS_DEPRECATED int | ex_get_node_set_param (int exoid, ex_entity_id node_set_id, void_int *num_nodes_in_set, void_int *num_df_in_set)
SEACAS_DEPRECATED int | ex_get_node_set (int exoid, ex_entity_id node_set_id, void_int *node_set_node_list)
SEACAS_DEPRECATED int | ex_get_node_set_dist_fact (int exoid, ex_entity_id node_set_id, void *node_set_dist_fact)
SEACAS_DEPRECATED int | ex_get_node_set_ids (int exoid, void_int *ids)
SEACAS_DEPRECATED int | ex_get_nset_var_tab (int exoid, int num_nodesets, int num_nset_var, int *nset_var_tab)
SEACAS_DEPRECATED int | ex_get_nset_var (int exoid, int time_step, int nset_var_index, ex_entity_id nset_id, int64_t num_node_this_nset, void *nset_var_vals)
SEACAS_DEPRECATED int | ex_get_one_elem_attr (int exoid, ex_entity_id elem_blk_id, int attrib_index, void *attrib)
SEACAS_DEPRECATED int | ex_get_side_set (int exoid, ex_entity_id side_set_id, void_int *side_set_elem_list, void_int *side_set_side_list)
SEACAS_DEPRECATED int | ex_get_side_set_dist_fact (int exoid, ex_entity_id side_set_id, void *side_set_dist_fact)
SEACAS_DEPRECATED int | ex_get_side_set_ids (int exoid, void_int *ids)
SEACAS_DEPRECATED int | ex_get_side_set_param (int exoid, ex_entity_id side_set_id, void_int *num_side_in_set, void_int *num_dist_fact_in_set)
SEACAS_DEPRECATED int | ex_get_sset_var (int exoid, int time_step, int sset_var_index, ex_entity_id sset_id, int64_t num_side_this_sset, void *sset_var_vals)
SEACAS_DEPRECATED int | ex_get_sset_var_tab (int exoid, int num_sidesets, int num_sset_var, int *sset_var_tab)
SEACAS_DEPRECATED int | ex_get_var_names (int exoid, const char *var_type, int num_vars, char *var_names[])
SEACAS_DEPRECATED int | ex_get_var_name (int exoid, const char *var_type, int var_num, char *var_name)
SEACAS_DEPRECATED int | ex_get_var_param (int exoid, const char *var_type, int *num_vars)
SEACAS_DEPRECATED int | ex_get_var_tab (int exoid, const char *var_type, int num_blk, int num_var, int *var_tab)
SEACAS_DEPRECATED int | ex_put_concat_node_sets (int exoid, void_int *node_set_ids, void_int *num_nodes_per_set, void_int *num_dist_per_set, void_int *node_sets_node_index, void_int *node_sets_df_index, void_int *node_sets_node_list, void *node_sets_dist_fact)
SEACAS_DEPRECATED int | ex_put_concat_side_sets (int exoid, void_int *side_set_ids, void_int *num_elem_per_set, void_int *num_dist_per_set, void_int *side_sets_elem_index, void_int *side_sets_dist_index, void_int *side_sets_elem_list, void_int *side_sets_side_list, void *side_sets_dist_fact)
SEACAS_DEPRECATED int | ex_put_concat_var_param (int exoid, int num_g, int num_n, int num_e, int num_elem_blk, int *elem_var_tab)
SEACAS_DEPRECATED int | ex_put_elem_attr_names (int exoid, ex_entity_id elem_blk_id, char *names[])
SEACAS_DEPRECATED int | ex_put_elem_attr (int exoid, ex_entity_id elem_blk_id, const void *attrib)
SEACAS_DEPRECATED int | ex_put_elem_block (int exoid, ex_entity_id elem_blk_id, const char *elem_type, int64_t num_elem_this_blk, int64_t num_nodes_per_elem, int64_t num_attr_per_elem)
SEACAS_DEPRECATED int | ex_put_elem_conn (int exoid, ex_entity_id elem_blk_id, const void_int *connect)
SEACAS_DEPRECATED int | ex_put_elem_map (int exoid, ex_entity_id map_id, const void_int *elem_map)
SEACAS_DEPRECATED int | ex_put_elem_num_map (int exoid, const void_int *elem_map)
SEACAS_DEPRECATED int | ex_put_elem_var (int exoid, int time_step, int elem_var_index, ex_entity_id elem_blk_id, int64_t num_elem_this_blk, const void *elem_var_vals)
SEACAS_DEPRECATED int | ex_put_elem_var_tab (int exoid, int num_elem_blk, int num_elem_var, int *elem_var_tab)
SEACAS_DEPRECATED int | ex_put_glob_vars (int exoid, int time_step, int num_glob_vars, const void *glob_var_vals)
SEACAS_DEPRECATED int | ex_put_node_map (int exoid, ex_entity_id map_id, const void_int *node_map)
SEACAS_DEPRECATED int | ex_put_node_num_map (int exoid, const void_int *node_map)
SEACAS_DEPRECATED int | ex_put_node_set (int exoid, ex_entity_id node_set_id, const void_int *node_set_node_list)
SEACAS_DEPRECATED int | ex_put_node_set_dist_fact (int exoid, ex_entity_id node_set_id, const void *node_set_dist_fact)
SEACAS_DEPRECATED int | ex_put_node_set_param (int exoid, ex_entity_id node_set_id, int64_t num_nodes_in_set, int64_t num_dist_in_set)
SEACAS_DEPRECATED int | ex_put_nset_var (int exoid, int time_step, int nset_var_index, ex_entity_id nset_id, int64_t num_nodes_this_nset, const void *nset_var_vals)
SEACAS_DEPRECATED int | ex_put_nset_var_tab (int exoid, int num_nset, int num_nset_var, int *nset_var_tab)
SEACAS_DEPRECATED int | ex_put_one_elem_attr (int exoid, ex_entity_id elem_blk_id, int attrib_index, const void *attrib)
SEACAS_DEPRECATED int | ex_put_side_set (int exoid, ex_entity_id side_set_id, const void_int *side_set_elem_list, const void_int *side_set_side_list)
SEACAS_DEPRECATED int | ex_put_side_set_dist_fact (int exoid, ex_entity_id side_set_id, const void *side_set_dist_fact)
SEACAS_DEPRECATED int | ex_put_side_set_param (int exoid, ex_entity_id side_set_id, int64_t num_side_in_set, int64_t num_dist_fact_in_set)
SEACAS_DEPRECATED int | ex_put_sset_var (int exoid, int time_step, int sset_var_index, ex_entity_id sset_id, int64_t num_faces_this_sset, const void *sset_var_vals)
SEACAS_DEPRECATED int | ex_put_sset_var_tab (int exoid, int num_sset, int num_sset_var, int *sset_var_tab)
SEACAS_DEPRECATED int | ex_put_var_name (int exoid, const char *var_type, int var_num, const char *var_name)
SEACAS_DEPRECATED int | ex_put_var_names (int exoid, const char *var_type, int num_vars, char *var_names[])
SEACAS_DEPRECATED int | ex_put_var_param (int exoid, const char *var_type, int num_vars)
SEACAS_DEPRECATED int | ex_put_var_tab (int exoid, const char *var_type, int num_blk, int num_var, int *var_tab)
SEACAS_DEPRECATED int | ex_get_n_coord (int exoid, int64_t start_node_num, int64_t num_nodes, void *x_coor, void *y_coor, void *z_coor)
SEACAS_DEPRECATED int | ex_get_n_nodal_var (int exoid, int time_step, int nodal_var_index, int64_t start_node, int64_t num_nodes, void *var_vals)
SEACAS_DEPRECATED int | ex_get_n_conn (int exoid, ex_entity_type blk_type, ex_entity_id blk_id, int64_t start_num, int64_t num_ent, void_int *nodeconn, void_int *edgeconn, void_int *faceconn)
SEACAS_DEPRECATED int | ex_get_n_attr (int exoid, ex_entity_type obj_type, ex_entity_id obj_id, int64_t start_num, int64_t num_ent, void *attrib)
SEACAS_DEPRECATED int | ex_get_n_one_attr (int exoid, ex_entity_type obj_type, ex_entity_id obj_id, int64_t start_num, int64_t num_ent, int attrib_index, void *attrib)
SEACAS_DEPRECATED int | ex_get_n_var (int exoid, int time_step, ex_entity_type var_type, int var_index, ex_entity_id obj_id, int64_t start_index, int64_t num_entities, void *var_vals)
SEACAS_DEPRECATED int | ex_get_n_elem_var (int exoid, int time_step, int elem_var_index, ex_entity_id elem_blk_id, int64_t num_elem_this_blk, int64_t start_elem_num, int64_t num_elem, void *elem_var_vals)
SEACAS_DEPRECATED int | ex_get_n_side_set (int exoid, ex_entity_id side_set_id, int64_t start_side_num, int64_t num_sides, void_int *side_set_elem_list, void_int *side_set_side_list)
SEACAS_DEPRECATED int | ex_put_n_side_set (int exoid, ex_entity_id side_set_id, int64_t start_side_num, int64_t num_sides, const void_int *side_set_elem_list, const void_int *side_set_side_list)
SEACAS_DEPRECATED int | ex_get_n_side_set_df (int exoid, ex_entity_id side_set_id, int64_t start_num, int64_t num_df_to_get, void *side_set_dist_fact)
SEACAS_DEPRECATED int | ex_put_n_side_set_df (int exoid, ex_entity_id side_set_id, int64_t start_num, int64_t num_df_to_get, void *side_set_dist_fact)
SEACAS_DEPRECATED int | ex_get_n_node_set (int exoid, ex_entity_id node_set_id, int64_t start_node_num, int64_t num_nodes, void_int *node_set_node_list)
SEACAS_DEPRECATED int | ex_put_n_node_set (int exoid, ex_entity_id node_set_id, int64_t start_node_num, int64_t num_nodes, const void_int *node_set_node_list)
SEACAS_DEPRECATED int | ex_get_n_node_set_df (int exoid, ex_entity_id node_set_id, int64_t start_num, int64_t num_df_to_get, void *node_set_dist_fact)
SEACAS_DEPRECATED int | ex_put_n_node_set_df (int exoid, ex_entity_id node_set_id, int64_t start_num, int64_t num_df_to_get, void *node_set_dist_fact)
SEACAS_DEPRECATED int | ex_get_n_elem_conn (int exoid, ex_entity_id elem_blk_id, int64_t start_elem_num, int64_t num_elems, void_int *connect)
SEACAS_DEPRECATED int | ex_put_n_elem_conn (int exoid, ex_entity_id elem_blk_id, int64_t start_elem_num, int64_t num_elems, const void_int *connect)
SEACAS_DEPRECATED int | ex_get_n_elem_attr (int exoid, ex_entity_id elem_blk_id, int64_t start_elem_num, int64_t num_elems, void *attrib)
SEACAS_DEPRECATED int | ex_put_n_elem_attr (int exoid, ex_entity_id elem_blk_id, int64_t start_elem_num, int64_t num_elems, void *attrib)
SEACAS_DEPRECATED int | ex_get_n_elem_num_map (int exoid, int64_t start_ent, int64_t num_ents, void_int *elem_map)
SEACAS_DEPRECATED int | ex_get_n_node_num_map (int exoid, int64_t start_ent, int64_t num_ents, void_int *node_map)
SEACAS_DEPRECATED int | ex_put_n_coord (int exoid, int64_t start_node_num, int64_t num_nodes, const void *x_coor, const void *y_coor, const void *z_coor)
SEACAS_DEPRECATED int | ex_put_n_elem_num_map (int exoid, int64_t start_ent, int64_t num_ents, const void_int *elem_map)
SEACAS_DEPRECATED int | ex_put_n_node_num_map (int exoid, int64_t start_ent, int64_t num_ents, const void_int *node_map)
SEACAS_DEPRECATED int | ex_put_n_one_attr (int exoid, ex_entity_type obj_type, ex_entity_id obj_id, int64_t start_num, int64_t num_ent, int attrib_index, const void *attrib)
SEACAS_DEPRECATED int | ex_put_n_var (int exoid, int time_step, ex_entity_type var_type, int var_index, ex_entity_id obj_id, int64_t start_index, int64_t num_entities, const void *var_vals)
SEACAS_DEPRECATED int | ex_put_n_nodal_var (int exoid, int time_step, int nodal_var_index, int64_t start_node, int64_t num_nodes, const void *nodal_var_vals)
SEACAS_DEPRECATED int | ex_get_partial_elem_var (int exoid, int time_step, int elem_var_index, ex_entity_id elem_blk_id, int64_t num_elem_this_blk, int64_t start_elem_num, int64_t num_elem, void *elem_var_vals)
SEACAS_DEPRECATED int | ex_get_partial_elem_map (int exoid, ex_entity_id map_id, int64_t ent_start, int64_t ent_count, void_int *elem_map)
SEACAS_DEPRECATED int | ex_get_partial_elem_conn (int exoid, ex_entity_id elem_blk_id, int64_t start_elem_num, int64_t num_elems, void_int *connect)
SEACAS_DEPRECATED int | ex_get_partial_elem_attr (int exoid, ex_entity_id elem_blk_id, int64_t start_elem_num, int64_t num_elems, void *attrib)
SEACAS_DEPRECATED int | ex_get_partial_elem_num_map (int exoid, int64_t start_ent, int64_t num_ents, void_int *elem_map)
SEACAS_DEPRECATED int | ex_get_partial_node_num_map (int exoid, int64_t start_ent, int64_t num_ents, void_int *node_map)
SEACAS_DEPRECATED int | ex_get_partial_node_set (int exoid, ex_entity_id node_set_id, int64_t start_node_num, int64_t num_nodes, void_int *node_set_node_list)
SEACAS_DEPRECATED int | ex_get_partial_node_set_df (int exoid, ex_entity_id node_set_id, int64_t start_num, int64_t num_df_to_get, void *node_set_dist_fact)
SEACAS_DEPRECATED int | ex_get_partial_side_set (int exoid, ex_entity_id side_set_id, int64_t start_side_num, int64_t num_sides, void_int *side_set_elem_list, void_int *side_set_side_list)
SEACAS_DEPRECATED int | ex_get_partial_side_set_df (int exoid, ex_entity_id side_set_id, int64_t start_num, int64_t num_df_to_get, void *side_set_dist_fact)
SEACAS_DEPRECATED int | ex_put_partial_node_num_map (int exoid, int64_t start_ent, int64_t num_ents, const void_int *node_map)
SEACAS_DEPRECATED int | ex_put_partial_elem_num_map (int exoid, int64_t start_ent, int64_t num_ents, const void_int *elem_map)
SEACAS_DEPRECATED int | ex_put_partial_elem_map (int exoid, ex_entity_id map_id, int64_t ent_start, int64_t ent_count, const void_int *elem_map)
SEACAS_DEPRECATED int | ex_put_partial_side_set (int exoid, ex_entity_id side_set_id, int64_t start_side_num, int64_t num_sides, const void_int *side_set_elem_list, const void_int *side_set_side_list)
SEACAS_DEPRECATED int | ex_put_partial_side_set_df (int exoid, ex_entity_id side_set_id, int64_t start_num, int64_t num_df_to_get, void *side_set_dist_fact)
SEACAS_DEPRECATED int | ex_put_partial_node_set (int exoid, ex_entity_id node_set_id, int64_t start_node_num, int64_t num_nodes, const void_int *node_set_node_list)
SEACAS_DEPRECATED int | ex_put_partial_node_set_df (int exoid, ex_entity_id node_set_id, int64_t start_num, int64_t num_df_to_get, void *node_set_dist_fact)
SEACAS_DEPRECATED int | ex_put_partial_elem_conn (int exoid, ex_entity_id elem_blk_id, int64_t start_elem_num, int64_t num_elems, const void_int *connect)
SEACAS_DEPRECATED int | ex_put_partial_elem_attr (int exoid, ex_entity_id elem_blk_id, int64_t start_elem_num, int64_t num_elems, void *attrib)
SEACAS_DEPRECATED int | ex_put_elem_var_slab (int exoid, int time_step, int elem_var_index, ex_entity_id elem_blk_id, int64_t start_pos, int64_t num_vals, void *elem_var_vals)
SEACAS_DEPRECATED int | ex_put_nodal_var_slab (int exoid, int time_step, int nodal_var_index, int64_t start_pos, int64_t num_vals, void *nodal_var_vals)
char * | ex_name_of_object (ex_entity_type obj_type)
ex_entity_type | ex_var_type_to_ex_entity_type (char var_type)
int | ex_set_parallel (int exoid, int is_parallel)
int | ex_get_idx (int exoid, const char *ne_var_name, int64_t *my_index, int pos)

## Variables
int | exoptval
int | exerrval

## Macro Definition Documentation

## ◆ EX_API_VERS

#define EX_API_VERS 7.21f

## ◆ EX_API_VERS_NODOT

#define EX_API_VERS_NODOT 721

## ◆ ex_create

#define ex_create | ( |  | path,
|  |  | mode,
|  |  | comp_ws,
|  |  | io_ws
| ) |  | ex_create_int(path, mode, comp_ws, io_ws, EX_API_VERS_NODOT)

Examples
  /test/create_mesh.c, /test/CreateEdgeFace.c, /test/rd_wt_mesh.c, /test/test-empty.c, /test/test_nemesis.c, /test/test_ts_files.c, /test/test_ts_nvar.c, /test/test_ts_partial_nvar.c, /test/testcp.c, /test/testcp_nl.c, /test/testcpd.c, /test/testrd1.c, /test/testrdwt.c, /test/testwt-compress.c, /test/testwt-groups.c, /test/testwt-localization.C, /test/testwt-long-name.c, /test/testwt-nface-nside.c, /test/testwt-nfaced.c, /test/testwt-nsided.c, /test/testwt-one-attrib.c, /test/testwt-oned.c, /test/testwt-partial.c, /test/testwt-zeroe.c, /test/testwt-zeron.c, /test/testwt.c, /test/testwt1.c, /test/testwt2.c, /test/testwt_clb.c, /test/testwt_nc.c, /test/testwt_nossnsdf.c, /test/testwt_ss.c, /test/testwtd.c, /test/testwtm.c, and /test/twod.c.

## ◆ EX_FALSE

#define EX_FALSE 0

Examples
  /test/create_mesh.c, and /test/rd_wt_mesh.c.

## ◆ EX_FATAL

#define EX_FATAL -1 /* fatal error flag def */

## ◆ EX_INVALID_ID

#define EX_INVALID_ID -1

The value used to indicate that an entity (block, nset, sset) has not had its id set to a valid value

## ◆ EX_NOERR

#define EX_NOERR 0 /* no error flag def */

## ◆ ex_open

#define ex_open | ( |  | path,
|  |  | mode,
|  |  | comp_ws,
|  |  | io_ws,
|  |  | version
| ) |  | ex_open_int(path, mode, comp_ws, io_ws, version, EX_API_VERS_NODOT)

Examples
  /test/rd_wt_mesh.c, /test/ReadEdgeFace.c, /test/test-empty.c, /test/test_nemesis.c, /test/test_ts_nvar_rd.c, /test/test_ts_partial_nvar_rd.c, /test/testcp.c, /test/testcp_nl.c, /test/testcpd.c, /test/testrd-groups.c, /test/testrd-long-name.c, /test/testrd-nfaced.c, /test/testrd-nsided.c, /test/testrd.c, /test/testrd1.c, /test/testrd_nc.c, /test/testrd_ss.c, /test/testrdd.c, /test/testrdwt.c, and /test/testwt-one-attrib.c.

## ◆ EX_TRUE

#define EX_TRUE -1

Examples
  /test/create_mesh.c, and /test/rd_wt_mesh.c.

## ◆ EX_VERS

#define EX_VERS EX_API_VERS

## ◆ EX_WARN

#define EX_WARN 1 /* warning flag def */

## ◆ EXODUS_EXPORT

#define EXODUS_EXPORT extern

## ◆ NEMESIS_API_VERSION

#define NEMESIS_API_VERSION EX_API_VERS

## ◆ NEMESIS_API_VERSION_NODOT

#define NEMESIS_API_VERSION_NODOT EX_API_VERS_NODOT

## ◆ NEMESIS_FILE_VERSION

#define NEMESIS_FILE_VERSION 2.6

## ◆ SEACAS_DEPRECATED

#define SEACAS_DEPRECATED

## Typedef Documentation

## ◆ ex_entity_id

typedef int64_t ex_entity_id

Specifies that this argument is the id of an entity: element block, nodeset, sideset, ...

## ◆ ex_entity_type

typedef enum ex_entity_type ex_entity_type

## ◆ ex_inquiry

typedef enum ex_inquiry ex_inquiry

## ◆ ex_options

typedef enum ex_options ex_options

## ◆ void_int

typedef void void_int

The mechanism for passing double/float and int/int64_t both use a void*; to avoid some confusion as to whether a function takes an integer or a float/double, the following typedef is used for the integer argument

## Enumeration Type Documentation

## ◆ ex_entity_type

enum ex_entity_type

Enumerator
EX_NODAL | nodal "block" for variables
EX_NODE_BLOCK | alias for EX_NODAL
EX_NODE_SET | node set property code
EX_EDGE_BLOCK | edge block property code
EX_EDGE_SET | edge set property code
EX_FACE_BLOCK | face block property code
EX_FACE_SET | face set property code
EX_ELEM_BLOCK | element block property code
EX_ELEM_SET | face set property code
EX_SIDE_SET | side set property code
EX_ELEM_MAP | element map property code
EX_NODE_MAP | node map property code
EX_EDGE_MAP | edge map property code
EX_FACE_MAP | face map property code
EX_GLOBAL | global "block" for variables
EX_COORDINATE | kluge so some internal wrapper functions work
EX_INVALID |

## ◆ ex_inquiry

enum ex_inquiry

See also
  ex_inquire()

Enumerator
EX_INQ_FILE_TYPE | inquire EXODUS file type
EX_INQ_API_VERS | inquire API version number
EX_INQ_DB_VERS | inquire database version number
EX_INQ_TITLE | inquire database title
EX_INQ_DIM | inquire number of dimensions
EX_INQ_NODES | inquire number of nodes
EX_INQ_ELEM | inquire number of elements
EX_INQ_ELEM_BLK | inquire number of element blocks
EX_INQ_NODE_SETS | inquire number of node sets
EX_INQ_NS_NODE_LEN | inquire length of node set node list
EX_INQ_SIDE_SETS | inquire number of side sets
EX_INQ_SS_NODE_LEN | inquire length of side set node list
EX_INQ_SS_ELEM_LEN | inquire length of side set element list
EX_INQ_QA | inquire number of QA records
EX_INQ_INFO | inquire number of info records
EX_INQ_TIME | inquire number of time steps in the database
EX_INQ_EB_PROP | inquire number of element block properties
EX_INQ_NS_PROP | inquire number of node set properties
EX_INQ_SS_PROP | inquire number of side set properties
EX_INQ_NS_DF_LEN | inquire length of node set distribution factor list
EX_INQ_SS_DF_LEN | inquire length of side set distribution factor list
EX_INQ_LIB_VERS | inquire API Lib vers number
EX_INQ_EM_PROP | inquire number of element map properties
EX_INQ_NM_PROP | inquire number of node map properties
EX_INQ_ELEM_MAP | inquire number of element maps
EX_INQ_NODE_MAP | inquire number of node maps
EX_INQ_EDGE | inquire number of edges
EX_INQ_EDGE_BLK | inquire number of edge blocks
EX_INQ_EDGE_SETS | inquire number of edge sets
EX_INQ_ES_LEN | inquire length of concat edge set edge list
EX_INQ_ES_DF_LEN | inquire length of concat edge set dist factor list
EX_INQ_EDGE_PROP | inquire number of properties stored per edge block
EX_INQ_ES_PROP | inquire number of properties stored per edge set
EX_INQ_FACE | inquire number of faces
EX_INQ_FACE_BLK | inquire number of face blocks
EX_INQ_FACE_SETS | inquire number of face sets
EX_INQ_FS_LEN | inquire length of concat face set face list
EX_INQ_FS_DF_LEN | inquire length of concat face set dist factor list
EX_INQ_FACE_PROP | inquire number of properties stored per face block
EX_INQ_FS_PROP | inquire number of properties stored per face set
EX_INQ_ELEM_SETS | inquire number of element sets
EX_INQ_ELS_LEN | inquire length of concat element set element list
EX_INQ_ELS_DF_LEN | inquire length of concat element set dist factor list
EX_INQ_ELS_PROP | inquire number of properties stored per elem set
EX_INQ_EDGE_MAP | inquire number of edge maps
EX_INQ_FACE_MAP | inquire number of face maps
EX_INQ_COORD_FRAMES | inquire number of coordinate frames
EX_INQ_DB_MAX_ALLOWED_NAME_LENGTH | inquire size of MAX_NAME_LENGTH dimension on database
EX_INQ_DB_MAX_USED_NAME_LENGTH | inquire size of MAX_NAME_LENGTH dimension on database
EX_INQ_MAX_READ_NAME_LENGTH | inquire client-specified max size of returned names
EX_INQ_DB_FLOAT_SIZE | inquire size of floating-point values stored on database
EX_INQ_NUM_CHILD_GROUPS | inquire number of groups contained in this (exoid) group
EX_INQ_GROUP_PARENT | inquire id of parent of this (exoid) group; returns exoid if at root
EX_INQ_GROUP_ROOT | inquire id of root group "/" of this (exoid) group; returns exoid if at root
EX_INQ_GROUP_NAME_LEN | inquire length of name of group exoid
EX_INQ_GROUP_NAME | inquire name of group exoid. "/" returned for root group
EX_INQ_FULL_GROUP_NAME_LEN | inquire length of full path name of this (exoid) group
EX_INQ_FULL_GROUP_NAME | inquire full "/"-separated path name of this (exoid) group
EX_INQ_THREADSAFE | Returns 1 if library is thread-safe; 0 otherwise
EX_INQ_INVALID |

## ◆ ex_options

enum ex_options

ex_opts() function codes - codes are OR'ed into exopts

Enumerator
EX_DEFAULT |
EX_VERBOSE | verbose mode message flag
EX_DEBUG | debug mode def
EX_ABORT | abort mode flag def
EX_NULLVERBOSE | verbose mode for null entity detection warning

## Function Documentation

## ◆ ex_add_attr()

int ex_add_attr | ( | int | exoid,
|  | ex_entity_type | obj_type,
|  | ex_entity_id | obj_id,
|  | int64_t | num_attr_per_entry
| ) |  |

## ◆ ex_close()

int ex_close | ( | int | exoid | ) |

The function ex_close() updates and then closes an open exodus file.

Returns
  In case of an error, ex_close() returns a negative number; a warning will return a positive number. Possible causes of errors include:
  - data file not properly opened with call to ex_create() or ex_open()

Parameters

  exoid | exodus file ID returned from a previous call to ex_create() or ex_open().

The following code segment closes an open exodus file:

int error,exoid;
error = ex_close (exoid);

Examples
  /test/create_mesh.c, /test/CreateEdgeFace.c, /test/rd_wt_mesh.c, /test/ReadEdgeFace.c, /test/test-empty.c, /test/test_nemesis.c, /test/test_ts_files.c, /test/test_ts_nvar.c, /test/test_ts_nvar_rd.c, /test/test_ts_partial_nvar.c, /test/test_ts_partial_nvar_rd.c, /test/testcp.c, /test/testcp_nl.c, /test/testcpd.c, /test/testrd-groups.c, /test/testrd-long-name.c, /test/testrd-nfaced.c, /test/testrd-nsided.c, /test/testrd.c, /test/testrd1.c, /test/testrd_nc.c, /test/testrd_par.c, /test/testrd_ss.c, /test/testrdd.c, /test/testrdwt.c, /test/testwt-compress.c, /test/testwt-groups.c, /test/testwt-localization.C, /test/testwt-long-name.c, /test/testwt-nface-nside.c, /test/testwt-nfaced.c, /test/testwt-nsided.c, /test/testwt-one-attrib.c, /test/testwt-oned.c, /test/testwt-partial.c, /test/testwt-zeroe.c, /test/testwt-zeron.c, /test/testwt.c, /test/testwt1.c, /test/testwt2.c, /test/testwt_clb.c, /test/testwt_nc.c, /test/testwt_nossnsdf.c, /test/testwt_ss.c, /test/testwtd.c, /test/testwtm.c, and /test/twod.c.

## ◆ ex_copy()

int ex_copy | ( | int | in_exoid,
|  | int | out_exoid
| ) |  |

Undocumented:

efficiently copies all non-transient information (attributes, dimensions, and variables from an opened EXODUS file to another opened EXODUS file. Will not overwrite a dimension or variable already defined in the new file.

Parameters

  in_exoid | exodus file id for input file
  out_exoid | exodus file id for output file

Examples
  /test/testcp.c, /test/testcp_nl.c, and /test/testcpd.c.

## ◆ ex_copy_string()

char* ex_copy_string | ( | char * | dest,
|  | char const * | source,
|  | size_t | elements
| ) |  |

Examples
  /test/create_mesh.c, /test/CreateEdgeFace.c, /test/ExoIICTests.cxx, /test/rd_wt_mesh.c, /test/test_nemesis.c, /test/test_ts_files.c, /test/testwt-compress.c, /test/testwt-localization.C, /test/testwt-nface-nside.c, /test/testwt-nfaced.c, and /test/testwt.c.

## ◆ ex_copy_transient()

int ex_copy_transient | ( | int | in_exoid,
|  | int | out_exoid
| ) |  |

## ◆ ex_create_group()

int ex_create_group | ( | int | parent_id,
|  | const char * | group_name
| ) |  |

Examples
  /test/testwt-groups.c.

## ◆ ex_create_int()

int ex_create_int | ( | const char * | path,
|  | int | cmode,
|  | int * | comp_ws,
|  | int * | io_ws,
|  | int | run_version
| ) |  |

Note
  The ex_create_int() is an internal function called by ex_create(). The user should call ex_create() and not ex_create_int().

The function ex_create() creates a new exodus file and returns an ID that can subsequently be used to refer to the file.

All floating point values in an exodus file are stored as either 4-byte (float) or 8-byte (double) numbers; no mixing of 4- and 8-byte numbers in a single file is allowed. An application code can compute either 4- or 8-byte values and can designate that the values be stored in the exodus file as either 4- or 8-byte numbers; conversion between the 4- and 8-byte values is performed automatically by the API routines. Thus, there are four possible combinations of compute word size and storage (or I/O) word size.

Returns
  In case of an error, ex_create() returns a negative number. Possible causes of errors include:
  - Passing a file name that includes a directory that does not exist.
  - Specifying a file name of a file that exists and also specifying a no clobber option.
  - Attempting to create a file in a directory without permission to create files there.
  - Passing an invalid file clobber mode.

Parameters

  | path | The file name of the new exodus file. This can be given as either an absolute path name (from the root of the file system) or a relative path name (from the current directory).
  | cmode | Mode. Use one of the following predefined constants: EX_NOCLOBBER To create the new file only if the given file name does not refer to a file that already exists. EX_CLOBBER To create the new file, regardless of whether a file with the same name already exists. If a file with the same name does exist, its contents will be erased. EX_64BIT_OFFSET To create a model that can store individual datasets larger than 2 gigabytes. This modifies the internal storage used by exodusII and also puts the underlying NetCDF file into the 64-bit offset' mode. See largemodel for more details on this mode. A large model file will also be created if the environment variable EXODUS_LARGE_MODEL is defined in the users environment. A message will be printed to standard output if this environment variable is found. EX_LARGE_MODEL is alias. EX_NORMAL_MODEL Create a standard model. EX_64BIT_DATA To create a model using the CDF5 format which uses the classic model but has 64-bit dimensions and sizes. This type will also be created if the environment variable EXODUS_NETCDF5 is defined in the users environment. A message will be printed to standard output if this environment variable is found. EX_NETCDF4 To create a model using the HDF5-based NetCDF-4 output. An HDF5-based NetCDF-4 file will also be created if the environment variable EXODUS_NETCDF4 is defined in the users environment. A message will be printed to standard output if this environment variable is found. EX_NOSHARE Do not open the underlying NetCDF file in share mode. See the NetCDF documentation for more details. EX_SHARE Do open the underlying NetCDF file in share mode. See the NetCDF documentation for more details.
  [in,out] | comp_ws | The word size in bytes (0, 4 or 8) of the floating point variables used in the application program. If 0 (zero) is passed, the default sizeof(float) will be used and returned in this variable. WARNING: all exodus functions requiring floats must be passed floats declared with this passed in or returned compute word size (4 or 8).}
  | io_ws | The word size in bytes (4 or 8) of the floating point data as they are to be stored in the exodus file.
  | run_version | (internally generated) used to verify compatibility of library and include files.

The following code segment creates an exodus file called `test.exo`:

#include "exodusII.h"
int CPU_word_size, IO_word_size, exoid;
CPU_word_size = sizeof(float); /* use float or double */
IO_word_size = 8; /* store variables as doubles */
/* create exodus file */
exoid = ex_create ("test.exo" /* filename path */
EX_CLOBBER, /* create mode */
&CPU_word_size, /* CPU float word size in bytes */
&IO_word_size); /* I/O float word size in bytes */

## ◆ ex_cvt_nodes_to_sides()

int ex_cvt_nodes_to_sides | ( | int | exoid,
|  | void_int * | num_elem_per_set,
|  | void_int * | num_nodes_per_set,
|  | void_int * | side_sets_elem_index,
|  | void_int * | side_sets_node_index,
|  | void_int * | side_sets_elem_list,
|  | void_int * | side_sets_node_list,
|  | void_int * | side_sets_side_list
| ) |  |

The function ex_cvt_nodes_to_sides() is used to convert a side set node list to a side set side list. This routine is provided for application programs that utilize side sets defined by nodes (as was done previous to release 2.0) rather than local faces or edges. The application program must allocate memory for the returned array of sides. The length of this array is the same as the length of the concatenated side sets element list, which can be determined with a call to ex_inquire() or ex_inquire_int().

Returns
  In case of an error, ex_cvt_nodes_to_sides() returns a negative number; a warning will return a positive number. Possible causes of errors include:
  - a warning value is returned if no side sets are stored in the file.
  - because the faces of a wedge require a different number of nodes to describe them (quadrilateral vs. triangular faces), the function will abort with a fatal return code if a wedge is encountered in the side set element list.

Parameters

  [in] | exoid | exodus file ID returned from a previous call to ex_create() or ex_open().
  [in] | num_elem_per_set | Array containing the number of sides for each set. The number of sides is equal to the number of elements for each set.
  [in] | num_nodes_per_set | Array containing the number of nodes for each set.
  [in] | side_sets_elem_index | Array containing indices into the `side_sets_elem_list` which are the locations of the first element for each set. These indices are 0-based. Unused.
  [in] | side_sets_node_index | Array containing indices into the `side_sets_node_list` which are the locations of the first node for each set. These indices are 0-based. Unused.
  [in] | side_sets_elem_list | Array containing the elements for all side sets. Internal element IDs are used in this list (see Section LocalElementIds).
  [in] | side_sets_node_list | Array containing the nodes for all side sets. Internal node IDs are used in this list (see Section LocalNodeIds).
  [out] | side_sets_side_list | Returned array containing the sides for all side sets.

The following code segment will convert side sets described by nodes to side sets described by local side numbers:

int error, exoid, ids[2], num_side_per_set[2],
num_nodes_per_set[2], elem_ind[2], node_ind[2],
elem_list[4], node_list[8], el_lst_len, *side_list;
ids[0] = 30 ; ids[1] = 31;
num_side_per_set[0] = 2; num_side_per_set[1] = 2;
num_nodes_per_set[0] = 4; num_nodes_per_set[1] = 4;
elem_ind[0] = 0; elem_ind[1] = 2;
node_ind[0] = 0; node_ind[1] = 4;
/* side set #1 */
elem_list[0] = 2; elem_list[1] = 2;
node_list[0] = 8; node_list[1] = 5;
node_list[2] = 6; node_list[3] = 7;
/* side set #2 */
elem_list[2] = 1; elem_list[3] = 2;
node_list[4] = 2; node_list[5] = 3;
node_list[6] = 7; node_list[7] = 8;
el_lst_len = ex_inquire_int(exoid, EX_INQ_SS_ELEM_LEN);
/* side set element list is same length as side list */
side_list = (int *) calloc (el_lst_len, sizeof(int));
ex_cvt_nodes_to_sides(exoid, num_side_per_set, num_nodes_per_set,
elem_ind, node_ind, elem_list,
node_list, side_list);

Algorithm:

      Read elem_block_ids --> elem_blk_id[array]

      Read element block parameters --> elem_blk_parms[array]

      Determine total number of elements in side set by summing num_elem_per_set

      Build side set element to side set node list index --> ss_elem_node_ndx[array]

      For each element in the side_set_elem_list  {
        If Jth element is not in current element block (e.g. J>elem_ctr) {
          get element block parameters (num_elem_in_blk, ...)
          elem_ctr += num_elem_in_blk

          free old connectity array space
          allocate connectivity array: size=num_elem_in_blk*num_nodes_per_elem
          get connectivity array
        }

        If Jth element is in current element block (e.g. J<=elem_ctr) {
          For each node in element (linear search of up to num_nodes_per_elem) {
            If side set element node[1] == element node[i] {
              Case element type = Hex {
                If side set element node[2] == element node[Hex_table[i,1]]
                  Jth side = Hex_table[i,2]

                 break
              }
              Case element type = Wedge {
                If side set element node[2] == element node[Wedge_table[i,1]]
                  Jth side = Wedge_table[i,2]

                break
              }
            }
          }
        }
      }

Examples
  /test/testwt1.c, /test/testwt_nossnsdf.c, /test/testwt_ss.c, and /test/testwtm.c.

## ◆ ex_err()

void ex_err | ( | const char * | module_name,
|  | const char * | message,
|  | int | err_num
| ) |  |

Examples
  /test/test_ts_errval.c.

## ◆ ex_err_fn()

void ex_err_fn | ( | int | exoid,
|  | const char * | module_name,
|  | const char * | message,
|  | int | err_num
| ) |  |

## ◆ ex_get_all_times()

int ex_get_all_times | ( | int | exoid,
|  | void * | time_values
| ) |  |

The function ex_get_all_times() reads the time values for all time steps. Memory must be allocated for the time values array before this function is invoked. The storage requirements (equal to the number of time steps) can be determined by using the ex_inquire() or ex_inquire_int() routines.

Because time values are floating point values, the application code must declare the array passed to be the appropriate type (float or double) to match the compute word size passed in ex_create() or ex_open().

Returns
  In case of an error, ex_get_all_times() returns a negative number; a warning will return a positive number. Possible causes of errors include:
  - data file not properly opened with call to ex_create() or ex_open()
  - no time steps have been stored in the file.

Parameters

  [in] | exoid | exodus file ID returned from a previous call to ex_create() or ex_open().
  [out] | time_values | Returned array of times. These are the time values at all time steps.

The following code segment will read the time values for all time steps stored in the data file:

int error, exoid, num_time_steps;
float *time_values;
/* determine how many time steps are stored */
num_time_steps = ex_inquire_int(exoid, EX_INQ_TIME);
/* read time values at all time steps */
time_values = (float *) calloc(num_time_steps, sizeof(float));
error = ex_get_all_times(exoid, time_values);

Examples
  /test/testrd-groups.c, /test/testrd-long-name.c, /test/testrd-nsided.c, /test/testrd.c, /test/testrd1.c, /test/testrd_nc.c, /test/testrd_par.c, and /test/testrdd.c.

## ◆ ex_get_attr()

int ex_get_attr | ( | int | exoid,
|  | ex_entity_type | obj_type,
|  | ex_entity_id | obj_id,
|  | void * | attrib
| ) |  |

Undocumented:
  reads the attributes for an edge, face, or element block

Examples
  /test/ReadEdgeFace.c, /test/testrd-groups.c, /test/testrd-long-name.c, /test/testrd-nsided.c, /test/testrd.c, /test/testrd1.c, /test/testrd_nc.c, /test/testrd_par.c, and /test/testrdd.c.

## ◆ ex_get_attr_names()

int ex_get_attr_names | ( | int | exoid,
|  | ex_entity_type | obj_type,
|  | ex_entity_id | obj_id,
|  | char ** | names
| ) |  |

Undocumented:

Examples
  /test/ReadEdgeFace.c, /test/testrd-groups.c, /test/testrd-long-name.c, /test/testrd-nsided.c, /test/testrd.c, and /test/testrd_par.c.

## ◆ ex_get_attr_param()

int ex_get_attr_param | ( | int | exoid,
|  | ex_entity_type | obj_type,
|  | ex_entity_id | obj_id,
|  | int * | num_attrs
| ) |  |

Undocumented:
  retrieves the number of attributes.

Examples
  /test/testrd-groups.c, /test/testrd-long-name.c, /test/testrd-nsided.c, /test/testrd.c, and /test/testrd_par.c.

## ◆ ex_get_block()

int ex_get_block | ( | int | exoid,
|  | ex_entity_type | blk_type,
|  | ex_entity_id | blk_id,
|  | char * | elem_type,
|  | void_int * | num_entries_this_blk,
|  | void_int * | num_nodes_per_entry,
|  | void_int * | num_edges_per_entry,
|  | void_int * | num_faces_per_entry,
|  | void_int * | num_attr_per_entry
| ) |  |

Undocumented:
  exgblk - read block parameters

entry conditions - input parameters: int idexo exodus file id int blk_type block type (edge,face,element) int blk_id block id

exit conditions - char* elem_type element type name int* num_entries_this_blk number of elements in this element block int* num_nodes_per_entry number of nodes per element block int* num_attr_per_entry number of attributes

revision history -

Examples
  /test/rd_wt_mesh.c, /test/ReadEdgeFace.c, /test/testrd-groups.c, /test/testrd-long-name.c, /test/testrd-nfaced.c, /test/testrd-nsided.c, /test/testrd.c, /test/testrd1.c, /test/testrd_nc.c, /test/testrd_par.c, /test/testrd_ss.c, /test/testrdd.c, /test/testrdwt.c, and /test/testwt-one-attrib.c.

## ◆ ex_get_block_param()

int ex_get_block_param | ( | int | exoid,
|  | ex_block * | block
| ) |  |

Undocumented:
  exgblk - read block parameters

entry conditions - input parameters: int idexo exodus file id int blk_type block type (edge,face,element) int blk_id block id

exit conditions - char* elem_type element type name int* num_entries_this_blk number of elements in this element block int* num_nodes_per_entry number of nodes per element block int* num_attr_per_entry number of attributes

revision history -

## ◆ ex_get_block_params()

int ex_get_block_params | ( | int | exoid,
|  | size_t | block_count,
|  | struct ex_block ** | blocks
| ) |  |

Reads the parameters describing element/face/edge blocks

Parameters

  exoid | exodus file id
  block_count | number of blocks being queried
  blocks | array of ex_block structures describing block counts

the id and type fields of the block(s) must be defined to specify which blocks to access; all other fileds will be filled in based on data from the file

## ◆ ex_get_cmap_params()

int ex_get_cmap_params | ( | int | exoid,
|  | void_int * | node_cmap_ids,
|  | void_int * | node_cmap_node_cnts,
|  | void_int * | elem_cmap_ids,
|  | void_int * | elem_cmap_elem_cnts,
|  | int | processor
| ) |  |

Examples
  /test/test_nemesis.c.

## ◆ ex_get_concat_node_sets()

SEACAS_DEPRECATED int ex_get_concat_node_sets | ( | int | exoid,
|  | void_int * | node_set_ids,
|  | void_int * | num_nodes_per_set,
|  | void_int * | num_df_per_set,
|  | void_int * | node_sets_node_index,
|  | void_int * | node_sets_df_index,
|  | void_int * | node_sets_node_list,
|  | void * | node_sets_dist_fact
| ) |  |

Deprecated:
  Use ex_get_concat_sets()(exoid, EX_NODE_SET, set_specs) instead

The function ex_get_concat_node_sets() reads the node set ID's, node set node count array, node set distribution factors count array, node set node pointers array, node set distribution factors pointer array, node set node list, and node set distribution factors for all of the node sets. `‘Concatenated node sets’' refers to the arrays required to define all of the node sets (ID array, counts arrays, pointers arrays, node list array, and distribution factors array) as described in Section 3.10 on page 11.

Because the distribution factors are floating point values, the application code must declare the array passed to be the appropriate type (float or double) to match the compute word size passed in ex_create() or ex_open().

The length of each of the returned arrays can be determined by invoking ex_inquire() or ex_inquire_int().

Returns
  In case of an error, ex_get_concat_node_sets() returns a negative number; a warning will return a positive number. Possible causes of errors include:
  - data file not properly opened with call to ex_create() or ex_open()
  - a warning value is returned if no node sets are stored in the file.

Parameters

  [in] | exoid | exodus file ID returned from a previous call to ex_create() or ex_open().
  [out] | node_set_ids | Returned array containing the node set ID for each set.
  [out] | num_nodes_per_set | Returned array containing the number of nodes for each set.
  [out] | num_df_per_set | Returned array containing the number of distribution factors for each set.
  [out] | node_sets_node_index | Returned array containing the indices into the node_set_node_list which are the locations of the first node for each set. These indices are 0-based.
  [out] | node_sets_df_index | Returned array containing the indices into the node_set_dist_fact which are the locations of the first distribution factor for each set. These indices are 0-based.
  [out] | node_sets_node_list | Returned array containing the nodes for all sets. Internal node IDs are used in this list (see Section LocalNodeIds).
  [out] | node_sets_dist_fact | Returned array containing the distribution factors for all sets.

As an example, the following code segment will read concatenated node sets:

int error, exoid, num_node_sets, list_len, *ids,
*num_nodes_per_set, *num_df_per_set, *node_ind,
*df_ind, *node_list;
float *dist_fact
/* read concatenated node sets */
num_node_sets = ex_inquire_int(exoid, EX_INQ_NODE_SETS);
ids = (int *) calloc(num_node_sets, sizeof(int));
num_nodes_per_set = (int *) calloc(num_node_sets, sizeof(int));
num_df_per_set = (int *) calloc(num_node_sets, sizeof(int));
node_ind = (int *) calloc(num_node_sets, sizeof(int));
df_ind = (int *) calloc(num_node_sets, sizeof(int));
list_len = ex_inquire_int(exoid, EX_INQ_NS_NODE_LEN);
node_list = (int *) calloc(list_len, sizeof(int));
list_len = ex_inquire_int(exoid, EX_INQ_NS_DF_LEN);
dist_fact = (float *) calloc(list_len, sizeof(float));
error = ex_get_concat_node_sets (exoid, ids, num_nodes_per_set,
num_df_per_set, node_ind, df_ind,
node_list, dist_fact);

Examples
  /test/testrd-groups.c, and /test/testrd_par.c.

## ◆ ex_get_concat_sets()

int ex_get_concat_sets | ( | int | exoid,
|  | ex_entity_type | set_type,
|  | struct ex_set_specs * | set_specs
| ) |  |

Undocumented:
  exgcss - ex_get_concat_sets

reads the set ID's, set entry count array, set entry pointers array, set entry list, set extra list, and set distribution factors for all sets of the specified type.

entry conditions - input parameters: int exoid exodus file id ex_entity_type set_type type of set

exit conditions - struct ex_set_specs* set_specs set specs structure

revision history -

Examples
  /test/testrd-long-name.c, /test/testrd-nsided.c, /test/testrd.c, /test/testrd1.c, /test/testrd_nc.c, /test/testrd_ss.c, and /test/testrdd.c.

## ◆ ex_get_concat_side_set_node_count()

int ex_get_concat_side_set_node_count | ( | int | exoid,
|  | int * | side_set_node_cnt_list
| ) |  |

Undocumented:

## ◆ ex_get_concat_side_sets()

SEACAS_DEPRECATED int ex_get_concat_side_sets | ( | int | exoid,
|  | void_int * | side_set_ids,
|  | void_int * | num_elem_per_set,
|  | void_int * | num_dist_per_set,
|  | void_int * | side_sets_elem_index,
|  | void_int * | side_sets_dist_index,
|  | void_int * | side_sets_elem_list,
|  | void_int * | side_sets_side_list,
|  | void * | side_sets_dist_fact
| ) |  |

Undocumented:
  reads the side set ID's, side set element count array, side set node count array, side set element pointers array, side set node pointers array, side set element list, side set node list, and side set distribution factors

Deprecated:
  Use ex_get_concat_sets()(exoid, EX_SIDE_SET, set_specs) instead

Examples
  /test/testrd-groups.c, and /test/testrd_par.c.

## ◆ ex_get_conn()

int ex_get_conn | ( | int | exoid,
|  | ex_entity_type | blk_type,
|  | ex_entity_id | blk_id,
|  | void_int * | nodeconn,
|  | void_int * | edgeconn,
|  | void_int * | faceconn
| ) |  |

Undocumented:
  exgconn - exodusII read edge/face/element block connectivity

entry conditions - expelb must be called first to establish element block parameters. input parameters: int exoid exodus file id int blk_type block type (edge, face, element) int blk_id block id

exit conditions - int* nodeconn nodal connectivity array int* edgeconn edge connectivity array (where applicable) int* faceconn face connectivity array (where applicable)

Examples
  /test/rd_wt_mesh.c, /test/ReadEdgeFace.c, /test/testrd-groups.c, /test/testrd-long-name.c, /test/testrd-nfaced.c, /test/testrd-nsided.c, /test/testrd.c, /test/testrd1.c, /test/testrd_nc.c, /test/testrd_par.c, /test/testrd_ss.c, /test/testrdd.c, and /test/testrdwt.c.

## ◆ ex_get_coord()

int ex_get_coord | ( | int | exoid,
|  | void * | x_coor,
|  | void * | y_coor,
|  | void * | z_coor
| ) |  |

The function ex_get_coord() reads the nodal coordinates of the nodes. Memory must be allocated for the coordinate arrays (x_coor, y_coor, and z_coor) before this call is made. The length of each of these arrays is the number of nodes in the mesh.

Because the coordinates are floating point values, the application code must declare the arrays passed to be the appropriate type (float or double) to match the compute word size passed in ex_create() or ex_open().

Returns
  In case of an error, ex_get_coord() returns a negative number; a warning will return a positive number. Possible causes of errors include:
  - data file not properly opened with call to ex_create() or ex_open()
  - a warning value is returned if nodal coordinates were not stored.

Parameters

  [in] | exoid | exodus file ID returned from a previous call to ex_create() or ex_open().
  [out] | x_coor | Returned X coordinates of the nodes. If this is NULL, the X-coordinates will not be read.
  [out] | y_coor | Returned Y coordinates of the nodes. These are returned only if num_dim > 1; otherwise, pass in NULL. If this is NULL, the Y-coordinates will not be read.
  [out] | z_coor | Returned Z coordinates of the nodes. These are returned only if num_dim > 2; otherwise, pass in NULL. If this is NULL, the Z-coordinates will not be read.

The following code segment will read the nodal coordinates from an open exodus file :

int error, exoid;
double *x, *y, *z;
/* read nodal coordinates values from database */
x = (double *)calloc(num_nodes, sizeof(double));
y = (double *)calloc(num_nodes, sizeof(double));
if (num_dim >= 3)
z = (double *)calloc(num_nodes, sizeof(double));
else
z = 0;
error = ex_get_coord(exoid, x, y, z);
/* Do the same as the previous call in three separate calls */
error = ex_get_coord(exoid, x, NULL, NULL);
error = ex_get_coord(exoid, NULL, y, NULL);
if (num_dim >= 3)
error = ex_get_coord(exoid, NULL, NULL, z);

Examples
  /test/rd_wt_mesh.c, /test/test_ts_nvar_rd.c, /test/testrd-groups.c, /test/testrd-long-name.c, /test/testrd-nfaced.c, /test/testrd-nsided.c, /test/testrd.c, /test/testrd1.c, /test/testrd_nc.c, /test/testrd_par.c, /test/testrdd.c, and /test/testrdwt.c.

## ◆ ex_get_coord_names()

int ex_get_coord_names | ( | int | exoid,
|  | char ** | coord_names
| ) |  |

The function ex_get_coord_names() reads the names of the coordinate arrays from the database. Memory must be allocated for the character strings before this function is invoked.

Returns
  In case of an error, ex_get_coord_names() returns a negative number; a warning will return a positive number. Possible causes of errors include:
  - data file not properly opened with call to ex_create() or ex_open()
  - a warning value is returned if coordinate names were not stored.

Parameters

  [in] | exoid | exodus file ID returned from a previous call to ex_create() or ex_open().
  [out] | coord_names | Returned pointer to a vector containing num_dim names of the nodal coordinate arrays.

The following code segment will read the coordinate names from an open exodus file :

int error, exoid;
char *coord_names[3];
for (i=0; i < num_dim; i++) {
coord_names[i] = (char *)calloc((..size of names...+1), sizeof(char));
}
error = ex_get_coord_names (exoid, coord_names);

Examples
  /test/testrd-groups.c, /test/testrd-long-name.c, /test/testrd-nfaced.c, /test/testrd-nsided.c, /test/testrd.c, /test/testrd1.c, /test/testrd_nc.c, /test/testrd_par.c, /test/testrdd.c, and /test/testrdwt.c.

## ◆ ex_get_coordinate_frames()

int ex_get_coordinate_frames | ( | int | exoid,
|  | int * | nframes,
|  | void_int * | cf_ids,
|  | void * | pt_coordinates,
|  | char * | tags
| ) |  |

Coordinate frames are stored in the database as a series of three points (defined in the basic cartesian coordinate system). The first of these points describes the origin of the new system. The second point lies on the 3 axis (or Z axis) of the frame. The third point is in the 1-3 (xz) plane. Each coordinate frame is identified by a unique, integer coordinate ID, and by a character tag indicating whether the frame is rectangular cartesian "R", cylindrical "C, or spherical "S". Because the coordinates are floating point values, the application code must declare the arrays passed to be the appropriate type "float" or "double" to match the compute word size passed in ex_create() or ex_open().

Parameters

  | exoid | exodus file id
  [in,out] | nframes | if 'cf_ids' is NULL, then nframes is returned with the number of defined coordinate frames. Else it is the number of coordinate frames to read.
  [out] | cf_ids | The (nframes) coordinate frame Ids. If cf_ids is NULL, no data will be returned in this or any other array. Only nframes will be modified. Otherwise, space must be allocated to store 'nframes' integers before making this call.
  [out] | pt_coordinates | The (9*nframes) coordinates of the three points defining each coordinate axis. The first three values are the origin of the first frame. The next three values are the coordinates of a point on the 3rd axis of the first frame. The next three values are the coordinates of a point in the plane of the 1-3 axis. The pattern is repeated for each frame. If 'cf_ids' is null, no data will be returned in this array. Otherwise, space must be allocated for 9*nframes floating point values. The size of the allocation depends upon the compute word size.
  [out] | tags | The (nframes) character tags associated with each coordinate frame. If 'cf_ids' is NULL, no data will be returned in this array. Otherwise, space must be allocated for 'nframes' characters.

Examples
  /test/testwt-one-attrib.c.

## ◆ ex_get_eb_info_global()

int ex_get_eb_info_global | ( | int | exoid,
|  | void_int * | el_blk_ids,
|  | void_int * | el_blk_cnts
| ) |  |

Examples
  /test/test_nemesis.c.

## ◆ ex_get_elem_attr()

SEACAS_DEPRECATED int ex_get_elem_attr | ( | int | exoid,
|  | ex_entity_id | elem_blk_id,
|  | void * | attrib
| ) |  |

Deprecated:
  Use ex_get_attr()(exoid, EX_ELEM_BLOCK, elem_blk_id, attrib) instead

The function ex_get_elem_attr() reads the attributes for an element block. Memory must be allocated for(num_attr x num_elem_this_blk) attributes before this routine is called.

Because the attributes are floating point values, the application code must declare the array passed to be the appropriate type (float or double) to match the compute word size passed in ex_create() or ex_open().

Returns
  In case of an error, ex_get_elem_attr() returns a negative number; a warning will return a positive number. Possible causes of errors include:
  - data file not properly opened with call to ex_create() or ex_open()
  - invalid element block ID.
  - a warning value is returned if no attributes are stored in the file.

Parameters

  [in] | exoid | exodus file ID returned from a previous call to ex_create() or ex_open().
  [in] | elem_blk_id | The element block ID.
  [out] | attrib | Size [num_elem_this_blk*num_attr]. Returned list of(num_attr x num_elem_this_blk) attributes for the element block, with the num_attr index cycling faster.

Refer to the code example in ex_get_elem_block() for an example of reading the element attributes for an element block.

## ◆ ex_get_elem_attr_names()

SEACAS_DEPRECATED int ex_get_elem_attr_names | ( | int | exoid,
|  | ex_entity_id | elem_blk_id,
|  | char ** | names
| ) |  |

reads the attribute names for an element block

Deprecated:
  Use ex_get_attr_names()(exoid, EX_ELEM_BLOCK, elem_blk_id, names) instead

## ◆ ex_get_elem_blk_ids()

SEACAS_DEPRECATED int ex_get_elem_blk_ids | ( | int | exoid,
|  | void_int * | ids
| ) |  |

Deprecated:
  Use ex_get_ids()(exoid, EX_ELEM_BLOCK, ids) instead

The function ex_get_elem_blk_ids() reads the IDs of all of the element blocks. Memory must be allocated for the returned array of ({num_elem_blk}) IDs before this function is invoked. The required size(num_elem_blk) can be determined via a call to ex_inquire() or ex_inquire_int().

Returns
  In case of an error, ex_get_elem_blk_ids() returns a negative number; a warning will return a positive number. Possible causes of errors include:
  - data file not properly opened with call to ex_create() or ex_open()

Parameters

  [in] | exoid | exodus file ID returned from a previous call to ex_create() or ex_open().
  [out] | ids | Returned array of the element blocks IDs. The order of the IDs in this array reflects the sequence that the element blocks were introduced into the file.

The following code segment reads all the element block IDs:

int error, exoid, *idelbs, num_elem_blk;
idelbs = (int *) calloc(num_elem_blk, sizeof(int));
error = ex_get_elem_blk_ids (exoid, idelbs);
/* Same result using non-deprecated functions */
error = ex_get_ids (exoid, EX_ELEM_BLOCK, idelbs);

## ◆ ex_get_elem_block()

SEACAS_DEPRECATED int ex_get_elem_block | ( | int | exoid,
|  | ex_entity_id | elem_blk_id,
|  | char * | elem_type,
|  | void_int * | num_elem_this_blk,
|  | void_int * | num_nodes_per_elem,
|  | void_int * | num_attr
| ) |  |

Deprecated:
  Use ex_get_block()(exoid, EX_ELEM_BLOCK, elem_blk_id, elem_type, num_elem_this_blk, num_nodes_per_elem, NULL, NULL, num_attr) instead

The function ex_get_elem_block() reads the parameters used to describe an element block. IDs of all element blocks stored can be determined by calling ex_get_elem_blk_ids().

Returns
  In case of an error, ex_get_elem_block() returns a negative number; a warning will return a positive number. Possible causes of errors include:
  - data file not properly opened with call to ex_create() or ex_open()
  - element block with specified ID is not stored in the data file.

Parameters

  [in] | exoid | exodus file ID returned from a previous call to ex_create() or ex_open().
  [in] | elem_blk_id | The element block ID.
  [out] | elem_type | Returned element typetype of elements in the element block. The maximum length of this string is `MAX_STR_LENGTH` .
  [out] | num_elem_this_blk | Returned number of elements in the element block.
  [out] | num_nodes_per_elem | Returned number of nodes per element in the element block.
  [out] | num_attr | Returned number of attributes per element in the element block.

As an example, the following code segment will read the parameters for the element block with an ID of 10 and read the connectivity and element attributes arrays from an open exodus file :

#include "exodusII.h"
int id, error, exoid, num_el_in_blk, num_nod_per_el, num_attr,
*connect;
float *attrib;
char elem_type[MAX_STR_LENGTH+1];
/* read element block parameters */
id = 10;
error = ex_get_elem_block(exoid, id, elem_type, &num_el_in_blk,
&num_nod_per_elem, &num_attr);
/* read element connectivity */
connect = (int *) calloc(num_nod_per_el*num_el_in_blk,
sizeof(int));
error = ex_get_elem_conn(exoid, id, connect);
/* read element block attributes */
attrib = (float *) calloc (num_attr * num_el_in_blk, sizeof(float));
error = ex_get_elem_attr (exoid, id, attrib);
/* Same result using non-deprecated functions */
error = ex_get_block(exoid, EX_ELEM_BLOCK, id, elem_type, &num_el_in_blk,
&num_nod_per_elem, 0, 0, &num_attr);
error = ex_get_conn (exoid, EX_ELEM_BLOCK, id, connect);
error = ex_get_attr (exoid, EX_ELEM_BLOCK, id, attrib);

## ◆ ex_get_elem_cmap()

int ex_get_elem_cmap | ( | int | exoid,
|  | ex_entity_id | map_id,
|  | void_int * | elem_ids,
|  | void_int * | side_ids,
|  | void_int * | proc_ids,
|  | int | processor
| ) |  |

Examples
  /test/test_nemesis.c.

## ◆ ex_get_elem_conn()

SEACAS_DEPRECATED int ex_get_elem_conn | ( | int | exoid,
|  | ex_entity_id | elem_blk_id,
|  | void_int * | connect
| ) |  |

Deprecated:
  Use ex_get_conn()(exoid, EX_ELEM_BLOCK, elem_blk_id, connect, 0, 0) instead

The function ex_get_elem_conn() reads the connectivity array for an element block. Memory must be allocated for the connectivity array (num_elem_this_blk * num_nodes_per_elem in length) before this routine is called.

Returns
  In case of an error, ex_get_elem_conn() returns a negative number; a warning will return a positive number. Possible causes of errors include:
  - an element block with the specified ID is not stored in the file.

Parameters

  [in] | exoid | exodus file ID returned from a previous call to ex_create() or ex_open().
  [in] | elem_blk_id | The element block ID.
  [out] | connect | Size [num_elem_this_blk,num_nodes_per_elem]. Returned connectivity array; a list of nodes (internal node IDs; See Section LocalNodeIds) that define each element. The node index cycles faster than the element index.

Refer to the code example in ex_get_elem_block() for an example of reading the connectivity for an element block.

## ◆ ex_get_elem_map()

SEACAS_DEPRECATED int ex_get_elem_map | ( | int | exoid,
|  | ex_entity_id | map_id,
|  | void_int * | elem_map
| ) |  |

reads the element map with specified ID

Deprecated:
  Use ex_get_num_map()(exoid, EX_ELEM_MAP, map_id, elem_map) instead

## ◆ ex_get_elem_num_map()

SEACAS_DEPRECATED int ex_get_elem_num_map | ( | int | exoid,
|  | void_int * | elem_map
| ) |  |

Deprecated:
  Use ex_get_id_map()(exoid, EX_ELEM_MAP, elem_map)

The function ex_get_elem_num_map() reads the optional element number map from the database. See Section LocalElementIds for a description of the element number map. If an element number map is not stored in the data file, a default array (1,2,3,. .. num_elem) is returned. Memory must be allocated for the element number map array ({num_elem} in length) before this call is made.

Returns
  In case of an error, ex_get_elem_num_map() returns a negative number; a warning will return a positive number. Possible causes of errors include:
  - data file not properly opened with call to ex_create() or ex_open()
  - if an element number map is not stored, a default map and a warning value are returned.

Parameters

  [in] | exoid | exodus file ID returned from a previous call to ex_create() or ex_open().
  [out] | elem_map | Returned element number map.

The following code will read an element number map from an open exodus file :

int *elem_map, error, exoid;
/* read element number map */
elem_map = (int *) calloc(num_elem, sizeof(int));
error = ex_get_elem_num_map (exoid, elem_map);
/* Equivalent using non-deprecated function */
error = ex_get_id_map(exoid, EX_ELEM_MAP, elem_map);

## ◆ ex_get_elem_type()

int ex_get_elem_type | ( | int | exoid,
|  | ex_entity_id | elem_blk_id,
|  | char * | elem_type
| ) |  |

## ◆ ex_get_elem_var()

SEACAS_DEPRECATED int ex_get_elem_var | ( | int | exoid,
|  | int | time_step,
|  | int | elem_var_index,
|  | ex_entity_id | elem_blk_id,
|  | int64_t | num_elem_this_blk,
|  | void * | elem_var_vals
| ) |  |

Deprecated:
  Use ex_get_var()(exoid, time_step, EX_ELEM_BLOCK, elem_var_index, elem_blk_id, num_elem_this_blk, elem_var_vals) instead

The function ex_get_elem_var() reads the values of a single element variable for one element block at one time step. Memory must be allocated for the element variable values array before this function is invoked.

Because element variables are floating point values, the application code must declare the array passed to be the appropriate type (float or double) to match the compute word size passed in ex_create() or ex_open().

Returns
  In case of an error, ex_get_elem_var() returns a negative number; a warning will return a positive number. Possible causes of errors include:
  - data file not properly opened with call to ex_create() or ex_open()
  - variable does not exist for the desired element block.
  - invalid element block.

Parameters

  [in] | exoid | exodus file ID returned from a previous call to ex_create() or ex_open().
  [in] | time_step | The time step number, as described under ex_put_time(), at which the element variable values are desired. This is essentially an index (in the time dimension) into the element variable values array stored in the database. The first time step is 1.
  [in] | elem_var_index | The index of the desired element variable. The first variable has an index of 1.
  [in] | elem_blk_id | The desired element block ID.
  [in] | num_elem_this_blk | The number of elements in this element block.
  [out] | elem_var_vals | Returned array of num_elem_this_blk values of the elem_var_index element variable for the element block with ID of elem_blk_id at the time_step time step.

As an example, the following code segment will read the var_index-th element variable at one time step stored in an exodus file :

int *ids, num_elem_blk, error, exoid, *num_elem_in_block,
step, var_ind;
float *var_vals;
ids = (int *) calloc(num_elem_blk, sizeof(int));
error = ex_get_elem_blk_ids (exoid, ids);
step = 1; /* read at the first time step */
for (i=0; i < num_elem_blk; i++) {
var_vals = (float *) calloc (num_elem_in_block[i], sizeof(float));
error = ex_get_elem_var (exoid, step, var_ind, ids[i],
num_elem_in_block[i], var_vals);
/* Using non-deprecated function: */
error = ex_get_var (exoid, step, EX_ELEM_BLOCK, var_ind, ids[i],
num_elem_in_block[i], var_vals);
free (var_values);
}

## ◆ ex_get_elem_var_tab()

SEACAS_DEPRECATED int ex_get_elem_var_tab | ( | int | exoid,
|  | int | num_elem_blk,
|  | int | num_elem_var,
|  | int * | elem_var_tab
| ) |  |

Deprecated:
  Use ex_get_truth_table()(exoid, EX_ELEM_BLOCK, num_elem_blk, num_elem_var, elem_var_tab)

The function ex_get_elem_var_tab() reads the exodus element variable truth table from the database. For a description of the truth table, see the usage of the function ex_put_elem_var_tab(). Memory must be allocated for the truth table(num_elem_blk x num_elem_var in length) before this function is invoked. If the truth table is not stored in the file, it will be created based on information in the file and then returned.

Returns
  In case of an error, ex_get_elem_var_tab() returns a negative number; a warning will return a positive number. Possible causes of errors include:
  - data file not properly opened with call to ex_create() or ex_open()
  - data file not initialized properly with call to ex_put_init().
  - the specified number of element blocks is different than the number specified in a call to ex_put_init().
  - there are no element variables stored in the file or the specified number of element variables doesn't match the number specified in a call to ex_put_variable_param().

Parameters

  [in] | exoid | exodus file ID returned from a previous call to ex_create() or ex_open().
  [in] | num_elem_blk | The number of element blocks.
  [in] | num_elem_var | The number of element variables.
  [out] | elem_var_tab | Size [num_elem_blk,num_elem_var]. Returned 2-dimensional array (with the num_elem_var index cycling faster) containing the element variable truth table.

As an example, the following coding will read the element variable truth table from an opened exodus file :

int *truth_tab, num_elem_blk, num_ele_vars, error, exoid;
truth_tab = (int *) calloc ((num_elem_blk*num_ele_vars),
sizeof(int));
error = ex_get_elem_var_tab (exoid, num_elem_blk, num_ele_vars,
truth_tab);

## ◆ ex_get_elem_var_time()

SEACAS_DEPRECATED int ex_get_elem_var_time | ( | int | exoid,
|  | int | elem_var_index,
|  | int64_t | elem_number,
|  | int | beg_time_step,
|  | int | end_time_step,
|  | void * | elem_var_vals
| ) |  |

Deprecated:
  Use ex_get_var_time()(exoid, EX_ELEM_BLOCK, elem_var_index, elem_number, beg_time_step, end_time_step, elem_var_vals)

The function ex_get_elem_var_time() reads the values of an element variable for a single element through a specified number of time steps. Memory must be allocated for the element variable values array before this function is invoked.

Because element variables are floating point values, the application code must declare the array passed to be the appropriate type (float or double) to match the compute word size passed in ex_create() or ex_open().

Returns
  In case of an error, ex_get_elem_var_time() returns a negative number; a warning will return a positive number. Possible causes of errors include:
  - data file not properly opened with call to ex_create() or ex_open()
  - data file not initialized properly with call to ex_put_init().
  - ex_put_elem_block() not called previously to specify parameters for all element blocks.
  - variable does not exist for the desired element or results haven't been written.

Parameters

  [in] | exoid | exodus file ID returned from a previous call to ex_create() or ex_open().
  [in] | elem_var_index | The index of the desired element variable. The first variable has an index of 1.
  [in] | elem_number | The internal ID (see Section LocalElementIds) of the desired element. The first element is 1.
  [in] | beg_time_step | The beginning time step for which an element variable value is desired. This is not a time value but rather a time step number, as described under ex_put_time(). The first time step is 1.
  [in] | end_time_step | The last time step for which an element variable value is desired. If negative, the last time step in the database will be used. The first time step is 1.
  [out] | elem_var_vals | returned array of(end_time_step {-} beg_time_step + 1) values of the elem_number-th element for the elem_var_index-th element variable.

For example, the following coding will read the values of the var_index-th element variable for element number 2 from the first time step to the last time step:

int error, exoid, num_time_steps, var_index, elem_num,
beg_time, end_time;
float *var_values;
/* determine how many time steps are stored */
num_time_steps = ex_inquire_int(exoid, EX_INQ_TIME);
/* read an element variable through time */
var_values = (float *) calloc (num_time_steps, sizeof(float));
var_index = 2;
elem_num = 2;
beg_time = 1;
end_time = -1;
error = ex_get_elem_var_time (exoid, var_index, elem_num,
beg_time, end_time, var_values);
/* Using non-deprecated function: */
error = ex_get_elem_var_time (exoid, EX_ELEM_BLOCK, var_index, elem_num,
beg_time, end_time, var_values);

## ◆ ex_get_entity_count_per_polyhedra()

int ex_get_entity_count_per_polyhedra | ( | int | exoid,
|  | ex_entity_type | blk_type,
|  | ex_entity_id | blk_id,
|  | int * | entity_counts
| ) |  |

reads in the number of entities (nodes/faces) per polyhedra (nsided/nfaced) in this element block.

Parameters

  exoid | exodus file id
  blk_type | type of block (face, or element)
  blk_id | block identifier
  entity_counts | entity_per_polyhedra count array

Examples
  /test/testrd-nfaced.c, and /test/testrd-nsided.c.

## ◆ ex_get_err()

void ex_get_err | ( | const char ** | msg,
|  | const char ** | func,
|  | int * | err_num
| ) |  |

Examples
  /test/test_ts_errval.c.

## ◆ ex_get_glob_var_time()

SEACAS_DEPRECATED int ex_get_glob_var_time | ( | int | exoid,
|  | int | glob_var_index,
|  | int | beg_time_step,
|  | int | end_time_step,
|  | void * | glob_var_vals
| ) |  |

Deprecated:
  Use ex_get_var_time()(exoid, EX_GLOBAL, global_var_index, 1, beg_time_step, end_time_step, glob_var_vals)

The function ex_get_glob_var_time() reads the values of a single global variable through a specified number of time steps. Memory must be allocated for the global variable values array before this function is invoked.

Because global variables are floating point values, the application code must declare the array passed to be the appropriate type (float or double) to match the compute word size passed in ex_create() or ex_open().

Returns
  In case of an error, ex_get_glob_var_time() returns a negative number; a warning will return a positive number. Possible causes of errors include:
  - data file not properly opened with call to ex_create() or ex_open()
  - specified global variable does not exist.
  - a warning value is returned if no global variables are stored in the file.

Parameters

  | exoid | exodus file ID returned from a previous call to ex_create() or ex_open().
  | glob_var_index | The index of the desired global variable. The first variable has an index of 1.
  | beg_time_step | The beginning time step for which a global variable value is desired. This is not a time value but rather a time step number, as described under ex_put_time(). The first time step is 1.
  | end_time_step | The last time step for which a global variable value is desired. If negative, the last time step in the database will be used. The first time step is 1.
  [out] | glob_var_vals | Returned array of (end_time_step - beg_time_step + 1) values for the glob_var_index$^{th}$ global variable.

The following is an example of using this function:

int error, exoid, num_time_steps, var_index;
int beg_time, end_time;
float *var_values;
num_time_steps = ex_inquire_int(exoid, EX_INQ_TIME);
var_index = 1;
beg_time = 1;
end_time = -1;
var_values = (float *) calloc (num_time_steps, sizeof(float));
error = ex_get_glob_var_time(exoid, var_index, beg_time,
end_time, var_values);

Examples
  /test/testrd-groups.c, and /test/testrd_par.c.

## ◆ ex_get_group_id()

int ex_get_group_id | ( | int | parent_id,
|  | const char * | group_name,
|  | int * | group_id
| ) |  |

Given an exoid and group name (NULL gets root group), return id of that group. If the name is NULL, return the root group. If the name contains "/", then the name is assumed to be a full path name and all groups in the file are searched. Otherwise, the name is assumed to be the name of a child group of exoid

## ◆ ex_get_group_ids()

int ex_get_group_ids | ( | int | parent_id,
|  | int * | num_groups,
|  | int * | group_ids
| ) |  |

Given a file or group 'parent' id, return the number of child groups and the ids of the child groups below the parent. If num_groups is NULL, do not return count; if group_ids is NULL, do not return ids.

Examples
  /test/testrd-groups.c.

## ◆ ex_get_id_map()

int ex_get_id_map | ( | int | exoid,
|  | ex_entity_type | map_type,
|  | void_int * | map
| ) |  |

Examples
  /test/rd_wt_mesh.c.

## ◆ ex_get_ids()

int ex_get_ids | ( | int | exoid,
|  | ex_entity_type | obj_type,
|  | void_int * | ids
| ) |  |

Examples
  /test/ReadEdgeFace.c, /test/testrd-groups.c, /test/testrd-long-name.c, /test/testrd-nfaced.c, /test/testrd-nsided.c, /test/testrd.c, /test/testrd1.c, /test/testrd_nc.c, /test/testrd_par.c, /test/testrd_ss.c, /test/testrdd.c, /test/testrdwt.c, and /test/testwt-one-attrib.c.

## ◆ ex_get_idx()

int ex_get_idx | ( | int | exoid,
|  | const char * | ne_var_name,
|  | int64_t * | my_index,
|  | int | pos
| ) |  |

## ◆ ex_get_info()

int ex_get_info | ( | int | exoid,
|  | char ** | info
| ) |  |

The function ex_get_info() reads information records from the database. The records are MAX_LINE_LENGTH-character strings. Memory must be allocated for the information records before this call is made. The number of records can be determined by invoking ex_inquire() or ex_inquire_int().

Returns
  In case of an error, ex_get_info() returns a negative number; a warning will return a positive number. Possible causes of errors include:
  - data file not properly opened with call to ex_create() or ex_open()
  - a warning value is returned if no information records were stored.

Parameters

  [in] | exoid | exodus file ID returned from a previous call to ex_create() or ex_open().
  [out] | info | Returned array containing the information records.

The following code segment will determine the number of information records and read them from an open exodus file :

int error, exoid, num_info;
char *info[MAXINFO];
/* read information records */
num_info = ex_inquire_int (exoid,EX_INQ_INFO);
for (i=0; i < num_info; i++) {
info[i] = (char *) calloc ((MAX_LINE_LENGTH+1), sizeof(char));
}
error = ex_get_info (exoid, info);

Examples
  /test/testrd-groups.c, /test/testrd-long-name.c, /test/testrd-nfaced.c, /test/testrd-nsided.c, /test/testrd.c, /test/testrd1.c, /test/testrd_nc.c, /test/testrd_par.c, /test/testrdd.c, and /test/testrdwt.c.

## ◆ ex_get_init()

int ex_get_init | ( | int | exoid,
|  | char * | title,
|  | void_int * | num_dim,
|  | void_int * | num_nodes,
|  | void_int * | num_elem,
|  | void_int * | num_elem_blk,
|  | void_int * | num_node_sets,
|  | void_int * | num_side_sets
| ) |  |

The function ex_get_init() reads the initializationinitialization parameters from an opened exodus file.

Returns
  In case of an error, ex_get_init() returns a negative number; a warning will return a positive number. Possible causes of errors include:
  - data file not properly opened with call to ex_create() or ex_open().

Parameters

  | exoid | exodus file ID returned from a previous call to ex_create() or ex_open().
  [out] | title | Returned database title. String length may be up to `MAX_LINE_LENGTH` bytes.
  [out] | num_dim | Returned dimensionality of the database. This is the number of coordinates per node.
  [out] | num_nodes | Returned number of nodal points.
  [out] | num_elem | Returned number of elements
  [out] | num_elem_blk | Returned number of element blocks
  [out] | num_node_sets | Returned number of node sets
  [out] | num_side_sets | Returned number of side sets

See also
  ex_get_init_ext()

The following code segment will read the initialization parameters from the open exodus file:

int num_dim, num_nodes, num_elem, num_elem_blk,
num_node_sets, num_side_sets, error, exoid;
char title[MAX_LINE_LENGTH+1];
/* read database parameters */
error = ex_get_init (exoid, title, &num_dim, &num_nodes,
&num_elem, &num_elem_blk, &num_node_sets, &num_side_sets);

Examples
  /test/rd_wt_mesh.c, /test/test-empty.c, /test/testrd-groups.c, /test/testrd-long-name.c, /test/testrd-nsided.c, /test/testrd.c, /test/testrd1.c, /test/testrd_nc.c, /test/testrd_par.c, /test/testrd_ss.c, /test/testrdd.c, /test/testrdwt.c, and /test/testwt-one-attrib.c.

## ◆ ex_get_init_ext()

int ex_get_init_ext | ( | int | exoid,
|  | ex_init_params * | info
| ) |  |

reads the initialization parameters from an opened EXODUS file

Parameters

  | exoid | exodus file id
  [out] | info | ex_init_params structure containing metadata for mesh.

See also
  ex_get_init()

Examples
  /test/ReadEdgeFace.c, and /test/testrd-nfaced.c.

## ◆ ex_get_init_global()

int ex_get_init_global | ( | int | exoid,
|  | void_int * | num_nodes_g,
|  | void_int * | num_elems_g,
|  | void_int * | num_elem_blks_g,
|  | void_int * | num_node_sets_g,
|  | void_int * | num_side_sets_g
| ) |  |

Examples
  /test/test_nemesis.c.

## ◆ ex_get_init_info()

int ex_get_init_info | ( | int | exoid,
|  | int * | num_proc,
|  | int * | num_proc_in_f,
|  | char * | ftype
| ) |  |

Examples
  /test/test_nemesis.c.

## ◆ ex_get_loadbal_param()

int ex_get_loadbal_param | ( | int | exoid,
|  | void_int * | num_int_nodes,
|  | void_int * | num_bor_nodes,
|  | void_int * | num_ext_nodes,
|  | void_int * | num_int_elems,
|  | void_int * | num_bor_elems,
|  | void_int * | num_node_cmaps,
|  | void_int * | num_elem_cmaps,
|  | int | processor
| ) |  |

Examples
  /test/test_nemesis.c.

## ◆ ex_get_map()

int ex_get_map | ( | int | exoid,
|  | void_int * | elem_map
| ) |  |

The function ex_get_map() reads the element order map from the database. If an element order map is not stored in the data file, a default array (1,2,3,. .. num_elem) is returned. Memory must be allocated for the element map array ({num_elem} in length) before this call is made.

Returns
  In case of an error, ex_get_map() returns a negative number; a warning will return a positive number. Possible causes of errors include:
  - data file not properly opened with call to ex_create() or ex_open()
  - if an element order map is not stored, a default map and a warning value are returned.

Parameters

  [in] | exoid | exodus file ID returned from a previous call to ex_create() or ex_open().
  [out] | elem_map | Returned element order map.

The following code will read an element order map from an open exodus file :

int *elem_map, error, exoid;
/* read element order map */
elem_map = (int *)calloc(num_elem, sizeof(int));
error = ex_get_map(exoid, elem_map);

Examples
  /test/testrd-groups.c, /test/testrd-long-name.c, /test/testrd-nsided.c, /test/testrd.c, /test/testrd_nc.c, /test/testrd_par.c, /test/testrdd.c, and /test/testrdwt.c.

## ◆ ex_get_map_param()

int ex_get_map_param | ( | int | exoid,
|  | int * | num_node_maps,
|  | int * | num_elem_maps
| ) |  |

Examples
  /test/testrd1.c.

## ◆ ex_get_n_attr()

SEACAS_DEPRECATED int ex_get_n_attr | ( | int | exoid,
|  | ex_entity_type | obj_type,
|  | ex_entity_id | obj_id,
|  | int64_t | start_num,
|  | int64_t | num_ent,
|  | void * | attrib
| ) |  |

Deprecated:
  Use ex_get_partial_attr()(exoid, obj_type, obj_id, start_num, num_ent, attrib) instead reads the specified attribute for a subsect of a block

Parameters

  exoid | exodus file id
  obj_type | object type (edge, face, elem block)
  obj_id | object id (edge, face, elem block ID)
  start_num | the starting index of the attributes to be returned.
  num_ent | the number of entities to read attributes for.
  attrib | array of attributes

## ◆ ex_get_n_conn()

SEACAS_DEPRECATED int ex_get_n_conn | ( | int | exoid,
|  | ex_entity_type | blk_type,
|  | ex_entity_id | blk_id,
|  | int64_t | start_num,
|  | int64_t | num_ent,
|  | void_int * | nodeconn,
|  | void_int * | edgeconn,
|  | void_int * | faceconn
| ) |  |

Deprecated:
  Use ex_get_partial_conn()(exoid, blk_type, blk_id, start_num, num_ent, nodeconn, edgeconn, faceconn) instead.

## ◆ ex_get_n_coord()

SEACAS_DEPRECATED int ex_get_n_coord | ( | int | exoid,
|  | int64_t | start_node_num,
|  | int64_t | num_nodes,
|  | void * | x_coor,
|  | void * | y_coor,
|  | void * | z_coor
| ) |  |

      \deprecated Use ex_get_partial_coord()(exoid, start_node_num, num_nodes, x_coor, y_coor,

z_coor) instead reads the coordinates of the nodes. Memory must be allocated for the coordinate arrays (x_coor, y_coor, and z_coor) before this call is made. The length of each of these arrays is the number of nodes in the mesh. Because the coordinates are floating point values, the application code must declare the arrays passed to be the appropriate type "float" or "double" to match the compute word size passed in ex_create() or ex_open()

Parameters

  | exoid | exodus file id
  | start_node_num | the starting index of the coordinates to be returned.
  | num_nodes | the number of nodes to read coordinates for.
  [out] | x_coor | Returned X coordinates of the nodes. These are returned only if x_coor is non-NULL.
  [out] | y_coor | Returned Y coordinates of the nodes. These are returned only if y_coor is non-NULL.
  [out] | z_coor | Returned Z coordinates of the nodes. These are returned only if z_coor is non-NULL.

## ◆ ex_get_n_elem_attr()

SEACAS_DEPRECATED int ex_get_n_elem_attr | ( | int | exoid,
|  | ex_entity_id | elem_blk_id,
|  | int64_t | start_elem_num,
|  | int64_t | num_elems,
|  | void * | attrib
| ) |  |

Deprecated:
  Use ex_get_partial_attr()(exoid, EX_ELEM_BLOCK, elem_blk_id, start_elem_num, num_elems, attrib) instead.

## ◆ ex_get_n_elem_conn()

SEACAS_DEPRECATED int ex_get_n_elem_conn | ( | int | exoid,
|  | ex_entity_id | elem_blk_id,
|  | int64_t | start_elem_num,
|  | int64_t | num_elems,
|  | void_int * | connect
| ) |  |

Deprecated:
  use ex_get_partial_conn()(exoid, EX_ELEM_BLOCK, elem_blk_id, start_elem_num, num_elems, connect, NULL, NULL) reads the connectivity array for an element block

## ◆ ex_get_n_elem_num_map()

SEACAS_DEPRECATED int ex_get_n_elem_num_map | ( | int | exoid,
|  | int64_t | start_ent,
|  | int64_t | num_ents,
|  | void_int * | elem_map
| ) |  |

Deprecated:
  Use ex_get_partial_id_map()(exoid, EX_ELEM_MAP, start_ent, num_ents, elem_map) instead

## ◆ ex_get_n_node_num_map()

SEACAS_DEPRECATED int ex_get_n_node_num_map | ( | int | exoid,
|  | int64_t | start_ent,
|  | int64_t | num_ents,
|  | void_int * | node_map
| ) |  |

Deprecated:
  Use ex_get_partial_id_map()(exoid, EX_NODE_MAP, start_ent, num_ents, node_map) instead

## ◆ ex_get_n_node_set()

SEACAS_DEPRECATED int ex_get_n_node_set | ( | int | exoid,
|  | ex_entity_id | node_set_id,
|  | int64_t | start_node_num,
|  | int64_t | num_nodes,
|  | void_int * | node_set_node_list
| ) |  |

Deprecated:
  Use ex_get_partial_set()(exoid, EX_NODE_SET, node_set_id, start_node_num, num_nodes, node_set_node_list, NULL) instead

## ◆ ex_get_n_node_set_df()

SEACAS_DEPRECATED int ex_get_n_node_set_df | ( | int | exoid,
|  | ex_entity_id | node_set_id,
|  | int64_t | start_num,
|  | int64_t | num_df_to_get,
|  | void * | node_set_dist_fact
| ) |  |

Deprecated:
  Use ex_get_partial_set_dist_fact()(exoid, EX_NODE_SET, node_set_id, start_num, num_df_to_get, node_set_dist_fact) instead

## ◆ ex_get_n_one_attr()

SEACAS_DEPRECATED int ex_get_n_one_attr | ( | int | exoid,
|  | ex_entity_type | obj_type,
|  | ex_entity_id | obj_id,
|  | int64_t | start_num,
|  | int64_t | num_ent,
|  | int | attrib_index,
|  | void * | attrib
| ) |  |

Deprecated:
  Use ex_get_partial_one_attr()(exoid, obj_type, obj_id, start_num, num_ent, attrib_index, attrib) instead.

reads the specified attribute for a subsect of a block

Parameters

  exoid | exodus file id
  obj_type | object type (edge, face, elem block)
  obj_id | object id (edge, face, elem block ID)
  start_num | the starting index of the attributes to be returned.
  num_ent | the number of entities to read attributes for.
  attrib_index | index of attribute to write
  attrib | array of attributes

## ◆ ex_get_n_side_set()

SEACAS_DEPRECATED int ex_get_n_side_set | ( | int | exoid,
|  | ex_entity_id | side_set_id,
|  | int64_t | start_side_num,
|  | int64_t | num_sides,
|  | void_int * | side_set_elem_list,
|  | void_int * | side_set_side_list
| ) |  |

Deprecated:
  Use ex_get_partial_side_set()(exoid, EX_SIDE_SET, side_set_id, start_side_num, num_sides, side_set_elem_list, side_set_side_list) instead

## ◆ ex_get_n_side_set_df()

SEACAS_DEPRECATED int ex_get_n_side_set_df | ( | int | exoid,
|  | ex_entity_id | side_set_id,
|  | int64_t | start_num,
|  | int64_t | num_df_to_get,
|  | void * | side_set_dist_fact
| ) |  |

Deprecated:
  Use ex_get_partial_set_dist_fact()(exoid, EX_SIDE_SET, side_set_id, start_num, num_df_to_get, side_set_dist_fact) instead

## ◆ ex_get_name()

int ex_get_name | ( | int | exoid,
|  | ex_entity_type | obj_type,
|  | ex_entity_id | entity_id,
|  | char * | name
| ) |  |

Examples
  /test/testrd-groups.c, /test/testrd-long-name.c, /test/testrd-nfaced.c, /test/testrd-nsided.c, /test/testrd.c, /test/testrd1.c, and /test/testrd_par.c.

## ◆ ex_get_names()

int ex_get_names | ( | int | exoid,
|  | ex_entity_type | obj_type,
|  | char ** | names
| ) |  |

Examples
  /test/ReadEdgeFace.c, /test/testrd-groups.c, /test/testrd-long-name.c, /test/testrd-nfaced.c, /test/testrd-nsided.c, /test/testrd.c, /test/testrd1.c, and /test/testrd_par.c.

## ◆ ex_get_nodal_var()

SEACAS_DEPRECATED int ex_get_nodal_var | ( | int | exoid,
|  | int | time_step,
|  | int | nodal_var_index,
|  | int64_t | num_nodes,
|  | void * | nodal_var_vals
| ) |  |

Deprecated:
  Use ex_get_var()(exoid, time_step, EX_NODAL, nodal_var_index, 1, num_nodes, nodal_var_vals) The function ex_get_nodal_var() reads the values of a single nodal variable for a single time step. Memory must be allocated for the nodal variable values array before this function is invoked.

Because nodal variables are floating point values, the application code must declare the array passed to be the appropriate type (float or double) to match the compute word size passed in ex_create() or ex_open().

Returns
  In case of an error, ex_get_nodal_var() returns a negative number; a warning will return a positive number. Possible causes of errors include:
  - data file not properly opened with call to ex_create() or ex_open()
  - specified nodal variable does not exist.
  - a warning value is returned if no nodal variables are stored in the file.

Parameters

  [in] | exoid | exodus file ID returned from a previous call to ex_create() or ex_open().
  [in] | time_step | The time step, as described under ex_put_time(), at which the nodal variable values are desired. This is essentially an index (in the time dimension) into the nodal variable values array stored in the database. The first time step is 1.
  [in] | nodal_var_index | The index of the desired nodal variable. The first variable has an index of 1.
  [in] | num_nodes | The number of nodal points.
  [out] | nodal_var_vals | Returned array of num_nodes values of the nodal_var_index-th nodal variable for the time_step-th time step.

For example, the following demonstrates how this function would be used:

int num_nodes, time_step, var_index;
float *var_values;
/* read the second nodal variable at the first time step */
time_step = 1;
var_index = 2;
var_values = (float *) calloc (num_nodes, sizeof(float));
error = ex_get_nodal_var(exoid, time_step, var_index, num_nodes,
var_values);

## ◆ ex_get_nodal_var_time()

SEACAS_DEPRECATED 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
| ) |  |

Deprecated:
  Use ex_get_var_time()(exoid, EX_NODAL, nodal_var_index, node_number, beg_time_step, end_time_step, node_var_vals) The function ex_get_nodal_var_time() reads the values of a nodal variable for a single node through a specified number of time steps. Memory must be allocated for the nodal variable values array before this function is invoked.

Because nodal variables are floating point values, the application code must declare the array passed to be the appropriate type (float or `‘double’') to match the compute word size passed in ex_create() or ex_open().

Returns
  In case of an error, ex_get_nodal_var_time() returns a negative number; a warning will return a positive number. Possible causes of errors include:
  - specified nodal variable does not exist.
  - a warning value is returned if no nodal variables are stored in the file.

Parameters

  [in] | exoid | exodus file ID returned from a previous call to ex_create() or ex_open().
  [in] | nodal_var_index | The index of the desired nodal variable. The first variable has an index of 1.
  [in] | node_number | The internal ID (see Section LocalNodeIds) of the desired node. The first node is 1.
  [in] | beg_time_step | The beginning time step for which a nodal variable value is desired. This is not a time value but rather a time step number, as described under ex_put_time(). The first time step is 1.
  [in] | end_time_step | The last time step for which a nodal variable value is desired. If negative, the last time step in the database will be used. The first time step is 1.
  [out] | nodal_var_vals | Returned array of(end_time_step {-} beg_time_step +1) values of the node_number-th node for the nodal_var_index-th nodal variable.

For example, the following code segment will read the values of the first nodal variable for node number one for all time steps stored in the data file:

int num_time_steps, var_index, node_num, beg_time, end_time, error, exoid;
float *var_values;
/* determine how many time steps are stored */
num_time_steps = ex_inquire_int(exoid, EX_INQ_TIME);
/* read a nodal variable through time */
var_values = (float *) calloc (num_time_steps, sizeof(float));
var_index = 1; node_num = 1; beg_time = 1; end_time = -1;
error = ex_get_var_time(exoid, EX_NODAL, var_index, node_num, beg_time,
end_time, var_values);

## ◆ ex_get_node_cmap()

int ex_get_node_cmap | ( | int | exoid,
|  | ex_entity_id | map_id,
|  | void_int * | node_ids,
|  | void_int * | proc_ids,
|  | int | processor
| ) |  |

Examples
  /test/test_nemesis.c.

## ◆ ex_get_node_map()

SEACAS_DEPRECATED int ex_get_node_map | ( | int | exoid,
|  | ex_entity_id | map_id,
|  | void_int * | node_map
| ) |  |

reads the node map with specified ID

Deprecated:
  Use ex_get_num_map()(exoid, EX_NODE_MAP, map_id, node_map

## ◆ ex_get_node_num_map()

SEACAS_DEPRECATED int ex_get_node_num_map | ( | int | exoid,
|  | void_int * | node_map
| ) |  |

Deprecated:
  Use ex_get_id_map()(exoid, EX_NODE_MAP, node_map)

The function ex_get_node_num_map() reads the optional node number mapnode number map from the database. See Section LocalNodeIds for a description of the node number map. If a node number map is not stored in the data file, a default array (1,2,3,. .. num_nodes) is returned. Memory must be allocated for the node number map array (num_nodes in length) before this call is made.

Returns
  In case of an error, ex_get_node_num_map() returns a negative number; a warning will return a positive number. Possible causes of errors include:
  - data file not properly opened with call to ex_create() or ex_open()
  - if a node number map is not stored, a default map and a warning value are returned.

Parameters

  [in] | exoid | exodus file ID returned from a previous call to ex_create() or ex_open().
  [out] | node_map | Returned node number map.

The following code will read a node number map from an open exodus file :

int *node_map, error, exoid;
/* read node number map */
node_map = (int *)calloc(num_nodes, sizeof(int));
error = ex_get_node_num_map(exoid, node_map);
/* Equivalent using non-deprecated function */
error = ex_get_id_map(exoid, EX_NODE_MAP, node_map);

## ◆ ex_get_node_set()

SEACAS_DEPRECATED int ex_get_node_set | ( | int | exoid,
|  | ex_entity_id | node_set_id,
|  | void_int * | node_set_node_list
| ) |  |

reads the node list for a single node set

Deprecated:
  Use ex_get_set()(exoid, EX_NODE_SET, node_set_id, node_set_node_list, NULL)

## ◆ ex_get_node_set_dist_fact()

SEACAS_DEPRECATED int ex_get_node_set_dist_fact | ( | int | exoid,
|  | ex_entity_id | node_set_id,
|  | void * | node_set_dist_fact
| ) |  |

Deprecated:
  Use ex_get_set_dist_fact()(exoid, EX_NODE_SET, node_set_id, node_set_dist_fact)

The function ex_get_node_set_dist_fact() returns the node set distribution factors for a single node set. Memory must be allocated for the list of distribution factors(num_dist_in_set in length) before this function is invoked.

Because the distribution factors are floating point values, the application code must declare the array passed to be the appropriate type (float or double) to match the compute word size passed in ex_create() or ex_open().

Returns
  In case of an error, ex_get_node_set_dist_fact() returns a negative number; a warning will return a positive number. Possible causes of errors include:
  - a warning value is returned if no distribution factors were stored.

Parameters

  [in] | exoid | exodus file ID returned from a previous call to ex_create() or ex_open().
  [in] | node_set_id | The node set ID.
  [out] | node_set_dist_fact | Returned array containing the distribution factors in the node set.

Refer to the description of ex_get_node_set_param() for a sample code segment to read a node set's distribution factors.

## ◆ ex_get_node_set_ids()

SEACAS_DEPRECATED int ex_get_node_set_ids | ( | int | exoid,
|  | void_int * | ids
| ) |  |

Deprecated:
  Use ex_get_ids()(exoid, EX_NODE_SET, ids)

The function ex_get_node_set_ids() reads the IDs of all of the node sets. Memory must be allocated for the returned array of ({num_node_sets}) IDs before this function is invoked.

Returns
  In case of an error, ex_get_node_set_ids() returns a negative number; a warning will return a positive number. Possible causes of errors include:
  - data file not properly opened with call to ex_create() or ex_open()
  - a warning value is returned if no node sets are stored in the file.

Parameters

  [in] | exoid | exodus file ID returned from a previous call to ex_create() or ex_open().
  [out] | ids | Returned array of the node sets IDs. The order of the IDs in this array reflects the sequence the node sets were introduced into the file.

As an example, the following code will read all of the node set IDs from an open data file:

int *ids, num_node_sets, error, exoid;
/* read node sets IDs */
ids = (int *) calloc(num_node_sets, sizeof(int));
error = ex_get_node_set_ids (exoid, ids);
/* Same result using non-deprecated functions. */
error = ex_get_ids (exoid, EX_NODE_SET, ids);

## ◆ ex_get_node_set_param()

SEACAS_DEPRECATED int ex_get_node_set_param | ( | int | exoid,
|  | ex_entity_id | node_set_id,
|  | void_int * | num_nodes_in_set,
|  | void_int * | num_df_in_set
| ) |  |

Deprecated:
  Use ex_get_set_param()(exoid, EX_NODE_SET, node_set_id, num_nodes_in_set, num_df_in_set)

The function ex_get_node_set_param() reads the number of nodes which describe a single node set and the number of distribution factors for the node set.

Returns
  In case of an error, ex_get_node_set_param() returns a negative number; a warning will return a positive number. Possible causes of errors include:
  - data file not properly opened with call to ex_create() or ex_open()
  - a warning value is returned if no node sets are stored in the file.
  - incorrect node set ID.

Parameters

  [in] | exoid | exodus file ID returned from a previous call to ex_create() or ex_open().
  [in] | node_set_id | The node set ID.
  [out] | num_nodes_in_set | Returned number of nodes in the node set.
  [out] | num_df_in_set | Returned number of distribution factors in the node set.

The following code segment will read a node set from an open exodus file :

int error, exoid, id, num_nodes_in_set, num_df_in_set, *node_list;
float *dist_fact;
/* read node set parameters */
id = 100;
error = ex_get_node_set_param(exoid, id, &num_nodes_in_set,
&num_df_in_set);
/* read node set node list */
node_list = (int *) calloc(num_nodes_in_set, sizeof(int));
error = ex_get_node_set(exoid, id, node_list);
/* read node set distribution factors */
if (num_df_in_set > 0) {
dist_fact = (float *) calloc(num_nodes_in_set, sizeof(float));
error = ex_get_node_set_dist_fact(exoid, id, dist_fact);
}
/* Same result using non-deprecated functions */
error = ex_get_set_param(exoid, EX_NODE_SET, id, &num_nodes_in_set,
&num_df_in_set);
error = ex_get_set(exoid, EX_NODE_SET, id, node_list);
if (num_df_in_set > 0) {
error = ex_get_set_dist_fact(exoid, EX_NODE_SET, id, dist_fact);
}

## ◆ ex_get_ns_param_global()

int ex_get_ns_param_global | ( | int | exoid,
|  | void_int * | global_ids,
|  | void_int * | node_cnts,
|  | void_int * | df_cnts
| ) |  |

Examples
  /test/test_nemesis.c.

## ◆ ex_get_nset_var()

SEACAS_DEPRECATED int ex_get_nset_var | ( | int | exoid,
|  | int | time_step,
|  | int | nset_var_index,
|  | ex_entity_id | nset_id,
|  | int64_t | num_node_this_nset,
|  | void * | nset_var_vals
| ) |  |

reads the values of a single nodeset variable for one nodeset at one time step in the database; assume the first time step and nodeset variable index is 1

Deprecated:
  Use ex_get_var()(exoid, time_step, EX_NODE_SET, nset_var_index, nset_id, num_node_this_nset, nset_var_vals) instead

## ◆ ex_get_nset_var_tab()

SEACAS_DEPRECATED int ex_get_nset_var_tab | ( | int | exoid,
|  | int | num_nodesets,
|  | int | num_nset_var,
|  | int * | nset_var_tab
| ) |  |

reads the EXODUS nodeset variable truth table from the database

Deprecated:
  Use ex_get_truth_table()(exoid, EX_NODE_SET, num_nodesets, num_nset_var, nset_var_tab)

## ◆ ex_get_num_map()

int ex_get_num_map | ( | int | exoid,
|  | ex_entity_type | map_type,
|  | ex_entity_id | map_id,
|  | void_int * | map
| ) |  |

Examples
  /test/ReadEdgeFace.c, and /test/testrd1.c.

## ◆ ex_get_num_props()

int ex_get_num_props | ( | int | exoid,
|  | ex_entity_type | obj_type
| ) |  |

## ◆ ex_get_object_truth_vector()

int ex_get_object_truth_vector | ( | int | exoid,
|  | ex_entity_type | obj_type,
|  | ex_entity_id | entity_id,
|  | int | num_var,
|  | int * | var_vec
| ) |  |

reads the EXODUS specified variable truth vector from the database

## ◆ ex_get_one_attr()

int ex_get_one_attr | ( | int | exoid,
|  | ex_entity_type | obj_type,
|  | ex_entity_id | obj_id,
|  | int | attrib_index,
|  | void * | attrib
| ) |  |

Examples
  /test/testrd-groups.c, /test/testrd-long-name.c, /test/testrd-nsided.c, /test/testrd.c, /test/testrd_par.c, and /test/testwt-one-attrib.c.

## ◆ ex_get_one_elem_attr()

SEACAS_DEPRECATED int ex_get_one_elem_attr | ( | int | exoid,
|  | ex_entity_id | elem_blk_id,
|  | int | attrib_index,
|  | void * | attrib
| ) |  |

reads the attributes for an element block

Deprecated:
  Use ex_get_one_attr()(exoid, EX_ELEM_BLOCK, elem_blk_id, attrib_index, attrib)

## ◆ ex_get_partial_attr()

int ex_get_partial_attr | ( | int | exoid,
|  | ex_entity_type | obj_type,
|  | ex_entity_id | obj_id,
|  | int64_t | start_num,
|  | int64_t | num_ent,
|  | void * | attrib
| ) |  |

reads the specified attribute for a subsect of a block

Parameters

  exoid | exodus file id
  obj_type | object type (edge, face, elem block)
  obj_id | object id (edge, face, elem block ID)
  start_num | the starting index of the attributes to be returned.
  num_ent | the number of entities to read attributes for.
  attrib | array of attributes

## ◆ ex_get_partial_conn()

int ex_get_partial_conn | ( | int | exoid,
|  | ex_entity_type | blk_type,
|  | ex_entity_id | blk_id,
|  | int64_t | start_num,
|  | int64_t | num_ent,
|  | void_int * | nodeconn,
|  | void_int * | edgeconn,
|  | void_int * | faceconn
| ) |  |

## ◆ ex_get_partial_coord()

int ex_get_partial_coord | ( | int | exoid,
|  | int64_t | start_node_num,
|  | int64_t | num_nodes,
|  | void * | x_coor,
|  | void * | y_coor,
|  | void * | z_coor
| ) |  |

reads the coordinates of the nodes. Memory must be allocated for the coordinate arrays (x_coor, y_coor, and z_coor) before this call is made. The length of each of these arrays is the number of nodes in the mesh. Because the coordinates are floating point values, the application code must declare the arrays passed to be the appropriate type "float" or "double" to match the compute word size passed in ex_create() or ex_open()

Parameters

  | exoid | exodus file id
  | start_node_num | the starting index of the coordinates to be returned.
  | num_nodes | the number of nodes to read coordinates for.
  [out] | x_coor | Returned X coordinates of the nodes. These are returned only if x_coor is non-NULL.
  [out] | y_coor | Returned Y coordinates of the nodes. These are returned only if y_coor is non-NULL.
  [out] | z_coor | Returned Z coordinates of the nodes. These are returned only if z_coor is non-NULL.

Examples
  /test/test_ts_partial_nvar_rd.c.

## ◆ ex_get_partial_coord_component()

int ex_get_partial_coord_component | ( | int | exoid,
|  | int64_t | start_node_num,
|  | int64_t | num_nodes,
|  | int | component,
|  | void * | coor
| ) |  |

reads the coordinates of some of the nodes in the model for the specified component Memory must be allocated for the coordinate array (coor) before this call is made. The length of the array is at least `num_nodes` Because the coordinates are floating point values, the application code must declare the array passed to be the appropriate type "float" or "double" to match the compute word size passed in ex_create() or ex_open()

Parameters

  | exoid | exodus file id
  | start_node_num | the starting index of the coordinates to be returned.
  | num_nodes | the number of nodes to read coordinates for.
  | component | which component (1=X, 2=Y, 3=Z)
  [out] | coor | Returned coordinate of the nodes for the specified component.

## ◆ ex_get_partial_elem_attr()

SEACAS_DEPRECATED int ex_get_partial_elem_attr | ( | int | exoid,
|  | ex_entity_id | elem_blk_id,
|  | int64_t | start_elem_num,
|  | int64_t | num_elems,
|  | void * | attrib
| ) |  |

Deprecated:
  use ex_get_partial_attr()(exoid, EX_ELEM_BLOCK, elem_blk_id, start_elem_num, num_elems, attrib)

## ◆ ex_get_partial_elem_conn()

SEACAS_DEPRECATED int ex_get_partial_elem_conn | ( | int | exoid,
|  | ex_entity_id | elem_blk_id,
|  | int64_t | start_elem_num,
|  | int64_t | num_elems,
|  | void_int * | connect
| ) |  |

Deprecated:
  use ex_get_partial_conn()(exoid, EX_ELEM_BLOCK, elem_blk_id, start_elem_num, num_elems, connect, NULL, NULL) reads the connectivity array for an element block

## ◆ ex_get_partial_elem_map()

SEACAS_DEPRECATED int ex_get_partial_elem_map | ( | int | exoid,
|  | ex_entity_id | map_id,
|  | int64_t | ent_start,
|  | int64_t | ent_count,
|  | void_int * | elem_map
| ) |  |

## ◆ ex_get_partial_elem_num_map()

SEACAS_DEPRECATED int ex_get_partial_elem_num_map | ( | int | exoid,
|  | int64_t | start_ent,
|  | int64_t | num_ents,
|  | void_int * | elem_map
| ) |  |

Deprecated:
  Use ex_get_partial_id_map()(exoid, EX_ELEM_MAP, start_ent, num_ents, elem_map)

## ◆ ex_get_partial_id_map()

int ex_get_partial_id_map | ( | int | exoid,
|  | ex_entity_type | map_type,
|  | int64_t | start_entity_num,
|  | int64_t | num_entities,
|  | void_int * | map
| ) |  |

## ◆ ex_get_partial_node_num_map()

SEACAS_DEPRECATED int ex_get_partial_node_num_map | ( | int | exoid,
|  | int64_t | start_ent,
|  | int64_t | num_ents,
|  | void_int * | node_map
| ) |  |

Deprecated:
  Use ex_get_partial_node_num_map()(exoid, EX_NODE_MAP, start_ent, num_ents, node_map)

## ◆ ex_get_partial_node_set()

SEACAS_DEPRECATED int ex_get_partial_node_set | ( | int | exoid,
|  | ex_entity_id | node_set_id,
|  | int64_t | start_node_num,
|  | int64_t | num_nodes,
|  | void_int * | node_set_node_list
| ) |  |

Deprecated:
  use ex_get_partial_set()(exoid, EX_NODE_SET, node_set_id, start_node_num, num_nodes, node_set_node_list, NULL)

## ◆ ex_get_partial_node_set_df()

SEACAS_DEPRECATED int ex_get_partial_node_set_df | ( | int | exoid,
|  | ex_entity_id | node_set_id,
|  | int64_t | start_num,
|  | int64_t | num_df_to_get,
|  | void * | node_set_dist_fact
| ) |  |

Deprecated:
  use ex_get_partial_set_dist_fact()(exoid, EX_NODE_SET, node_set_id, start_num, num_df_to_get, node_set_dist_fact)

## ◆ ex_get_partial_num_map()

int ex_get_partial_num_map | ( | int | exoid,
|  | ex_entity_type | map_type,
|  | ex_entity_id | map_id,
|  | int64_t | ent_start,
|  | int64_t | ent_count,
|  | void_int * | map
| ) |  |

Examples
  /test/testrd1.c.

## ◆ ex_get_partial_one_attr()

int ex_get_partial_one_attr | ( | int | exoid,
|  | ex_entity_type | obj_type,
|  | ex_entity_id | obj_id,
|  | int64_t | start_num,
|  | int64_t | num_ent,
|  | int | attrib_index,
|  | void * | attrib
| ) |  |

reads the specified attribute for a subsect of a block

Parameters

  exoid | exodus file id
  obj_type | object type (edge, face, elem block)
  obj_id | object id (edge, face, elem block ID)
  start_num | the starting index of the attributes to be returned.
  num_ent | the number of entities to read attributes for.
  attrib_index | index of attribute to write
  attrib | array of attributes

## ◆ ex_get_partial_set()

int ex_get_partial_set | ( | int | exoid,
|  | ex_entity_type | set_type,
|  | ex_entity_id | set_id,
|  | int64_t | offset,
|  | int64_t | num_to_get,
|  | void_int * | set_entry_list,
|  | void_int * | set_extra_list
| ) |  |

reads a portion of the set entry list and set extra list for a single set

Parameters

  exoid | exodus file id
  set_type | set type
  set_id | set id
  offset | index of first entry in set to access (1-based)
  num_to_get | number of entries to output.
  set_entry_list | array of entries in set. Set to NULL to not read.
  set_extra_list | array of extras in set. Set to NULL to not read.

## ◆ ex_get_partial_set_dist_fact()

int ex_get_partial_set_dist_fact | ( | int | exoid,
|  | ex_entity_type | set_type,
|  | ex_entity_id | set_id,
|  | int64_t | offset,
|  | int64_t | num_to_put,
|  | void * | set_dist_fact
| ) |  |

reads the distribution factors for a single set

## ◆ ex_get_partial_side_set()

SEACAS_DEPRECATED int ex_get_partial_side_set | ( | int | exoid,
|  | ex_entity_id | side_set_id,
|  | int64_t | start_side_num,
|  | int64_t | num_sides,
|  | void_int * | side_set_elem_list,
|  | void_int * | side_set_side_list
| ) |  |

Deprecated:
  use ex_get_partial_set()(exoid, EX_SIDE_SET, side_set_id, start_side_num, num_sides, side_set_elem_list, side_set_side_list)

## ◆ ex_get_partial_side_set_df()

SEACAS_DEPRECATED int ex_get_partial_side_set_df | ( | int | exoid,
|  | ex_entity_id | side_set_id,
|  | int64_t | start_num,
|  | int64_t | num_df_to_get,
|  | void * | side_set_dist_fact
| ) |  |

Deprecated:
  Use ex_get_partial_set_dist_fact()(exoid, EX_SIDE_SET, side_set_id, start_num, num_df_to_get, side_set_dist_fact)

## ◆ ex_get_processor_elem_maps()

int ex_get_processor_elem_maps | ( | int | exoid,
|  | void_int * | elem_mapi,
|  | void_int * | elem_mapb,
|  | int | processor
| ) |  |

Examples
  /test/test_nemesis.c.

## ◆ ex_get_processor_node_maps()

int ex_get_processor_node_maps | ( | int | exoid,
|  | void_int * | node_mapi,
|  | void_int * | node_mapb,
|  | void_int * | node_mape,
|  | int | processor
| ) |  |

Examples
  /test/test_nemesis.c.

## ◆ ex_get_prop()

int ex_get_prop | ( | int | exoid,
|  | ex_entity_type | obj_type,
|  | ex_entity_id | obj_id,
|  | const char * | prop_name,
|  | void_int * | value
| ) |  |

The function ex_get_prop() reads an integer object property value stored for a single element block, node set, or side set.

Returns
  In case of an error, ex_get_prop() returns a negative number; a warning will return a positive number. Possible causes of errors include:
  - data file not properly opened with call to ex_create() or ex_open()
  - invalid object type specified.
  - a warning value is returned if a property with the specified name is not found.

Parameters

  [in] | exoid | exodus file ID returned from a previous call to ex_create() or ex_open().
  [in] | obj_type | Type of object; use one of the options in the table below.
  [in] | obj_id | The element block, node set, or side set ID.
  [in] | prop_name | The name of the property (maximum length is `MAX_STR_LENGTH` ) for which the value is desired.
  [out] | value | Returned value of the property.

ex_entity_type | description
--- | ---
EX_NODE_SET | Node Set entity type
EX_EDGE_BLOCK | Edge Block entity type
EX_EDGE_SET | Edge Set entity type
EX_FACE_BLOCK | Face Block entity type
EX_FACE_SET | Face Set entity type
EX_ELEM_BLOCK | Element Block entity type
EX_ELEM_SET | Element Set entity type
EX_SIDE_SET | Side Set entity type
EX_ELEM_MAP | Element Map entity type
EX_NODE_MAP | Node Map entity type
EX_EDGE_MAP | Edge Map entity type
EX_FACE_MAP | Face Map entity type

For an example of code to read an object property, refer to the description for ex_get_prop_names().

Examples
  /test/testrd-groups.c, /test/testrd-long-name.c, /test/testrd-nsided.c, /test/testrd.c, /test/testrd1.c, /test/testrd_nc.c, /test/testrd_par.c, /test/testrdd.c, and /test/testrdwt.c.

## ◆ ex_get_prop_array()

int ex_get_prop_array | ( | int | exoid,
|  | ex_entity_type | obj_type,
|  | const char * | prop_name,
|  | void_int * | values
| ) |  |

The function ex_get_prop_array() reads an array of integer property values for all element blocks, node sets, or side sets. The order of the values in the array correspond to the order in which the element blocks, node sets, or side sets were introduced into the file. Before this function is invoked, memory must be allocated for the returned array of(num_elem_blk, num_node_sets, or {num_side_sets}) integer values.

This function can be used in place of

- ex_get_elem_blk_ids(),
- ex_get_node_set_ids(), and
- ex_get_side_set_ids() to get element block, node set, and side set IDs, respectively, by requesting the property name ID. One should also note that this same function can be accomplished with multiple calls to ex_get_prop().

Returns
  In case of an error, ex_get_prop_array() returns a negative number; a warning will return a positive number. Possible causes of errors include:
  - data file not properly opened with call to ex_create() or ex_open()
  - invalid object type specified.
  - a warning value is returned if a property with the specified name is not found.

Parameters

  [in] | exoid | exodus file ID returned from a previous call to ex_create() or ex_open().
  [in] | obj_type | Type of object; use one of the options in the table below.
  [in] | prop_name | The name of the property (maximum length of `MAX_STR_LENGTH` ) for which the values are desired.
  [out] | values | Returned array of property values.

ex_entity_type | description
--- | ---
EX_NODE_SET | Node Set entity type
EX_EDGE_BLOCK | Edge Block entity type
EX_EDGE_SET | Edge Set entity type
EX_FACE_BLOCK | Face Block entity type
EX_FACE_SET | Face Set entity type
EX_ELEM_BLOCK | Element Block entity type
EX_ELEM_SET | Element Set entity type
EX_SIDE_SET | Side Set entity type
EX_ELEM_MAP | Element Map entity type
EX_NODE_MAP | Node Map entity type
EX_EDGE_MAP | Edge Map entity type
EX_FACE_MAP | Face Map entity type

For an example of code to read an array of object properties, refer to the description for ex_get_prop_names().

Examples
  /test/testrd-groups.c, /test/testrd-long-name.c, /test/testrd-nsided.c, /test/testrd.c, /test/testrd1.c, /test/testrd_nc.c, /test/testrd_par.c, /test/testrdd.c, and /test/testrdwt.c.

## ◆ ex_get_prop_names()

int ex_get_prop_names | ( | int | exoid,
|  | ex_entity_type | obj_type,
|  | char ** | prop_names
| ) |  |

The function ex_get_prop_names() returns names of integer properties stored for an element block, node set, or side set. The number of properties (needed to allocate space for the property names) can be obtained via a call to ex_inquire() or ex_inquire_int().

Returns
  In case of an error, ex_get_prop_names() returns a negative number; a warning will return a positive number. Possible causes of errors include:
  - data file not properly opened with call to ex_create() or ex_open()
  - invalid object type specified.

Parameters

  [in] | exoid | exodus file ID returned from a previous call to ex_create() or ex_open().
  [in] | obj_type | Type of object; use one of the options in the table below.
  [out] | prop_names | Returned array containing num_props (obtained from call to ex_inquire() or ex_inquire_int()) names (of maximum length `MAX_STR_LENGTH` ) of properties to be stored. ID, a reserved property name, will be the first name in the array.

ex_entity_type | description
--- | ---
EX_NODE_SET | Node Set entity type
EX_EDGE_BLOCK | Edge Block entity type
EX_EDGE_SET | Edge Set entity type
EX_FACE_BLOCK | Face Block entity type
EX_FACE_SET | Face Set entity type
EX_ELEM_BLOCK | Element Block entity type
EX_ELEM_SET | Element Set entity type
EX_SIDE_SET | Side Set entity type
EX_ELEM_MAP | Element Map entity type
EX_NODE_MAP | Node Map entity type
EX_EDGE_MAP | Edge Map entity type
EX_FACE_MAP | Face Map entity type

As an example, the following code segment reads in properties assigned to node sets:

int error, exoid, num_props, *prop_values;
char *prop_names[MAX_PROPS];
/* read node set properties */
num_props = ex_inquire_int(exoid, EX_INQ_NS_PROP);
for (i=0; i < num_props; i++) {
prop_names[i] = (char *) malloc ((MAX_STR_LENGTH+1), sizeof(char));
prop_values = (int *) malloc (num_node_sets, sizeof(int));
}
error = ex_get_prop_names(exoid,EX_NODE_SET,prop_names);
for (i=0; i < num_props; i++) {
error = ex_get_prop_array(exoid, EX_NODE_SET, prop_names[i],
prop_values);
}

Examples
  /test/testrd-groups.c, /test/testrd-long-name.c, /test/testrd-nsided.c, /test/testrd.c, /test/testrd1.c, /test/testrd_nc.c, /test/testrd_par.c, /test/testrdd.c, and /test/testrdwt.c.

## ◆ ex_get_qa()

int ex_get_qa | ( | int | exoid,
|  | char * | qa_record[][4]
| ) |  |

The function ex_get_qa() reads the QA records from the database. Each QA record contains four MAX_STR_LENGTH-byte character strings. The character strings are:

- the analysis code name
- the analysis code QA descriptor
- the analysis date
- the analysis time

Memory must be allocated for the QA records before this call is made. The number of QA records can be determined by invoking ex_inquire().

Returns
  In case of an error, ex_get_qa() returns a negative number; a warning will return a positive number. Possible causes of errors include:
  - data file not properly opened with call to ex_create() or ex_open()
  - a warning value is returned if no QA records were stored.

Parameters

  [in] | exoid | exodus file ID returned from a previous call to ex_create() or ex_open().
  [out] | qa_record | Returned array containing the QA records.

The following will determine the number of QA records and read them from the open exodus file:

int num_qa_rec, error, exoid
char *qa_record[MAX_QA_REC][4];
/* read QA records */
num_qa_rec = ex_inquire_int(exoid, EX_INQ_QA);
for (i=0; i<num_qa_rec; i++) {
for (j=0; j<4; j++)
qa_record[i][j] = (char *) calloc ((MAX_STR_LENGTH+1), sizeof(char));
}
error = ex_get_qa (exoid, qa_record);

Examples
  /test/testrd-groups.c, /test/testrd-long-name.c, /test/testrd-nfaced.c, /test/testrd-nsided.c, /test/testrd.c, /test/testrd1.c, /test/testrd_nc.c, /test/testrd_par.c, /test/testrdd.c, and /test/testrdwt.c.

## ◆ ex_get_set()

int ex_get_set | ( | int | exoid,
|  | ex_entity_type | set_type,
|  | ex_entity_id | set_id,
|  | void_int * | set_entry_list,
|  | void_int * | set_extra_list
| ) |  |

reads the set entry list and set extra list for a single set

Parameters

  exoid | exodus file id
  set_type | set type
  set_id | set id
  *set_entry_list | array of entries in set. Set to NULL to not read.
  *set_extra_list | array of extras in set. Set to NULL to not read.

Examples
  /test/ReadEdgeFace.c, /test/testrd-groups.c, /test/testrd-long-name.c, /test/testrd-nsided.c, /test/testrd.c, /test/testrd1.c, /test/testrd_nc.c, /test/testrd_par.c, /test/testrd_ss.c, /test/testrdd.c, and /test/testrdwt.c.

## ◆ ex_get_set_dist_fact()

int ex_get_set_dist_fact | ( | int | exoid,
|  | ex_entity_type | set_type,
|  | ex_entity_id | set_id,
|  | void * | set_dist_fact
| ) |  |

reads the distribution factors for a single set

Examples
  /test/ReadEdgeFace.c, /test/testrd-groups.c, /test/testrd-long-name.c, /test/testrd-nsided.c, /test/testrd.c, /test/testrd1.c, /test/testrd_nc.c, /test/testrd_par.c, /test/testrd_ss.c, /test/testrdd.c, and /test/testrdwt.c.

## ◆ ex_get_set_param()

int ex_get_set_param | ( | int | exoid,
|  | ex_entity_type | set_type,
|  | ex_entity_id | set_id,
|  | void_int * | num_entry_in_set,
|  | void_int * | num_dist_fact_in_set
| ) |  |

Examples
  /test/ReadEdgeFace.c, /test/testrd-groups.c, /test/testrd-long-name.c, /test/testrd-nsided.c, /test/testrd.c, /test/testrd1.c, /test/testrd_nc.c, /test/testrd_par.c, /test/testrd_ss.c, /test/testrdd.c, and /test/testrdwt.c.

## ◆ ex_get_sets()

int ex_get_sets | ( | int | exoid,
|  | size_t | set_count,
|  | struct ex_set * | sets
| ) |  |

## ◆ ex_get_side_set()

SEACAS_DEPRECATED int ex_get_side_set | ( | int | exoid,
|  | ex_entity_id | side_set_id,
|  | void_int * | side_set_elem_list,
|  | void_int * | side_set_side_list
| ) |  |

reads the side set element list and side set side list for a single side set

Deprecated:
  Use ex_get_set()(exoid, EX_SIDE_SET, side_set_id, side_set_elem_list, side_set_side_list)

## ◆ ex_get_side_set_dist_fact()

SEACAS_DEPRECATED int ex_get_side_set_dist_fact | ( | int | exoid,
|  | ex_entity_id | side_set_id,
|  | void * | side_set_dist_fact
| ) |  |

reads the distribution factors for a single side set

Deprecated:
  Use ex_get_set_dist_fact()(exoid, EX_SIDE_SET, side_set_id, side_set_dist_fact)

## ◆ ex_get_side_set_ids()

SEACAS_DEPRECATED int ex_get_side_set_ids | ( | int | exoid,
|  | void_int * | ids
| ) |  |

reads the side set ids from the database

Deprecated:
  Use ex_get_ids()(exoid, EX_SIDE_SET, ids)

## ◆ ex_get_side_set_node_count()

int ex_get_side_set_node_count | ( | int | exoid,
|  | ex_entity_id | side_set_id,
|  | int * | side_set_node_cnt_list
| ) |  |

## ◆ ex_get_side_set_node_list()

int ex_get_side_set_node_list | ( | int | exoid,
|  | ex_entity_id | side_set_id,
|  | void_int * | side_set_node_cnt_list,
|  | void_int * | side_set_node_list
| ) |  |

Examples
  /test/testrd-groups.c, /test/testrd-long-name.c, /test/testrd.c, /test/testrd1.c, /test/testrd_nc.c, /test/testrd_par.c, /test/testrd_ss.c, /test/testrdd.c, and /test/testrdwt.c.

## ◆ ex_get_side_set_node_list_len()

int ex_get_side_set_node_list_len | ( | int | exoid,
|  | ex_entity_id | side_set_id,
|  | void_int * | side_set_node_list_len
| ) |  |

This routine is designed to read the Exodus II V 2.0 side set side definition and return the length of a ExodusI style side set node list.

Parameters

  | exoid | exodus file id
  | side_set_id | side set id
  [out] | *side_set_node_list_len | length of node list

## ◆ ex_get_side_set_param()

SEACAS_DEPRECATED int ex_get_side_set_param | ( | int | exoid,
|  | ex_entity_id | side_set_id,
|  | void_int * | num_side_in_set,
|  | void_int * | num_dist_fact_in_set
| ) |  |

reads the number of sides and the number of distribution factors which describe a single side set

Parameters

  | exoid | exodus file id
  | side_set_id | side set id
  [out] | num_side_in_set | number of sides in the side set
  [out] | num_dist_fact_in_set | number of distribution factors in the

Deprecated:
  Use ex_get_set_param()(exoid, EX_SIDE_SET, side_set_id, num_side_in_set, num_dist_fact_in_set)

## ◆ ex_get_ss_param_global()

int ex_get_ss_param_global | ( | int | exoid,
|  | void_int * | global_ids,
|  | void_int * | side_cnts,
|  | void_int * | df_cnts
| ) |  |

Examples
  /test/test_nemesis.c.

## ◆ ex_get_sset_var()

SEACAS_DEPRECATED int ex_get_sset_var | ( | int | exoid,
|  | int | time_step,
|  | int | sset_var_index,
|  | ex_entity_id | sset_id,
|  | int64_t | num_side_this_sset,
|  | void * | sset_var_vals
| ) |  |

reads the values of a single sideset variable for one sideset at one time step in the database; assume the first time step and sideset variable index is 1

Deprecated:
  Use ex_get_var()(exoid, time_step, EX_SIDE_SET, sset_var_index, sset_id, num_side_this_sset, sset_var_vals) instead

## ◆ ex_get_sset_var_tab()

SEACAS_DEPRECATED int ex_get_sset_var_tab | ( | int | exoid,
|  | int | num_sidesets,
|  | int | num_sset_var,
|  | int * | sset_var_tab
| ) |  |

reads the EXODUS sideset variable truth table from the database

Deprecated:
  Use ex_get_truth_table()(exoid, EX_SIDE_SET, num_sidesets, num_sset_var, sset_var_tab)

## ◆ ex_get_time()

int ex_get_time | ( | int | exoid,
|  | int | time_step,
|  | void * | time_value
| ) |  |

The function ex_get_time() reads the time value for a specified time step.

Because time values are floating point values, the application code must declare the array passed to be the appropriate type (float or double) to match the compute word size passed in ex_create() or ex_open().

Returns
  In case of an error, ex_get_time() returns a negative number; a warning will return a positive number. Possible causes of errors include:
  - data file not properly opened with call to ex_create() or ex_open()
  - no time steps have been stored in the file.

Parameters

  [in] | exoid | exodus file ID returned from a previous call to ex_create() or ex_open().
  [in] | time_step | The time step number. This is essentially an index (in the time dimension) into the global, nodal, and element variables arrays stored in the database. The first time step is 1.
  [out] | time_value | Returned time at the specified time step.

As an example, the following coding will read the time value stored in the data file for time step n:

int n, error, exoid;
float time_value;
/* read time value at time step 3 */
n = 3;
error = ex_get_time (exoid, n, &time_value);

Examples
  /test/testrd-groups.c, /test/testrd-long-name.c, /test/testrd-nsided.c, /test/testrd.c, /test/testrd1.c, /test/testrd_nc.c, /test/testrd_par.c, and /test/testrdd.c.

## ◆ ex_header_size()

size_t ex_header_size | ( | int | exoid | ) |

## ◆ ex_inquire()

int ex_inquire | ( | int | exoid,
|  | int | req_info,
|  | void_int * | ret_int,
|  | float * | ret_float,
|  | char * | ret_char
| ) |  |

The function ex_inquire() is used to inquire values of certain data entities in an exodus file. Memory must be allocated for the returned values before this function is invoked.query database.

See also
  ex_inquire_int().

Returns
  In case of an error, ex_inquire() returns a negative number; a warning will return a positive number. Possible causes of errors include:
  - data file not properly opened with call to ex_create() or ex_open().
  - requested information not stored in the file.
  - invalid request flag.

Parameters

  [in] | exoid | exodus file ID returned from a previous call to ex_create() or ex_open().
  [in] | req_info | A flag which designates what information is requested. It must be one of the following constants in the table below.
  [out] | ret_int | Returned integer, if an integer value is requested (according to req_info); otherwise, supply a dummy argument.
  [out] | ret_float | Returned float, if a float value is requested (according to req_info); otherwise, supply a dummy argument. This argument is always a float even if the database IO and/or CPU word size is a double.
  [out] | ret_char | Returned character string, if a character value is requested (according to req_info); otherwise, supply a dummy argument.

EX_INQ_API_VERS | The exodus API version number is returned in ret_float and an undotted version number is returned in ret_int. The API version number reflects the release of the function library (i.e., function names, argument list, etc.). The API and LIB version numbers are synchronized and will always match. Initially, it was thought that maintaining the two versions separately would be a benefit, but that was more confusing than helpful, so the numbers were made the same.
EX_INQ_DB_VERS | The exodus database version number is returned in ret_float and an `‘undotted’' version number is returned in ret_int. The database version number reflects the version of the library that was used to write the file pointed to by exoid.
EX_INQ_LIB_VERS | The exodus library version number is returned in ret_float and an undotted version number is returned in ret_int. The API library version number reflects the version number of the exodus library linked with this application.
EX_INQ_TITLE | The title stored in the database is returned in ret_char.
EX_INQ_DIM | The dimensionality, or number of coordinates per node (1, 2 or 3), of the database is returned in ret_int.
EX_INQ_NODES | The number of nodes is returned in ret_int.
EX_INQ_ELEM | The number of elements is returned in ret_int.
EX_INQ_ELEM_BLK | The number of element blocks is returned in ret_int.
EX_INQ_NODE_SETS | The number of node sets is returned in ret_int.
EX_INQ_NS_NODE_LEN | The length of the concatenated node sets node list is returned in ret_int.
EX_INQ_NS_DF_LEN | The length of the concatenated node sets distribution list is returned in ret_int.
EX_INQ_SIDE_SETS | The number of side sets is returned in ret_int.
EX_INQ_SS_ELEM_LEN | The length of the concatenated side sets element list is returned in ret_int.
EX_INQ_SS_DF_LEN | The length of the concatenated side sets distribution factor list is returned in ret_int.
EX_INQ_SS_NODE_LEN | The aggregate length of all of the side sets node lists is returned in ret_int.
EX_INQ_EB_PROP | The number of integer properties stored for each element block is returned in ret_int; this number includes the property named ID.
EX_INQ_NS_PROP | The number of integer properties stored for each node set is returned in ret_int; this number includes the property named ID.
EX_INQ_SS_PROP | The number of integer properties stored for each side set is returned in ret_int; this number includes the property named ID.
EX_INQ_QA | The number of QA records is returned in ret_int.
EX_INQ_INFO | The number of information records is returned in ret_int.
EX_INQ_TIME | The number of time steps stored in the database is returned in ret_int.
EX_INQ_EDGE_BLK | The number of edge blocks is returned in ret_int.
EX_INQ_EDGE_MAP | The number of edge maps is returned in ret_int.
EX_INQ_EDGE_PROP | The number of properties stored per edge blockis returned in ret_int.
EX_INQ_EDGE_SETS | The number of edge sets is returned in ret_int.
EX_INQ_EDGE | The number of edges is returned in ret_int.
EX_INQ_FACE | The number of faces is returned in ret_int.
EX_INQ_EB_PROP | The number of element block properties is returned in ret_int.
EX_INQ_ELEM_MAP | The number of element maps is returned in ret_int.
EX_INQ_ELEM_SETS | The number of element sets is returned in ret_int.
EX_INQ_ELS_DF_LEN | The length of the concatenated element set distribution factor list is returned in ret_int.
EX_INQ_ELS_LEN | The length of the concatenated element set element list is returned in ret_int.
EX_INQ_ELS_PROP | The number of properties stored per elem set is returned in ret_int.
EX_INQ_EM_PROP | The number of element map properties is returned in ret_int.
EX_INQ_ES_DF_LEN | The length of the concatenated edge set distribution factor list is returned in ret_int.
EX_INQ_ES_LEN | The length of the concatenated edge set edge list is returned in ret_int.
EX_INQ_ES_PROP | The number of properties stored per edge set is returned in ret_int.
EX_INQ_FACE_BLK | The number of face blocks is returned in ret_int.
EX_INQ_FACE_MAP | The number of face maps is returned in ret_int.
EX_INQ_FACE_PROP | The number of properties stored per face block is returned in ret_int.
EX_INQ_FACE_SETS | The number of face sets is returned in ret_int.
EX_INQ_FS_DF_LEN | The length of the concatenated face set distribution factor list is returned in ret_int.
EX_INQ_FS_LEN | The length of the concatenated face set face list is returned in ret_int.
EX_INQ_FS_PROP | The number of properties stored per face set is returned in ret_int.
EX_INQ_NM_PROP | The number of node map properties is returned in ret_int.
EX_INQ_NODE_MAP | The number of node maps is returned in ret_int.
EX_INQ_COORD_FRAMES | The number of coordinate frames is returned in ret_int.

As an example, the following will return the number of element block properties stored in the exodus file :

#include "exodusII.h"
int error, exoid, num_props;
float fdum;
char *cdum;
/* determine the number of element block properties */
error = ex_inquire (exoid, EX_INQ_EB_PROP, &num_props,
&fdum, cdum);
/* ...Another way to get the same information */
num_props = ex_inquire_int(exoid, EX_INQ_EB_PROP);

Examples
  /test/ReadEdgeFace.c, /test/testcp.c, /test/testcp_nl.c, /test/testcpd.c, /test/testrd-groups.c, /test/testrd-long-name.c, /test/testrd-nfaced.c, /test/testrd-nsided.c, /test/testrd.c, /test/testrd1.c, /test/testrd_nc.c, /test/testrd_par.c, /test/testrd_ss.c, /test/testrdd.c, and /test/testrdwt.c.

## ◆ ex_inquire_int()

int64_t ex_inquire_int | ( | int | exoid,
|  | int | req_info
| ) |  |

A variant of ex_inquire() which queries integer-valued information only.

See also
  ex_inquire().

Parameters

  [in] | exoid | exodus file ID returned from a previous call to ex_create() or ex_open().
  [in] | req_info | A flag which designates what information is requested. (See ex_inquire() documentation)

Returns
  result of inquiry.

As an example, the following will return the number of nodes, elements, and element blocks stored in the exodus file :

#include "exodusII.h"
int exoid;
int num_nodes = ex_inquire_int(exoid, EX_INQ_NODES);
int num_elems = ex_inquire_int(exoid, EX_INQ_ELEM);
int num_block = ex_inquire_int(exoid, EX_INQ_ELEM_BLK);

Examples
  /test/rd_wt_mesh.c, /test/ReadEdgeFace.c, /test/test_ts_nvar.c, /test/test_ts_nvar_rd.c, /test/test_ts_partial_nvar.c, /test/test_ts_partial_nvar_rd.c, /test/testrd-groups.c, /test/testrd-long-name.c, and /test/testwt-one-attrib.c.

## ◆ ex_int64_status()

int ex_int64_status | ( | int | exoid | ) |

## ◆ ex_large_model()

int ex_large_model | ( | int | exoid | ) |

Determine whether the new large model storage is being used in this file, or old method. Basically, the difference is whether the coordinates and nodal variables are stored in a blob (xyz components together) or as a variable per component per nodal_variable.

## ◆ ex_name_of_object()

char* ex_name_of_object | ( | ex_entity_type | obj_type | ) |

## ◆ ex_open_int()

int ex_open_int | ( | const char * | path,
|  | int | mode,
|  | int * | comp_ws,
|  | int * | io_ws,
|  | float * | version,
|  | int | run_version
| ) |  |

## ◆ ex_opts()

int ex_opts | ( | int | options | ) |

The function ex_opts() is used to set message reporting options.

Returns
  Returns previous value for the message reporting option.

Parameters

  [in] | options | Integer option value. Current options are shown in the table below.

EX_ABORT | Causes fatal errors to force program exit. (Default is false.)
EX_DEBUG | Causes certain messages to print for debug use. (Default is false.)
EX_VERBOSE | Causes all error messages to print when true, otherwise no error messages will print. (Default is false.)

Note
  Values may be OR'ed together to provide any combination of these capabilities.

For example, the following will cause all messages to print and will cause the program to exit upon receipt of fatal error:

#include "exodusII.h"
ex_opts(EX_ABORT|EX_VERBOSE);

Examples
  /test/create_mesh.c, /test/CreateEdgeFace.c, /test/ExoIICTests.cxx, /test/rd_wt_mesh.c, /test/test-empty.c, /test/test_ts_files.c, /test/test_ts_nvar_rd.c, /test/test_ts_partial_nvar.c, /test/test_ts_partial_nvar_rd.c, /test/testcp.c, /test/testcp_nl.c, /test/testcpd.c, /test/testrd-groups.c, /test/testrd-long-name.c, /test/testrd-nfaced.c, /test/testrd-nsided.c, /test/testrd.c, /test/testrd1.c, /test/testrd_nc.c, /test/testrd_par.c, /test/testrd_ss.c, /test/testrdd.c, /test/testrdwt.c, /test/testwt-compress.c, /test/testwt-groups.c, /test/testwt-localization.C, /test/testwt-long-name.c, /test/testwt-nface-nside.c, /test/testwt-nfaced.c, /test/testwt-nsided.c, /test/testwt-one-attrib.c, /test/testwt-oned.c, /test/testwt-partial.c, /test/testwt-zeroe.c, /test/testwt-zeron.c, /test/testwt.c, /test/testwt1.c, /test/testwt2.c, /test/testwt_clb.c, /test/testwt_nc.c, /test/testwt_nossnsdf.c, /test/testwt_ss.c, /test/testwtd.c, /test/testwtm.c, and /test/twod.c.

## ◆ ex_print_config()

void ex_print_config | ( | void |  | ) |

## ◆ ex_put_all_var_param()

int ex_put_all_var_param | ( | int | exoid,
|  | int | num_g,
|  | int | num_n,
|  | int | num_e,
|  | int * | elem_var_tab,
|  | int | num_m,
|  | int * | nset_var_tab,
|  | int | num_s,
|  | int * | sset_var_tab
| ) |  |

defines the number of global, nodal, element, nodeset, and sideset variables that will be written to the database

Parameters

  exoid | exodus file id
  num_g | global variable count
  num_n | nodal variable count
  num_e | element variable count
  *elem_var_tab | element variable truth table array
  num_m | nodeset variable count
  *nset_var_tab | nodeset variable truth table array
  num_s | sideset variable count
  *sset_var_tab | sideset variable truth table array

Examples
  /test/create_mesh.c, /test/rd_wt_mesh.c, and /test/testwt_clb.c.

## ◆ ex_put_all_var_param_ext()

int ex_put_all_var_param_ext | ( | int | exoid,
|  | const ex_var_params * | vp
| ) |  |

writes the number of global, nodal, element, nodeset, and sideset variables that will be written to the database

Parameters

  exoid | exodus file id
  *vp | pointer to variable parameter info

Examples
  /test/CreateEdgeFace.c.

## ◆ ex_put_attr()

int ex_put_attr | ( | int | exoid,
|  | ex_entity_type | blk_type,
|  | ex_entity_id | blk_id,
|  | const void * | attrib
| ) |  |

writes the attributes for an edge/face/element block

Parameters

  exoid | exodus file id
  blk_type | block type
  blk_id | block id
  attrib | array of attributes

Examples
  /test/CreateEdgeFace.c, /test/test_ts_files.c, /test/testrdwt.c, /test/testwt-compress.c, /test/testwt-groups.c, /test/testwt-long-name.c, /test/testwt-nsided.c, /test/testwt-one-attrib.c, /test/testwt-oned.c, /test/testwt-partial.c, /test/testwt.c, /test/testwt1.c, /test/testwt2.c, /test/testwt_clb.c, /test/testwt_nc.c, /test/testwt_nossnsdf.c, /test/testwt_ss.c, /test/testwtd.c, /test/testwtm.c, and /test/twod.c.

## ◆ ex_put_attr_names()

int ex_put_attr_names | ( | int | exoid,
|  | ex_entity_type | blk_type,
|  | ex_entity_id | blk_id,
|  | char ** | names
| ) |  |

Examples
  /test/CreateEdgeFace.c, /test/test_ts_files.c, /test/testwt-compress.c, /test/testwt-groups.c, /test/testwt-long-name.c, /test/testwt-nsided.c, /test/testwt-oned.c, /test/testwt-partial.c, /test/testwt.c, /test/testwt_nc.c, and /test/twod.c.

## ◆ ex_put_attr_param()

int ex_put_attr_param | ( | int | exoid,
|  | ex_entity_type | obj_type,
|  | ex_entity_id | obj_id,
|  | int | num_attrs
| ) |  |

defines the number of attributes.

Parameters

  exoid | exodus file id
  obj_type | block/set type (node, edge, face, elem)
  obj_id | block/set id (ignored for NODAL)
  num_attrs | number of attributes

Examples
  /test/test_ts_files.c, /test/testwt-compress.c, /test/testwt-groups.c, /test/testwt-long-name.c, /test/testwt-nsided.c, /test/testwt-oned.c, /test/testwt-partial.c, /test/testwt.c, and /test/testwt_nc.c.

## ◆ ex_put_block()

int ex_put_block | ( | int | exoid,
|  | ex_entity_type | blk_type,
|  | ex_entity_id | blk_id,
|  | const char * | entry_descrip,
|  | int64_t | num_entries_this_blk,
|  | int64_t | num_nodes_per_entry,
|  | int64_t | num_edges_per_entry,
|  | int64_t | num_faces_per_entry,
|  | int64_t | num_attr_per_entry
| ) |  |

writes the parameters used to describe an element/face/edge block

Parameters

  exoid | exodus file id
  blk_type | type of block (edge, face, or element)
  blk_id | block identifier
  entry_descrip | string describing shape of entries in the block
  num_entries_this_blk | number of entries(records) in the block
  num_nodes_per_entry | number of nodes per block entry
  num_edges_per_entry | number of edges per block entry
  num_faces_per_entry | number of faces per block entry
  num_attr_per_entry | number of attributes per block entry

Examples
  /test/create_mesh.c, /test/rd_wt_mesh.c, /test/testrdwt.c, /test/testwt-groups.c, /test/testwt-long-name.c, /test/testwt-nface-nside.c, /test/testwt-nfaced.c, /test/testwt-nsided.c, /test/testwt-one-attrib.c, /test/testwt-oned.c, /test/testwt-partial.c, /test/testwt1.c, /test/testwt2.c, /test/testwt_nc.c, /test/testwt_nossnsdf.c, /test/testwt_ss.c, /test/testwtd.c, /test/testwtm.c, and /test/twod.c.

## ◆ ex_put_block_param()

int ex_put_block_param | ( | int | exoid,
|  | const ex_block | block
| ) |  |

writes the parameters used to describe an element/face/edge block

Parameters

  exoid | exodus file id
  block | ex_block structure describing block counts

Examples
  /test/CreateEdgeFace.c.

## ◆ ex_put_block_params()

int ex_put_block_params | ( | int | exoid,
|  | size_t | block_count,
|  | const struct ex_block * | blocks
| ) |  |

writes the parameters used to describe an element/face/edge block

Parameters

  exoid | exodus file id
  block_count | number of blocks being defined
  blocks | array of ex_block structures describing block counts

Examples
  /test/test_ts_files.c, /test/testwt-compress.c, /test/testwt-localization.C, and /test/testwt.c.

## ◆ ex_put_cmap_params()

int ex_put_cmap_params | ( | int | exoid,
|  | void_int * | node_cmap_ids,
|  | void_int * | node_cmap_node_cnts,
|  | void_int * | elem_cmap_ids,
|  | void_int * | elem_cmap_elem_cnts,
|  | int64_t | processor
| ) |  |

Examples
  /test/test_nemesis.c.

## ◆ ex_put_cmap_params_cc()

int ex_put_cmap_params_cc | ( | int | exoid,
|  | void_int * | node_cmap_ids,
|  | void_int * | node_cmap_node_cnts,
|  | void_int * | node_proc_ptrs,
|  | void_int * | elem_cmap_ids,
|  | void_int * | elem_cmap_elem_cnts,
|  | void_int * | elem_proc_ptrs
| ) |  |

Examples
  /test/test_nemesis.c.

## ◆ ex_put_concat_all_blocks()

int ex_put_concat_all_blocks | ( | int | exoid,
|  | const ex_block_params * | param
| ) |  |

writes the parameters used to describe all element, edge, and face blocks

Parameters

  exoid | exodus file id
  param | block parameters structure

## ◆ ex_put_concat_elem_block()

int ex_put_concat_elem_block | ( | int | exoid,
|  | const void_int * | elem_blk_id,
|  | char * | elem_type[],
|  | const void_int * | num_elem_this_blk,
|  | const void_int * | num_nodes_per_elem,
|  | const void_int * | num_attr_this_blk,
|  | int | define_maps
| ) |  |

writes the parameters used to describe an element block

Parameters

  exoid | exodus file id
  elem_blk_id | element block id
  elem_type | element type string
  num_elem_this_blk | number of elements in the element blk
  num_nodes_per_elem | number of nodes per element block
  num_attr_this_blk | number of attributes
  define_maps | if != 0, write maps, else don't

Examples
  /test/create_mesh.c, /test/rd_wt_mesh.c, and /test/testwt_clb.c.

## ◆ ex_put_concat_node_sets()

SEACAS_DEPRECATED int ex_put_concat_node_sets | ( | int | exoid,
|  | void_int * | node_set_ids,
|  | void_int * | num_nodes_per_set,
|  | void_int * | num_dist_per_set,
|  | void_int * | node_sets_node_index,
|  | void_int * | node_sets_df_index,
|  | void_int * | node_sets_node_list,
|  | void * | node_sets_dist_fact
| ) |  |

Deprecated:
  Use ex_put_concat_sets()(exoid, EX_NODE_SET, &set_specs)

The function ex_put_concat_node_sets() writes the node set ID's, node sets node count array, node sets distribution factor count array, node sets node list pointers array, node sets distribution factor pointer, node set node list, and node set distribution factors for all of the node sets. `‘Concatenated node sets’' refers to the arrays required to define all of the node sets (ID array, counts arrays, pointers arrays, node list array, and distribution factors array) as described in Section 3.10 on page 11. Writing concatenated node sets is more efficient than writing individual node sets.

Because the distribution factors are floating point values, the application code must declare the array passed to be the appropriate type (float or double) to match the compute word size passed in ex_create() or ex_open().

Returns
  In case of an error, ex_put_concat_node_sets() returns a negative number; a warning will return a positive number. Possible causes of errors include:
  - data file not properly opened with call to ex_create() or ex_open()
  - data file opened for read only.
  - data file not initialized properly with call to ex_put_init().
  - the number of node sets specified in a call to ex_put_init() was zero or has been exceeded.
  - a node set with the same ID has already been stored.
  - the number of distribution factors specified for one of the node sets is not zero and is not equal to the number of nodes in the same node set.

Parameters

  [in] | exoid | exodus file ID returned from a previous call to ex_create() or ex_open().
  [in] | node_set_ids | Array containing the node set ID for each set.
  [in] | num_nodes_per_set | Array containing the number of nodes for each set.
  [in] | num_dist_per_set | Array containing the number of distribution factors for each set.
  [in] | node_sets_node_index | Array containing the indices into the node_set_node_list which are the locations of the first node for each set. These indices are 0-based. Pass NULL for remaining parameters to just set the nodeset parameters and not output nodeset data.
  [in] | node_sets_df_index | Array containing the indices into the node_set_dist_list which are the locations of the first distribution factor for each set. These indices are 0-based.
  [in] | node_sets_node_list | Array containing the nodes for all sets. Internal node IDs are used in this list (See Section LocalNodeIds).
  [in] | node_sets_dist_fact | Array containing the distribution factors for all sets.

For example, the following code will write out two node sets in a concatenated format:

int ids[2], num_nodes_per_set[2], node_ind[2], node_list[8],
num_df_per_set[2], df_ind[2], error, exoid;
float dist_fact[8];
ids[0] = 20; ids[1] = 21;
num_nodes_per_set[0] = 5; num_nodes_per_set[1] = 3;
node_ind[0] = 0; node_ind[1] = 5;
node_list[0] = 100; node_list[1] = 101; node_list[2] = 102;
node_list[3] = 103; node_list[4] = 104;
node_list[5] = 200; node_list[6] = 201; node_list[7] = 202;
num_df_per_set[0] = 5; num_df_per_set[1] = 3;
df_ind[0] = 0; df_ind[1] = 5;
dist_fact[0] = 1.0; dist_fact[1] = 2.0; dist_fact[2] = 3.0;
dist_fact[3] = 4.0; dist_fact[4] = 5.0;
dist_fact[5] = 1.1; dist_fact[6] = 2.1;
dist_fact[7] = 3.1;
error = ex_put_concat_node_sets (exoid, ids, num_nodes_per_set,
num_df_per_set, node_ind, df_ind,
node_list, dist_fact);

Examples
  /test/testwtm.c.

## ◆ ex_put_concat_sets()

int ex_put_concat_sets | ( | int | exoid,
|  | ex_entity_type | set_type,
|  | const struct ex_set_specs * | set_specs
| ) |  |

writes the set ID's, set entry count array, set entry pointers array, set entry list, set extra list, and distribution factors list for all the sets of the specified type.

Parameters

  exoid | exodus file id
  set_type | type of set
  set_specs | set specs structure

Examples
  /test/testwt1.c, /test/testwt_clb.c, /test/testwt_nossnsdf.c, /test/testwt_ss.c, and /test/testwtm.c.

## ◆ ex_put_concat_side_sets()

SEACAS_DEPRECATED int ex_put_concat_side_sets | ( | int | exoid,
|  | void_int * | side_set_ids,
|  | void_int * | num_elem_per_set,
|  | void_int * | num_dist_per_set,
|  | void_int * | side_sets_elem_index,
|  | void_int * | side_sets_dist_index,
|  | void_int * | side_sets_elem_list,
|  | void_int * | side_sets_side_list,
|  | void * | side_sets_dist_fact
| ) |  |

writes the side set ID's, side set element count array, side set element pointers array, side set element list, side set side list, and distribution factors list.

Parameters

  exoid | exodus file id
  side_set_ids | array of side set ids
  num_elem_per_set | number of elements/sides/faces per set
  num_dist_per_set | number of distribution factors per set
  side_sets_elem_index | index array of elements into elem list
  side_sets_dist_index | index array of df into df list
  side_sets_elem_list | array of elements
  side_sets_side_list | array of sides/faces
  side_sets_dist_fact | array of distribution factors

Deprecated:
  Use ex_put_concat_sets()(exoid, EX_SIDE_SET, set_specs)

## ◆ ex_put_concat_var_param()

SEACAS_DEPRECATED int ex_put_concat_var_param | ( | int | exoid,
|  | int | num_g,
|  | int | num_n,
|  | int | num_e,
|  | int | num_elem_blk,
|  | int * | elem_var_tab
| ) |  |

writes the number of global, nodal, and element variables that will be written to the database

Parameters

  exoid | int exodus file id
  num_g | int global variable count
  num_n | int nodal variable count
  num_e | int element variable count
  num_elem_blk | int number of element blocks
  elem_var_tab | int* element variable truth table array

Deprecated:
  Use ex_put_all_var_param()(exoid, num_g, num_n, num_e, elem_var_tab, 0, 0, 0, 0)

## ◆ ex_put_conn()

int ex_put_conn | ( | int | exoid,
|  | ex_entity_type | blk_type,
|  | ex_entity_id | blk_id,
|  | const void_int * | node_conn,
|  | const void_int * | elem_edge_conn,
|  | const void_int * | elem_face_conn
| ) |  |

writes the connectivity array for a block

Parameters

  exoid | exodus file id
  blk_type | type of block
  blk_id | id of block
  node_conn | node-element connectivity
  elem_edge_conn | element-edge connectivity (NULL if none)
  elem_face_conn | element-face connectivity (NULL if none)

Examples
  /test/create_mesh.c, /test/CreateEdgeFace.c, /test/rd_wt_mesh.c, /test/test_ts_files.c, /test/testrdwt.c, /test/testwt-compress.c, /test/testwt-groups.c, /test/testwt-localization.C, /test/testwt-long-name.c, /test/testwt-nface-nside.c, /test/testwt-nfaced.c, /test/testwt-nsided.c, /test/testwt-one-attrib.c, /test/testwt-oned.c, /test/testwt-partial.c, /test/testwt.c, /test/testwt1.c, /test/testwt2.c, /test/testwt_clb.c, /test/testwt_nc.c, /test/testwt_nossnsdf.c, /test/testwt_ss.c, /test/testwtd.c, /test/testwtm.c, and /test/twod.c.

## ◆ ex_put_coord()

int ex_put_coord | ( | int | exoid,
|  | const void * | x_coor,
|  | const void * | y_coor,
|  | const void * | z_coor
| ) |  |

The function ex_put_coord() writes the nodal coordinates of the nodes in the model. The function ex_put_init() must be invoked before this call is made.

Because the coordinates are floating point values, the application code must declare the arrays passed to be the appropriate type (float or double) to match the compute word size passed in ex_create() or ex_open().

Returns
  In case of an error, ex_put_coord() returns a negative number; a warning will return a positive number. Possible causes of errors include:
  - data file not properly opened with call to ex_create() or ex_open()
  - data file opened for read only.
  - data file not initialized properly with call to ex_put_init().

Parameters

  [in] | exoid | exodus file ID returned from a previous call to ex_create() or ex_open().
  [in] | x_coor | The X-coordinates of the nodes. If this is NULL, the X-coordinates will not be written.
  [in] | y_coor | The Y-coordinates of the nodes. These are stored only if num_dim > 1; otherwise, pass in NULL. If this is NULL, the Y-coordinates will not be written.
  [in] | z_coor | The Z-coordinates of the nodes. These are stored only if num_dim > 2; otherwise, pass in NULL. If this is NULL, the Z-coordinates will not be written.

The following will write the nodal coordinates to an open exodus file :

int error, exoid;
// /* if file opened with compute word size of sizeof(float) */
float x[8], y[8], z[8];
// /* write nodal coordinates values to database */
x[0] = 0.0; y[0] = 0.0; z[0] = 0.0;
x[1] = 0.0; y[1] = 0.0; z[1] = 1.0;
x[2] = 1.0; y[2] = 0.0; z[2] = 1.0;
x[3] = 1.0; y[3] = 0.0; z[3] = 0.0;
x[4] = 0.0; y[4] = 1.0; z[4] = 0.0;
x[5] = 0.0; y[5] = 1.0; z[5] = 1.0;
x[6] = 1.0; y[6] = 1.0; z[6] = 1.0;
x[7] = 1.0; y[7] = 1.0; z[7] = 0.0;
error = ex_put_coord(exoid, x, y, z);
/* Do the same as the previous call in three separate calls */
error = ex_put_coord(exoid, x, NULL, NULL);
error = ex_put_coord(exoid, NULL, y, NULL);
error = ex_put_coord(exoid, NULL, NULL, z);

Examples
  /test/create_mesh.c, /test/CreateEdgeFace.c, /test/rd_wt_mesh.c, /test/test_ts_files.c, /test/test_ts_nvar.c, /test/testrdwt.c, /test/testwt-compress.c, /test/testwt-groups.c, /test/testwt-localization.C, /test/testwt-long-name.c, /test/testwt-nface-nside.c, /test/testwt-nfaced.c, /test/testwt-nsided.c, /test/testwt-one-attrib.c, /test/testwt-oned.c, /test/testwt-zeroe.c, /test/testwt.c, /test/testwt1.c, /test/testwt2.c, /test/testwt_clb.c, /test/testwt_nc.c, /test/testwt_nossnsdf.c, /test/testwt_ss.c, /test/testwtd.c, /test/testwtm.c, and /test/twod.c.

## ◆ ex_put_coord_names()

int ex_put_coord_names | ( | int | exoid,
|  | char * | coord_names[]
| ) |  |

The function ex_put_coord_names() writes the names of the coordinate arrays to the database. Memory must be allocated for the character strings before this function is invoked.

In case of an error, ex_put_coord_names() returns a negative number; a warning will return a positive number. Possible causes of errors include:

- data file not properly opened with call to ex_create() or ex_open()
- data file opened for read only.
- data file not initialized properly with call to ex_put_init().

Parameters

  [in] | exoid | exodus file ID returned from a previous call to ex_create() or ex_open().
  [in] | coord_names | Array containing num_dim names of length ``...max_name_length... of the nodal coordinate arrays.

The following coding will write the coordinate names to an open exodus file :

int error, exoid;
char *coord_names[3];
coord_names[0] = "xcoor";
coord_names[1] = "ycoor";
coord_names[2] = "zcoor";
error = ex_put_coord_names (exoid, coord_names);

Examples
  /test/CreateEdgeFace.c, /test/test_ts_files.c, /test/testrdwt.c, /test/testwt-compress.c, /test/testwt-groups.c, /test/testwt-localization.C, /test/testwt-long-name.c, /test/testwt-nface-nside.c, /test/testwt-nfaced.c, /test/testwt-nsided.c, /test/testwt-one-attrib.c, /test/testwt-oned.c, /test/testwt-partial.c, /test/testwt-zeroe.c, /test/testwt-zeron.c, /test/testwt.c, /test/testwt1.c, /test/testwt2.c, /test/testwt_clb.c, /test/testwt_nc.c, /test/testwt_nossnsdf.c, /test/testwt_ss.c, /test/testwtd.c, /test/testwtm.c, and /test/twod.c.

## ◆ ex_put_coordinate_frames()

int ex_put_coordinate_frames | ( | int | exoid,
|  | int | nframes,
|  | const void_int * | cf_ids,
|  | void * | pt_coordinates,
|  | const char * | tags
| ) |  |

expfrm - ex_put_coordinate_frames: write coordinate frames

Parameters

  exoid | exodus file id
  nframes | number of coordinate frames in model
  cf_ids | coordinate ids
  pt_coordinates | pointer to coordinates. 9 values per coordinate frame
  tags | character tag for each frame. 'r' - rectangular, 'c' - cylindrical, 's' - spherical

returns - EX_NOERR for no error EX_FATAL for fatal errors 1 number frames < 0

Examples
  /test/testwt-one-attrib.c.

## ◆ ex_put_eb_info_global()

int ex_put_eb_info_global | ( | int | exoid,
|  | void_int * | el_blk_ids,
|  | void_int * | el_blk_cnts
| ) |  |

Examples
  /test/test_nemesis.c.

## ◆ ex_put_elem_attr()

SEACAS_DEPRECATED int ex_put_elem_attr | ( | int | exoid,
|  | ex_entity_id | elem_blk_id,
|  | const void * | attrib
| ) |  |

Deprecated:
  Use ex_put_attr()(exoid, EX_ELEM_BLOCK, elem_blk_id, attrib)

The function ex_put_elem_attr() writes the attributes for an element block. Each element in the element block must have the same number of attributes, so there are(num_attr x num_elem_this_blk) attributes for each element block. The function ex_put_elem_block() must be invoked before this call is made.

Because the attributes are floating point values, the application code must declare the array passed to be the appropriate type (float or double) to match the compute word size passed in ex_create() or ex_open().

Returns
  In case of an error, ex_put_elem_attr() returns a negative number; a warning will return a positive number. Possible causes of errors include:
  - data file not properly opened with call to ex_create() or ex_open()
  - data file opened for read only.
  - data file not initialized properly with call to ex_put_init().
  - ex_put_elem_block() was not called previously for specified element block ID.
  - ex_put_elem_block() was called with 0 attributes specified.

Parameters

  [in] | exoid | exodus file ID returned from a previous call to ex_create() or ex_open().
  [in] | elem_blk_id | The element block ID.
  [in] | attrib | Size [num_elem_this_blk*num_attr] The list of attributes for the element block. The num_attr index cycles faster.

Refer to the code example in ex_put_elem_block() for an example of writing the attributes array for an element block.

## ◆ ex_put_elem_attr_names()

SEACAS_DEPRECATED int ex_put_elem_attr_names | ( | int | exoid,
|  | ex_entity_id | elem_blk_id,
|  | char * | names[]
| ) |  |

writes the attribute names for an element block

Parameters

  exoid | exodus file id
  elem_blk_id | element block id
  names[] | ptr array of attribute names

Deprecated:
  Use ex_put_attr_names()(exoid, EX_ELEM_BLOCK, elem_blk_id, names)

## ◆ ex_put_elem_block()

SEACAS_DEPRECATED int ex_put_elem_block | ( | int | exoid,
|  | ex_entity_id | elem_blk_id,
|  | const char * | elem_type,
|  | int64_t | num_elem_this_blk,
|  | int64_t | num_nodes_per_elem,
|  | int64_t | num_attr_per_elem
| ) |  |

Deprecated:
  Use ex_put_block()(exoid, EX_ELEM_BLOCK, elem_blk_id, elem_type, num_elem_this_blk, num_nodes_per_elem, 0, 0, num_attr_per_elem)

The function ex_put_elem_block() writes the parameters used to describe an element block.

Returns
  In case of an error, ex_put_elem_block() returns a negative number; a warning will return a positive number. Possible causes of errors include:
  - data file not properly opened with call to ex_create() or ex_open()
  - data file opened for read only.
  - data file not initialized properly with call to ex_put_init().
  - an element block with the same ID has already been specified.
  - the number of element blocks specified in the call to ex_put_init() has been exceeded.

Parameters

  [in] | exoid | exodus file ID returned from a previous call to ex_create() or ex_open().
  [in] | elem_blk_id | The element block ID.
  [in] | elem_type | The type of elements in the element block. The maximum length of this string is `MAX_STR_LENGTH` .
  [in] | num_elem_this_blk | The number of elements in the element block.
  [in] | num_nodes_per_elem | The number of nodes per element in the element block.
  [in] | num_attr_per_elem | The number of attributes per element in the element block.

For example, the following code segment will initialize an element block with an ID of 10, write out the connectivity array, and write out the element attributes array:

int id, error, exoid, num_elem_in_blk, num_nodes_per_elem, *connect, num_attr;
float *attrib;
/* write element block parameters */
id = 10;
num_elem_in_blk = 2;
num_nodes_per_elem = 4; /* elements are 4-node shells */
num_attr = 1; /* one attribute per element */
error = ex_put_elem_block(exoid, id, "SHELL", num_elem_in_blk,
num_nodes_per_elem, num_attr);
/* write element connectivity */
connect = (int *)calloc(num_elem_in_blk*num_nodes_per_elem, sizeof(int));
/* fill connect with node numbers; nodes for first elemen */
connect[0] = 1; connect[1] = 2; connect[2] = 3; connect[3] = 4;
/* nodes for second element */
connect[4] = 5; connect[5] = 6; connect[6] = 7; connect[7] = 8;
error = ex_put_elem_conn (exoid, id, connect);
/* write element block attributes */
attrib = (float *) calloc (num_attr*num_elem_in_blk, sizeof(float));
for (i=0, cnt=0; i < num_elem_in_blk; i++) {
for (j=0; j < num_attr; j++, cnt++) {
attrib[cnt] = 1.0;
}
}
error = ex_put_elem_attr (exoid, id, attrib);
/* Same result using non-deprecated code */
error = ex_put_block(exoid, EX_ELEM_BLOCK, id, "SHELL", num_elem_in_blk,
num_nodes_per_elem, 0, 0, num_attr);
error = ex_put_conn (exoid, EX_ELEM_BLOCK, id, connect);
error = ex_put_attr (exoid, EX_ELEM_BLOCK, id, attrib);

## ◆ ex_put_elem_cmap()

int ex_put_elem_cmap | ( | int | exoid,
|  | ex_entity_id | map_id,
|  | void_int * | elem_ids,
|  | void_int * | side_ids,
|  | void_int * | proc_ids,
|  | int | processor
| ) |  |

Examples
  /test/test_nemesis.c.

## ◆ ex_put_elem_conn()

SEACAS_DEPRECATED int ex_put_elem_conn | ( | int | exoid,
|  | ex_entity_id | elem_blk_id,
|  | const void_int * | connect
| ) |  |

Deprecated:
  Use ex_put_conn()(exoid, EX_ELEM_BLOCK, elem_blk_id, connect, 0, 0)

The function ex_put_elem_conn() writes the connectivity array for an element block. The function ex_put_elem_block() must be invoked before this call is made.

Returns
  In case of an error, ex_put_elem_conn() returns a negative number; a warning will return a positive number. Possible causes of errors include:
  - data file opened for read only.
  - data file not initialized properly with call to ex_put_init().
  - ex_put_elem_block() was not called previously.

Parameters

  [in] | exoid | exodus file ID returned from a previous call to ex_create() or ex_open().
  [in] | elem_blk_id | The element block ID.
  [in] | connect | Size [num_elem_this_blk,num_nodes_per_elem], The connectivity array; a list of nodes (internal node IDs; See Section LocalNodeIds) that define each element in the element block. The node index cycles faster than the element index.

Refer to the code example in ex_put_elem_block() for an example of writing the connectivity array for an element block.

## ◆ ex_put_elem_map()

SEACAS_DEPRECATED int ex_put_elem_map | ( | int | exoid,
|  | ex_entity_id | map_id,
|  | const void_int * | elem_map
| ) |  |

writes an element map; this is a vector of integers of length number of elements

Parameters

  exoid | exodus file id
  map_id | element map id
  elem_map | element map

Deprecated:
  Use ex_put_num_map()(exoid, EX_ELEM_MAP, map_id, elem_map)

## ◆ ex_put_elem_num_map()

SEACAS_DEPRECATED int ex_put_elem_num_map | ( | int | exoid,
|  | const void_int * | elem_map
| ) |  |

Deprecated:
  Use ex_put_id_map()(exoid, EX_ELEM_MAP, elem_map)

The function ex_put_elem_num_map() writes out the optional element number map to the database. See Section LocalElementIds for a description of the element number map. The function ex_put_init() must be invoked before this call is made.

Returns
  In case of an error, ex_put_elem_num_map() returns a negative number; a warning will return a positive number. Possible causes of errors include:
  - data file not properly opened with call to ex_create() or ex_open()
  - data file opened for read only.
  - data file not initialized properly with call to ex_put_init().
  - an element number map already exists in the file.

Parameters

  [in] | exoid | exodus file ID returned from a previous call to ex_create() or ex_open().
  [in] | elem_map | The element number map.

The following code generates a default element number map and outputs it to an open exodus file. This is a trivial case and included just for illustration. Since this map is optional, it should be written out only if it contains something other than the default map.

int error, exoid;
int *elem_map = (int *)calloc(num_elem, sizeof(int));
for (i=1; i <= num_elem; i++)
elem_map[i-1] = i;
error = ex_put_elem_num_map(exoid, elem_map);
/* Equivalent using non-deprecated function */
error = ex_put_id_map(exoid, EX_ELEM_MAP, elem_map);

Examples
  /test/twod.c.

## ◆ ex_put_elem_var()

SEACAS_DEPRECATED int ex_put_elem_var | ( | int | exoid,
|  | int | time_step,
|  | int | elem_var_index,
|  | ex_entity_id | elem_blk_id,
|  | int64_t | num_elem_this_blk,
|  | const void * | elem_var_vals
| ) |  |

Deprecated:
  Use ex_put_var()(exoid, time_step, EX_ELEM_BLOCK, elem_var_index, elem_blk_id, num_elem_this_blk, elem_var_vals)

The function ex_put_elem_var() writes the values of a single element variable for one element block at one time step. It is recommended, but not required, to write the element variable truth table (with ex_put_elem_var_tab() before this function is invoked for better efficiency.

Because element variables are floating point values, the application code must declare the array passed to be the appropriate type (float or double) to match the compute word size passed in ex_create() or ex_open().

Returns
  In case of an error, ex_put_elem_var() returns a negative number; a warning will return a positive number. Possible causes of errors include:
  - data file not properly opened with call to ex_create() or ex_open()
  - data file opened for read only.
  - data file not initialized properly with call to ex_put_init().
  - invalid element block ID.
  - ex_put_elem_block() not called previously to specify parameters for this element block.
  - ex_put_variable_param() not called previously specifying the number of element variables.
  - an element variable truth table was stored in the file but contains a zero (indicating no valid element variable) for the specified element block and element variable.

Parameters

  [in] | exoid | exodus file ID returned from a previous call to ex_create() or ex_open().
  [in] | time_step | The time step number, as described under ex_put_time(). This is essentially a counter that is incremented only when results variables are output. The first time step is 1.
  [in] | elem_var_index | The index of the element variable. The first variable has an index of 1.
  [in] | elem_blk_id | The element block ID.
  [in] | num_elem_this_blk | The number of elements in the given element block.
  [in] | elem_var_vals | Array of num_elem_this_blk values of the elem_var_index-th element variable for the element block with ID of elem_blk_id at the time_step-th time step.

The following coding will write out all of the element variables for a single time step n to an open exodus file :

int num_ele_vars, num_elem_blk, *num_elem_in_block,error,
exoid, n, *ebids;
float *elem_var_vals;
/* write element variables */
for (k=1; k <= num_ele_vars; k++) {
for (j=0; j < num_elem_blk; j++) {
elem_var_vals = (float *)
calloc(num_elem_in_block[j], sizeof(float));
for (m=0; m < num_elem_in_block[j]; m++) {
/* simulation code fills this in */
elem_var_vals[m] = 10.0;
}
error = ex_put_elem_var (exoid, n, k, ebids[j],
num_elem_in_block[j], elem_var_vals);
/* Using non-deprecated function: */
error = ex_put_var (exoid, n, EX_ELEM_BLOCK, k, ebids[j],
num_elem_in_block[j], elem_var_vals);
free (elem_var_vals);
}
}

Examples
  /test/testwt-groups.c, /test/testwt-nface-nside.c, and /test/twod.c.

## ◆ ex_put_elem_var_slab()

SEACAS_DEPRECATED int ex_put_elem_var_slab | ( | int | exoid,
|  | int | time_step,
|  | int | elem_var_index,
|  | ex_entity_id | elem_blk_id,
|  | int64_t | start_pos,
|  | int64_t | num_vals,
|  | void * | elem_var_vals
| ) |  |

Deprecated:
  Use ex_put_partial_var()(exoid, time_step, EX_ELEM_BLOCK, elem_var_index, elem_blk_id, start_pos, num_vals, elem_var_vals)

## ◆ ex_put_elem_var_tab()

SEACAS_DEPRECATED int ex_put_elem_var_tab | ( | int | exoid,
|  | int | num_elem_blk,
|  | int | num_elem_var,
|  | int * | elem_var_tab
| ) |  |

## ◆ ex_put_entity_count_per_polyhedra()

int ex_put_entity_count_per_polyhedra | ( | int | exoid,
|  | ex_entity_type | blk_type,
|  | ex_entity_id | blk_id,
|  | const int * | entity_counts
| ) |  |

writes out the number of entities (nodes/faces) per polyhedra (nsided/nfaced) in this element block to the database.

Parameters

  exoid | exodus file id
  blk_type | type of block (face, or element)
  blk_id | block identifier
  entity_counts | entity_per_polyhedra count array

Examples
  /test/testwt-nface-nside.c, /test/testwt-nfaced.c, and /test/testwt-nsided.c.

## ◆ ex_put_glob_vars()

SEACAS_DEPRECATED int ex_put_glob_vars | ( | int | exoid,
|  | int | time_step,
|  | int | num_glob_vars,
|  | const void * | glob_var_vals
| ) |  |

Deprecated:
  Use ex_put_var()(exoid, time_step, EX_GLOBAL, 1, 0, num_glob_vars, glob_var_vals)

The function ex_put_glob_vars() writes the values of all the global variables for a single time step. The function ex_put_variable_param() must be invoked before this call is made.

Because global variables are floating point values, the application code must declare the array passed to be the appropriate type (float or double) to match the compute word size passed in ex_create() or ex_open().

Returns
  In case of an error, ex_put_glob_vars() returns a negative number; a warning will return a positive number. Possible causes of errors include:
  - data file not properly opened with call to ex_create() or ex_open()
  - data file opened for read only.
  - ex_put_variable_param() not called previously specifying the number of global variables.

Parameters

  [in] | exoid | exodus file ID returned from a previous call to ex_create() or ex_open().
  [in] | time_step | The time step number, as described under ex_put_time(). This is essentially a counter that is incremented when results variables are output. The first time step is 1.
  [in] | num_glob_vars | The number of global variables to be written to the database.
  [in] | glob_var_vals | Array of num_glob_vars global variable values for the time_step-th time step.

As an example, the following coding will write the values of all the global variables at one time step to an open exodus II file:

int num_glo_vars, error, exoid, time_step;
float *glob_var_vals
/* write global variables */
for (j=0; j < num_glo_vars; j++) {
/* application code fills this array */
glob_var_vals[j] = 10.0;
}
error = ex_put_glob_vars (exoid, time_step, num_glo_vars, glob_var_vals);
/* Using non-deprecated functions: */
error = ex_put_var (exoid, time_step, EX_GLOBAL, 1, 0, num_glo_vars,
glob_var_vals);

## ◆ ex_put_id_map()

int ex_put_id_map | ( | int | exoid,
|  | ex_entity_type | map_type,
|  | const void_int * | map
| ) |  |

writes out the entity numbering map to the database; this allows the entity numbers to be non-contiguous. This map is used for mapping between local and global entity ids.

Parameters

  exoid | exodus file id
  map_type |
  map | element numbering map array

Examples
  /test/create_mesh.c, /test/rd_wt_mesh.c, and /test/testwt_nossnsdf.c.

## ◆ ex_put_info()

int ex_put_info | ( | int | exoid,
|  | int | num_info,
|  | char * | info[]
| ) |  |

The function ex_put_info() writes information records to the database. The records are MAX_LINE_LENGTH-character strings.

In case of an error, ex_put_info() returns a negative number; a warning will return a positive number. Possible causes of errors include:

- data file not properly opened with call to ex_create() or ex_open()
- data file opened for read only.
- information records already exist in file.

Parameters

  [in] | exoid | exodus file ID returned from a previous call to ex_create() or ex_open().
  [in] | num_info | The number of information records.
  [in] | info | Array containing the information records. To only define the number of info records instead of defining and outputting, pass NULL for info argument.

The following code will write out three information records to an open exodus file -

int error, exoid, num_info;
char *info[3];
/* write information records */
num_info = 3;
info[0] = "This is the first information record.";
info[1] = "This is the second information record.";
info[2] = "This is the third information record.";
error = ex_put_info(exoid, num_info, info);

The following code will first tell the database that there are three information records, and then later actually output those records.

int error, exoid, num_info;
char *info[3];
/* Define the number of information records that will be written
later. */
num_info = 3;
error = ex_put_info(exoid, num_info, NULL);
/* Now, actually write the information records */
info[0] = "This is the first information record.";
info[1] = "This is the second information record.";
info[2] = "This is the third information record.";
error = ex_put_info(exoid, num_info, info);

Examples
  /test/test_ts_files.c, /test/testrdwt.c, /test/testwt-compress.c, /test/testwt-groups.c, /test/testwt-localization.C, /test/testwt-long-name.c, /test/testwt-nface-nside.c, /test/testwt-nfaced.c, /test/testwt-nsided.c, /test/testwt-oned.c, /test/testwt-partial.c, /test/testwt-zeroe.c, /test/testwt-zeron.c, /test/testwt.c, /test/testwt1.c, /test/testwt2.c, /test/testwt_clb.c, /test/testwt_nc.c, /test/testwt_nossnsdf.c, /test/testwt_ss.c, /test/testwtd.c, and /test/testwtm.c.

## ◆ ex_put_init()

int ex_put_init | ( | int | exoid,
|  | const char * | title,
|  | int64_t | num_dim,
|  | int64_t | num_nodes,
|  | int64_t | num_elem,
|  | int64_t | num_elem_blk,
|  | int64_t | num_node_sets,
|  | int64_t | num_side_sets
| ) |  |

The function ex_put_init() writes the initialization parameters to the exodus file. This function must be called once (and only once) before writing any data to the file.

Returns
  In case of an error, ex_put_init() returns a negative number; a warning will return a positive number. Possible causes of errors include:
  - data file not properly opened with call to ex_create() or ex_open()
  - data file opened for read only.
  - this routine has been called previously.

Parameters

  exoid | exodus file ID returned from a previous call to ex_create() or ex_open().
  title | Database title. Maximum length is MAX_LINE_LENGTH.
  num_dim | The dimensionality of the database. This is the number of coordinates per node.
  num_nodes | The number of nodal points.
  num_elem | The number of elements.
  num_elem_blk | The number of element blocks.
  num_node_sets | The number of node sets.
  num_side_sets | The number of side sets.

The following code segment will initialize an open exodus file with the specified parameters:

int num_dim, num_nods, num_el, num_el_blk, num_ns, num_ss, error, exoid;
/* initialize file with parameters */
num_dim = 3; num_nods = 46; num_el = 5; num_el_blk = 5;
num_ns = 2; num_ss = 5;
error = ex_put_init (exoid, "This is the title", num_dim,
num_nods, num_el,num_el_blk, num_ns, num_ss);

Examples
  /test/create_mesh.c, /test/rd_wt_mesh.c, /test/test_ts_files.c, /test/test_ts_nvar.c, /test/test_ts_partial_nvar.c, /test/testrdwt.c, /test/testwt-compress.c, /test/testwt-groups.c, /test/testwt-localization.C, /test/testwt-long-name.c, /test/testwt-nsided.c, /test/testwt-one-attrib.c, /test/testwt-oned.c, /test/testwt-partial.c, /test/testwt-zeroe.c, /test/testwt-zeron.c, /test/testwt.c, /test/testwt1.c, /test/testwt2.c, /test/testwt_clb.c, /test/testwt_nc.c, /test/testwt_nossnsdf.c, /test/testwt_ss.c, /test/testwtd.c, /test/testwtm.c, and /test/twod.c.

## ◆ ex_put_init_ext()

int ex_put_init_ext | ( | int | exoid,
|  | const ex_init_params * | model
| ) |  |

writes the initialization parameters to the EXODUS file

Parameters

  exoid | exodus file id
  model | finite element model parameters

Examples
  /test/CreateEdgeFace.c, /test/testwt-nface-nside.c, and /test/testwt-nfaced.c.

## ◆ ex_put_init_global()

int ex_put_init_global | ( | int | exoid,
|  | int64_t | num_nodes_g,
|  | int64_t | num_elems_g,
|  | int64_t | num_elem_blks_g,
|  | int64_t | num_node_sets_g,
|  | int64_t | num_side_sets_g
| ) |  |

Examples
  /test/test_nemesis.c.

## ◆ ex_put_init_info()

int ex_put_init_info | ( | int | exoid,
|  | int | num_proc,
|  | int | num_proc_in_f,
|  | char * | ftype
| ) |  |

Examples
  /test/test_nemesis.c.

## ◆ ex_put_loadbal_param()

int ex_put_loadbal_param | ( | int | exoid,
|  | int64_t | num_int_nodes,
|  | int64_t | num_bor_nodes,
|  | int64_t | num_ext_nodes,
|  | int64_t | num_int_elems,
|  | int64_t | num_bor_elems,
|  | int64_t | num_node_cmaps,
|  | int64_t | num_elem_cmaps,
|  | int | processor
| ) |  |

## ◆ ex_put_loadbal_param_cc()

int ex_put_loadbal_param_cc | ( | int | exoid,
|  | void_int * | num_int_nodes,
|  | void_int * | num_bor_nodes,
|  | void_int * | num_ext_nodes,
|  | void_int * | num_int_elems,
|  | void_int * | num_bor_elems,
|  | void_int * | num_node_cmaps,
|  | void_int * | num_elem_cmaps
| ) |  |

Examples
  /test/test_nemesis.c.

## ◆ ex_put_map()

int ex_put_map | ( | int | exoid,
|  | const void_int * | elem_map
| ) |  |

The function ex_put_map() writes out the optional element order map to the database. The function ex_put_init() must be invoked before this call is made.

In case of an error, ex_put_map() returns a negative number; a warning will return a positive number. Possible causes of errors include:

- data file not properly opened with call to ex_create() or ex_open()
- data file opened for read only.
- data file not initialized properly with call to ex_put_init().
- an element map already exists in the file.

Parameters

  [in] | exoid | exodus file ID returned from a previous call to ex_create() or ex_open().
  [in] | elem_map | The element order map.

The following code generates a default element order map and outputs it to an open exodus file. This is a trivial case and included just for illustration. Since this map is optional, it should be written out only if it contains something other than the default map.

int error, exoid;
int *elem_map = (int *)calloc(num_elem, sizeof(int));
for (i=0; i < num_elem; i++) {
elem_map[i] = i+1;
}
error = ex_put_map(exoid, elem_map);

Examples
  /test/test_ts_files.c, /test/testrdwt.c, /test/testwt-compress.c, /test/testwt-groups.c, /test/testwt-long-name.c, /test/testwt-nsided.c, /test/testwt-oned.c, /test/testwt-partial.c, /test/testwt.c, /test/testwt2.c, /test/testwt_clb.c, /test/testwt_nc.c, /test/testwt_nossnsdf.c, /test/testwtd.c, and /test/testwtm.c.

## ◆ ex_put_map_param()

int ex_put_map_param | ( | int | exoid,
|  | int | num_node_maps,
|  | int | num_elem_maps
| ) |  |

defines the number of node and element maps. It is more efficient to define both of these at the same time; however, they can be defined in separate calls by setting only one of the counts to a non-zero value. It is an error to redefine the number of node or element maps.

Parameters

  exoid | exodus file id
  num_node_maps | number of node maps
  num_elem_maps | number of element maps

Examples
  /test/testwt1.c.

## ◆ ex_put_n_coord()

SEACAS_DEPRECATED int ex_put_n_coord | ( | int | exoid,
|  | int64_t | start_node_num,
|  | int64_t | num_nodes,
|  | const void * | x_coor,
|  | const void * | y_coor,
|  | const void * | z_coor
| ) |  |

Deprecated:
  Use ex_put_partial_coord()(exoid, start_node_num, num_nodes, x_coor, y_coor, z_coor) instead. writes the coordinates of some of the nodes in the model Only writes the 'non-null' arrays.

Parameters

  exoid | exodus file id
  start_node_num | the starting index (1-based) of the coordinates to be written
  num_nodes | the number of nodes to write coordinates for.
  x_coor | x coord array
  y_coor | y coord array
  z_coor | z coord array

## ◆ ex_put_n_elem_attr()

SEACAS_DEPRECATED int ex_put_n_elem_attr | ( | int | exoid,
|  | ex_entity_id | elem_blk_id,
|  | int64_t | start_elem_num,
|  | int64_t | num_elems,
|  | void * | attrib
| ) |  |

## ◆ ex_put_n_elem_conn()

SEACAS_DEPRECATED int ex_put_n_elem_conn | ( | int | exoid,
|  | ex_entity_id | elem_blk_id,
|  | int64_t | start_elem_num,
|  | int64_t | num_elems,
|  | const void_int * | connect
| ) |  |

Deprecated:
  Use ex_put_partial_conn()(exoid, EX_ELEM_BLOCK, elem_blk_id, start_elem_num, num_elems, connect, NULL, NULL)

## ◆ ex_put_n_elem_num_map()

SEACAS_DEPRECATED int ex_put_n_elem_num_map | ( | int | exoid,
|  | int64_t | start_ent,
|  | int64_t | num_ents,
|  | const void_int * | elem_map
| ) |  |

Deprecated:
  Use ex_put_partial_id_map()(exoid, EX_ELEM_MAP, start_ent, num_ents, elem_map)

## ◆ ex_put_n_node_num_map()

SEACAS_DEPRECATED int ex_put_n_node_num_map | ( | int | exoid,
|  | int64_t | start_ent,
|  | int64_t | num_ents,
|  | const void_int * | node_map
| ) |  |

Deprecated:
  Use ex_put_partial_id_map()(exoid, EX_NODE_MAP, start_ent, num_ents, node_map)

## ◆ ex_put_n_node_set()

SEACAS_DEPRECATED int ex_put_n_node_set | ( | int | exoid,
|  | ex_entity_id | node_set_id,
|  | int64_t | start_node_num,
|  | int64_t | num_nodes,
|  | const void_int * | node_set_node_list
| ) |  |

## ◆ ex_put_n_node_set_df()

SEACAS_DEPRECATED int ex_put_n_node_set_df | ( | int | exoid,
|  | ex_entity_id | node_set_id,
|  | int64_t | start_num,
|  | int64_t | num_df_to_get,
|  | void * | node_set_dist_fact
| ) |  |

Deprecated:
  Use ex_put_partial_set_dist_fact()(exoid, EX_NODE_SET, node_set_id, start_num, num_df_to_get, node_set_dist_fact)

## ◆ ex_put_n_one_attr()

SEACAS_DEPRECATED int ex_put_n_one_attr | ( | int | exoid,
|  | ex_entity_type | obj_type,
|  | ex_entity_id | obj_id,
|  | int64_t | start_num,
|  | int64_t | num_ent,
|  | int | attrib_index,
|  | const void * | attrib
| ) |  |

Deprecated:
  Use ex_put_partial_one_attr()(exoid, obj_type, obj_id, start_num, num_ent, attrib_index, attrib) writes the specified attribute for a block

Parameters

  exoid | exodus file id
  obj_type | object type (edge, face, elem block)
  obj_id | object id (edge, face, elem block ID)
  start_num | the starting index of the attributes to be written
  num_ent | the number of entities to write attributes for.
  attrib_index | index of attribute to write
  attrib | array of attributes

## ◆ ex_put_n_side_set()

SEACAS_DEPRECATED int ex_put_n_side_set | ( | int | exoid,
|  | ex_entity_id | side_set_id,
|  | int64_t | start_side_num,
|  | int64_t | num_sides,
|  | const void_int * | side_set_elem_list,
|  | const void_int * | side_set_side_list
| ) |  |

Deprecated:
  use ex_put_partial_set()(exoid, EX_SIDE_SET, side_set_id, start_side_num, num_sides, side_set_elem_list, side_set_side_list) instead

## ◆ ex_put_n_side_set_df()

SEACAS_DEPRECATED int ex_put_n_side_set_df | ( | int | exoid,
|  | ex_entity_id | side_set_id,
|  | int64_t | start_num,
|  | int64_t | num_df_to_get,
|  | void * | side_set_dist_fact
| ) |  |

Deprecated:
  use ex_put_partial_set_dist_fact()(exoid, EX_SIDE_SET, side_set_id, start_num, num_df_to_get, side_set_dist_fact)

## ◆ ex_put_name()

int ex_put_name | ( | int | exoid,
|  | ex_entity_type | obj_type,
|  | ex_entity_id | entity_id,
|  | const char * | name
| ) |  |

writes the name of the specified entity to the database. The entity with id `entity_id` must exist before calling ex_put_name().

Parameters

  exoid | exodus file id
  obj_type | object type
  entity_id | id of entity name to write
  name | ptr to entity name

Examples
  /test/test_ts_files.c, /test/testwt-compress.c, /test/testwt-groups.c, /test/testwt-localization.C, /test/testwt.c, and /test/testwt1.c.

## ◆ ex_put_names()

int ex_put_names | ( | int | exoid,
|  | ex_entity_type | obj_type,
|  | char * | names[]
| ) |  |

writes the entity names to the database

Parameters

  exoid | exodus file id
  obj_type | object type
  names | ptr array of entity names

Examples
  /test/CreateEdgeFace.c, /test/test_ts_files.c, /test/testwt-compress.c, /test/testwt-groups.c, /test/testwt-long-name.c, /test/testwt-nface-nside.c, /test/testwt-nfaced.c, /test/testwt-nsided.c, /test/testwt-oned.c, /test/testwt-partial.c, /test/testwt.c, /test/testwt1.c, /test/testwt_nc.c, and /test/twod.c.

## ◆ ex_put_nodal_var()

SEACAS_DEPRECATED int ex_put_nodal_var | ( | int | exoid,
|  | int | time_step,
|  | int | nodal_var_index,
|  | int64_t | num_nodes,
|  | const void * | nodal_var_vals
| ) |  |

Deprecated:
  Use ex_put_var()(exoid, time_step, EX_NODAL, nodal_var_index, 1, num_nodes, nodal_var_vals)

The function ex_put_nodal_var() writes the values of a single nodal variable for a single time step. The function ex_put_variable_param() must be invoked before this call is made.

Because nodal variables are floating point values, the application code must declare the array passed to be the appropriate type (float or double) to match the compute word size passed in ex_create() or ex_open().

Returns
  In case of an error, ex_put_nodal_var() returns a negative number; a warning will return a positive number. Possible causes of errors include:
  - data file not properly opened with call to ex_create() or ex_open()
  - data file opened for read only.
  - data file not initialized properly with call to ex_put_init().
  - ex_put_variable_param() not called previously specifying the number of nodal variables.

Parameters

  [in] | exoid | exodus file ID returned from a previous call to ex_create() or ex_open().
  [in] | time_step | The time step number, as described under ex_put_time(). This is essentially a counter that is incremented when results variables are output. The first time step is 1.
  [in] | nodal_var_index | The index of the nodal variable. The first variable has an index of 1.
  [in] | num_nodes | The number of nodal points.
  [in] | nodal_var_vals | Array of num_nodes values of the nodal_var_index-th nodal variable for the time_step-th time step.

As an example, the following code segment writes all the nodal variables for a single time step:

int num_nod_vars, num_nodes, error, exoid, time_step;
float *nodal_var_vals;
/* write nodal variables */
nodal_var_vals = (float *) calloc(num_nodes, sizeof(float));
for (k=1; k <= num_nod_vars; k++) {
for (j=0; j < num_nodes; j++) {
/* application code fills in this array */
nodal_var_vals[j] = 10.0;
}
error = ex_put_nodal_var(exoid, time_step, k, num_nodes,
nodal_var_vals);
}

Examples
  /test/testwt-groups.c, /test/testwt-nface-nside.c, and /test/twod.c.

## ◆ ex_put_nodal_var_slab()

SEACAS_DEPRECATED int ex_put_nodal_var_slab | ( | int | exoid,
|  | int | time_step,
|  | int | nodal_var_index,
|  | int64_t | start_pos,
|  | int64_t | num_vals,
|  | void * | nodal_var_vals
| ) |  |

Deprecated:
  Use ex_put_partial_var()(exoid, time_step, EX_NODAL, nodal_var_index, 1, start_pos, num_vals, nodal_var_vals) instead.

## ◆ ex_put_node_cmap()

int ex_put_node_cmap | ( | int | exoid,
|  | ex_entity_id | map_id,
|  | void_int * | node_ids,
|  | void_int * | proc_ids,
|  | int | processor
| ) |  |

Examples
  /test/test_nemesis.c.

## ◆ ex_put_node_map()

SEACAS_DEPRECATED int ex_put_node_map | ( | int | exoid,
|  | ex_entity_id | map_id,
|  | const void_int * | node_map
| ) |  |

writes an node map; this is a vector of integers of length number of nodes

Parameters

  exoid | exodus file id
  map_id | node map id
  node_map | node map

Deprecated:
  Use ex_put_num_map()(exoid, EX_NODE_MAP, map_id, node_map)

## ◆ ex_put_node_num_map()

SEACAS_DEPRECATED int ex_put_node_num_map | ( | int | exoid,
|  | const void_int * | node_map
| ) |  |

Deprecated:
  Use ex_put_id_map()(exoid, EX_NODE_MAP, node_map)

The function ex_put_node_num_map() writes out the optional node number map to the database. See Section LocalNodeIds for a description of the node number map. The function ex_put_init() must be invoked before this call is made.

Returns
  In case of an error, ex_put_node_num_map() returns a negative number; a warning will return a positive number. Possible causes of errors include:
  - data file not properly opened with call to ex_create() or ex_open()
  - data file opened for read only.
  - data file not initialized properly with call to ex_put_init().
  - a node number map already exists in the file.

Parameters

  [in] | exoid | exodus file ID returned from a previous call to ex_create() or ex_open().
  [in] | node_map | The node number map.

The following code generates a default node number map and outputs it to an open exodus file. This is a trivial case and included just for illustration. Since this map is optional, it should be written out only if it contains something other than the default map.

int error, exoid;
int *node_map = (int *)calloc(num_nodes, sizeof(int));
for (i=1; i <= num_nodes; i++)
node_map[i-1] = i;
error = ex_put_node_num_map(exoid, node_map);
/* Equivalent using non-deprecated function */
error = ex_put_id_map(exoid, EX_NODE_MAP, node_map);

Examples
  /test/twod.c.

## ◆ ex_put_node_set()

SEACAS_DEPRECATED int ex_put_node_set | ( | int | exoid,
|  | ex_entity_id | node_set_id,
|  | const void_int * | node_set_node_list
| ) |  |

Deprecated:
  Use ex_put_set()(exoid, EX_NODE_SET, node_set_id, node_set_node_list, NULL)

The function ex_put_node_set() writes the node list for a single node set. The function ex_put_node_set_param() must be called before this routine is invoked.

Returns
  In case of an error, ex_put_node_set() returns a negative number; a warning will return a positive number. Possible causes of errors include:
  - data file not properly opened with call to ex_create() or ex_open()
  - data file opened for read only.
  - data file not initialized properly with call to ex_put_init().
  - ex_put_node_set_param() not called previously.

Parameters

  [in] | exoid | exodus file ID returned from a previous call to ex_create() or ex_open().
  [in] | node_set_id | The node set ID.
  [in] | node_set_node_list | Array containing the node list for the node set. Internal node IDs are used in this list (See Section LocalNodeIds).

Refer to the description of ex_put_node_set_param() for a sample code segment to write out a node set.

## ◆ ex_put_node_set_dist_fact()

SEACAS_DEPRECATED int ex_put_node_set_dist_fact | ( | int | exoid,
|  | ex_entity_id | node_set_id,
|  | const void * | node_set_dist_fact
| ) |  |

Deprecated:
  Use ex_put_set_dist_fact()(exoid, EX_NODE_SET, node_set_id, node_set_dist_fact)

The function ex_put_node_set_dist_fact() writes node set distribution factors for a single node set. The function ex_put_node_set_param() must be called before this routine is invoked.

Because the distribution factors are floating point values, the application code must declare the array passed to be the appropriate type (float or double) to match the compute word size passed in ex_create() or ex_open().

Returns
  In case of an error, ex_put_node_set_dist_fact() returns a negative number; a warning will return a positive number. Possible causes of errors include:
  - data file not properly opened with call to ex_create() or ex_open()
  - data file opened for read only.
  - data file not initialized properly with call to ex_put_init().
  - ex_put_node_set_param() not called previously.
  - a call to ex_put_node_set_param() specified zero distribution factors.

Parameters

  [in] | exoid | exodus file ID returned from a previous call to ex_create() or ex_open().
  [in] | node_set_id | The node set ID.
  [in] | node_set_dist_fact | Array containing the distribution factors in the node set.

Refer to the description of ex_put_node_set_param() for a sample code segment to write out the distribution factors for a node set.

## ◆ ex_put_node_set_param()

SEACAS_DEPRECATED int ex_put_node_set_param | ( | int | exoid,
|  | ex_entity_id | node_set_id,
|  | int64_t | num_nodes_in_set,
|  | int64_t | num_dist_in_set
| ) |  |

Deprecated:
  Use ex_put_set_param()(exoid, EX_NODE_SET, node_set_id, num_nodes_in_set, num_dist_in_set)

The function ex_put_node_set_param() writes the node set ID, the number of nodes which describe a single node set, and the number of node set distribution factors for the node set.

Returns
  In case of an error, ex_put_node_set_param() returns a negative number; a warning will return a positive number. Possible causes of errors include:
  - data file not properly opened with call to ex_create() or ex_open()
  - data file opened for read only.
  - data file not initialized properly with call to ex_put_init().
  - the number of node sets specified in the call to ex_put_init() was zero or has been exceeded.
  - a node set with the same ID has already been stored.
  - the specified number of distribution factors is not zero and is not equal to the number of nodes.

Parameters

  [in] | exoid | exodus file ID returned from a previous call to ex_create() or ex_open().
  [in] | node_set_id | The node set ID.
  [in] | num_nodes_in_set | The number of nodes in the node set.
  [in] | num_dist_in_set | The number of distribution factors in the node set. This should be either 0 (zero) for no factors, or should equal num_nodes_in_set.

The following code segment will write out a node set to an open exodus file :

int id, num_nodes_in_set, num_dist_in_set, error, exoid, *node_list;
float *dist_fact;
/* write node set parameters */
id = 20; num_nodes_in_set = 5; num_dist_in_set = 5;
error = ex_put_node_set_param(exoid, id, num_nodes_in_set,
num_dist_in_set);
/* write node set node list */
node_list = (int *) calloc (num_nodes_in_set, sizeof(int));
node_list[0] = 100; node_list[1] = 101; node_list[2] = 102;
node_list[3] = 103; node_list[4] = 104;
error = ex_put_node_set(exoid, id, node_list);
/* write node set distribution factors */
dist_fact = (float *) calloc (num_dist_in_set, sizeof(float));
dist_fact[0] = 1.0; dist_fact[1] = 2.0; dist_fact[2] = 3.0;
dist_fact[3] = 4.0; dist_fact[4] = 5.0;
error = ex_put_node_set_dist_fact(exoid, id, dist_fact);
/* Same result using non-deprecated functions */
error = ex_put_set_param(exoid, EX_NODE_SET, id, num_nodes_in_set,
num_dist_in_set);
error = ex_put_set(exoid, EX_NODE_SET, id, node_list, NULL);
error = ex_put_set_dist_fact(exoid, EX_NODE_SET, id, dist_fact);

## ◆ ex_put_ns_param_global()

int ex_put_ns_param_global | ( | int | exoid,
|  | void_int * | global_ids,
|  | void_int * | node_cnts,
|  | void_int * | df_cnts
| ) |  |

Examples
  /test/test_nemesis.c.

## ◆ ex_put_nset_var()

SEACAS_DEPRECATED int ex_put_nset_var | ( | int | exoid,
|  | int | time_step,
|  | int | nset_var_index,
|  | ex_entity_id | nset_id,
|  | int64_t | num_nodes_this_nset,
|  | const void * | nset_var_vals
| ) |  |

writes the values of a single nodeset variable for one nodeset at one time step to the database; assume the first time step and nodeset variable index are 1

Parameters

  exoid | exodus file id
  time_step | time step number
  nset_var_index | nodeset variable index
  nset_id | nodeset id
  num_nodes_this_nset | number of nodes in this nodeset
  nset_var_vals | the values to be written

Deprecated:
  Use ex_put_var()(exoid, time_step, EX_NODE_SET, nset_var_index, nset_id, num_nodes_this_nset, nset_var_vals)

Examples
  /test/testwt-groups.c, and /test/twod.c.

## ◆ ex_put_nset_var_tab()

SEACAS_DEPRECATED int ex_put_nset_var_tab | ( | int | exoid,
|  | int | num_nset,
|  | int | num_nset_var,
|  | int * | nset_var_tab
| ) |  |

writes the EXODUS nodeset variable truth table to the database; also, creates netCDF variables in which to store EXODUS nodeset variable values; although this table isn't required (because the netCDF variables can also be created in ex_put_nset_var), this call will save tremendous time because all of the variables are defined at once while the file is in define mode, rather than going in and out of define mode (causing the entire file to be copied over and over) which is what occurs when the nodeset variable values variables are defined in ex_put_nset_var

Parameters

  exoid | exodus file id
  num_nset | number of nodesets
  num_nset_var | number of nodeset variables
  nset_var_tab | nodeset variable truth table array

Deprecated:
  Use ex_put_truth_table()(exoid, EX_NODE_SET, num_nset, num_nset_var, nset_var_tab)

## ◆ ex_put_num_map()

int ex_put_num_map | ( | int | exoid,
|  | ex_entity_type | map_type,
|  | ex_entity_id | map_id,
|  | const void_int * | map
| ) |  |

writes a map; this is a vector of integers of the same length as the number of entries in the source object (nodes, edges, faces, or elements in the file).

Parameters

  exoid | exodus file id
  map_type | type of map (node,edge,face,elem)
  map_id | id to associate with new map
  map | map set value array

Examples
  /test/CreateEdgeFace.c, and /test/testwt1.c.

## ◆ ex_put_one_attr()

int ex_put_one_attr | ( | int | exoid,
|  | ex_entity_type | obj_type,
|  | ex_entity_id | obj_id,
|  | int | attrib_index,
|  | const void * | attrib
| ) |  |

writes the specified attribute for a block

Parameters

  exoid | exodus file id
  obj_type | object type (edge, face, elem block)
  obj_id | object id (edge, face, elem block ID)
  attrib_index | index of attribute to write
  attrib | array of attributes

Examples
  /test/test_ts_files.c, /test/testwt-compress.c, /test/testwt-groups.c, /test/testwt-long-name.c, /test/testwt-nsided.c, /test/testwt-one-attrib.c, /test/testwt-oned.c, /test/testwt.c, and /test/testwt_nc.c.

## ◆ ex_put_one_elem_attr()

SEACAS_DEPRECATED int ex_put_one_elem_attr | ( | int | exoid,
|  | ex_entity_id | elem_blk_id,
|  | int | attrib_index,
|  | const void * | attrib
| ) |  |

writes the specified attribute for an element block

Parameters

  exoid | exodus file id
  elem_blk_id | element block id
  attrib_index | index of attribute to write
  attrib | array of attributes

Deprecated:
  Use ex_put_one_attr()(exoid, EX_ELEM_BLOCK, elem_blk_id, attrib_index, attrib)

## ◆ ex_put_partial_attr()

int ex_put_partial_attr | ( | int | exoid,
|  | ex_entity_type | blk_type,
|  | ex_entity_id | blk_id,
|  | int64_t | start_entity,
|  | int64_t | num_entity,
|  | const void * | attrib
| ) |  |

writes the attributes for an edge/face/element block

Parameters

  exoid | exodus file id
  blk_type | block type
  blk_id | block id
  start_entity | the starting index (1-based) of the attribute to be written
  num_entity | the number of entities to write attributes
  attrib | array of attributes

## ◆ ex_put_partial_conn()

int ex_put_partial_conn | ( | int | exoid,
|  | ex_entity_type | blk_type,
|  | ex_entity_id | blk_id,
|  | int64_t | start_num,
|  | int64_t | num_ent,
|  | const void_int * | nodeconn,
|  | const void_int * | edgeconn,
|  | const void_int * | faceconn
| ) |  |

## ◆ ex_put_partial_coord()

int ex_put_partial_coord | ( | int | exoid,
|  | int64_t | start_node_num,
|  | int64_t | num_nodes,
|  | const void * | x_coor,
|  | const void * | y_coor,
|  | const void * | z_coor
| ) |  |

writes the coordinates of some of the nodes in the model Only writes the 'non-null' arrays.

Parameters

  exoid | exodus file id
  start_node_num | the starting index (1-based) of the coordinates to be written
  num_nodes | the number of nodes to write coordinates for.
  x_coor | x coord array
  y_coor | y coord array
  z_coor | z coord array

Examples
  /test/test_ts_partial_nvar.c, and /test/testwt-partial.c.

## ◆ ex_put_partial_coord_component()

int ex_put_partial_coord_component | ( | int | exoid,
|  | int64_t | start_node_num,
|  | int64_t | num_nodes,
|  | int | component,
|  | const void * | coor
| ) |  |

writes the coordinates of some of the nodes in the model for the specified component

Parameters

  exoid | exodus file id
  start_node_num | the starting index (1-based) of the coordinates to be written
  num_nodes | the number of nodes to write coordinates for.
  component | which component (1=X, 2=Y, 3=Z)
  coor | coord array

## ◆ ex_put_partial_elem_attr()

SEACAS_DEPRECATED int ex_put_partial_elem_attr | ( | int | exoid,
|  | ex_entity_id | elem_blk_id,
|  | int64_t | start_elem_num,
|  | int64_t | num_elems,
|  | void * | attrib
| ) |  |

Deprecated:
  Use ex_put_partial_attr()(exoid, EX_ELEM_BLOCK, elem_blk_id, start_elem_num, num_elems, attrib) instead.

## ◆ ex_put_partial_elem_conn()

SEACAS_DEPRECATED int ex_put_partial_elem_conn | ( | int | exoid,
|  | ex_entity_id | elem_blk_id,
|  | int64_t | start_elem_num,
|  | int64_t | num_elems,
|  | const void_int * | connect
| ) |  |

Deprecated:
  Use ex_put_partial_conn()(exoid, EX_ELEM_BLOCK, elem_blk_id, start_elem_num, num_elems, connect, NULL, NULL)

## ◆ ex_put_partial_elem_map()

SEACAS_DEPRECATED int ex_put_partial_elem_map | ( | int | exoid,
|  | ex_entity_id | map_id,
|  | int64_t | ent_start,
|  | int64_t | ent_count,
|  | const void_int * | elem_map
| ) |  |

writes an element map; this is a vector of integers of length number of elements

Deprecated:
  Use ex_put_partial_num_map()(exoid, EX_ELEM_MAP, map_id, ent_start, ent_count, elem_map) instead

## ◆ ex_put_partial_elem_num_map()

SEACAS_DEPRECATED int ex_put_partial_elem_num_map | ( | int | exoid,
|  | int64_t | start_ent,
|  | int64_t | num_ents,
|  | const void_int * | elem_map
| ) |  |

Deprecated:
  Use ex_put_partial_id_map()(exoid, EX_ELEM_MAP, start_ent, num_ents, elem_map)

## ◆ ex_put_partial_id_map()

int ex_put_partial_id_map | ( | int | exoid,
|  | ex_entity_type | map_type,
|  | int64_t | start_entity_num,
|  | int64_t | num_entities,
|  | const void_int * | map
| ) |  |

writes out a portion of the entity numbering map to the database; this allows the entity numbers to be non-contiguous. This map is used for mapping between local and global entity ids.

Parameters

  exoid | exodus file id
  map_type |
  start_entity_num |
  num_entities |
  map | element numbering map array

## ◆ ex_put_partial_node_num_map()

SEACAS_DEPRECATED int ex_put_partial_node_num_map | ( | int | exoid,
|  | int64_t | start_ent,
|  | int64_t | num_ents,
|  | const void_int * | node_map
| ) |  |

Deprecated:
  Use ex_put_partial_id_map()(exoid, EX_NODE_MAP, start_ent, num_ents, node_map)

## ◆ ex_put_partial_node_set()

SEACAS_DEPRECATED int ex_put_partial_node_set | ( | int | exoid,
|  | ex_entity_id | node_set_id,
|  | int64_t | start_node_num,
|  | int64_t | num_nodes,
|  | const void_int * | node_set_node_list
| ) |  |

Deprecated:
  Use ex_put_partial_set()(exoid, EX_NODE_SET, node_set_id, start_node_num, num_nodes, node_set_node_list, NULL)

## ◆ ex_put_partial_node_set_df()

SEACAS_DEPRECATED int ex_put_partial_node_set_df | ( | int | exoid,
|  | ex_entity_id | node_set_id,
|  | int64_t | start_num,
|  | int64_t | num_df_to_get,
|  | void * | node_set_dist_fact
| ) |  |

Deprecated:
  Use ex_put_partial_set_dist_fact()(exoid, EX_NODE_SET, node_set_id, start_num, num_df_to_get, node_set_dist_fact)

## ◆ ex_put_partial_num_map()

int ex_put_partial_num_map | ( | int | exoid,
|  | ex_entity_type | map_type,
|  | ex_entity_id | map_id,
|  | int64_t | ent_start,
|  | int64_t | ent_count,
|  | const void_int * | map
| ) |  |

writes a map; this is a vector of integers of length number of mesh objects of that type (element, node, face, edge)

Examples
  /test/testwt1.c.

## ◆ ex_put_partial_one_attr()

int ex_put_partial_one_attr | ( | int | exoid,
|  | ex_entity_type | obj_type,
|  | ex_entity_id | obj_id,
|  | int64_t | start_num,
|  | int64_t | num_ent,
|  | int | attrib_index,
|  | const void * | attrib
| ) |  |

writes the specified attribute for a block

Parameters

  exoid | exodus file id
  obj_type | object type (edge, face, elem block)
  obj_id | object id (edge, face, elem block ID)
  start_num | the starting index of the attributes to be written
  num_ent | the number of entities to write attributes for.
  attrib_index | index of attribute to write
  attrib | array of attributes

Examples
  /test/testwt-partial.c.

## ◆ ex_put_partial_set()

int ex_put_partial_set | ( | int | exoid,
|  | ex_entity_type | set_type,
|  | ex_entity_id | set_id,
|  | int64_t | offset,
|  | int64_t | num_to_put,
|  | const void_int * | set_entry_list,
|  | const void_int * | set_extra_list
| ) |  |

writes the set entry list and set extra list for a single set

Parameters

  exoid | exodus file id
  set_type | set type
  set_id | set id
  offset | The initial entity (1-based) to be output
  num_to_put | The number of entities to output
  *set_entry_list | array of entries in set. Set to NULL to not write.
  *set_extra_list | array of extras in set. Set to NULL to not write.

## ◆ ex_put_partial_set_dist_fact()

int ex_put_partial_set_dist_fact | ( | int | exoid,
|  | ex_entity_type | set_type,
|  | ex_entity_id | set_id,
|  | int64_t | offset,
|  | int64_t | num_to_put,
|  | const void * | set_dist_fact
| ) |  |

writes the partial distribution factors for a single set

Parameters

  exoid | exodus file id
  set_type | set type
  set_id | set id
  offset | index (1-based) of first dist factor to write
  num_to_put | number of dist factors to write.
  *set_dist_fact | array of dist factors for set

## ◆ ex_put_partial_side_set()

SEACAS_DEPRECATED int ex_put_partial_side_set | ( | int | exoid,
|  | ex_entity_id | side_set_id,
|  | int64_t | start_side_num,
|  | int64_t | num_sides,
|  | const void_int * | side_set_elem_list,
|  | const void_int * | side_set_side_list
| ) |  |

Deprecated:
  Use ex_put_partial_set()(exoid, EX_SIDE_SET, side_set_id, start_side_num, num_sides, side_set_elem_list, side_set_side_list)

## ◆ ex_put_partial_side_set_df()

SEACAS_DEPRECATED int ex_put_partial_side_set_df | ( | int | exoid,
|  | ex_entity_id | side_set_id,
|  | int64_t | start_num,
|  | int64_t | num_df_to_get,
|  | void * | side_set_dist_fact
| ) |  |

Deprecated:
  Use ex_put_partial_set_dist_fact()(exoid, EX_SIDE_SET, side_set_id, start_num, num_df_to_get, side_set_dist_fact)

## ◆ ex_put_processor_elem_maps()

int ex_put_processor_elem_maps | ( | int | exoid,
|  | void_int * | elem_mapi,
|  | void_int * | elem_mapb,
|  | int | processor
| ) |  |

Examples
  /test/test_nemesis.c.

## ◆ ex_put_processor_node_maps()

int ex_put_processor_node_maps | ( | int | exoid,
|  | void_int * | node_mapi,
|  | void_int * | node_mapb,
|  | void_int * | node_mape,
|  | int | proc_id
| ) |  |

Examples
  /test/test_nemesis.c.

## ◆ ex_put_prop()

int ex_put_prop | ( | int | exoid,
|  | ex_entity_type | obj_type,
|  | ex_entity_id | obj_id,
|  | const char * | prop_name,
|  | ex_entity_id | value
| ) |  |

The function ex_put_prop() stores an integer object property value to a single element block, node set, or side set. Although it is not necessary to invoke ex_put_prop_names(), since ex_put_prop() will allocate space within the data file if it hasn't been previously allocated, it is more efficient to use ex_put_prop_names() if there is more than one property to store.

It should be noted that the interpretation of the values of the integers stored as properties is left to the application code. In general, a zero (0) means the object does not have the specified property (or is not in the specified group); a nonzero value means the object does have the specified property. When space is allocated for the properties using ex_put_prop_names() or ex_put_prop(), the properties are initialized to zero (0).

Because the ID of an element block, node set, or side set is just another property (named ID), this routine can be used to change the value of an ID. This feature must be used with caution, though, because changing the ID of an object to the ID of another object of the same type (element block, node set, or side set) would cause two objects to have the same ID, and thus only the first would be accessible. Therefore, ex_put_prop() issues a warning if a user attempts to give two objects the same ID.

Returns
  In case of an error, ex_put_prop() returns a negative number; a warning will return a positive number. Possible causes of errors include:
  - data file not properly opened with call to ex_create() or ex_open()
  - data file opened for read only.
  - data file not initialized properly with call to ex_put_init().
  - invalid object type specified.
  - a warning is issued if a user attempts to change the ID of an object to the ID of an existing object of the same type.

Parameters

  [in] | exoid | exodus file ID returned from a previous call to ex_create() or ex_open().
  [in] | obj_type | Type of object; use one of the options in the table below.
  [in] | obj_id | The element block, node set, or side set ID.
  [in] | prop_name | The name of the property for which the value will be stored. Maximum length of this string is `MAX_STR_LENGTH` .
  [in] | value | The value of the property.

ex_entity_type | description
--- | ---
EX_NODE_SET | Node Set entity type
EX_EDGE_BLOCK | Edge Block entity type
EX_EDGE_SET | Edge Set entity type
EX_FACE_BLOCK | Face Block entity type
EX_FACE_SET | Face Set entity type
EX_ELEM_BLOCK | Element Block entity type
EX_ELEM_SET | Element Set entity type
EX_SIDE_SET | Side Set entity type
EX_ELEM_MAP | Element Map entity type
EX_NODE_MAP | Node Map entity type
EX_EDGE_MAP | Edge Map entity type
EX_FACE_MAP | Face Map entity type

For an example of code to write out an object property, refer to the description for ex_put_prop_names().

Examples
  /test/test_ts_files.c, /test/testrdwt.c, /test/testwt-compress.c, /test/testwt-groups.c, /test/testwt-long-name.c, /test/testwt-nsided.c, /test/testwt-oned.c, /test/testwt-partial.c, /test/testwt-zeroe.c, /test/testwt.c, /test/testwt1.c, /test/testwt2.c, /test/testwt_clb.c, /test/testwt_nc.c, /test/testwt_nossnsdf.c, /test/testwtd.c, and /test/testwtm.c.

## ◆ ex_put_prop_array()

int ex_put_prop_array | ( | int | exoid,
|  | ex_entity_type | obj_type,
|  | const char * | prop_name,
|  | const void_int * | values
| ) |  |

The function ex_put_prop_array() stores an array of ({num_elem_blk}, num_node_sets, or num_side_sets) integer property values for all element blocks, node sets, or side sets. The order of the values in the array must correspond to the order in which the element blocks, node sets, or side sets were introduced into the file. For instance, if the parameters for element block with ID 20 were written to a file (via ex_put_elem_block()), and then parameters for element block with ID 10, followed by the parameters for element block with ID 30, the first, second, and third elements in the property array would correspond to element block 20, element block 10, and element block 30, respectively.

One should note that this same functionality (writing properties to multiple objects) can be accomplished with multiple calls to ex_put_prop().

Although it is not necessary to invoke ex_put_prop_names(), since ex_put_prop_array() will allocate space within the data file if it hasn't been previously allocated, it is more efficient to use ex_put_prop_names() if there is more than one property to store.

Returns
  In case of an error, ex_put_prop_array() returns a negative number; a warning will return a positive number. Possible causes of errors include:
  - data file not properly opened with call to ex_create() or ex_open()
  - data file opened for read only.
  - data file not initialized properly with call to ex_put_init().
  - invalid object type specified.

Parameters

  [in] | exoid | exodus file ID returned from a previous call to ex_create() or ex_open().
  [in] | obj_type | Type of object; use one of the options in the table below.
  [in] | prop_name | The name of the property for which the values will be stored. Maximum length of this string is `MAX_STR_LENGTH` .
  [in] | values | An array of property values.

ex_entity_type | description
--- | ---
EX_NODE_SET | Node Set entity type
EX_EDGE_BLOCK | Edge Block entity type
EX_EDGE_SET | Edge Set entity type
EX_FACE_BLOCK | Face Block entity type
EX_FACE_SET | Face Set entity type
EX_ELEM_BLOCK | Element Block entity type
EX_ELEM_SET | Element Set entity type
EX_SIDE_SET | Side Set entity type
EX_ELEM_MAP | Element Map entity type
EX_NODE_MAP | Node Map entity type
EX_EDGE_MAP | Edge Map entity type
EX_FACE_MAP | Face Map entity type

For an example of code to write an array of object properties, refer to the description for ex_put_prop_names().

Examples
  /test/test_ts_files.c, /test/testrdwt.c, /test/testwt-compress.c, /test/testwt-groups.c, /test/testwt-long-name.c, /test/testwt-nsided.c, /test/testwt-oned.c, /test/testwt-partial.c, /test/testwt-zeroe.c, /test/testwt.c, /test/testwt1.c, /test/testwt2.c, /test/testwt_clb.c, /test/testwt_nc.c, /test/testwt_nossnsdf.c, /test/testwtd.c, and /test/testwtm.c.

## ◆ ex_put_prop_names()

int ex_put_prop_names | ( | int | exoid,
|  | ex_entity_type | obj_type,
|  | int | num_props,
|  | char ** | prop_names
| ) |  |

The function ex_put_prop_names() writes object property names and allocates space for object property arrays used to assign integer properties to element blocks, node sets, or side sets. The property arrays are initialized to zero (0). Although this function is optional, since ex_put_prop() will allocate space within the data file if it hasn't been previously allocated, it is more efficient to use ex_put_prop_names() if there is more than one property to store.

Returns
  In case of an error, ex_put_prop_names() returns a negative number; a warning will return a positive number. Possible causes of errors include:
  - data file not properly opened with call to ex_create() or ex_open()
  - data file opened for read only.
  - data file not initialized properly with call to ex_put_init().
  - invalid object type specified.
  - no object of the specified type is stored in the file.

Parameters

  [in] | exoid | exodus file ID returned from a previous call to ex_create() or ex_open().
  [in] | obj_type | Type of object; use one of the options in the table below.
  [in] | num_props | The number of integer properties to be assigned to all of the objects of the type specified (element blocks, node sets, or side sets).
  [in] | prop_names | Array containing num_props names (of maximum length of `MAX_STR_LENGTH` ) of properties to be stored.

ex_entity_type | description
--- | ---
EX_NODE_SET | Node Set entity type
EX_EDGE_BLOCK | Edge Block entity type
EX_EDGE_SET | Edge Set entity type
EX_FACE_BLOCK | Face Block entity type
EX_FACE_SET | Face Set entity type
EX_ELEM_BLOCK | Element Block entity type
EX_ELEM_SET | Element Set entity type
EX_SIDE_SET | Side Set entity type
EX_ELEM_MAP | Element Map entity type
EX_NODE_MAP | Node Map entity type
EX_EDGE_MAP | Edge Map entity type
EX_FACE_MAP | Face Map entity type

For instance, suppose a user wanted to assign the 1st, 3rd, and 5th element blocks (those element blocks stored 1st, 3rd, and 5th, regardless of their ID) to a group (property) called TOP, and the 2nd, 3rd, and 4th element blocks to a group called LSIDE. This could be accomplished with the following code:

char* prop_names[2];
int top_part[] = {1,0,1,0,1};
int lside_part[] = {0,1,1,1,0};
int id[] = {10, 20, 30, 40, 50};
prop_names[0] = "TOP";
prop_names[1] = "LSIDE";
/* This call to ex_put_prop_names is optional, but more efficient */
ex_put_prop_names (exoid, EX_ELEM_BLOCK, 2, prop_names);
/* The property values can be output individually thus */
for (i=0; i < 5; i++) {
ex_put_prop (exoid, EX_ELEM_BLOCK, id[i], prop_names[0],
top_part[i]);
ex_put_prop (exoid, EX_ELEM_BLOCK, id[i], prop_names[1],
lside_part[i]);
}
/* Alternatively, the values can be output as an array */
ex_put_prop_array (exoid, EX_ELEM_BLOCK, prop_names[0],
top_part);
ex_put_prop_array (exoid, EX_ELEM_BLOCK, prop_names[1],
lside_part);

Examples
  /test/test_ts_files.c, /test/testrdwt.c, /test/testwt-compress.c, /test/testwt-groups.c, /test/testwt-long-name.c, /test/testwt-oned.c, /test/testwt-partial.c, /test/testwt.c, /test/testwt1.c, /test/testwt2.c, /test/testwt_clb.c, /test/testwt_nc.c, /test/testwt_nossnsdf.c, /test/testwtd.c, and /test/testwtm.c.

## ◆ ex_put_qa()

int ex_put_qa | ( | int | exoid,
|  | int | num_qa_records,
|  | char * | qa_record[][4]
| ) |  |

The function ex_put_qa() writes the QA records to the database. Each QA record contains four MAX_STR_LENGTH-byte character strings. The character strings are:

- the analysis code name
- the analysis code QA descriptor
- the analysis date
- the analysis time

Returns
  In case of an error, ex_put_qa() returns a negative number; a warning will return a positive number. Possible causes of errors include:
  - data file not properly opened with call to ex_create() or ex_open()
  - data file opened for read only.
  - QA records already exist in file.

Parameters

  [in] | exoid | exodus file ID returned from a previous call to ex_create() or ex_open().
  [in] | num_qa_records | The number of QA records.
  [in] | qa_record | Array containing the QA records. To only define the number of qa records instead of defining and outputting, pass NULL for qa_record argument.

The following code segment will write out two QA records:

int num_qa_rec, error, exoid;
char *qa_record[2][4];
/* write QA records */
num_qa_rec = 2;
qa_record[0][0] = "TESTWT1";
qa_record[0][1] = "testwt1";
qa_record[0][2] = "07/07/93";
qa_record[0][3] = "15:41:33";
qa_record[1][0] = "FASTQ";
qa_record[1][1] = "fastq";
qa_record[1][2] = "07/07/93";
qa_record[1][3] = "16:41:33";
error = ex_put_qa (exoid, num_qa_rec, qa_record);

Examples
  /test/test_ts_files.c, /test/testrdwt.c, /test/testwt-compress.c, /test/testwt-groups.c, /test/testwt-long-name.c, /test/testwt-nface-nside.c, /test/testwt-nfaced.c, /test/testwt-nsided.c, /test/testwt-oned.c, /test/testwt-partial.c, /test/testwt-zeroe.c, /test/testwt-zeron.c, /test/testwt.c, /test/testwt1.c, /test/testwt2.c, /test/testwt_clb.c, /test/testwt_nc.c, /test/testwt_nossnsdf.c, /test/testwt_ss.c, /test/testwtd.c, and /test/testwtm.c.

## ◆ ex_put_set()

int ex_put_set | ( | int | exoid,
|  | ex_entity_type | set_type,
|  | ex_entity_id | set_id,
|  | const void_int * | set_entry_list,
|  | const void_int * | set_extra_list
| ) |  |

writes the set entry list and set extra list for a single set

Parameters

  exoid | exodus file id
  set_type | set type
  set_id | set id
  *set_entry_list | array of entries in set. Set to NULL to not write.
  *set_extra_list | array of extras in set. Set to NULL to not write.

Examples
  /test/test_ts_files.c, /test/testrdwt.c, /test/testwt-compress.c, /test/testwt-groups.c, /test/testwt-long-name.c, /test/testwt-nsided.c, /test/testwt-oned.c, /test/testwt-partial.c, /test/testwt-zeroe.c, /test/testwt.c, /test/testwt2.c, /test/testwt_clb.c, /test/testwt_nc.c, /test/testwtd.c, /test/testwtm.c, and /test/twod.c.

## ◆ ex_put_set_dist_fact()

int ex_put_set_dist_fact | ( | int | exoid,
|  | ex_entity_type | set_type,
|  | ex_entity_id | set_id,
|  | const void * | set_dist_fact
| ) |  |

writes the distribution factors for a single set

Parameters

  exoid | exodus file id
  set_type | set type
  set_id | set id
  *set_dist_fact | array of dist factors for set

Examples
  /test/test_ts_files.c, /test/testrdwt.c, /test/testwt-compress.c, /test/testwt-groups.c, /test/testwt-long-name.c, /test/testwt-nsided.c, /test/testwt-oned.c, /test/testwt-partial.c, /test/testwt-zeroe.c, /test/testwt.c, /test/testwt2.c, /test/testwt_clb.c, /test/testwt_nc.c, /test/testwtd.c, and /test/testwtm.c.

## ◆ ex_put_set_param()

int ex_put_set_param | ( | int | exoid,
|  | ex_entity_type | set_type,
|  | ex_entity_id | set_id,
|  | int64_t | num_entries_in_set,
|  | int64_t | num_dist_fact_in_set
| ) |  |

writes the set id and the number of entries which describe a single set

Parameters

  exoid | exodus file id
  set_type | the type of set
  set_id | set id
  num_entries_in_set | number of entries in the set
  num_dist_fact_in_set | number of distribution factors in the set

Examples
  /test/test_ts_files.c, /test/testrdwt.c, /test/testwt-compress.c, /test/testwt-groups.c, /test/testwt-long-name.c, /test/testwt-nsided.c, /test/testwt-oned.c, /test/testwt-partial.c, /test/testwt-zeroe.c, /test/testwt.c, /test/testwt2.c, /test/testwt_nc.c, /test/testwtd.c, /test/testwtm.c, and /test/twod.c.

## ◆ ex_put_sets()

int ex_put_sets | ( | int | exoid,
|  | size_t | set_count,
|  | const struct ex_set * | sets
| ) |  |

writes the set parameters and optionally set data for 1 or more sets

Parameters

  exoid | exodus file id
  set_count | number of sets to write
  *sets | array of ex_set structures

Examples
  /test/CreateEdgeFace.c.

## ◆ ex_put_side_set()

SEACAS_DEPRECATED int ex_put_side_set | ( | int | exoid,
|  | ex_entity_id | side_set_id,
|  | const void_int * | side_set_elem_list,
|  | const void_int * | side_set_side_list
| ) |  |

writes the side set element list and side set side list for a single side set

Parameters

  exoid | exodus file id
  side_set_id | side set id
  *side_set_elem_list | array of elements in side set
  *side_set_side_list | array of sides in side set

Deprecated:
  Use ex_put_set()(exoid, EX_SIDE_SET, side_set_id, side_set_elem_list, side_set_side_list)

## ◆ ex_put_side_set_dist_fact()

SEACAS_DEPRECATED int ex_put_side_set_dist_fact | ( | int | exoid,
|  | ex_entity_id | side_set_id,
|  | const void * | side_set_dist_fact
| ) |  |

writes the distribution factors for a single side set

Parameters

  exoid | exodus file id
  side_set_id | side set id
  *side_set_dist_fact | array of dist factors for side set

Deprecated:
  Use ex_put_set_dist_fact()(exoid, EX_SIDE_SET, side_set_id, side_set_dist_fact)

## ◆ ex_put_side_set_param()

SEACAS_DEPRECATED int ex_put_side_set_param | ( | int | exoid,
|  | ex_entity_id | side_set_id,
|  | int64_t | num_side_in_set,
|  | int64_t | num_dist_fact_in_set
| ) |  |

writes the side set id and the number of sides (edges or faces) which describe a single side set

Parameters

  exoid | exodus file id
  side_set_id | side set id
  num_side_in_set | number of sides in the side set
  num_dist_fact_in_set | number of distribution factors in the side set

Deprecated:
  Use ex_put_set_param()(exoid, EX_SIDE_SET, side_set_id, num_side_in_set, num_dist_fact_in_set)

## ◆ ex_put_ss_param_global()

int ex_put_ss_param_global | ( | int | exoid,
|  | void_int * | global_ids,
|  | void_int * | side_cnts,
|  | void_int * | df_cnts
| ) |  |

Examples
  /test/test_nemesis.c.

## ◆ ex_put_sset_var()

SEACAS_DEPRECATED int ex_put_sset_var | ( | int | exoid,
|  | int | time_step,
|  | int | sset_var_index,
|  | ex_entity_id | sset_id,
|  | int64_t | num_faces_this_sset,
|  | const void * | sset_var_vals
| ) |  |

writes the values of a single sideset variable for one sideset at one time step to the database; assume the first time step and sideset variable index are 1

Parameters

  exoid | exodus file id
  time_step | time step number
  sset_var_index | sideset variable index
  sset_id | sideset id
  num_faces_this_sset | number of faces in this sideset
  sset_var_vals | the variable values to be written

Deprecated:
  Use ex_put_var()(exoid, time_step, EX_SIDE_SET, sset_var_index, sset_id, num_faces_this_sset, sset_var_vals)

Examples
  /test/testwt-groups.c, and /test/twod.c.

## ◆ ex_put_sset_var_tab()

SEACAS_DEPRECATED int ex_put_sset_var_tab | ( | int | exoid,
|  | int | num_sset,
|  | int | num_sset_var,
|  | int * | sset_var_tab
| ) |  |

writes the EXODUS sideset variable truth table to the database; also, creates netCDF variables in which to store EXODUS sideset variable values; although this table isn't required (because the netCDF variables can also be created in ex_put_sset_var), this call will save tremendous time because all of the variables are defined at once while the file is in define mode, rather than going in and out of define mode (causing the entire file to be copied over and over) which is what occurs when the sideset variable values variables are defined in ex_put_sset_var

Parameters

  exoid | exodus file id
  num_sset | number of sidesets
  num_sset_var | number of sideset variables
  *sset_var_tab | sideset variable truth table array

Deprecated:
  Use ex_put_truth_table()(exoid, EX_SIDE_SET, num_sset, num_sset_var, sset_var_tab)

## ◆ ex_put_time()

int ex_put_time | ( | int | exoid,
|  | int | time_step,
|  | const void * | time_value
| ) |  |

The function ex_put_time() writes the time value for a specified time step.

Because time values are floating point values, the application code must declare the array passed to be the appropriate type (float or double) to match the compute word size passed in ex_create() or ex_open().

Returns
  In case of an error, ex_put_time() returns a negative number; a warning will return a positive number. Possible causes of errors include:
  - data file not properly opened with call to ex_create() or ex_open()
  - data file opened for read only.

Parameters

  [in] | exoid | exodus file ID returned from a previous call to ex_create() or ex_open().
  [in] | time_step | The time step number. This is essentially a counter that is incremented only when results variables are output to the data file. The first time step is 1.
  [in] | time_value | The time at the specified time step.

The following code segment will write out the simulation time value at simulation time step n:

int error, exoid, n;
float time_value;
/* write time value */
error = ex_put_time (exoid, n, &time_value);

Examples
  /test/create_mesh.c, /test/CreateEdgeFace.c, /test/rd_wt_mesh.c, /test/test_ts_files.c, /test/test_ts_nvar.c, /test/test_ts_partial_nvar.c, /test/testwt-compress.c, /test/testwt-groups.c, /test/testwt-localization.C, /test/testwt-long-name.c, /test/testwt-nface-nside.c, /test/testwt-nsided.c, /test/testwt-oned.c, /test/testwt-partial.c, /test/testwt-zeroe.c, /test/testwt-zeron.c, /test/testwt.c, /test/testwt1.c, /test/testwt2.c, /test/testwt_clb.c, /test/testwt_nc.c, /test/testwt_nossnsdf.c, /test/testwtd.c, /test/testwtm.c, and /test/twod.c.

## ◆ ex_put_var()

int ex_put_var | ( | int | exoid,
|  | int | time_step,
|  | ex_entity_type | var_type,
|  | int | var_index,
|  | ex_entity_id | obj_id,
|  | int64_t | num_entries_this_obj,
|  | const void * | var_vals
| ) |  |

Examples
  /test/create_mesh.c, /test/CreateEdgeFace.c, /test/rd_wt_mesh.c, /test/test_ts_files.c, /test/test_ts_nvar.c, /test/testwt-compress.c, /test/testwt-groups.c, /test/testwt-localization.C, /test/testwt-long-name.c, /test/testwt-nface-nside.c, /test/testwt-nsided.c, /test/testwt-oned.c, /test/testwt-partial.c, /test/testwt-zeroe.c, /test/testwt-zeron.c, /test/testwt.c, /test/testwt1.c, /test/testwt2.c, /test/testwt_clb.c, /test/testwt_nc.c, /test/testwt_nossnsdf.c, /test/testwtd.c, /test/testwtm.c, and /test/twod.c.

## ◆ ex_set_err()

void ex_set_err | ( | const char * | module_name,
|  | const char * | message,
|  | int | err_num
| ) |  |

## ◆ ex_set_int64_status()

int ex_set_int64_status | ( | int | exoid,
|  | int | mode
| ) |  |

## ◆ ex_set_max_name_length()

int ex_set_max_name_length | ( | int | exoid,
|  | int | length
| ) |  |

Examples
  /test/testrd-long-name.c, and /test/testwt-oned.c.

## ◆ ex_set_option()

int ex_set_option | ( | int | exoid,
|  | ex_option_type | option,
|  | int | option_value
| ) |  |

Examples
  /test/create_mesh.c, /test/testwt-compress.c, and /test/testwt-long-name.c.

## ◆ ex_set_parallel()

int ex_set_parallel | ( | int | exoid,
|  | int | is_parallel
| ) |  |

ex_set_parallel() sets the parallel setting for a file. returns 1 (true) or 0 (false) depending on the current setting. Do not use this unless you know what you are doing and why you are doing it. One use is if calling ex_get_partial_set() in a serial mode (proc 0 only) on a file opened in parallel. Make sure to reset the value to original value after done with special case...

Parameters

  exoid | integer which uniquely identifies the file of interest.
  is_parallel | 1 if parallel, 0 if serial.

## ◆ ex_strerror()

const char* ex_strerror | ( | int | err_num | ) |

## ◆ ex_update()

int ex_update | ( | int | exoid | ) |

updates an opened EXODUS file (or EXODUS history file)

Parameters

  exoid | exodus file id

Examples
  /test/test_ts_files.c, /test/testwt-compress.c, /test/testwt-groups.c, /test/testwt-localization.C, /test/testwt-long-name.c, /test/testwt-nface-nside.c, /test/testwt-nsided.c, /test/testwt-oned.c, /test/testwt-partial.c, /test/testwt-zeroe.c, /test/testwt-zeron.c, /test/testwt.c, /test/testwt1.c, /test/testwt2.c, /test/testwt_clb.c, /test/testwt_nc.c, /test/testwt_nossnsdf.c, /test/testwtd.c, and /test/testwtm.c.

## ◆ ex_var_type_to_ex_entity_type()

ex_entity_type ex_var_type_to_ex_entity_type | ( | char | var_type | ) |

## Variable Documentation

## ◆ exerrval

int exerrval

shared error return value

## ◆ exoptval

int exoptval

error reporting flag (default is quiet)