Download EnSight Interface Manual

1.3 USERD_get_block_vector_values_by_component
USERD_get_block_vector_values_by_component
/*-------------------------------------------------------------------* if Z_PER_NODE:
*
Get the values at each node of a block, for a given vector
*
variable, one component at a time.
*
* or if Z_PER_ELEM:
*
Get the values at each element of a block, for a given vector
*
variable, one component at a time.
*
* (IN) block_number
Since EnSight Version 7.4:
*
-------------------------*
= The block number
*
*
(1-based index of part table, namely:
*
*
1 ... Numparts_available.
*
*
It is NOT the part_id label that is
*
loaded in USERD_get_part_build_info)
*
*
Prior to EnSight 7.4:
*
--------------------*
= The block id label
*
*
It is the part_id label that was
*
loaded in USERD_get_part_build_info
*
*
It is NOT the 1-based index of the
*
part table that is used in geometry routines.
*
* (IN) which_vector
= The variable “number” to get (1 ... Num_variables)
*
* (IN) which_component
= Z_COMPX if x component wanted
*
= Z_COMPY if y component wanted
*
= Z_COMPZ if z component wanted
*
* (OUT) vector_array
= 1D array containing vector
*
component value for each node or element.
*
*
Array will have been allocated:
*
*
if Z_PER_NODE:
*
i*j*k for the block long
*
*
if Z_PER_ELEM:
*
(i-1)*(i-1)*(k-1) for the block long
*
* returns: Z_OK if successful
*
Z_ERR if not successful
*
* Notes:
* * This will be based on Current_time_step
*
* * Not called unless Num_structured_blocks is > 0,
*
Num_variables is > 0, and there are some vector type variables
*
* * The per_node or per_elem classification must be obtainable from the
*
variable number (a var_classify array needs to be retained)
*
*--------------------------------------------------------------------*/
1-12
EnSight Interface Manual