Renumber Action

PCL Reference Manual > Finite Element Functions > Renumber Action

XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX''">XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX''">

Renumber Action

This section is used to describe some of the functions used to renumber the identifiers used to reference a selection of finite element model (FEM) nodes or elements.


fem_renum_elem_1	(original_selection, new_selection, flag, created_selection)


Description:
This function will renumber a selection of element identifiers in either a consecutive manner beginning with a starting element identifier or as directed by a selection of element identifiers.
Input:
STRING	original_selection[]	This value specifies a selection of element identifiers that will be renumbered.
STRING	new_selection[]	This value specifies a selection of element identifiers to which the original elements will be renumbered. If there is only one element identifier in the selection the original element identifiers will be renumbered in a consecutive manner. If more than one element identifier is provided, the identifiers in the input value original_selection will be renumbered to match the identifiers specified by this input value.
INTEGER	flag	When set to 2, this value specifies use of the new numbering control scheme. When set to 4, this value specifies use of the new id offset method.
Output:
STRING	created_selection[VIRTUAL]	This value returns a description of the renumbered element identifiers.
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 created_selection. It is the responsibility of the calling function to free the allocated string storage space.

This function will update the element identifiers that are stored in the database and displayed in a viewport.

Example:

Please see fem_renum_elem_1 (p. 779) in the PCL Reference Manual Examples.


fem_renum_node_1	(original_selection, new_selection, flag, created_selection)


Description:
This function will renumber a selection of node identifiers in either a consecutive manner beginning with a starting node identifier or as directed by a selection of node identifiers.
Input:
STRING	original_selection[]	This value specifies a selection of node identifiers that will be renumbered.
STRING	new_selection[]	This value specifies a selection of node identifiers to which the original nodes will be renumbered. If there is only one node identifier in the selection the original node identifiers will be renumbered in a consecutive manner. If more than one node identifier is provided, the identifiers in the input value original_selection will be renumbered to match the identifiers specified by this input value.
INTEGER	flag	When set to 2, this value specifies use of the new numbering control scheme. When set to 4, this value specifies use of the new id offset method.
Output:
INTEGER	created_selection[VIRTUAL]	This value returns a description of the renumbered node identifiers.
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 created_selection. It is the responsibility of the calling function to free the allocated string storage space.

This function will update the node identifiers that are stored in the database and displayed in a viewport.

Example:

Please see fem_renum_node_1 (p. 780) in the PCL Reference Manual Examples.


fem_renum_conn	(conn_list, new_id_list, flag, new_ids)


Description:
This function will renumber a selection of connectors.
Input:
STRING	conn_list	List of connectors to renumber (e.g. CONN 2 3 5:10)
STRING	new_id_list	List of IDs to be assigned (e.g. “500”)
INTEGER	flag	Control options (6=offset)
Output:
STRING	new_idsirtual string containing a list of new IDs (e.g. “Connector 502 503 505:510).	This value returns a description of the renumbered node identifiers.
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:
• 0 Success • -1 Memory error • >0 Database error