Element/Node Relations

Tutorial Toolkit Function Descriptions > Finite Element Model > Element/Node Relations

XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX''">XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX''">


db_count_elems_using_node	( nnode, nid, nelem, fflag )


Description:
This function will count the number of elements associated with the specified array of nodes in the memory database.
Input:
INTEGER	nnode	The number of node ids in the node id array.
INTEGER	nid()	The array of node IDs to be looked for.
Output:
INTEGER	nelem()	The number of elements associated with this node.
INTEGER	fflag	A flag indicating if any nodes were not found.
INTEGER	<Return Value>	Integer indicating success or failure of the routine. If the routine failed, this value contains an indication of the reason.
Error Conditions:
13000020	Node not found.
SUCCESS	if the node exists and is associated with some elements.

Example:

Please see db_count_elems_using_node (p. 687) in the MSC Acumen Toolkit - Code Example.


db_count_mpcs_using_node	( nnode, nid, nmpc, fflag )


Description:
This function will count the number of MPCs associated with a group of nodes.
Input:
INTEGER	nnode	This value specifies the number of node id values listed in the input value nid.
INTEGER	nid(nnode)	This value specifies the id values of the nodes for which information is being requested.
Output:
INTEGER	nmpc(nnode)	This value returns the number of MPCs using each node.
INTEGER	fflag	This value returns a non zero value if one or more of the nodes listed in the input value nid are not found.
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:
13000020	Node not found.
External Dependencies and Side Effects:
Accesses records in the mpc_term_node table in the database.

Example:

Please see db_count_mpcs_using_node (p. 688) in the MSC Acumen Toolkit - Code Example.


db_count_nodes_in_mpc	( nmpc, mpcid, nnode, fflag )


Description:
Returns the total number of nodes in a specified MPC.
Input:
INTEGER	nmpc	The number of MPCs for which the information is being requested.
INTEGER	mpcid()	The ids of the MPCs for which the information is being requested.
Output:
INTEGER	nnode()	The number of nodes in each MPC.
INTEGER	fflag	An error flag indicating that one or more of the MPCs was not found.
INTEGER	<Return Value>	Integer indicating success or failure of the routine. If the routine failed, this value contains an indication of the reason.
Error Conditions:
13000142	The MPC was not found in the database.
External Dependencies and Side Effects:
Accesses records in the mpc_term_node table in the database.

Example:

Please see db_count_nodes_in_mpc (p. 690) in the MSC Acumen Toolkit - Code Example.


db_get_elems_using_nodes	( nnode, nid, mxelem, nelem, eid )


Description:
This function will retrieve the list of elements associated with the specified array of nodes in the memory database.
Input:
INTEGER	nnode	The number of node IDs in the node ID array.
INTEGER	nid()	The array of node IDs to be looked for.
INTEGER	mxelem	The maximum number of elements allowed per node.
Output:
INTEGER	nelem()	The number of elements associated with this node.
INTEGER	eid()	The IDs of all elements referencing this node.
INTEGER	<Return Value>	Integer indicating success or failure of the routine. If the routine failed, this value contains an indication of the reason.
Error Conditions:
13000020	Node not found.
SUCCESS	If the node exists and is associated with some elements.

Example:

See example for db_count_elems_using_node, 305. See also db_get_elems_using_nodes (p. 715) in the MSC Acumen Toolkit - Code Example.


db_get_elem_nodes	( eid, numnode, nid )


Description:
This function will retrieve all of the node IDs for a specified element. The nodes will be returned in node position order.
Input:
INTEGER	eid	The element ID to be looked up.
Output:
INTEGER	numnode	The number of nodes associated with this element.
INTEGER	nid()	The array of node IDs associated with this element.
INTEGER	<Return Value>	Integer indicating success or failure of the routine. If the routine failed, this value contains an indication of the reason.
Error Conditions:
13000020	Node not found.
SUCCESS	If some nodes exist for this element.

Example:

Please see db_get_elem_nodes (p. 706) in the MSC Acumen Toolkit - Code Example.


db_get_nodes_in_mpc	( nmpc, mpcid, mxnode, nnode, nid )


Description:
Returns a list of all nodes which refer to the specified MPC.
Input:
INTEGER	nmpc	The number of MPCs ids for which the information is being requested.
INTEGER	mpcid()	The ids of the MPCs for which the information is being requested.
INTEGER	mxnode	The maximum number of nodes which may be returned per MPC.
Output:
INTEGER	nnode()	The number of nodes using each MPC.
INTEGER	nid()	The ids of the nodes for each MPC.
INTEGER	<Return Value>	Integer indicating success or failure of the routine. If the routine failed, this value contains an indication of the reason.
Error Conditions:
13000142	The MPC was not found in the database.
13000150	The list of nodes for one or more of the MPCs is longer than MAXNODE.
External Dependencies and Side Effects:
Accesses records in the mpc_term_node table in the database.

Example:

See example for db_count_nodes_in_mpc, 306. See also db_get_nodes_in_mpc (p. 735) in the MSC Acumen Toolkit - Code Example.


list_get_node_ass_el_edge	(elem_edge_list, node_list)


Description:
This function gets the nodes associated to the specified element edges.
Input:
STRING	elem_edge_list[]	List of element edges.
Output:
STRING	node_list[VIRTUAL]	List of nodes.
INTEGER	<Return Value>	0 for success.
Error Condition:
None

Example:

Please see list_get_node_ass_el_edge (p. 762) in the MSC Acumen Toolkit - Code Example.


list_get_node_ass_el_face	(elem_face_list, node_list)


Description:
This function gets the nodes associated to the specified element faces.
Input:
STRING	elem_face_list[]	List of element faces.
Output:
STRING	node_list[VIRTUAL]	List of nodes.
INTEGER	<Return Value>	0 for success.
Error Condition:
None

Example:

Please see list_get_node_ass_el_face (p. 764) in the MSC Acumen Toolkit - Code Example.


list_get_node_ass_elem	(elem_list, node_list)


Description:
This function gets the nodes associated to the specified element.
Input:
STRING	elem_list[]	List of elements.
Output:
STRING	node_list[VIRTUAL]	List of nodes.
INTEGER	<Return Value>	0 for success.
Error Condition:
None

Example:

Please see list_get_node_ass_elem (p. 766) in the MSC Acumen Toolkit - Code Example.


list_get_node_ass_geo	(ent_list, node_list)


Description:
This function gets the nodes associated to the specified geometry entities.
Input:
STRING	ent_list[]	List of geometry entities.
Output:
STRING	node_list[VIRTUAL]	List of nodes.
INTEGER	<Return Value>	0 for success.
Error Condition:
None

Example:

Please see list_get_node_ass_geo (p. 768) in the MSC Acumen Toolkit - Code Example.


list_get_node_ass_group	(num, group_list, node_list)


Description:
This function gets the nodes associated to the specified groups.
Input:
INTEGER	num	Number of groups.
STRING ARRAY	group_list[]()	Array of group names.
Output:
STRING	node_list[VIRTUAL]	List of nodes.
INTEGER	<Return Value>	0 for success.
Error Condition:
None

Example:

Please see list_get_node_ass_group (p. 769) in the MSC Acumen Toolkit - Code Example.


list_get_node_ass_mpc	(mpc_list, node_list)


Description:
This function gets the nodes associated to the specified mpcs.
Input:
STRING	mpc_list[]	List of mpcs.
Output:
STRING	node_list[VIRTUAL]	List of nodes.
INTEGER	<Return Value>	0 for success.
Error Condition:
None

Example:

Please see list_get_node_ass_mpc (p. 772) in the MSC Acumen Toolkit - Code Example.


list_get_node_att_fringe	(val, act, tol, group, node_list)


Description:
This function gets the nodes associated with a specified fringe range.
Input:
REAL	val(2)	Upper & lower fringe value.
STRING	act[80]	Method name.
REAL	tol	Tolerance of xyz or rpt if applicable.
STRING	group[32]	Group name which has the fringe table.
Output:
STRING	node_list[VIRTUAL]	List of nodes.
INTEGER	<Return Value>	0 for success.
Error Condition:
None

Example:

Please see list_get_node_att_fringe (p. 774) in the MSC Acumen Toolkit - Code Example.


list_get_node_att_value	(val_xyz, val_log, act, tol, coord, group, node_list)


Description:
This function gets the nodes associated with a specified coordinate value.
Input:
REAL ARRAY	val_xyz(3)	Value of xyz or rpt coordinate.
LOGICAL ARRAY	val_log(3)	Logical value specifying active coords.
STRING ARRAY	act[80](3)	Method name.
REAL ARRAY	tol(3)	Tolerance of xyz or rpt if applicable.
STRING	coord[32]	Coordinate frame
LOGICAL	group	Logical value for group.
Output:
STRING	node_list[VIRTUAL]	List of nodes.
INTEGER	<Return Value>	0 for success.
Error Condition:
None

Example:

Please see list_get_node_att_value (p. 776) in the MSC Acumen Toolkit - Code Example.