*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

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