Exodus: include/exodusII.h File Reference

#include "exodus_config.h"
#include "netcdf.h"
#include <stddef.h>
#include <stdint.h>
#include <stdlib.h>

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	EXODUS_VERSION "7.24"

#define	EXODUS_VERSION_MAJOR 7

#define	EXODUS_VERSION_MINOR 24

#define	EXODUS_RELEASE_DATE "August 5, 2019"

#define	EX_API_VERS 7.24f

#define	EX_API_VERS_NODOT (100 * EXODUS_VERSION_MAJOR + EXODUS_VERSION_MINOR)

#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

#define	EX_NOERR 0

#define	EX_WARN 1

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_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_info (int exoid, char **info)

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

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

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

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

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, ex_inquiry req_info, void_int , float , char *)

int64_t	ex_inquire_int (int exoid, ex_inquiry 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_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_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_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_time (int exoid, int time_step, const void *time_value)

int	ex_get_all_times (int exoid, void *time_values)

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

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

int	ex_create_group (int parent_id, const char *group_name)

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_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_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_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_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_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, const 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_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_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)

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.24f

◆ EX_API_VERS_NODOT

#define EX_API_VERS_NODOT (100 * EXODUS_VERSION_MAJOR + EXODUS_VERSION_MINOR)

◆ EX_FALSE

#define EX_FALSE 0

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

◆ 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_TRUE

#define EX_TRUE -1

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

◆ EX_VERS

#define EX_VERS EX_API_VERS

◆ EXODUS_EXPORT

#define EXODUS_EXPORT extern

◆ EXODUS_RELEASE_DATE

#define EXODUS_RELEASE_DATE "August 5, 2019"

◆ EXODUS_VERSION

#define EXODUS_VERSION "7.24"

◆ EXODUS_VERSION_MAJOR

#define EXODUS_VERSION_MAJOR 7

◆ EXODUS_VERSION_MINOR

#define EXODUS_VERSION_MINOR 24

◆ 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_copy_string()

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

Undocumented:: Safer than strncpy – guarantees null termination

Examples: /test/create_mesh.c, /test/CreateEdgeFace.c, /test/rd_wt_mesh.c, /test/test_nemesis.c, /test/test_ts_files.c, /test/testwt-compress.c, /test/testwt-nface-nside.c, /test/testwt-nfaced.c, and /test/testwt.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_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_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_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_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.

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_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_idx()

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

Parameters

exoid	NetCDF/Exodus file ID
ne_var_name	Nemesis index variable name
my_index	array of length 2 to hold results
pos	position of this proc/cmap in index

◆ 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.

Parameters

exoid	NetCDF/Exodus file ID
elem_blk_id	Element block ID
start_elem_num	Starting position to read from
num_elems	Number of elements to read
attrib	Attribute

◆ 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

Parameters

exoid	NetCDF/Exodus file ID
elem_blk_id	Element block ID
start_elem_num	Starting position to read from
num_elems	Number of elements to read
connect	Connectivity vector

◆ 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

Parameters

exoid	NetCDF/Exodus file ID
start_ent	Starting position to read from
num_ents	Number of elements to read
elem_map	element map numbers

◆ 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

Parameters

exoid	NetCDF/Exodus file ID
start_ent	starting node number
num_ents	number of nodes to read
node_map	vector for node map

◆ 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

Parameters

exoid	NetCDF/Exodus file ID
node_set_id	Node set ID
start_node_num	Node index to start reading at
num_nodes	Number of nodes to read
node_set_node_list	List of nodes in node set

◆ 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

Parameters

exoid	NetCDF/Exodus file ID
node_set_id	Node-set ID
start_num	Starting df number
num_df_to_get	Number of df's to read
node_set_dist_fact	Distribution factors

◆ 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

Parameters

exoid	NetCDF/Exodus file ID
side_set_id	Side-set ID to read
start_side_num	Starting element number
num_sides	Number of sides to read
side_set_elem_list	List of element IDs
side_set_side_list	List of side IDs

◆ 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

Parameters

exoid	NetCDF/Exodus file ID
side_set_id	Side-set ID
start_num	Starting df number
num_df_to_get	Number of df's to read
side_set_dist_fact	Distribution factors

◆ 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_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.

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

Parameters

exoid	NetCDF/Exodus file ID
elem_blk_id	Element block ID
start_elem_num	Starting position to read from
num_elems	Number of elements to read
attrib	Attribute

◆ 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

Parameters

exoid	NetCDF/Exodus file ID
elem_blk_id	Element block ID
start_elem_num	Starting position to read from
num_elems	Number of elements to read
connect	Connectivity vector

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

Parameters

exoid	NetCDF/Exodus file ID
start_ent	Starting position to read from
num_ents	Number of elements to read
elem_map	element map numbers

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

Parameters

exoid	NetCDF/Exodus file ID
start_ent	starting node number
num_ents	number of nodes to read
node_map	vector for 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)

Parameters

exoid	NetCDF/Exodus file ID
node_set_id	Node set ID
start_node_num	Node index to start reading at
num_nodes	Number of nodes to read
node_set_node_list	List of nodes in node set

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

Parameters

exoid	NetCDF/Exodus file ID
node_set_id	Node-set ID
start_num	Starting df number
num_df_to_get	Number of df's to read
node_set_dist_fact	Distribution factors

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

Parameters

exoid	NetCDF/Exodus file ID
side_set_id	Side-set ID to read
start_side_num	Starting element number
num_sides	Number of sides to read
side_set_elem_list	List of element IDs
side_set_side_list	List of side IDs

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

Parameters

exoid	NetCDF/Exodus file ID
side_set_id	Side-set ID
start_num	Starting df number
num_df_to_get	Number of df's to read
side_set_dist_fact	Distribution factors

◆ 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_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_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_name_of_object()

char* ex_name_of_object ( ex_entity_type obj_type )

Undocumented:

◆ 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.

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_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_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.

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 element */
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_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.

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)

Parameters

exoid	NetCDF/Exodus file ID
time_step	time index
elem_var_index	elemental variable index
elem_blk_id	elemental block id
start_pos	Starting position to write to
num_vals	Number of elements to write
elem_var_vals	variable values

◆ 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_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.

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

Parameters

exoid	NetCDF/Exodus file ID
elem_blk_id	Element block ID
start_elem_num	Starting position to write to
num_elems	Number of elements to write
attrib	Attribute

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

Parameters

exoid	NetCDF/Exodus file ID
elem_blk_id	Element block ID
start_elem_num	Starting position to write to
num_elems	Number of elements to write
connect	Connectivity vector

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

Parameters

exoid	NetCDF/Exodus file ID
node_set_id	Node set ID
start_node_num	Node index to start writing at
num_nodes	Number of nodes to write
node_set_node_list	List of nodes in node set

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

Parameters

exoid	NetCDF/Exodus file ID
node_set_id	Node-set ID
start_num	Starting df number
num_df_to_get	Number of df's to write
node_set_dist_fact	Distribution factors

◆ 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

Parameters

exoid	NetCDF/Exodus file ID
side_set_id	Side-set ID to write
start_side_num	Starting element number
num_sides	Number of sides to write
side_set_elem_list	List of element IDs
side_set_side_list	List of side IDs

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

Parameters

exoid	NetCDF/Exodus file ID
side_set_id	Side-set ID
start_num	Starting df number
num_df_to_get	Number of df's to write
side_set_dist_fact	Distribution factors

◆ 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_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.

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_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_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_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.

Parameters

exoid	NetCDF/Exodus file ID
elem_blk_id	Element block ID
start_elem_num	Starting position to write to
num_elems	Number of elements to write
attrib	Attribute

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

Parameters

exoid	NetCDF/Exodus file ID
elem_blk_id	Element block ID
start_elem_num	Starting position to write to
num_elems	Number of elements to write
connect	Connectivity vector

◆ 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_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)

Parameters

exoid	NetCDF/Exodus file ID
node_set_id	Node set ID
start_node_num	Node index to start writing at
num_nodes	Number of nodes to write
node_set_node_list	List of nodes in node set

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

Parameters

exoid	NetCDF/Exodus file ID
node_set_id	Node-set ID
start_num	Starting df number
num_df_to_get	Number of df's to write
node_set_dist_fact	Distribution factors

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

Parameters

exoid	NetCDF/Exodus file ID
side_set_id	Side-set ID to write
start_side_num	Starting element number
num_sides	Number of sides to write
side_set_elem_list	List of element IDs
side_set_side_list	List of side IDs

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

Parameters

exoid	NetCDF/Exodus file ID
side_set_id	Side-set ID
start_num	Starting df number
num_df_to_get	Number of df's to write
side_set_dist_fact	Distribution factors

◆ 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_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_var_type_to_ex_entity_type()

ex_entity_type ex_var_type_to_ex_entity_type ( char var_type )

Undocumented:

Variable Documentation

◆ exerrval

int exerrval

shared error return value

◆ exoptval

int exoptval

error reporting flag (default is quiet)

Data Structures

Macros

Typedefs

Enumerations

Functions

Variables

Macro Definition Documentation

◆ EX_API_VERS

◆ EX_API_VERS_NODOT

◆ EX_FALSE

◆ EX_INVALID_ID

◆ EX_TRUE

◆ EX_VERS

◆ EXODUS_EXPORT

◆ EXODUS_RELEASE_DATE

◆ EXODUS_VERSION

◆ EXODUS_VERSION_MAJOR

◆ EXODUS_VERSION_MINOR

◆ NEMESIS_API_VERSION

◆ NEMESIS_API_VERSION_NODOT

◆ NEMESIS_FILE_VERSION

◆ SEACAS_DEPRECATED

Typedef Documentation

◆ ex_entity_id

◆ ex_entity_type

◆ ex_inquiry

◆ ex_options

◆ void_int

Enumeration Type Documentation

◆ ex_entity_type

◆ ex_inquiry

◆ ex_options

Function Documentation

◆ ex_copy_string()

◆ ex_get_concat_node_sets()

◆ ex_get_concat_side_sets()

◆ ex_get_elem_attr()

◆ ex_get_elem_attr_names()

◆ ex_get_elem_blk_ids()

◆ ex_get_elem_block()

◆ ex_get_elem_conn()

◆ ex_get_elem_map()

◆ ex_get_elem_num_map()

◆ ex_get_elem_var()

◆ ex_get_elem_var_tab()

◆ ex_get_elem_var_time()

◆ ex_get_glob_var_time()

◆ ex_get_idx()

◆ ex_get_n_attr()

◆ ex_get_n_conn()

◆ ex_get_n_coord()

◆ ex_get_n_elem_attr()

◆ ex_get_n_elem_conn()

◆ ex_get_n_elem_num_map()

◆ ex_get_n_node_num_map()

◆ ex_get_n_node_set()

◆ ex_get_n_node_set_df()

◆ ex_get_n_one_attr()

◆ ex_get_n_side_set()

◆ ex_get_n_side_set_df()

◆ ex_get_nodal_var_time()

◆ ex_get_node_map()

◆ ex_get_node_num_map()

◆ ex_get_node_set()

◆ ex_get_node_set_dist_fact()

◆ ex_get_node_set_ids()

◆ ex_get_node_set_param()

◆ ex_get_nset_var()

◆ ex_get_nset_var_tab()

◆ ex_get_one_elem_attr()

◆ ex_get_partial_elem_attr()

◆ ex_get_partial_elem_conn()

◆ ex_get_partial_elem_map()

◆ ex_get_partial_elem_num_map()

◆ ex_get_partial_node_num_map()

◆ ex_get_partial_node_set()

◆ ex_get_partial_node_set_df()

◆ ex_get_partial_side_set()

◆ ex_get_partial_side_set_df()

◆ ex_get_side_set()