Nodes

Tutorial Toolkit Function Descriptions > Finite Element Model > Nodes

XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX''">XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX''">

Nodes


db_get_nodal_association	( nnode, nid, gid, gtype )


Description:
This function will retrieve the geometry type and ID that is associated with each node that is specified.
Input:
INTEGER	nnode	The number of node IDs being supplied.
INTEGER	nid()	The array of nodes IDs to be looked up.
Output:
INTEGER	gid()	The array of geometry IDs (one for each node ID).
INTEGER	gtype()	The array of geometry types (one for each node ID).
INTEGER	<Return Value>	Integer indicating success or failure of the routine. If the routine failed, this value contains an indication of the reason.

Example:

Please see db_get_nodal_association (p. 730) in the MSC Acumen Toolkit - Code Example.


db_get_node	( id, xyz )


Description:
Given a node ID, this function will look up the specified node and return the coordinates of that node to the caller.
Input:
INTEGER	id	The node ID to be looked up.
Output:
REAL	xyz(3)	An array of 3 floating point values which are the coordinates of the specified node.
INTEGER	<Return Value>	Integer indicating the success or failure of the routine.
Error Conditions:
SUCCESS	This function completed successfully.
13000020	Node not found.

Example:

Please see db_get_node (p. 731) in the MSC Acumen Toolkit - Code Example.


db_get_nodes_by_lbc	( lbc_id, max_node, nnode, nid )


Description:
Gets all nodes associated with an specified lbc.
Input:
INTEGER	lbc_id	Id of the lbc to which the requested nodes are associated.
INTEGER	max_node	Maximum number of node ids for which storage has been allocated by the calling routine.
Output:
INTEGER	nnode	Number of nodes found associated to the specified lbc.
INTEGER	nid()	Ids of the nodes associated to the specified lbc.
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:
13000002	Unrecoverable database error.
13000048	Maximum node count exceeded.
External Dependencies and Side Effects:
None.

Example:

Please see db_get_nodes_by_lbc (p. 732) in the MSC Acumen Toolkit - Code Example.


db_get_nodes_for_geometry	( geo_type, geo_id, parent_type, parent_id, nnode, nids, ncoord )


Description:
This function will retrieve information about all of the nodes associated with a given piece of geometry.
Input:
INTEGER	geo_type	The type of geometry in question.
INTEGER	geo_id	The id of the geometry in question.
INTEGER	parent_type	The type of highest order geometry that the “geo-type” is part of.
INTEGER	parent_id	The id of the highest order geometry that the “geo-type” is part of.
Output:
INTEGER	nnode	The number of nodes found.
INTEGER	nids()	The IDs of all of the nodes found.
REAL	ncoord()	The model space coordinates of each node (x, y, z).
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:
SUCCESS	This function completed successfully.

Example:

Please see db_get_nodes_for_geometry (p. 733) in the MSC Acumen Toolkit - Code Example.


db_get_next_node_id	( id )


Description:
This function will return the next available node ID to the caller. This can be used to create another node.
Input:
None.
Output:
INTEGER	id	The next available node ID.
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:
SUCCESS	This function completed successfully.

Example:

Please see db_get_next_node_id (p. 728) in the MSC Acumen Toolkit - Code Example.


db_get_min_node_id	( id )


Description:
This function will find the smallest node ID currently in use.
Input:
None.
Output:
INTEGER	id	The smallest node ID currently in use.
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:
SUCCESS	This function completed successfully.

Example:

Please see db_get_min_node_id (p. 723) in the MSC Acumen Toolkit - Code Example.


db_get_max_node_id	( id )


Description:
This function will find the largest node ID currently in use.
Input:
None.
Output:
INTEGER	id	The largest node ID currently in use.
INTEGER	<Return Value>	Integer indicating success or failure of the routine. If the routine failed, this value contains an indication of the reason.

Example:

See example for db_get_min_node_id, 296. See also db_get_max_node_id (p. 720) in the MSC Acumen Toolkit - Code Example.


fem_get_node_assoc_groups	( nnode, idnodes, ngroups, ids )


Description:
Get a list of all the groups associated with the nodes in the FEM_LIST.
Input:
INTEGER	nnode	Number of nodes.
INTEGER	idnodes()	List of nodes.
Output:
INTEGER	ngroups	Number of unique groups associated with nodes.
INTEGER	ids()symbol	Pointer to VIRTUAL integer array containing list of associated group IDs.
INTEGER	<Return Value>	0 Function was successful. -1 Abort -2 No NODEs in list -3 No associated groups
Error Conditions:
2001070	Unable to acquire %I% words of virtual memory.
4	Interrupted system call.

Example:

Please see fem_get_node_assoc_groups (p. 754) in the MSC Acumen Toolkit - Code Example.


fem_get_node_ids	( entity_lst, nnode, idnode, notfound, idnoexist )


Description:
This function will sort a list of node id values, returning a list of existing nodes and a list of nodes that do not exist.
Input:
STRING	entity_list[]	This value specifies a list of nodes.
Output:
INTEGER	nnode	This value returns the number of node id values in the return value idnode.
INTEGER	idnode(VIRTUAL)	This value returns an array of node id values that refer to nodes that do exist.
INTEGER	notfound	This value returns the number of node id values in the return value idnoexist.
INTEGER	idnoexist(VIRTUAL)	This value returns an array of node id values that refer to nodes that do not exist.
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:
-1	Abort.
-2	No existing nodes in list
4	Interrupted system call.
2001070	Unable to acquire %I% words of virtual memory.
16000102	Database error during list processing: Node not found

Example:

See example for fem_get_node_assoc_groups, 297. See also fem_get_node_ids (p. 755) in the MSC Acumen Toolkit - Code Example.


db_verify_nodes_exist	( nnode, nid, exist )


Description:
This function verifies that a set of node id values exist in the database.
Input:
INTEGER	nnode	This value specifies the number of node values listed in the input value nid.
INTEGER	nid(nnode)	This value specifies the node ids to be checked.
Output:
INTEGER	exist(nnode)	This value specifies an array of integers used used to designate the existence of a node I. A non-zero value indicates the existence of the node and a 0 indicates the id does not exist.
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.

Example:

Please see db_verify_nodes_exist (p. 745) in the MSC Acumen Toolkit - Code Example.


db_count_unref_nodes	( nbr_unref_node )


Description:
This function will count all of the nodes in the database which are not referenced by any of the elements.
Input:
None.
Output:
INTEGER	nbr_unref_node	The number of unreferenced nodes in the database.
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:
SUCCESS	This function completed successfully.
13000020	Node not found.

Example:

Please see db_count_unref_nodes (p. 693) in the MSC Acumen Toolkit - Code Example.


db_get_unreferenced_node_ids	( nnode, nunref, nid )


Description:
This function will return the IDs and the count of all of the nodes in the database that are not referenced by any elements or mpcs. If the specified count is less than the number of nodes in the database, output will stop when the requested count has been reached. The order of the IDs returned is not determinate.
Input:
INTEGER	nnode	The maximum number of nodes that can be returned.
Output:
INTEGER	nunref	The number of unreferenced nodes found.
INTEGER	nid()	The array of IDs of the unreferenced nodes.
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:
SUCCESS	This function completed successfully.
13000048	Maximum node count exceeded.

Example:

Please see db_get_unreferenced_node_ids (p. 738) in the MSC Acumen Toolkit - Code Example.