Tutorial Toolkit Function Descriptions > Graphics > Element Tables
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX''">XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX''">   
Element Tables
The element graphics tables are used to display scalar and vector plots for imaging.
 
ga_elem_scalar_create
( title,nbr_elems,elem_ids,nbr_values,max_vals, scalars,id )
Description:
Creates a scalar element table.
Input:
STRING
title[]
Title of table.
INTEGER
nbr_elems
Number of elements to place in table.
INTEGER
elem_ids ( )
Array of element ids.
INTEGER
nbr_values ( )
Number of scalar values in each element.
INTEGER
max_vals
Maximum number of scalar values in any element.
REAL
scalars (nbr_elems, max_value)
Scalar values for all elements.
Output:
INTEGER
id
Id of created element scalar table.
INTEGER
<Return Value>
See error conditions.
Error Conditions:
11000098
A fatal error has occurred in the database. Database is corrupted.
Example:
Please see ga_elem_scalar_create (p. 99) in the MSC Acumen Toolkit - Code Examples.
 
ga_elem_scalar_single_create
( title, nbr_elems, elem_ids, nbr_nodes, scalars, id )
Description:
Creates a scalar element table given only one value per element.
Input:
STRING
title[]
Title of table.
INTEGER
nbr_elems
Number of elements to place in table.
INTEGER
elem_ids ( )
Array of element ids.
INTEGER
nbr_nodes ( )
Number of nodes in each element.
REAL
scalars ( )
One scalar value per element.
Output:
 
 
INTEGER
id
Id of created element scalar table.
INTEGER
<Return Value>
See error conditions.
Error Conditions:
 
11000098
A fatal error has occurred in the database. Database is corrupted.
Example:
Please see ga_elem_scalar_single_create (p. 101) in the MSC Acumen Toolkit - Code Examples.
 
ga_vector_create
( title, comp_vect_flag, sym_flag, nbr_vectors, vect_ent_types, vect_ent_ids, vect_locs, normals, vect_types, anchor_styles, vect_colors, sub_ids, id )
Description:
Creates a vector table.
Input:
 
 
STRING
title[]
Title of table.
INTEGER
comp_vect_flag
Whether 3 component vector should be displayed or a resultant vector.
INTEGER
sym_flag
Whether vector should be displayed symmetrically on the opposite side.
INTEGER
nbr_vectors
Number of vectors to place in table.
INTEGER
vect_ent_types ( )
Array of entity types.
INTEGER
vect_ent_ids ( )
Array of entity ids (if negative, use the location to signify the location of the vector).
REAL
vect_locs (nbr_vectors ,3)
Location of vector (only used if vector_ent_ids < 0 ).
REAL
normals (nbr_vectors ,3)
Normal of vector (includes length).
INTEGER
vect_types ( )
Vector types.
0 - no arrow head.
1 - one arrow head.
2 - double head.
3 - triple head.
4 - one arrow head 0-displacements.
5 - double head 0-displacements.
6 - triple head 0-displacements.
7 - one arrow head imposed displacements.
8 - double head imposed displacements.
9 - triple head imposed displacements.
100’s are reserved for markers.
101 - dot.
102 - circle.
103 - X.
104 - +.
105 - filled circle.
106 - square.
107 - filled square.
108 - triangle.
109 - filled triangle.
110 - diamond.
111 - filled diamond.
INTEGER
anchor_styles ( )
Anchor styles (1-base, 2-tip, 3-middle).
INTEGER
vect_colors ( )
Vector colors.
For results:
NULL - use the colors on D.P. form.
0 - use vector color.
1,2,3 - use component colors.
For functional assignments:
Values must be specified. The value is the type of vector. The possible values are taken from the preference include file ( LBCCOLOR1, LBCCOLOR2, EPCOLOR1, EPCOLOR2, etc. ).
INTEGER
sub_ids ( )
Sub ids. Only used by FA.
Output:
INTEGER
id
Id of created vector table.
Example:
Please see ga_vector_create (p. 215) in the MSC Acumen Toolkit - Code Examples.
 
ga_vector_get
( id, title, comp_vect_flag, sym_flag, vect_ent_types, vect_ent_ids, vect_locs, normals, vect_types, anchor_styles, vect_colors, sub_ids )
Description:
Gets a vector table.
Input:
INTEGER
id
Id of vector table.
Output:
 
 
STRING
title[]
Title of table.
INTEGER
comp_vect_flag
Whether 3 component vector should be displayed or a resultant vector.
INTEGER
sym_flag
Whether vector should be displayed symmetrically on the opposite side.
INTEGER
vect_ent_types ( )
Array of entity types.
INTEGER
vect_ent_ids ( )
Array of entity ids (if negative, use the location to signify the location of the vector).
REAL
vect_locs ( ,3)
Location of vector (only used if vector_ent_ids < 0 ).
REAL
normals ( ,3)
Normal of vector (includes length).
INTEGER
vect_types ( )
Vector types (1-one arrow head, 2-double head, 3-triple head, 0-no arrow head).
INTEGER
anchor_styles ( )
Anchor styles (1-base, 2-tip, 3-middle).
INTEGER
vect_colors ( )
Vector colors.
INTEGER
sub_ids ( )
Sub-ids.
INTEGER
<Return Value>
0 if function was succesful.
Error Conditions:
11000143
The specified vector result table was not found.
11000098
A fatal error has occurred in the database. Database is corrupted.
Example:
Please see ga_vector_get (p. 218) in the MSC Acumen Toolkit - Code Examples.
 
ga_vector_number_get
( id, number )
Description:
Gets the number of vectors in vector table.
Input:
 
 
INTEGER
id
Id of vector table.
Output:
INTEGER
number
Number of vectors in table.
INTEGER
<Return Value>
0 if function was successful.
Example:
Please see ga_vector_number_get (p. 222) in the MSC Acumen Toolkit - Code Examples.