Model.nodecreateonlines#

Model.nodecreateonlines(collection, number, bias_style, bias_intensity)#

Creates nodes or points at locations of intersection between two sets of input geometries. Only intersections between entities from different sets are calculated and are used to create nodes or points.

If there is overlap (continuous intersection) between the entities, the result is undefined. For example, finding the intersection of a surface edge to a parent surface is undefined and can return unexpected or varied results.

Parameters:

  • collection (Collection) – The collection containing the input line entities.

  • number (int) – The number of nodes to create.

  • bias_style (int) –

    0 - Linear

    1 - Exponential

    2 - Bell curve

  • bias_intensity (double) – The bias intensity value. A positive value indicates biasing along the line direction, while a negative value indicates biasing along the opposite direction. The bias_intensity=0 indicates no biasing.

Example#

Create 5 nodes on lines with IDs 10 , 11 , 12 , and 13 with linear biasing of 2.0#
import hm
import hm.entities as ent

model = hm.Model()

model.nodecreateonlines(
    collection=hm.Collection(model, ent.Line, [10, 11, 12]),
    number=5,
    bias_style=0,
    bias_intensity=2.0,
)