*CE_FE_Register

Registers pre-existing FE to a single connector ID.

Syntax

*CE_FE_Register id testpoint_index entity_type_string_array number_of_entity_types id_integer_array number_of_ids

Type

HyperMesh Tcl Modify Command

Description

Registers pre-existing FE to a single connector ID. Successfully registering pre-existing FE forces a connector to its realized state.

To use this command, a connector must be in user control mode. Also, note that a single FE entity can be registered with, at most, a single connector. Any FE registered with a given connector is treated as part of that connector’s realization.

Inputs

id
The ID of the connector to register to.
testpoint_idx
The connector sub-index in which to register this FE. A connector line with a density of three has three sub-indices (0-2), and a connector point has a single sub-index (0).
entity_type_string_array
The ID of the string array that contains the additional entity type names. The string array is created using the *createstringarray command. This should always be set to 1.
Supported types are elements, systems, vectors, loads and equations. This array should either map 1-to-1 with id_integer_array, or it should only have a single index in which case all the IDs would be of the same type.
number_of_entity_types
Integer indicating the size (number of strings) in the string array created using *createstringarray.
id_integer_array
The ID of the integer array that contains the entity IDs. The integer array is created using the *createarray command. This should always be set to 1.
number_of_ids
Integer indicating the size (number of integers) in the integer array created using *createarray.

Examples

First, change connector 7 to the user control mode:
*CE_SetSpecificDetailById 7 2 1 0.0
Second, create the necessary arrays:
*createstringarray 3 "systems" "elements" "systems"
*createarray 3 30 2127 31
Third, call the CE_FE_Register function for connector 7:
*CE_FE_Register 7 0 1 3 1 3
Finally, turn the user control mode off for connector 7 (optional):
*CE_SetSpecificDetailById 7 2 0 0.0

Errors

Incorrect usage results in a Tcl error. To detect errors, you can use the catch command:
if { [ catch {command_name...} ] } {
   # Handle error
}