*CE_AddLinkEntitiesWithArrays

Update connectors at the specified locations with arrays.

Syntax

*CE_AddLinkEntitiesWithArrays integer_array number_of_integers entity_type entity_mark_id entity_state ce_rules ce_le_rule tolerance_flag double_array number_of_doubles keep_existing string_array number_of_strings

Type

HyperMesh Tcl Modify Command

Description

This command updates connectors at the specified locations with arrays.

Inputs

integer_array
The integer array ID that contains the connector ID and number of layers for that connector. 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.
entity_type
The entity type to be added to the connectors as links.
entity_mark_id
The mark ID the entities to use as links. Valid values are 1 and 2.
entity_state
The state of the link entities. Valid values are:
0 - Geometry.
1 - Elements.
ce_rules
Flag indicating when to make the links. Valid values are:
0 - Now.
1 - At realize.
ce_le_rule
Flag indicating how to make the links. Valid values are:
0 - None.
1 - Use ID.
2 - Use name.
tolerance_flag
Flag indicating whether to use the default tolerance. Valid values are:
0 - Use default.
1 - Use specified values.
double_array
The double array ID that contains the add link tolerance values. The double array is created using the *createdoublearray command. This should always be set to 1.
The tolerance is used to add entities only within the given value from the specified connector. Must be set to 1. Ignored if tolerance_flag is 0.
number_of_doubles
Integer indicating the size (number of doubles) in the double array created using *createdoublearray.
keep_existing
Option for deleting existing links first then adding new links, or adding new links directly.
0 - Delete then add.
1 - Add.
string_array
The string array ID that contains the additional input parameters. The string array is created using the *createstringarray command. This should always be set to 1.
Valid strings are:
ce_spot_extralinknum=1
The number of extra links for spot connectors.
ce_seam_extralinknum=0
The number of extra links for seam connectors.
ce_spot_non_normal=1
The non-normal option for spot connectors.
ce_area_non_normal=0
The non-normal option for area connectors.
number_of_strings
Integer indicating the size (number of strings) in the string array created using *createstringarray.

Examples

To add comps 1 and 2 to connectors 1001, 1002, and 1003 from scratch, the layer numbers for these connectors are 2, 3, and 2, the tolerances are 10.0, 11.0, and 15.0:
*createarray 6 1001 2 1002 3 1003 2
*createdoublearray 3 10.0 11.0 15.0;
*createstringarray 4 "ce_spot_extralinknum=5" "ce_seam_extralinknum=7" "ce_spot_non_normal=1" "ce_area_non_normal=0"
*createmark comps 1 1 2
*CE_AddLinkEntitiesWithArrays 1 6 comps 1 1 1 0 1 1 3 0 1 4

Errors

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

Version History

12.0.110