Model.CE_ConnectorCreateByMark#

Model.CE_ConnectorCreateByMark(collection, ce_style, num_links, link_collection, link_elems_geom='', link_rule='', relink_rule='', tol_flag=0, tol=0, line_preserve_nodes=0, line_spacing=1.0, line_density=0, line_offset_flag=0, line_offset=0, start_offset=0.0, end_offset=0.0, retain_line=1, seam_area_group=0, ce_nonnormal=0, area_width=0.0, area_offset=0.0, area_mesh_type=0, area_mesh_size=10.0, loc_as_link=0, ce_extralinknum=0, ce_hexaoffsetcheck=0, area_linecombine=0.0, ce_normal_link=0, ce_link_option=0, ce_normal_angle=0.0, ce_center_pos=0.0, ce_boltmindiameter=0.0, ce_boltmaxdiameter=0.0, ce_boltcenterset=0, ce_num_center=0, ce_maxlinkupto=0, line_combine_option='', smooth_curve_nodes=0, ce_boltcenter=0, ce_config_name='', ce_engg_name='', ce_seam_vertex_angle=45.0, line_preserve_joints=0, ce_seam_discontinuity=0, eline_flag=False, disable_multilinks=0, grouplinks=False, main_link_count=0, main_link_ids=hwIntList())#

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

Parameters:

collection (Collection) –
The collection containing the entities that specify 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 components (for spot, bolt, seam, area or apply_mass), elements (for spot or apply_mass), nodes (for spot or apply_mass), surfaces (for spot, seam or area) and tags (for spot or apply_mass)
link_elems_geom (hwString) – Specifies whether to connect elements (elems) or geometry (geom). Default elems.
link_rule (hwString) – The link rule. Valid values are “now”, “at_fe_realize” or “none”. (Default “none”)
relink_rule (hwString) – The relink rule. Valid values are “id”, “name” or “none”. (Default “none”)
tol_flag (int) –
0 - Do not offset tol. (Default)

1 - Use tol.
tol (double) – Add entities as links only within this distance of the specified location. (Default 0.0)
line_spacing (double) – The spacing for spot or seam connectors on lines. (Default 1.0)
line_density (int) – The density for spot or seam connectors on lines. (Default 0.0)
line_offset_flag (int) –
0 - Do not offset connectors. (Default)

1 - Offset connectors.
line_offset (double) – Offset value from the ends of the line for spot or seam connectors on lines. (Default 0.0)
seam_area_group (int) –
Group flag for seam or area connector.

0 - No (default).

1 - Yes.
area_width (double) – Width of area connectors created from node or line lists. (Default 1.0)
area_offset (double) – Offset area connectors created from node or line lists from the selected location by this value. (Default 0.0)
area_mesh_type (int) –
The mesh type for area connectors when using surfs as the location.

0 - trias

1 - quads

2 - mixed

3 - right trias
area_mesh_size (double) – The mesh size for area connectors when using surfs as the location. (Default 10.0)
ce_nonnormal (int) –
0 - Normal projection

1 - Non-normal projection.
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
line_preserve_nodes (int) – Reserved for future development
loc_as_link (int) – Reserved for future development
ce_extralinknum (int) – Reserved for future development
ce_hexaoffsetcheck (int) – Reserved for future development
area_linecombine (double) – 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 (double) – 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_num_center (int) – Reserved for future development
ce_maxlinkupto (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
ce_boltcenter (hwTriple) – Reserved for future development
ce_config_name (hwString) – The name of the bolt config.
ce_engg_name (hwString) – Reserved for future development
ce_seam_vertex_angle (double) – Reserved for future development
line_preserve_joints (int) – Reserved for future development
ce_seam_discontinuity (int) – Reserved for future development
eline_flag (bool) – Reserved for future development
disable_multilinks (int) – Reserved for future development
grouplinks (bool) – Reserved for future development
main_link_count (int) – Reserved for future development
main_link_ids (hwIntList) – 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#

import hm
import hm.entities as ent

model = hm.Model()

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