*CE_MarkReplaceLinkEntities

Replaces the links from scratch in connectors.

Syntax

*CE_MarkReplaceLinkEntities mark_id link_type link_mark_id ce_style num_ents string_array number_of_strings

Type

HyperMesh Tcl Modify Command

Description

Replaces the links from scratch in connectors.

Inputs

mark_id

The ID of the mark of connectors. Valid values are 1 and 2.

link_type

The type of link to replace.

link_mark_id

The ID of the mark of link entities to remove. Valid values are 1 and 2.

ce_style

The style of connectors to create. Valid values are area, bolt, seam, and spot.

num_ents

The number of links to replace.

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.

Strings are indicated using the format "name=value". Valid strings are:

link_elems_geom=<value>: Specifies whether to connect elems (default) or geom.
link_rule=<value>: Specifies the link rule. Valid values are now, at_fe_realize or none (default).
relink_rule=<value>: Specifies the relink rule. Valid values are id, name or none (default).
tol=<value>: Add entities as links only within this distance of the specified location. Default 0.0.
tol_flag=<value>: Flag for seam or area connector grouping:; 0 - Do not use tol (default); 1 - Use tol

number_of_strings

Integer indicating the size (number of strings) in the string array created using *createstringarray.

Examples

Replace links for spot connectors 1 and 2 by removing existing links first:

*createmark connectors 1 1 2
*createmark comps 1 1 2 3 4
*createstringarray 5 "link_elems_geom=elems" "link_rule=now" "relink_rule=id" "tol=99.0" " tol_flag=1"
*CE_MarkReplaceLinkEntities 1 comps 1 "spot" 4 1 5

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

2021