*CE_AddLinkEntitiesWithXYZs

Update connectors as group links with criteria.

Syntax

*CE_AddLinkEntitiesWithXYZs connector_mark_id entity_type entity_mark_id entity_state ce_rules ce_le_rule locator xyz_array xyz_size

Type

HyperMesh Tcl Modify Command

Description

This command updates connectors as group links with criteria.

Inputs

connector_mark_id
The ID of the mark containing the connectors to update. Valid values are 1 and 2..
entity_type
Type of entity to be added to the connectors as links.
entity_mark_id
The ID of the mark containing 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 - During realization by proximity.
ce_le_rule
Flag indicating how to make the links. Valid values are:
0 - None.
1 - Use ID.
2 - Use name.
locator
Flag that indicates how to use the XYZs. Valid values are:
1 - Do projection.
2 - Find closest node.
3 - Find node at XYZ.
xyz_array
The ID of the XYZ double array created using *createdoublearray command. This should always be 1.
xyz_size
The size of the XYZ double array. Must be a multiple of 3.

Examples

To add comps 1 and 2 as a group link to connectors 1-3, using (1.0, 2.5, 3.0) and (2.0, 3.0, 0.5) as locating coordinates. The link state is "elem", make link now, link rule is "use ID", and the locator is to use projection:
*createmark connectors 1 1-3
*createmark comps 1 1 2
*createdoublearray 6 1.0 2.5 3.0 2.0 3.0 0.5
*CE_AddLinkEntitiesWithXYZs 1 comps 1 1 0 1 1 1 6

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

10-SA1-120