Verify Action

PCL Reference Manual > Finite Element Functions > Verify Action

XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX''">XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX''">

Verify Action

This section is used to describe some of the functions used to verify entities in a finite element model.

The verification of a finite element model consists of a number of different tests which can be performed to check the validity of a finite element model. These tests include checks of element distortion, element duplication, model boundaries, nodal connectivity, and node and element identifier numbering.


fem_conn_fastener_verify	(method, fmt, diameter, gs, ga, gb, pata, patb)


Description:
This function will verify spot weld connector inputs.
Input:
STRING[]	method	The connector creation method (Projection or Axis).
STRING[]	fmt	The fastener format (PROP or ELEM).
REAL	diameter	The connector diameter.
STRING[]	gs	List of connector locations (nodes or xyz).
STRING[]	ga	List of surface A pierce nodes.
STRING[]	gb	List of surface B pierce nodes.
STRING[]	pata	List of surface A patch identifiers.
STRING[]	patb	List of surface B patch identifiers.
Output:
INTEGER	<Return Value>	This function returns a value of 0 if successful.
Error Conditions:
MSG_FEM_CONN_ZERO_DIAM MSG_FEM_CONN_GS_OR_GA_REQD MSG_FEM_CONN_ALIGN_GA_GB_REQD MSG_FEM_CONN_PATA_PATB_REQD MSG_FEM_CONN_BAD_POINT_PATCH MSG_FEM_CONN_GS_NODE_ID_REQD MSG_FEM_CONN_PROP_NOT_FOUND


fem_conn_spotweld_verify	(method, fmt, diameter, gs, ga, gb, pata, patb, sptyp)


Description:
This function will verify spot weld connector inputs.
Input:
STRING[]	method	The connector creation method (Projection or Axis).
STRING[]	fmt	The weld format (ELPAT, PARTPAT, ALIGN, ELEMID, or GRIDID).
REAL	diameter	The spot weld diameter.
STRING[]	gs	List of connector locations (nodes or xyz).
STRING[]	ga	List of surface A pierce nodes.
STRING[]	gb	List of surface B pierce nodes.
STRING[]	pata	List of surface A patch identifiers.
STRING[]	patb	List of surface B patch identifiers.
STRING[]	sptyp	Surface patch types (GRIDID format only). Q4Q8 = quad4/quad8, Q4T6 = quad4/tri6, etc.
Output:
INTEGER	<Return Value>	This function returns a value of 0 if successful.
Error Conditions:
MSG_FEM_CONN_ZERO_DIAM MSG_FEM_CONN_GS_OR_GA_REQD MSG_FEM_CONN_ALIGN_GA_GB_REQD MSG_FEM_CONN_PATA_PATB_REQD MSG_FEM_CONN_BAD_POINT_PATCH MSG_FEM_CONN_GS_NODE_ID_REQD MSG_FEM_CONN_PROP_NOT_FOUND


fem_verify_display	(group_name, table_id, best_value, worst_value, threshold, render_style)


Description:
This function will display a graphics table of the results of an element verification procedure. It will make use of a threshold value to identify elements that have failed.
Input:
STRING	group_name[31]	This value specifies the label of the group to which the results will be assigned.
INTEGER	table_id	This value specifies the id for a graphic table that will be assigned to the group specified by the input value group_name.
REAL	best_value	This value specifies the best value in the graphic table.
REAL	worst_value	This value specifies the worst value in the graphic table.
REAL	threshold	This value specifies the threshold for all elements that have failed the verification process. Any entry with a value greater than the threshold value will be shown as an element that has failed.
STRING	render_style[31]	This value specifies the render style assigned to each element. This value should be set to “ELEMFILL”. See the remarks below for a table of allowed values.
Output:
None.
Error Conditions:
None.

Remarks:

This function will assign a table of verification results to either a group or to all of the entities in the model depending on the display method that has been set.

The input value render_style can have the following values:


Render Style

	“WIREFRAME”	“HIDDEN”	“SHADED”
	“FRINGE”	“FRINGE/LIGHT”	“ELEMFILL”
	“CONTOUR”

Example:

Please see fem_verify_display.


fem_verify_ids_display	(group_name, table_id, minimum_value, maximum_value, render_style)


Description:
This function will display a graphics table of the results of an element verification procedure without the use of a threshold value.
Input:
STRING	group_name[31]	This value specifies the label of the group to which the results will be assigned.
INTEGER	table_id	This value specifies the id for a graphic table that will be assigned to the group specified by the input value group_name.
REAL	minimum_value	This value specifies the minimum value in the graphic table.
REAL	maximum_value	This value specifies the maximum value in the graphic table.
STRING	render_style[31]	This value specifies the render style assigned to each element. This value should be set to “ELEMFILL”. See the remarks below for a table of allowed values.
Output:
None.
Error Conditions:
None.

Remarks:

This function will assign a table of verification results to either a group or to all of the entities in the model depending on the display method that has been set.

The input value render_style can have the following values:


Render Style

	“WIREFRAME”	“HIDDEN”	“SHADED”
	“FRINGE”	“FRINGE/LIGHT”	“ELEMFILL”
	“CONTOUR”

Example:

Please see fem_verify_ids_display.


fem_verify_display.plot	(option, table_id, threshold, entities_failed)


Description:
This function will display the entities that have failed an element verification procedure as a high lighted wireframe.
Input:
STRING	option[]	This value specifies the type of plot to be displayed: “plot_failed” to plot only the elements that have failed the verification process and are members of the current group, or “restore” to restore the original viewport display.
INTEGER	table_id	This value specifies the id for a graphics table that will be assigned to the current group.
REAL	threshold	This value specifies the threshold for all elements that will be colored as elements that have failed the verification process.
Output:
STRING	entities_failed [VIRTUAL]
		This value will return a description of the elements in the current group that have failed the element verification process when the input value option is set to “plot_failed”. If the input value option is not set to “plot_failed” this value will return the initial value set by the calling function.
INTEGER	<Return Value>	This function returns a value of 0 when executed successfully and a non zero value to indicate a change in status or an error.
Error Conditions:
None.

Remarks:

This function will return a value of zero and will do nothing if the input value option is not set to either “plot_failed” or “restore”.

Space is internally allocated for the string returned by the output value entities_failed when the input value option is set to “plot_failed”. It is the responsibility of the calling function to free the allocated string storage space.

Example:

Please see fem_verify_display.plot.


fem_verify_draw_normal_vectors	(segment_id)


Description:
This function will draw normal vectors on all shell or surface elements in the current group.
Input:
INTEGER	segment_id	This value specifies the graphics segment id for the graphics segment in which the normal vectors will be drawn.
Output:
INTEGER	<Return Value>	This function returns a value of 0 when executed successfully and a non zero value to indicate a change in status or an error.
Error Conditions:
None.

Remarks:

See the description for the function gm_segment_create() in the PCL Customization manual for more information on the use of graphics segments.

Example:

Please see fem_verify_draw_normal_vectors.


fem_verify_el_ids	(group_name, minimum_value, minimum_id, maximum_value, maximum_id, table_id)


Description:
This function will load the graphic display tables with the id values of all of the elements in the current group as scalar results values.
Input:
None.
Output:
STRING	group_name[31]	This value will return a description of the group to which the id value information has been applied.
REAL	minimum_value	This value will return the minimum id value.
INTEGER	minimum_id	This value will return the id of the element with the minimum id value.
REAL	maximum_value	This value will return the maximum id value.
INTEGER	maximum_id	This value will return the id of the element with the maximum id value.
INTEGER	table_id	This value returns the id for the table of element id values.
INTEGER	<Return Value>	This function returns a value of 0 when executed successfully and a non zero value to indicate a change in status or an error.
Error Conditions:
See the Status Messages for information on any error values returned by this function.

Remarks:

This function is used in the implementation of the “Finite Elements” switch bar form that is displayed when the action is set to “Verify”, the object is set to “Element”, and the test is set to “IDs”.

Use the fem_verify_ids_display() function to display the graphics display tables produced by this function.

Example:

Please see fem_verify_el_ids.


fem_verify_elem_conect	(reverse, entities_failed)


Description:
This function will test solid elements for proper connectivity.
Input:
LOGICAL	reverse	This value specifies, when set to TRUE, that any elements that are found with a negative volume should be reversed so that the volume is positive. When this value is set to false, elements will be allowed to retain negative volume values.
Output:
STRING	entities_failed [VIRTUAL]
		This value will return a description of the elements in the current group that have failed the element verification process.
INTEGER	<Return Value>	This function returns a value of 0 when executed successfully and a non zero value to indicate a change in status or an error.
Error Conditions:
See the Status Messages for information on any error values returned by this function.

Remarks:

Space is internally allocated for the string returned by the output value entities_failed. It is the responsibility of the calling function to free the allocated string storage space.

Example:

Please see fem_verify_elem_conect.


fem_verify_elem_jacobratio	(group_name minimum_value, minimum_id, maximum_value, maximum_id, table_id)


Description:
This function will load the graphic display tables with the Jacobian ratio values of all of the elements in the current group.
Input:
None.
Output:
STRING	group_name[31]	This value will return a description of the group to which the Jacobian ratio information has been applied.
REAL	minimum_value	This value will return the minimum Jacobian ratio value.
INTEGER	minimum_id	This value will return the id of the element with the minimum Jacobian ratio value.
REAL	maximum_value	This value will return the maximum Jacobian ratio value.
INTEGER	maximum_id	This value will return the id of the element with the maximum Jacobian ratio value.
INTEGER	table_id	This value returns the id for the table of element Jacobian ratio values.
INTEGER	<Return Value>	This function returns a value of 0 when executed successfully and a non zero value to indicate a change in status or an error.
Error Conditions:
See the Status Messages for information on any error values returned by this function.

Remarks:

Example:

Please see fem_verify_elem_jacobratio.


fem_verify_elem_jacobzero	(group_name, minimum_value, minimum_id, maximum_value, maximum_id, table_id)


Description:
This function will load the graphic display tables with the Jacobian zero values of all of the elements in the current group.
Input:
None.
Output:
STRING	group_name[31]	This value will return a description of the group to which the Jacobian zero information has been applied.
REAL	minimum_value	This value will return the minimum Jacobian zero value.
INTEGER	minimum_id	This value will return the id of the element with the minimum Jacobian zero value.
REAL	maximum_value	This value will return the maximum Jacobian zero value.
INTEGER	maximum_id	This value will return the id of the element with the maximum Jacobian zero value.
INTEGER	table_id	This value returns the id for the table of element Jacobian zero values.
INTEGER	<Return Value>	This function returns a value of 0 when executed successfully and a non zero value to indicate a change in status or an error.
Error Conditions:
See the Status Messages for information on any error values returned by this function.

Remarks:

Example:

Please see fem_verify_elem_jacobzero


fem_verify_element_duplicates	(delete_elements, delete_high, num_duplicates, kept_elements, deleted_elements)


Description:
Check the entire database for duplicate elements and optionally delete them.
Input:
LOGICAL	delete_elements	This value specifies, when set to TRUE, that any duplicate elements will be deleted. When this value is set to FALSE, duplicate elements will not be deleted.
LOGICAL	delete_high	This value specifies, when set to TRUE, that the elements with the higher identifier values will be deleted from sets of duplicate elements. If this value is set to FALSE, the duplicate elements with the lower identifier values will be deleted from sets of duplicate elements. Duplicate elements will be deleted only when the input value delete_elements is set to TRUE.
Output:
INTEGER	num_duplicates	This value returns the number of duplicate elements that where found.
STRING	kept_elements[VIRTUAL]
		This value returns a description of the elements that where not deleted by the verification process.
STRING	deleted_elements[VIRTUAL]
		This value returns a description of the elements that where deleted by the verification process.
INTEGER	<Return Value>	This function returns a value of 0 when executed successfully and a non zero value to indicate a change in status or an error.
Error Conditions:
None.

Remarks:

Space is internally allocated for the string returned by the output values kept_elements and deleted_elements. It is the responsibility of the calling function to free the allocated string storage space.

Example:

Please see fem_verify_element_duplicates.


fem_verify_element_normals	(reverse_elements, color_code, guide_element, group_name, table_id)


Description:
This function will verify the direction of the normal vectors for all shell elements in the current group.
Input:
LOGICAL	reverse_elements	This value specifies, when set to TRUE, that reversed normals be flipped to match the direction specified by the input value guide_element.
LOGICAL	color_code	This value specifies, when set to TRUE, that a results table to be used for the element color coding to be created.
STRING	guide_element[]	This value specifies the id for an element that is used to define the desired normal direction.
Output:
STRING	group_name[31]	This value will return a description of the group to which the normal vector information has been applied.
INTEGER	table_id	This value returns the id for the table of element normal vector values.
INTEGER	<Return Value>	This function returns a value of 0 when executed successfully and a non zero value to indicate a change in status or an error.
Error Conditions:
See the Status Messages for information on any error values returned by this function.

Remarks:

This function will not draw any normal vectors in the viewport.

Example:

Please see fem_verify_element_normals.


fem_verify_get_graphset	(display_method, group_name, render_style, viewport_name, spectrum_setting)


Description:
This function will retrieve the graphics display settings that can be used to restore the graphics display to its original state.
Input:
None.
Output:
INTEGER	display_method	This value returns the display method value: 1 = entities, or 2 = groups.
STRING	group_name[31]	This value returns the name of the current group.
STRING	render_style[31]	This value returns the render style. See the remarks below for a table of allowed values.
STRING	viewport_name[31]	This value returns the name of the current viewport.
INTEGER	spectrum_setting	This value returns TRUE or 1 if the current spectrum settings are posted to the current viewport and FALSE or 0 otherwise.
INTEGER	<Return Value>	This function returns a value of 0 when executed successfully and a non zero value to indicate a change in status or an error.
Error Conditions:
See the Status Messages for information on any error values returned by this function.

Remarks:

See the description for the function fem_verify_reset_graphics() for more information.

The returned value render_style can have the following values:


Render Style

	“WIREFRAME”	“HIDDEN”	“SHADED”
	“FRINGE”	“FRINGE/LIGHT”	“ELEMFILL”
	“CONTOUR”

Example:

Please see fem_verify_get_graphset.


fem_verify_hex_all	(threshold, num_failures, worst_value, worst_id)


Description:
This function will run all of the verification tests for all hexagonal elements in the current group and highlight any elements that fail the tests.
Input:
REAL	threshold(10)	This value specifies the threshold comparison value for all of the tests. See the remarks for a description of the use of each offset in this array.
Output:
INTEGER	num_failures(10)	This value returns the number of elements that have failed a test. See the remarks for a description of the use of each offset in this array.
REAL	worst_value(10)	This value returns the value for the worst case value of each test. See the remarks for a description of the use of each offset in this array.
INTEGER	worst_id(10)	This value returns the id for the worst case element of each test. See the remarks for a description of the use of each offset in this array.
INTEGER	<Return Value>	This function returns a value of 0 when executed successfully and a non zero value to indicate a change in status or an error.
Error Conditions:
See the Status Messages for information on any error values returned by this function.

Remarks:

This function is used in the implementation of the “Finite Elements” switch bar form that is displayed when the action is set to “Verify”, the object is set to “Hex”, and the test is set to “All”.

The real input value threshold uses the offsets in the array to specify the test failure threshold values for the following finite model attributes:


	Offset	Description

	1	The aspect ratio or the length/height of the element with a range of 0 to 20.
	2	The edge angle of the element with a range of 0 to 90 degrees.
	3	The face skew angle of the element with a range of 0 to 90 degrees.
	4	The face warp angle of the element with a range of 0 to 90 degrees.
	5	The element twist angle with a range of 0 to 90 degrees.
	6	The face taper value ranging from 0 to 1.
	7	The normal offset value.
	8	The tangent offset value.
	9	Not used.
	10	Not used.

The output values num_failures, worst_value, and worst_id all use array offsets in the in the following manner:


	Offset	Description

	1	The value for aspect ratio test.
	2	The value for the edge angle test.
	3	The value for the face skew angle test.
	4	The value for the face warp angle test.
	5	The value for the element twist angle test.
	6	The value for the face taper test.
	7	The value for the normal offset test.
	8	The value for the tangent offset test.
	9	The value for the Jacobian ratio test.
	10	The value for the Jacobian zero test.

Example:

Please see fem_verify_hex_all.


fem_verify_hex_aspect	(normalize, threshold, group_name, minimum_value, minimum_id, maximum_value, maximum_id, table_id)


Description:
This function will load the graphic display tables with the aspect ratio values of all of the hexagonal elements in the current group.
Input:
LOGICAL	normalize	This value specifies, when set to TRUE, that the aspect ratio values loaded into the graphic display table are calculated using this formula: 1 - width / length. The standard aspect ratio values are calculated when this value is set to FALSE using this formula: length / width.
REAL	threshold	This value specifies the threshold of failure comparison value. When the input value normalize is set to TRUE, this value must be greater than 0.0 and equal to or less than 1.0. When the input value normalize is set to FALSE, this value must be greater than 0.0 and less than or equal to 1.0 E +10.
Output:
STRING	group_name[31]	This value will return a description of the group to which the test has been applied.
REAL	minimum_value	This value will return the minimum aspect ratio value.
INTEGER	minimum_id	This value will return the id of the element with the minimum aspect ratio value.
REAL	maximum_value	This value will return the maximum aspect ratio value.
INTEGER	maximum_id	This value will return the id of the element with the maximum aspect ratio value.
INTEGER	table_id	This value returns the id for the table of element aspect ratio values.
INTEGER	<Return Value>	This function returns a value of 0 when executed successfully and a non zero value to indicate a change in status or an error.
Error Conditions:
See the Status Messages for information on any error values returned by this function.

Remarks:

This function will write the element number and the aspect ratio value for each element in the current group that has exceeded the threshold value to the history window.

This function can display a percent complete popup form.

Example:

Please see fem_verify_hex_aspect.


fem_verify_hex_edangle	(normalize, threshold, group_name, minimum_value, minimum_id, maximum_value, maximum_id, table_id)


Description:
This function will load the graphic display tables with the edge angle values of all of the hexagonal elements in the current group.
Input:
LOGICAL	normalize	This value specifies, when set to TRUE, that the edge angle values loaded into the graphic display table are calculated using this formula: (90.0 - interior angle) / 90.0. The standard edge angle values are calculated when this value is set to FALSE using this formula: 90.0 - interior angle.
REAL	threshold	This value specifies the threshold of failure comparison value. When the input value normalize is set to TRUE, this value must be greater than 0.0 and equal to or less than 1.0. When the input value normalize is set to FALSE, this value must be greater than 0.0 and less than or equal to 120.0.
Output:
STRING	group_name[31]	This value will return a description of the group to which the test has been applied.
REAL	minimum_value	This value will return the minimum edge angle value.
INTEGER	minimum_id	This value will return the id of the element with the minimum edge angle value.
REAL	maximum_value	This value will return the maximum edge angle value.
INTEGER	maximum_id	This value will return the id of the element with the maximum edge angle value.
INTEGER	table_id	This value returns the id for the table of element edge angle values.
INTEGER	<Return Value>	This function returns a value of 0 when executed successfully and a non zero value to indicate a change in status or an error.
Error Conditions:
See the Status Messages for information on any error values returned by this function.

Remarks:

Example:

Please see fem_verify_hex_edangle (p. 825) in the PCL Reference Manual Examples.


fem_verify_hex_fskew	(normalize, threshold, group_name, minimum_value, minimum_id, maximum_value, maximum_id, table_id)


Description:
This function will load the graphic display tables with the face skew values of all of the hexagonal elements in the current group.
Input:
LOGICAL	normalize	This value specifies, when set to TRUE, that the face skew values loaded into the graphic display table are calculated using this formula: (90.0 - interior angle) / 90.0. The standard face skew values are calculated when this value is set to FALSE using this formula: 90.0 - interior angle.
REAL	threshold	This value specifies the threshold of failure comparison value. When the input value normalize is set to TRUE, this value must be greater than 0.0 and equal to or less than 1.0. When the input value normalize is set to FALSE, this value must be greater than 0.0 and less than or equal to 90.0.
Output:
STRING	group_name[31]	This value will return a description of the group to which the test has been applied.
REAL	minimum_value	This value will return the minimum face skew value.
INTEGER	minimum_id	This value will return the id of the element with the minimum face skew value.
REAL	maximum_value	This value will return the maximum face skew value.
INTEGER	maximum_id	This value will return the id of the element with the maximum face skew value.
INTEGER	table_id	This value returns the id for the table of element face skew values.
INTEGER	<Return Value>	This function returns a value of 0 when executed successfully and a non zero value to indicate a change in status or an error.
Error Conditions:
See the Status Messages for information on any error values returned by this function.

Remarks:

Example:

Please see fem_verify_hex_fskew.


fem_verify_hex_ftaper	(normalize, threshold, group_name, minimum_value, minimum_id, maximum_value, maximum_id, table_id)


Description:
This function will load the graphic display tables with the face taper values of all of the hexagonal elements in the current group.
Input:
LOGICAL	normalize	This value specifies, when set to TRUE, that the face taper values loaded into the graphic display table are calculated using this formula: (90.0 - interior angle) / 90.0. The standard face taper values are calculated when this value is set to FALSE using this formula: 90.0 - interior angle.
REAL	threshold	This value specifies the threshold of failure comparison value. When the input value normalize is set to TRUE, this value must be greater than 0.0 and equal to or less than 1.0. When the input value normalize is set to FALSE, this value must be greater than 0.0 and less than or equal to 2147483600.0.
Output:
STRING	group_name[31]	This value will return a description of the group to which the test has been applied.
REAL	minimum_value	This value will return the minimum face taper value.
INTEGER	minimum_id	This value will return the id of the element with the minimum face taper value.
REAL	maximum_value	This value will return the maximum face taper value.
INTEGER	maximum_id	This value will return the id of the element with the maximum face taper value.
INTEGER	table_id	This value returns the id for the table of element face taper values.
INTEGER	<Return Value>	This function returns a value of 0 when executed successfully and a non zero value to indicate a change in status or an error.
Error Conditions:
See the Status Messages for information on any error values returned by this function.

Remarks:

Example:

Please see fem_verify_hex_ftaper.


fem_verify_hex_fwarp	(normalize, threshold, group_name, minimum_value, minimum_id, maximum_value, maximum_id, table_id)


Description:
This function will load the graphic display tables with the face warp values of all of the hexagonal elements in the current group.
Input:
LOGICAL	normalize	This value specifies, when set to TRUE, that the face warp values loaded into the graphic display table are calculated using this formula: (interior angle) / 15.0. The standard face warp values are calculated when this value is set to FALSE using this formula: interior angle.
REAL	threshold	This value specifies the threshold of failure comparison value. When the input value normalize is set to TRUE, this value must be greater than 0.0 and equal to or less than 1.0. When the input value normalize is set to FALSE, this value must be greater than 0.0 and less than or equal to 90.0.
Output:
STRING	group_name[31]	This value will return a description of the group to which the test has been applied.
REAL	minimum_value	This value will return the minimum face warp value.
INTEGER	minimum_id	This value will return the id of the element with the minimum face warp value.
REAL	maximum_value	This value will return the maximum face warp value.
INTEGER	maximum_id	This value will return the id of the element with the maximum face warp value.
INTEGER	table_id	This value returns the id for the table of element face warp values.
INTEGER	<Return Value>	This function returns a value of 0 when executed successfully and a non zero value to indicate a change in status or an error.
Error Conditions:
See the Status Messages for information on any error values returned by this function.

Remarks:

Example:

Please see fem_verify_hex_fwarp.


fem_verify_hex_twist	(normalize, threshold, group_name, minimum_value, minimum_id, maximum_value, maximum_id, table_id)


Description:
This function will load the graphic display tables with the twist values of all of the hexagonal elements in the current group.
Input:
LOGICAL	normalize	This value specifies, when set to TRUE, that the twist values loaded into the graphic display table are calculated using this formula: (interior angle) / 90.0. The standard twist values are calculated when this value is set to FALSE using this formula: interior angle.
REAL	threshold	This value specifies the threshold of failure comparison value. When the input value normalize is set to TRUE, this value must be greater than 0.0 and equal to or less than 1.0. When the input value normalize is set to FALSE, this value must be greater than 0.0 and less than or equal to 90.0.
Output:
STRING	group_name[31]	This value will return a description of the group to which the test has been applied.
REAL	minimum_value	This value will return the minimum twist value.
INTEGER	minimum_id	This value will return the id of the element with the minimum twist value.
REAL	maximum_value	This value will return the maximum twist value.
INTEGER	maximum_id	This value will return the id of the element with the maximum twist value.
INTEGER	table_id	This value returns the id for the table of element twist values.
INTEGER	<Return Value>	This function returns a value of 0 when executed successfully and a non zero value to indicate a change in status or an error.
Error Conditions:
See the Status Messages for information on any error values returned by this function.

Remarks:

Example:

Please see fem_verify_hex_twist.


fem_verify_midnode_normoff	(threshold, group_name, minimum_value, minimum_id, maximum_value, maximum_id, table_id)


Description:
This function will load the graphic display tables with the midnode normal offset values of all of the elements in the current group.
Input:
REAL	threshold	This value specifies the threshold of failure comparison value. This value must be greater than 0.0 and equal to or less than 1.0.
Output:
STRING	group_name[31]	This value will return a description of the group to which the test has been applied.
REAL	minimum_value	This value will return the minimum normal offset value.
INTEGER	minimum_id	This value will return the id of the element with the minimum normal offset value.
REAL	maximum_value	This value will return the maximum normal offset value.
INTEGER	maximum_id	This value will return the id of the element with the maximum normal offset value.
INTEGER	table_id	This value returns the id for the table of normal element offset values.
INTEGER	<Return Value>	This function returns a value of 0 when executed successfully and a non zero value to indicate a change in status or an error.
Error Conditions:
See the Status Messages for information on any error values returned by this function.

Remarks:

This function is used in the implementation of the “Finite Elements” switch bar form that is displayed when the action is set to “Verify”, the object is set to “Midnode”, and the test is set to “Normal Offset”.

Example:

Please see fem_verify_midnode_normoff.


fem_verify_midnode_tanoff	(threshold, group_name, minimum_value, minimum_id, maximum_value, maximum_id, table_id)


Description:
This function will load the graphic display tables with the midnode tangent offset values of all of the elements in the current group.
Input:
REAL	threshold	This value specifies the threshold of failure comparison value. This value must be greater than 0.0 and equal to or less than 1.0.
Output:
STRING	group_name[31]	This value will return a description of the group to which the test has been applied.
REAL	minimum_value	This value will return the minimum tangent offset value.
INTEGER	minimum_id	This value will return the id of the element with the minimum tangent offset value.
REAL	maximum_value	This value will return the maximum tangent offset value.
INTEGER	maximum_id	This value will return the id of the element with the maximum tangent offset value.
INTEGER	table_id	This value returns the id for the table of tangent element offset values.
INTEGER	<Return Value>	This function returns a value of 0 when executed successfully and a non zero value to indicate a change in status or an error.
Error Conditions:
See the Status Messages for information on any error values returned by this function.

Remarks:

Example:

Please see fem_verify_midnode_tanoff.


fem_verify_node_ids	(group_name, minimum_value, minimum_id, maximum_value, maximum_id, table_id)


Description:
This function will load the graphic display tables with the id values of all of the nodes in the current group as scalar results values.
Input:
None.
Output:
STRING	group_name[31]	This value will return a description of the group to which the id value information has been applied.
REAL	minimum_value	This value will return the minimum id value.
INTEGER	minimum_id	This value will return the id of the element with the minimum id value.
REAL	maximum_value	This value will return the maximum id value.
INTEGER	maximum_id	This value will return the id of the element with the maximum id value.
INTEGER	table_id	This value returns the id for the table of element id values.
INTEGER	<Return Value>	This function returns a value of 0 when executed successfully and a non zero value to indicate a change in status or an error.
Error Conditions:
None.

Remarks:

This function is used in the implementation of the “Finite Elements” switch bar form that is displayed when the action is set to “Verify”, the object is set to “Node”, and the test is set to “Ids”.

Example:

Please see fem_verify_node_ids.


fem_verify_quad_all	(threshold, num_failures, worst_value, worst_id)


Description:
This function will run all of the verification tests for all quadrilateral elements in the current group and highlight any elements that fail the tests.
Input:
REAL	threshold(8)	This value specifies the threshold comparison value for all of the tests. See the remarks for a description of the use of each offset in this array.
Output:
INTEGER	num_failures(8)	This value returns the number of elements that have failed a test. See the remarks for a description of the use of each offset in this array.
REAL	worst_value(8)	This value returns the value for the worst case value of each test. See the remarks for a description of the use of each offset in this array.
INTEGER	worst_id(8)	This value returns the id for the worst case element of each test. See the remarks for a description of the use of each offset in this array.
INTEGER	<Return Value>	This function returns a value of 0 when executed successfully and a non zero value to indicate a change in status or an error.
Error Conditions:
See the Status Messages for information on any error values returned by this function.

Remarks:

This function is used in the implementation of the “Finite Elements” switch bar form that is displayed when the action is set to “Verify”, the object is set to “Quad”, and the test is set to “All”.

The input value threshold and the output value num_failures both use the values at the following offsets for the following finite element model attributes:


	Offset	Description.

	1	The value for the aspect ratio test.
	2	The value for the face warp angle test.
	3	The value for the face skew angle test.
	4	The value for the face taper test.
	5	The value for the normal offset test.
	6	The value for the tangent offset test.
	7	Not used.
	8	Not used.

The output values worst_value and worst_id both use the values at the following offsets to return information about the following finite element model attributes


	Offset	Description.

	1	The value for aspect ratio test.
	2	The value for the face warp angle test.
	3	The value for the face skew angle test.
	4	The value for the face taper test.
	5	The value for the normal offset test.
	6	The value for the tangent offset test.
	7	The value for the Jacobian ratio test.
	8	The value for the Jacobian zero test.

Example:

Please see fem_verify_quad_all.


fem_verify_quad_aspect	(normalize, threshold, split, group_name, minimum_value, minimum_id, maximum_value, maximum_id, created_elements, created_nodes, table_id)


Description:
This function will load the graphic display tables with the aspect ratio values of all of the quadrilateral elements in the current group.
Input:
LOGICAL	normalize	This value specifies, when set to TRUE, that the aspect ratio values loaded into the graphic display table are calculated using this formula: (1 - (h2 / h1)). The standard aspect ratio values are calculated when this value is set to FALSE using this formula: (h1 / h2).
REAL	threshold	This value specifies the threshold of failure comparison value. When the input value normalize is set to TRUE, this value must be greater than 0.0 and equal to or less than 1.0. When the input value normalize is set to FALSE, this value must be greater than 0.0 and less than or equal to 2147483600.0.
LOGICAL	split	This value specifies, when set to TRUE, that each quadrilateral element that fails the test will be deleted and replaced with two quadrilateral elements that split the original element across its longer dimension.
Output:
STRING	group_name[31]	This value will return a description of the group to which the test has been applied.
REAL	minimum_value	This value will return the minimum aspect ratio value.
INTEGER	minimum_id	This value will return the id of the element with the minimum aspect ratio value.
REAL	maximum_value	This value will return the maximum aspect ratio value.
INTEGER	maximum_id	This value will return the id of the element with the maximum aspect ratio value.
STRING	created_elements[VIRTUAL]
		This value returns a description of any elements that have been created by this function.
STRING	created_nodes[VIRTUAL]
		This value returns a description of any nodes that have been created by this function.
INTEGER	table_id	This value returns the id for the table of element aspect ratio values.
INTEGER	<Return Value>	This function returns a value of 0 when executed successfully and a non zero value to indicate a change in status or an error.
Error Conditions:
See the Status Messages for information on any error values returned by this function.

Remarks:

This function will list the element number, the aspect ratio value, and the threshold value for every element whose aspect ratio exceeds the threshold value in the history window.

Space is internally allocated for the string returned by the output values created_elements and created_nodes. It is the responsibility of the calling function to free the allocated string storage space.

This function can display a percent complete popup form.

Example:

Please see fem_verify_quad_aspect.


fem_verify_quad_skew	(normalize, threshold, split, group_name, minimum_value, minimum_id, maximum_value, maximum_id, created_elements, created_nodes, table_id)


Description:
This function will load the graphic display tables with the skew angle values of all of the quadrilateral elements in the current group.
Input:
LOGICAL	normalize	This value specifies, when set to TRUE, that the skew angle values loaded into the graphic display table are calculated using this formula: ((90.0 - interior angle) / 90.0). The standard skew angle values are calculated when this value is set to FALSE using this formula: (90.0 - interior angle).
REAL	threshold	This value specifies the threshold of failure comparison value. When the input value normalize is set to TRUE, this value must be greater than 0.0 and equal to or less than 1.0. When the input value normalize is set to FALSE, this value must be greater than 0.0 and less than or equal to 90.0.
LOGICAL	split	This value specifies, when set to TRUE, that each quadrilateral element that fails the test will be deleted and replaced with two triangular elements that split the original element along its shorter diagonal dimension.
Output:
STRING	group_name[31]	This value will return a description of the group to which the test has been applied.
REAL	minimum_value	This value will return the minimum skew angle value.
INTEGER	minimum_id	This value will return the id of the element with the minimum skew angle value.
REAL	maximum_value	This value will return the maximum skew angle value.
INTEGER	maximum_id	This value will return the id of the element with the maximum skew angle value.
STRING	created_elements[VIRTUAL]
		This value returns a description of any elements that have been created by this function.
STRING	created_nodes[VIRTUAL]
		This value returns a description of any nodes that have been created by this function.
INTEGER	table_id	This value returns the id for the table of element skew angle values.
INTEGER	<Return Value>	This function returns a value of 0 when executed successfully and a non zero value to indicate a change in status or an error.
Error Conditions:
See the Status Messages for information on any error values returned by this function.

Remarks:

This function will list the element number and the skew angle value for every element whose skew angle exceeds the threshold value in the history window.

This function can display a percent complete popup form.

Example:

Please see fem_verify_quad_skew.


fem_verify_quad_taper	(normalize, threshold, split, group_name, minimum_value, minimum_id, maximum_value, maximum_id, created_elements, created_nodes, table_id)


Description:
This function will load the graphic display tables with the taper angle values of all of the quadrilateral elements in the current group.
Input:
LOGICAL	normalize	This value specifies, when set to TRUE, that the taper angle values loaded into the graphic display table are calculated using this formula: (1- ((4.0 x interior angle) / quadrilateral area)). The standard taper angle values are calculated when this value is set to FALSE using this formula: ((4.0 x interior angle) / quadrilateral area).
REAL	threshold	This value specifies the threshold of failure comparison value. When the input value normalize is set to TRUE, this value must be greater than 0.0 and equal to or less than 1.0. When the input value normalize is set to FALSE, this value must be greater than 0.0 and less than or equal to 1.0.
LOGICAL	split	This value specifies, when set to TRUE, that each quadrilateral element that fails the test will be deleted and replaced with two quadrilateral elements.
Output:
STRING	group_name[31]	This value will return a description of the group to which the test has been applied.
REAL	minimum_value	This value will return the minimum taper angle value.
INTEGER	minimum_id	This value will return the id of the element with the minimum taper angle value.
REAL	maximum_value	This value will return the maximum taper angle value.
INTEGER	maximum_id	This value will return the id of the element with the maximum taper angle value.
STRING	created_elements[VIRTUAL]
		This value returns a description of any elements that have been created by this function.
STRING	created_nodes[VIRTUAL]
		This value returns a description of any nodes that have been created by this function.
INTEGER	table_id	This value returns the id for the table of element taper angle values.
INTEGER	<Return Value>	This function returns a value of 0 when executed successfully and a non zero value to indicate a change in status or an error.
Error Conditions:
See the Status Messages for information on any error values returned by this function.

Remarks:

This function will list the element number, the taper angle value, and the threshold value for every element whose taper angle exceeds the threshold value in the history window.

This function can display a percent complete popup form.

Example:

Please see fem_verify_quad_taper.


fem_verify_quad_warp	(normalize, threshold, split, group_name, minimum_value, minimum_id, maximum_value, maximum_id, created_elements, created_nodes, table_id)


Description:
This function will load the graphic display tables with the warp angle values of all of the quadrilateral elements in the current group.
Input:
LOGICAL	normalize	This value specifies, when set to TRUE, that the warp angle values loaded into the graphic display table are calculated using this formula: (interior angle / 15.0). The standard warp angle values are calculated when this value is set to FALSE using this formula: (interior angle).
REAL	threshold	This value specifies the threshold of failure comparison value. When the input value normalize is set to TRUE, this value must be greater than 0.0 and equal to or less than 1.0. When the input value normalize is set to FALSE, this value must be greater than 0.0 and less than or equal to 90.0.
LOGICAL	split	This value specifies, when set to TRUE, that each quadrilateral element that fails the test will be deleted and replaced with two triangular elements.
Output:
STRING	group_name[31]	This value will return a description of the group to which the test has been applied.
REAL	minimum_value	This value will return the minimum warp angle value.
INTEGER	minimum_id	This value will return the id of the element with the minimum warp angle value.
REAL	maximum_value	This value will return the maximum warp angle value.
INTEGER	maximum_id	This value will return the id of the element with the maximum warp angle value.
STRING	created_elements[VIRTUAL]
		This value returns a description of any elements that have been created by this function.
STRING	created_nodes[VIRTUAL]
		This value returns a description of any nodes that have been created by this function.
INTEGER	table_id	This value returns the id for the table of element warp angle values.
INTEGER	<Return Value>	This function returns a value of 0 when executed successfully and a non zero value to indicate a change in status or an error.
Error Conditions:
See the Status Messages for information on any error values returned by this function.

Remarks:

This function will list the element number and the warp angle value for every element whose warp angle exceeds the threshold value in the history window.

This function can display a percent complete popup form.

Example:

Please see fem_verify_quad_warp.


fem_verify_reset_graphics	(render_style, group_name, spectrum_set, viewport_name)


Description:
This function can be used to reset graphics parameters after the results of a finite element verification operation has been displayed in a viewport.
Input:
STRING	render_style[31]	This value specifies the original render style. This value will either be applied to the group named in the input value group_name or to all of the entities in the model, depending on the current display method setting. See the remarks below for a table of allowed values.
STRING	group_name[31]	This value specifies the original group name to which the render style will be applied.
INTEGER	spectrum_set	This value specifies the original spectrum setting which, if set to TRUE or 1, will indicate that the current spectrum settings are posted to the viewport. This value can be set to FALSE or 0 to indicate that the current spectrum settings are not posted to the viewport.
STRING	viewport_name[31]	This value specifies the original viewport name to which the input value spectrum_set will be applied.
Output:
INTEGER	<Return Value>	This function returns a value of 0 when executed successfully and a non zero value to indicate a change in status or an error.
Error Conditions:
None.

Remarks:

See the description for the function fem_verify_get_graphset() for more information.

Setting the input value spectrum_set to TRUE or 1 will not post the current spectrum settings to a viewport, it will just place a setting in the database to indicate the post status of the spectrum settings.

The returned value render_style can have the following values:


Render Style

	“WIREFRAME”	“HIDDEN”	“SHADED”
	“FRINGE”	“FRINGE/LIGHT”	“ELEMFILL”
	“CONTOUR”

Example:

Please see fem_verify_reset_graphics.


fem_verify_tet_all	(threshold, num_failures, worst_value, worst_id)


Description:
This function will run all of the verification tests for all tetrahedral elements in the current group and highlight any elements that fail the tests.
Input:
REAL	threshold(8)	This value specifies the threshold comparison values for all tests.
Output:
INTEGER	num_failures(8)	This value returns the number of elements failing the tests.
REAL	worst_value(8)	This value returns the value at which worst case occurred.
INTEGER	worst_id(8)	This value returns the identifiers for the worst case elements that have failed the tests.
INTEGER	<Return Value>	This function returns a value of 0 when executed successfully and a non zero value to indicate a change in status or an error.
Error Conditions:
See the Status Messages for information on any error values returned by this function.

Remarks:

This function is used in the implementation of the “Finite Elements” switch bar form that is displayed when the action is set to “Verify”, the object is set to “Tet”, and the test is set to “All”.

The input value threshold and the output value num_failures both use the values at the following offsets for the following finite element model attributes:


	Offset	Description.

	1	The value for the aspect ratio test.
	2	The value for the face warp angle test.
	3	The value for the face skew angle test.
	4	The value for the face taper test.
	5	The value for the normal offset test.
	6	The value for the tangent offset test.
	7	Not used.
	8	Not used.

The output values worst_value and worst_id both use the values at the following offsets to return information about the following finite element model attributes:


	Offset	Description.

	1	The value for aspect ratio test.
	2	The value for the face warp angle test.
	3	The value for the face skew angle test.
	4	The value for the face taper test.
	5	The value for the normal offset test.
	6	The value for the tangent offset test.
	7	The value for the Jacobian ratio test.
	8	The value for the Jacobian zero test.

Example:

Please see fem_verify_tet_all.


fem_verify_tet_aspect	(normalize, threshold, group_name, minimum_value, minimum_id, maximum_value, maximum_id, table_id)


Description:
This function will load the graphic display tables with the aspect ratio values of all of the tetrahedral elements in the current group.
Input:
LOGICAL	normalize	This value specifies, when set to TRUE, that the aspect ratio values loaded into the graphic display table are calculated using a normalization formula.
REAL	threshold	This value specifies the threshold of failure comparison value. When the input value normalize is set to TRUE, this value must be greater than 0.0 and equal to or less than 1.0. When the input value normalize is set to FALSE, this value must be greater than 0.0 and less than or equal to 1.0 E +10.
Output:
STRING	group_name[31]	This value will return a description of the group to which the test has been applied.
REAL	minimum_value	This value will return the minimum aspect ratio value.
INTEGER	minimum_id	This value will return the id of the element with the minimum aspect ratio value.
REAL	maximum_value	This value will return the maximum aspect ratio value.
INTEGER	maximum_id	This value will return the id of the element with the maximum aspect ratio value.
INTEGER	table_id	This value returns the id for the table of element aspect ratio values.
INTEGER	<Return Value>	This function returns a value of 0 when executed successfully and a non zero value to indicate a change in status or an error.
Error Conditions:
See the Status Messages for information on any error values returned by this function.

Remarks:

This function will write the element number and the aspect ratio value for each element in the current group that has exceeded the threshold value to the history window.

This function can display a percent complete popup form.

Example:

Please see fem_verify_tet_aspect.


fem_verify_tet_collapse	(normalize, threshold, group_name, minimum_value, minimum_id, maximum_value, maximum_id, table_id)


Description:
This function will load the graphic display tables with the collapse values of all of the tetrahedral elements in the current group.
Input:
LOGICAL	normalize	This value specifies, when set to TRUE, that the collapse values loaded into the graphic display table are calculated using a normalization formula.
REAL	threshold	This value specifies the threshold of failure comparison value. When the input value normalize is set to TRUE, this value must be greater than 0.0 and equal to or less than 1.0. When the input value normalize is set to FALSE, this value must be greater than 0.0 and less than or equal to 1.0 E +10.
Output:
STRING	group_name[31]	This value will return a description of the group to which the test has been applied.
REAL	minimum_value	This value will return the minimum collapse value.
INTEGER	minimum_id	This value will return the id of the element with the minimum collapse value.
REAL	maximum_value	This value will return the maximum collapse value.
INTEGER	maximum_id	This value will return the id of the element with the maximum collapse value.
INTEGER	table_id	This value returns the id for the table of element collapse values.
INTEGER	<Return Value>	This function returns a value of 0 when executed successfully and a non zero value to indicate a change in status or an error.
Error Conditions:
See the Status Messages for information on any error values returned by this function.

Remarks:

This function will write the element number and the collapse value for each element in the current group that has exceeded the threshold value to the history window.

This function can display a percent complete popup form.

Example:

Please see fem_verify_tet_collapse.


fem_verify_tet_edangle	(normalize, threshold, group_name, minimum_value, minimum_id, maximum_value, maximum_id, table_id)


Description:
This function will load the graphic display tables with the edge angle values of all of the tetrahedral elements in the current group.
Input:
LOGICAL	normalize	This value specifies, when set to TRUE, that the edge angle values loaded into the graphic display table are calculated using a normalization formula.
REAL	threshold	This value specifies the threshold of failure comparison value. When the input value normalize is set to TRUE, this value must be greater than 0.0 and equal to or less than 1.0. When the input value normalize is set to FALSE, this value must be greater than 0.0 and less than or equal to 1.0 E +10.
Output:
STRING	group_name[31]	This value will return a description of the group to which the test has been applied.
REAL	minimum_value	This value will return the minimum edge angle value.
INTEGER	minimum_id	This value will return the id of the element with the minimum edge angle value.
REAL	maximum_value	This value will return the maximum edge angle value.
INTEGER	maximum_id	This value will return the id of the element with the maximum edge angle value.
INTEGER	table_id	This value returns the id for the table of element edge angle values.
INTEGER	<Return Value>	This function returns a value of 0 when executed successfully and a non zero value to indicate a change in status or an error.
Error Conditions:
See the Status Messages for information on any error values returned by this function.

Remarks:

This function will write the element number and the edge angle value for each element in the current group that has exceeded the threshold value to the history window.

This function can display a percent complete popup form.

Example:

Please see fem_verify_tet_edangle.


fem_verify_tet_fskew	(normalize, threshold, group_name, minimum_value, minimum_id, maximum_value, maximum_id, table_id)


Description:
This function will load the graphic display tables with the face skew values of all of the tetrahedral elements in the current group.
Input:
LOGICAL	normalize	This value specifies, when set to TRUE, that the face skew values loaded into the graphic display table are calculated using a normalization formula.
REAL	threshold	This value specifies the threshold of failure comparison value. When the input value normalize is set to TRUE, this value must be greater than 0.0 and equal to or less than 1.0. When the input value normalize is set to FALSE, this value must be greater than 0.0 and less than or equal to 90.0.
Output:
STRING	group_name[31]	This value will return a description of the group to which the test has been applied.
REAL	minimum_value	This value will return the minimum face skew value.
INTEGER	minimum_id	This value will return the id of the element with the minimum face skew value.
REAL	maximum_value	This value will return the maximum face skew value.
INTEGER	maximum_id	This value will return the id of the element with the maximum face skew value.
INTEGER	table_id	This value returns the id for the table of element face skew values.
INTEGER	<Return Value>	This function returns a value of 0 when executed successfully and a non zero value to indicate a change in status or an error.
Error Conditions:
See the Status Messages for information on any error values returned by this function.

Remarks:

This function will write the element number and the face skew value for each element in the current group that has exceeded the threshold value to the history window.

This function can display a percent complete popup form.

Example:

Please see fem_verify_tet_fskew.


fem_verify_tria_all	(threshold, num_failures, worst_value, worst_id)


Description:
This function will run all of the verification tests for all triangular elements in the current group an highlight any elements that fail the tests.
Input:
REAL	threshold(6)	This value specifies the threshold comparison value for all of the tests. See the remarks for a description of the use of each offset in this array.
Output:
INTEGER	num_failures(6)	This value returns the number of elements that have failed a test. See the remarks for a description of the use of each offset in this array.
REAL	worst_value(6)	This value returns the value for the worst case value of each test. See the remarks for a description of the use of each offset in this array.
INTEGER	worst_id(6)	This value returns the id for the worst case element of each test. See the remarks for a description of the use of each offset in this array.
INTEGER	<Return Value>	This function returns a value of 0 when executed successfully and a non zero value to indicate a change in status or an error.
Error Conditions:
See the Status Messages for information on any error values returned by this function.

Remarks:

This function is used in the implementation of the “Finite Elements” switch bar form that is displayed when the action is set to “Verify”, the object is set to “Tria”, and the test is set to “All”.

The input value threshold and the output value num_failures both use the values at the following offsets for the following finite element model attributes.


	Offset	Description.

	1	The value for the aspect ratio test.
	2	The value for the face skew angle test.
	3	The value for the normal offset test.
	4	The value for the tangent offset test.
	5	Not used.
	6	Not used.

The output values worst_value and worst_id both use the values at the following offsets to return information about the following finite element model attributes


	Offset	Description.

	1	The value for aspect ratio test.
	2	The value for the face skew angle test.
	3	The value for the normal offset test.
	4	The value for the tangent offset test.
	5	The value for the Jacobian ratio test.
	6	The value for the Jacobian zero test.

Example:

Please see fem_verify_tria_all.


fem_verify_tria_aspect	(normalize, threshold, group_name, minimum_value, minimum_id, maximum_value, maximum_id, table_id)


Description:
This function will load the graphic display tables with the aspect ratio values of all of the triangular elements in the current group.
Input:
LOGICAL	normalize	This value specifies, when set to TRUE, that the aspect ratio values loaded into the graphic display table are calculated using a normalization formula.
REAL	threshold	This value specifies the threshold of failure comparison value. When the input value normalize is set to TRUE, this value must be greater than 0.0 and equal to or less than 1.0. When the input value normalize is set to FALSE, this value must be greater than 0.0 and less than or equal to 90.0.
Output:
STRING	group_name[31]	This value will return a description of the group to which the test has been applied.
REAL	minimum_value	This value will return the minimum aspect ratio value.
INTEGER	minimum_id	This value will return the id of the element with the minimum aspect ratio value.
REAL	maximum_value	This value will return the maximum aspect ratio value.
INTEGER	maximum_id	This value will return the id of the element with the maximum aspect ratio value.
INTEGER	table_id	This value returns the id for the table of element aspect ratio values.
INTEGER	<Return Value>	This function returns a value of 0 when executed successfully and a non zero value to indicate a change in status or an error.
Error Conditions:
See the Status Messages for information on any error values returned by this function.

Remarks:

This function will write the element number, the aspect ratio value for each element in the current group that has exceeded the threshold value, and the threshold value to the history window.

This function can display a percent complete popup form.

Example:

Please see fem_verify_tria_aspect.


fem_verify_tria_skew	(normalize, threshold, group_name, minimum_value, minimum_id, maximum_value, maximum_id, table_id)


Description:
This function will load the graphic display tables with the skew angle values of all of the triangular elements in the current group.
Input:
LOGICAL	normalize	This value specifies, when set to TRUE, that the skew angle values loaded into the graphic display table are calculated using a normalization formula.
REAL	threshold	This value specifies the threshold of failure comparison value. When the input value normalize is set to TRUE, this value must be greater than 0.0 and equal to or less than 1.0. When the input value normalize is set to FALSE, this value must be greater than 0.0 and less than or equal to 90.0.
Output:
STRING	group_name[31]	This value will return a description of the group to which the test has been applied.
REAL	minimum_value	This value will return the minimum skew angle value.
INTEGER	minimum_id	This value will return the id of the element with the minimum skew angle value.
REAL	maximum_value	This value will return the maximum skew angle value.
INTEGER	maximum_id	This value will return the id of the element with the maximum skew angle value.
INTEGER	table_id	This value returns the id for the table of element skew angle values.
INTEGER	<Return Value>	This function returns a value of 0 when executed successfully and a non zero value to indicate a change in status or an error.
Error Conditions:
See the Status Messages for information on any error values returned by this function.

Remarks:

This function will write the element number, the skew angle value for each element in the current group that has exceeded the threshold value, and the threshold value to the history window.

This function can display a percent complete popup form.

Example:

Please see fem_verify_tria_skew.


fem_verify_wedge_all	(threshold, num_failures, worst_value, worst_id)


Description:
This function will run all of the verification tests for all wedge elements in the current group an highlight any elements that fail the tests.
Input:
REAL	threshold(10)	This value specifies the threshold comparison value for all of the tests. See the remarks for a description of the use of each offset in this array.
Output:
INTEGER	num_failures(10)	This value returns the number of elements that have failed a test. See the remarks for a description of the use of each offset in this array.
REAL	worst_value(10)	This value returns the value for the worst case value of each test. See the remarks for a description of the use of each offset in this array.
INTEGER	worst_id(10)	This value returns the id for the worst case element of each test. See the remarks for a description of the use of each offset in this array.
INTEGER	<Return Value>	This function returns a value of 0 when executed successfully and a non zero value to indicate a change in status or an error.
Error Conditions:
See the Status Messages for information on any error values returned by this function.

Remarks:

A wedge element has the following prismatic shape:

This function is used in the implementation of the “Finite Elements” switch bar form that is displayed when the action is set to “Verify”, the object is set to “Wedge”, and the test is set to “All”.

The real input value threshold uses the offsets in the array to specify the test failure threshold values for the following finite model attributes:


	Offset	Description

	1	The aspect ratio or the length/height of the element with a range of 0 to 20.
	2	The edge angle of the element with a range of 0 to 90 degrees.
	3	The face skew angle of the element with a range of 0 to 90 degrees.
	4	The face warp angle of the element with a range of 0 to 90 degrees.
	5	The element twist angle with a range of 0 to 90 degrees.
	6	The face taper value ranging from 0 to 1.
	7	The normal offset value.
	8	The tangent offset value.
	9	Not used.
	10	Not used.

The output values num_failures, worst_value, and worst_id all use array offsets in the in the following manner:


	Offset	Description

	1	The value for aspect ratio test.
	2	The value for the edge angle test.
	3	The value for the face skew angle test.
	4	The value for the face warp angle test.
	5	The value for the element twist angle test.
	6	The value for the face taper test.
	7	The value for the normal offset test.
	8	The value for the tangent offset test.
	9	The value for the Jacobian ratio test.
	10	The value for the Jacobian zero test.

Example:

Please see fem_verify_wedge_all.


fem_verify_wedge_aspect	(normalize, threshold, group_name, minimum_value, minimum_id, maximum_value, maximum_id, table_id)


Description:
This function will load the graphic display tables with the aspect ratio values of all of the wedge elements in the current group.
Input:
LOGICAL	normalize	This value specifies, when set to TRUE, that the aspect ratio values loaded into the graphic display table are calculated using a normalization formula.
REAL	threshold	This value specifies the threshold of failure comparison value. When the input value normalize is set to TRUE, this value must be greater than 0.0 and equal to or less than 1.0. When the input value normalize is set to FALSE, this value must be greater than 0.0 and less than or equal to 10.0 E +10.
Output:
STRING	group_name[31]	This value will return a description of the group to which the test has been applied.
REAL	minimum_value	This value will return the minimum aspect ratio value.
INTEGER	minimum_id	This value will return the id of the element with the minimum aspect ratio value.
REAL	maximum_value	This value will return the maximum aspect ratio value.
INTEGER	maximum_id	This value will return the id of the element with the maximum aspect ratio value.
INTEGER	table_id	This value returns the id for the table of element aspect ratio values.
INTEGER	<Return Value>	This function returns a value of 0 when executed successfully and a non zero value to indicate a change in status or an error.
Error Conditions:
See the Status Messages for information on any error values returned by this function.

Remarks:

A wedge element has the following prismatic shape:

This function will write the element number and the aspect ratio value for each element in the current group that has exceeded the threshold value to the history window.

This function can display a percent complete popup form.

Example:

Please see fem_verify_wedge_aspect.


fem_verify_wedge_edangle	(normalize, threshold, group_name, minimum_value, minimum_id, maximum_value, maximum_id, table_id)


Description:
This function will load the graphic display tables with the face edge angle values of all of the wedge elements in the current group.
Input:
LOGICAL	normalize	This value specifies, when set to TRUE, that the face edge angle values loaded into the graphic display table are calculated using a normalization formula.
REAL	threshold	This value specifies the threshold of failure comparison value. When the input value normalize is set to TRUE, this value must be greater than 0.0 and equal to or less than 1.0. When the input value normalize is set to FALSE, this value must be greater than 0.0 and less than or equal to 120.0
Output:
STRING	group_name[31]	This value will return a description of the group to which the test has been applied.
REAL	minimum_value	This value will return the minimum face edge angle value.
INTEGER	minimum_id	This value will return the id of the element with the minimum face edge angle value.
REAL	maximum_value	This value will return the maximum face edge angle value.
INTEGER	maximum_id	This value will return the id of the element with the maximum face edge angle value.
INTEGER	table_id	This value returns the id for the table of element face edge angle values.
INTEGER	<Return Value>	This function returns a value of 0 when executed successfully and a non zero value to indicate a change in status or an error.
Error Conditions:
See the Status Messages for information on any error values returned by this function.

Remarks:

A wedge element has the following prismatic shape:

This function will write the element number and the face edge angle value for each element in the current group that has exceeded the threshold value to the history window.

This function can display a percent complete popup form.

Example:

Please see fem_verify_wedge_edangle.


fem_verify_wedge_fskew	(normalize, threshold, group_name, minimum_value, minimum_id, maximum_value, maximum_id, table_id)


Description:
This function will load the graphic display tables with the face skew angle values of all of the wedge elements in the current group.
Input:
LOGICAL	normalize	This value specifies, when set to TRUE, that the face skew angle values loaded into the graphic display table are calculated using a normalization formula.
REAL	threshold	This value specifies the threshold of failure comparison value. When the input value normalize is set to TRUE, this value must be greater than 0.0 and equal to or less than 1.0. When the input value normalize is set to FALSE, this value must be greater than 0.0 and less than or equal to 90.0
Output:
STRING	group_name[31]	This value will return a description of the group to which the test has been applied.
REAL	minimum_value	This value will return the minimum face skew angle value.
INTEGER	minimum_id	This value will return the id of the element with the minimum face skew angle value.
REAL	maximum_value	This value will return the maximum face skew angle value.
INTEGER	maximum_id	This value will return the id of the element with the maximum face skew angle value.
INTEGER	table_id	This value returns the id for the table of element face skew angle values.
INTEGER	<Return Value>	This function returns a value of 0 when executed successfully and a non zero value to indicate a change in status or an error.
Error Conditions:
See the Status Messages for information on any error values returned by this function.

Remarks:

A wedge element has the following prismatic shape:

This function will write the element number and the face skew angle value for each element in the current group that has exceeded the threshold value to the history window.

This function can display a percent complete popup form.

Example:

Please see fem_verify_wedge_fskew.


fem_verify_wedge_ftaper	(normalize, threshold, group_name, minimum_value, minimum_id, maximum_value, maximum_id, table_id)


Description:
This function will load the graphic display tables with the face taper values of all of the wedge elements in the current group.
Input:
LOGICAL	normalize	This value specifies, when set to TRUE, that the face taper values loaded into the graphic display table are calculated using a normalization formula.
REAL	threshold	This value specifies the threshold of failure comparison value. When the input value normalize is set to TRUE, this value must be greater than 0.0 and equal to or less than 1.0. When the input value normalize is set to FALSE, this value must be greater than 0.0 and less than or equal to 2147483600.0
Output:
STRING	group_name[31]	This value will return a description of the group to which the test has been applied.
REAL	minimum_value	This value will return the minimum face taper value.
INTEGER	minimum_id	This value will return the id of the element with the minimum face taper value.
REAL	maximum_value	This value will return the maximum face taper value.
INTEGER	maximum_id	This value will return the id of the element with the maximum face taper value.
INTEGER	table_id	This value returns the id for the table of element face taper values.
INTEGER	<Return Value>	This function returns a value of 0 when executed successfully and a non zero value to indicate a change in status or an error.
Error Conditions:
See the Status Messages for information on any error values returned by this function.

Remarks:

A wedge element has the following prismatic shape:

This function will write the element number and the face taper value for each element in the current group that has exceeded the threshold value to the history window.

This function can display a percent complete popup form.

Example:

Please see fem_verify_wedge_ftaper.


fem_verify_wedge_fwarp	(normalize, threshold, group_name, minimum_value, minimum_id, maximum_value, maximum_id, table_id)


Description:
This function will load the graphic display tables with the face warp values of all of the wedge elements in the current group.
Input:
LOGICAL	normalize	This value specifies, when set to TRUE, that the face taper values loaded into the graphic display table are calculated using a normalization formula.
REAL	threshold	This value specifies the threshold of failure comparison value. When the input value normalize is set to TRUE, this value must be greater than 0.0 and equal to or less than 1.0. When the input value normalize is set to FALSE, this value must be greater than 0.0 and less than or equal to 90.0
Output:
STRING	group_name[31]	This value will return a description of the group to which the test has been applied.
REAL	minimum_value	This value will return the minimum face warp value.
INTEGER	minimum_id	This value will return the id of the element with the minimum face warp value.
REAL	maximum_value	This value will return the maximum face warp value.
INTEGER	maximum_id	This value will return the id of the element with the maximum face warp value.
INTEGER	table_id	This value returns the id for the table of element face warp values.
INTEGER	<Return Value>	This function returns a value of 0 when executed successfully and a non zero value to indicate a change in status or an error.
Error Conditions:
See the Status Messages for information on any error values returned by this function.

Remarks:

A wedge element has the following prismatic shape:

This function will write the element number and the face warp value for each element in the current group that has exceeded the threshold value to the history window.

This function can display a percent complete popup form.

Example:

Please see fem_verify_wedge_fwarp.


fem_verify_wedge_twist	(normalize, threshold, group_name, minimum_value, minimum_id, maximum_value, maximum_id, table_id)


Description:
This function will load the graphic display tables with the twist values of all of the wedge elements in the current group.
Input:
LOGICAL	normalize	This value specifies, when set to TRUE, that the twist values loaded into the graphic display table are calculated using a normalization formula.
REAL	threshold	This value specifies the threshold of failure comparison value. When the input value normalize is set to TRUE, this value must be greater than 0.0 and equal to or less than 1.0. When the input value normalize is set to FALSE, this value must be greater than 0.0 and less than or equal to 120.0
Output:
STRING	group_name[31]	This value will return a description of the group to which the test has been applied.
REAL	minimum_value	This value will return the minimum twist value.
INTEGER	minimum_id	This value will return the id of the element with the minimum twist value.
REAL	maximum_value	This value will return the maximum twist value.
INTEGER	maximum_id	This value will return the id of the element with the maximum twist value.
INTEGER	table_id	This value returns the id for the table of element twist values.
INTEGER	<Return Value>	This function returns a value of 0 when executed successfully and a non zero value to indicate a change in status or an error.
Error Conditions:
See the Status Messages for information on any error values returned by this function.

Remarks:

A wedge element has the following prismatic shape:

This function will write the element number and the twist value for each element in the current group that has exceeded the threshold value to the history window.

This function can display a percent complete popup form.

Example:

Please see fem_verify_wedge_twist.


verify_boundaries_display_mgr.erase	()


Description:
This function will erase the free boundary display in the viewport.
Input:
None.
Output:
None.
Error Conditions:
None.

Remarks:

See the function verify_boundaries_display_mgr.plot() for more information.

Example:

Please see verify_boundaries_display_mgr.erase.


verify_boundaries_display_mgr.plot	(display_type)


Description:
This function will plot either the free faces or face edges of all of the elements in the model.
Input:
STRING	display_type[10]	This value specifies the property of the free elements to plot and can be set to either “Free_Edges” or “Free_Faces”.
Output:
None.
Error Conditions:
None.

Remarks:

See the function verify_boundaries_display_mgr.erase() for more information.

Example:

Please see verify_boundaries_display_mgr.plot.