Model.hm_collisiongetcomponentlinesegment

Model.hm_collisiongetcomponentlinesegment(component_index, linesegment_index, include_ignored=False)

Returns the line segment coordinates for a component collision pair. Once the call to the relevant hm_collision* functions to generate the collision data is made, this function can follow. In addition, the pair_results argument to Model.hm_collisioncheck() must be set to True.

For each intersecting type of collision, there is a list of pairs of intersecting components. For each intersecting component pair, there is a list of intersection line segments.

To execute this function, the below sequence of data collection is required:

1. Get the number of colliding component pairs

2. Get the component IDs for each component pair

3. Get the number of intersected entities for each component pair

Parameters:

• component_index (int) – The index of the component pair to query, starting from 0. The total number of component pairs for a specific collision_type can be found using Model.hm_collisiongetcomponentpaircount().

• linesegment_index (int) – The index of the line segment to query, starting from 0. The total number of entity pairs for a specific component_index can be found using Model.hm_collisiongetcomponentlinesegmentcount().

• include_ignored (bool) –

  Specifies if results ignored when the allowable_depth value which is specified via Model.hm_collisioninit() should be reported or not:

  False - Do not include ignored results (default).

  True - Include ignored results.

Returns:

• hwReturnStatus - Status object

• HmQueryResult - Result object containing the output values:

  • lineSegment1 (numpy.ndarray) - x,y,z-coordinates of line segment’s start.

  • lineSegment2 (numpy.ndarray) - x,y,z-coordinates of line segment’s end.

Example

Create nodes at the center of intersection line segments for intersect components with ID 1 and 2

import hm
import hm.entities as ent

model = hm.Model()

model.hm_collisioninit(tolerance=10**(-5))

comp_collection_1 = hm.Collection(model,ent.Element,hm.Collection(model,ent.Component,[1]))

comp_collection_2 = hm.Collection(model,ent.Element,hm.Collection(model,ent.Component,[2]))

model.hm_collisionentitycreate(
    collection=comp_collection_1,
    dimension=0,
    thickness_type=0,
    thickness=0,
    edge_penetration=0,
    midside_nodes=0,
    split_quads=0,
    used_topology=0,
    grouping_identifier=False,
    offset=0
)
model.hm_collisionentitycreate(
    collection=comp_collection_2,
    dimension=0,
    thickness_type=0,
    thickness=0,
    edge_penetration=0,
    midside_nodes=0,
    split_quads=0,
    used_topology=0,
    grouping_identifier=False,
    offset=0
)

int_elems = hm.Collection(model,ent.Element,populate=False)

model.hm_collisioncheck(intersected_elements=int_elems,store_segments=True,pair_results=True)

_, result = model.hm_collisiongetcomponentpaircount(collisionType=0)

component_pair_count = result.numberOfCollisionPairs

if component_pair_count > 0:

    for i in range(0,component_pair_count):

        _, result = model.hm_collisiongetcomponentlinesegmentcount(comp_index=i)
        linesegmentcount = result.numberOfLineSegments

        if linesegmentcount!=0:

            for j in range(0,linesegmentcount):

                _, result = model.hm_collisiongetcomponentlinesegment(component_index=i,linesegment_index=j)
                linesegments_start = result.lineSegment1
                linesegments_end = result.lineSegment2

                curr_x = (linesegments_start[0] + linesegments_end[0])/2
                curr_y = (linesegments_start[1] + linesegments_end[1])/2
                curr_z = (linesegments_start[2] + linesegments_end[2])/2

                # Creating node with global coordinates calulated from above
                ent.Node(model,globalx=curr_x, globaly=curr_y, globalz=curr_z)

model.hm_collisionend()