Model.CE_ConnectorCreateByMarkWithCC

Model.CE_ConnectorCreateByMarkWithCC(collection, ce_style, num_links, link_collection, cc_type, cc_name, area_mesh_size=10.0, area_mesh_type=1, area_offset=0.0, area_width=1.0, line_density=0.0, line_density=0.0, line_offset=0.0, line_offset_flag=0, line_spacing=1.0, link_elems_geom="geom", link_rule="none", relink_rule="none", seam_area_group=0, tol=0.0, tol_flag=0, line_preserve_nodes=0, start_offset=0.0, end_offset=0.0, retain_line=1, ce_nonnormal=0, loc_as_link=0, ce_extralinknum=0, ce_hexaoffsetcheck=0, area_linecombine=1, ce_normal_link=1, ce_link_option=0, ce_normal_angle=0.0, ce_center_pos=0, ce_boltmindiameter=0.0, ce_boltmaxdiameter=0.0, ce_boltcenterset=0, ce_boltcenter=0, ce_num_center=0, ce_maxlinkupto=0, ce_aero_line=0, line_combine_option="", smooth_curve_nodes=0, line_preserve_joints=0, ce_seam_discontinuity=0, const eline_flag=0, disable_multilinks=0, grouplinks=0, main_link_count=0, main_link_ids=hwIntList(), area_facet_index="")

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

Parameters:

• collection (Collection) –

  The collection containing the entities that specifies the location to create connectors. Valid entities are:

  points Valid for Spot, Bolt, and Apply Mass connectors.

  nodes Valid for Spot, Bolt, and Apply Mass connectors.

  lines Valid for Spot, Bolt, and Seam connectors.

  elements Valid only for Area connectors.

  surfaces Valid only for Area connectors.

• ce_style (hwString) – The style of connectors to create. Valid values are “apply_mass”, “area”, “bolt”, “seam”, and “spot”.

• num_links (int) – The number of links to use.

• link_collection (Collection) –

  The collection containing the entities to create links for. Valid entities are:

  components Valid only for Spot, Bolt, Seam or Area or Apply Mass connectors.

  elements Valid for Spot or Apply Mass connectors.

  nodes Valid for Spot or Apply Mass connectors.

  surfaces Valid only for Spot, Seam or Area connectors.

  tags Valid for Spot or Apply Mass connectors.

• cc_type (EntityFullType) – The type of control to assign. Valid values are connectorcontrol and connectorcontroldefault.

• cc_name (hwString) – The name of the connectorcontrol/connectorcontroldefault to assign.

• area_mesh_size (double) – The mesh size for area connectors when entities in collection are surfaces.

• area_mesh_type (int) –

  The mesh type for area connectors when entities in collection are surfaces.

  0 - Trias

  1 - Quads

  2 - Mixed

  3 - Right trias

• area_offset (double) – Offset area connectors created from node or line lists from the selected location by this value. (Default 0.0.)

• area_width (double) – Width of area connectors created from node or line lists. (Default 1.0.)

• line_density (double) – The density for spot or seam connectors on lines. (Default 0.0.)

• line_offset (double) – Offset value from the ends of the line for spot or seam connectors on lines. (Default 0.0.)

• line_offset_flag (int) –

  0 - Do not offset connectors (default)

  1 - Offset connectors

• line_spacing (double) – The spacing for spot or seam connectors on lines. (Default 1.0.)

• link_elems_geom (hwString) – Specifies whether to connect elements (“elems” default) or geometry (“geom”).

• link_rule (hwString) – Specifies the link rule. Valid values are “now”, “at_fe_realize” or “none”. (Default “none”)

• relink_rule (hwString) – Specifies the relink rule. Valid values are “id”, “name” or “none”. (Default “none”)

• seam_area_group (int) –

  Flag for seam or area connector grouping:

  0 - No (default)

  1 - Yes

• tol (double) – Add entities as links only within this distance of the specified location. (Default 0.0.)

• tol_flag (int) –

  Flag for seam or area connector grouping:

  0 - Do not use tol (default)

  1 - Use tol

• line_preserve_nodes (int) – Reserved for future development.

• start_offset (double) – The offset distance at the start of the combined line.

• end_offset (double) – The offset distance at the end of the combined line.

• retain_line (int) – Reserved for future development.

• ce_nonnormal (int) –

  0 - Normal projection

  1 - Non-normal projection.

• loc_as_link (int) – Reserved for future development.

• ce_extralinknum (int) – Reserved for future development.

• ce_hexaoffsetcheck (int) – Reserved for future development.

• area_linecombine (int) – Reserved for future development.

• ce_normal_link (int) – Reserved for future development.

• ce_link_option (int) – Reserved for future development.

• ce_normal_angle (double) – Reserved for future development.

• ce_center_pos (int) – Reserved for future development.

• ce_boltmindiameter (double) – The minimum diameter for a hole to be accepted as a bolt hole.

• ce_boltmaxdiameter (double) – The maximum diameter for a hole to be accepted as a bolt hole.

• ce_boltcenterset (int) – Reserved for future development.

• ce_boltcenter (int) – Reserved for future development.

• ce_num_center (int) – Reserved for future development.

• ce_maxlinkupto (int) – Reserved for future development.

• ce_aero_line (int) – Reserved for future development.

• line_combine_option (hwString) –

  The combine option for combining the two or more line connectors:

  combine_smooth - Combines lines/connector with smooth

  curvecombine_straight - Combines lines/connectors with straight

  curvecombine_midline - Combines two lines/connectors as one midline connector

• smooth_curve_nodes (int) – Reserved for future development.

• line_preserve_joints (int) – Reserved for future development.

• ce_seam_discontinuity (int) – Reserved for future development.

• eline_flag (int) – Reserved for future development.

• disable_multilinks (int) – Reserved for future development.

• grouplinks (int) – Reserved for future development.

• main_link_count (int) – Reserved for future development.

• main_link_ids (hwIntList) – Reserved for future development.

• area_facet_index (hwString) – Reserved for future development.

Example

Create a spot connector at the location of node with ID 10 to connect components with IDs 3 and 4 using a tolerance of 6.0 and assign connectorcontrol “my_acm”

import hm
import hm.entities as ent

model = hm.Model()

model.CE_ConnectorCreateByMarkWithCC(
    collection=hm.Collection(model, ent.Node, [10]),
    ce_style="spot",
    num_links=2,
    link_collection=hm.Collection(model, ent.Component, [3, 4]),
    cc_type=ent.Connectorcontrol,
    cc_name="my_acm",
    link_elems_geom="elems",
    link_rule="now",
    relink_rule="none",
    tol_flag=1,
    tol=6.0,
)