*CE_ConnectorCreateByMark

Creates a certain style of connector at locations specified by a mark, with certain rules and details.

Syntax

*CE_ConnectorCreateByMark entity_type mark_id ce_style num_links link_entity_type link_mark_id string_array number_of_strings

Type

HyperMesh Tcl Modify

Description

Creates a certain style of connector at locations specified by a mark, with certain rules and details.

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).
mark_id
The ID of the mark 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 containing the link entities. Valid values are 1 and 2.
string_array
The ID of the string array that contains the additional input parameters. The string array is created using the *createstringarray command. This should always be set to 1. Valid parameters include:
area_mesh_size=<value>
The mesh size for area connectors when using surfs as the location. Default 10.0.
area_mesh_type=<value>
The mesh type for area connectors when using surfs as the location.
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 elements (elems) or geometry (geom). Default elems.
link_rule=<value>
The link rule. Valid values are now, at_fe_realize or none. Default none.
relink_rule=<value>
The relink rule. Valid values are id, name or none. Default none.
seam_area_group=<value>
Group flag for seam or area connector.
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>
0 - Do not offset tol (default).
1 - Use tol.
number_of_strings
Integer indicating the size (number of strings) in the string array created using *createstringarray.

Examples

To create a spot connector at the location of node 10 to connect components 3 and 4 using a tolerance of 6.0:
*createmark nodes 1 10
*createmark comps 2 3 4
*createstringarray 5 "link_elems_geom=elems" "link_rule=now" "relink_rule=none" "tol_flag=1" "tol=6.0"
*CE_ConnectorCreateByMark nodes 1 spot 2 comps 2 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
}