*CE_ConnectorCreateByListWithCC

Creates a connector from a list and assigns a connectorcontrol/connectorcontroldefault.

Syntax

*CE_ConnectorCreateByListWithCC entity_type list_id ce_style num_links link_entity_type link_mark_id string_array number_of_strings cc_type cc_name

Type

HyperMesh Tcl Modify Command

Description

Creates a connector from a list and assigns a connectorcontrol/connectorcontroldefault.

Inputs

entity_type

The entity type that specifies the location to create connectors. Valid values are:

elems (for area)

lines (for spot, bolt, seam and area)

nodes (for spot, bolt and apply_mass)

points (for spot, bolt and apply_mass)

surfs (for area).

list_id

The ID of the list containing the entities. Valid values are 1 and 2.

ce_style

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

num_links

The number of links to use.

link_entity_type

The type of entity to create links for. Valid values are:

comps (for spot, bolt, seam, area or apply_mass)

elems (for spot or apply_mass)

nodes (for spot or apply_mass)

surfs (for spot, seam or area)

tags (for spot or apply_mass)

link_mark_id

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

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:

area_mesh_size=<value>: The mesh size for area connectors when entity_type is surfs. Default 10.0.
area_mesh_type=<value>: The mesh type for area connectors when entity_type is surfs.; 0 - Trias; 1 - Quads; 2 - Mixed; 3 - Right trias
area_offset=<value>: Offset area connectors created from node or line lists from the selected location by this value. Default 0.0.
area_width=<value>: Width of area connectors created from node or line lists. Default 1.0.
line_density=<value>: The density for spot or seam connectors on lines. Default 0.0.
line_offset=<value>: Offset value from the ends of the line for spot or seam connectors on lines. Default 0.0.
line_offset_flag=<value>: 0 - Do not offset connectors (default); 1 - Offset connectors
line_spacing=<value>: The spacing for spot or seam connectors on lines. Default 1.0.
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).
seam_area_group=<value>: Flag for seam or area connector grouping:; 0 - No (default); 1 - Yes
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.

cc_type

The type of control to assign. Valid values are connectorcontrol and connectorcontroldefault.

cc_name

The name of the connectorcontrol/connectorcontroldefault to assign.

Examples

Create a seam connector at the location of line 10 to connect component 3 and 4 using a tolerance of 6.0 and assign connectorcontrol seam_quad_ltb:

*createlist lines 1 10
*createmark components 2 3 4
*createstringarray 5 "link_elems_geom=elems" "link_rule=now" "relink_rule=none" "tol_flag=1" "tol=6.000000"
*CE_ConnectorCreateByListWithCC lines 1 "seam" 2 comps 2 1 5 connectorcontrol "seam_quad_ltb"

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