*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

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