*CE_FE_RegisterAdvanced
Registers pre-existing FE to multiple connector IDs.
Syntax
*CE_FE_RegisterAdvanced entity_type integer_array number_of_integers
Type
HyperMesh Tcl Modify
Description
Registers pre-existing FE to multiple connector IDs. 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
- entity_type
- The FE type to be registered. Supported types are elements, systems, vectors, loads and equations.
- integer_array
- The ID of the integer array that contains the input data. The integer array is created using the *createarray command. This should always be set to 1.
- number_of_integers
- 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
The following process registers elements 100 and 101 with connector 10, and elements 200, 201, and 202 with connector 20.
First, place connectors 10 and 20 in user control
mode:
*createmark connectors 1 10 20
*CE_SetSpecificDetail 1 2 1 0
Second, create the necessary array of
ints:
*createarray 11 10 0 2 100 101 20 0 3 200 201 202
Third, call *CE_FE_RegisterAdvanced
function:
*CE_FE_RegisterAdvanced elements 1 11
Finally, turn off user control mode for connectors 10 and 20
(optional):
*CE_SetSpecificDetail 1 2 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
}