ex_put_concat_node_sets.c File Reference

#include "exodusII.h"

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

Function Documentation

ex_put_concat_node_sets()

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

Deprecated

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

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

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

Returns

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

• data file not properly opened with call to ex_create() or ex_open()
• data file opened for read only.
• data file not initialized properly with call to ex_put_init().
• the number of node sets specified in a call to ex_put_init() was zero or has been exceeded.
• a node set with the same ID has already been stored.
• the number of distribution factors specified for one of the node sets is not zero and is not equal to the number of nodes in the same node set.

Parameters

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

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

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