Model.hm_wadlinessetoptions#

Model.hm_wadlinessetoptions(active_hood_method=False, blerl_height=600.000000, blerl_offset=82.500000, blerl_selen=1000.000000, brrl_offset=82.500000, corner_gauge_height=236.000000, corner_height_max=1003.000000, corner_height_min=75.000000, cycling_impact_angle=60.000000, cycling_zone_max=0.000000, cycling_zone_min=0.000000, groundz_cord=0.000000, headform_adult_impact_angle=65.000000, headform_child_impact_angle=50.000000, headform_forward_impact_angle=20.000000, horiz_proj_min_angle=60.000000, horiz_proj_min_dist=50.000000, impactor_mass=10.500000, impactor_mass_nominal=7.400000, init_velocity=11.110000, leg_offset=42.000000, protocol_method=0, protocol_version=8.400000, side_ref_wad_dist=1000.000000, side_reference_resolution=100.000000, srl_left_offset=82.500000, srl_right_offset=82.500000, upper_legform_max_energy=457.000000, upper_legform_min_energy=160.000000, upperlegbumper_lowerlimit=425.000000, upperlegbumper_upperlimit=500.000000, wad_method=1, zheight=75.000000)#

Sets various WAD lines module options. Accepts a series of name value pairs, and any number of pairs may be given. This API may be called any number of times, such as once per option, or just once with all the options. The API can be called at any time during the analysis, thus allowing options to change between calls. Changes do not retroactively update any previous calculated results. It is recommended that this API be called before any results are requested.

If an option is not given it will be assigned a default value. If the options protocol_method and protocol_version are set using this API, and not set in other APIs which accept them, those APIs will default to the values set by this API.

The following are the options which can be set using this API:

Parameters:

  • active_hood_method (bool) –

    Active hood method for creation of the BRRL offset.

    0 - Off (Default)

    1 - On

  • blerl_height (double) – The height from the ground to start the straight edge for creating the bonnet leading edge reference line. (Default=600.0)

  • blerl_offset (double) – The offset distance used to create the bonnet leading edge reference line. (Default=82.5)

  • blerl_selen (double) – The length of the straight edge used to create the bonnet leading edge reference line. (Default=1000.0)

  • brrl_offset (double) – The offset distance used to create the bonnet rear reference offset line. (Default=82.5)

  • corner_gauge_height (double) – The total height of the corner gauge (UN-R127). (Default=236.0)

  • corner_height_max (double) – The maximum value for the height of the center of the corner gauge (UN-R127). (Default=1003.0)

  • corner_height_min (double) – The minimum value for the height of the center of the corner gauge (UN-R127). (Default=75.0)

  • cycling_impact_angle (double) – The impact angle of cyclist headform impact points. (Default=60)

  • cycling_zone_max (double) – The WAD line where cycling impact zone ends. Used in regulation CNCAP 2021 and EuroNCAP 2022/2023. (Default=0)

  • cycling_zone_min (double) – The WAD line where cycling impact zone starts. Used in regulation CNCAP 2021 and EuroNCAP 2022/2023. (Default=0)

  • groundz_cord (double) – The height of the ground plane for which marking is done, stored as a structuralproperty. (Default=0.0)

  • headform_adult_impact_angle (double) – The impact angle used for adult headform points. (Default=65.0)

  • headform_child_impact_angle (double) – The impact angle used for child headform points. (Default=50.0)

  • headform_forward_impact_angle (double) – The impact angle used for horizontally projected headform points. (Default=20.0)

  • horiz_proj_min_angle (double) – The minimum angle used to determine if points should be horizontally projected (Euro NCAP 8.2). (Default=60.0)

  • horiz_proj_min_dist (double) – The minimum distance allowed between horizontally projected grid points and other grid points (Euro NCAP 8.2). (Default=50.0)

  • impactor_mass (double) – The mass of the impactor used to test upper legform impact point. (Default=10.5)

  • impactor_mass_nominal (double) – The nominal mass of the impactor used to test upper legform impact point. (Default=7.4)

  • init_velocity (double) – The initial velocity of the impactor. (Default=11.11)

  • leg_offset (double) – The offset distance from the corner bounds where legform points are not created. (Default for GTR 42.0)

  • protocol_method (int) –

    0 - Euro NCAP (Default)

    1 - Homologation

    2 - ECER

    3 - UN-R127 for corners, Euro NCAP elsewhere

    4 - CNCAP

  • protocol_version (double) – Used for Euro NCAP protocol, 8.4 (default if not specified), 7.0, 8.0 or 8.2.

  • side_ref_wad_dist (double) – The WAD distance used for extending reference lines forward (Euro NCAP 8.2). Default 1000.

  • side_reference_resolution (double) – The distance between adjacent side reference trace lines used to create the side reference line. Default 100.

  • srl_left_offset (double) – The offset distance used to create the left bonnet side reference offset line. Default 82.5.

  • srl_right_offset (double) – The offset distance used to create the right bonnet side reference offset line. Default 82.5.

  • upper_legform_max_energy (double) – The upper limit for energy of the upper leg impactor. Default 457.0.

  • upper_legform_min_energy (double) – The lower limit for energy of the upper leg impactor. Default 160.0.

  • upperlegbumper_lowerlimit (double) – The lower limit used to create lower legform points. Default 425.0.

  • upperlegbumper_upperlimit (double) – The upper limit used to create lower legform points. Default 500.0.

  • wad_method (int) –

    0 - Measures along the surface of the vehicle, not direct from bonnet to windshield

    1 - Measures along tangent (Default)

  • zheight (double) – The z height parameter for impact points created through the Model.hm_wadlinesgetgridpoints() function.

Returns:

Example#

Setup and extract WAD lines data#
import hm
import hm.entities as ent

model = hm.Model()

model.hm_wadlinesinit()

model.hm_wadlinessetoptions(protocol_version=8.0)

model.hm_wadlinessetparameters(
    side_angle=45.0,
    front_angle=50.0,
    spacing=100.0,
    rear_reference_radius=100.0,
    reference_resolution=50.0,
    upper_bumper_angle=20.0,
    lower_bumper_angle=25.0,
    corner_angle=60.0,
)

model.hm_wadlinessetaxes(
    origin=[0.0, 0.0, 0.0], forwardvec=[1.0, 0.0, 0.0], leftvec=[0.0, 1.0, 0.0]
)

comps1 = hm.Collection(
    model, ent.Component, "Name=bonnet OR Name=bumper OR Name=fenderL OR Name=fenderR"
)
comps2 = hm.Collection(model, ent.Component, "Name=windshield OR Name=a-pillars")

model.hm_wadlinessetentities_bycollection(frontEntities=comps1, rearEntities=comps2)

elems = hm.Collection(
    model, ent.Element, hm.Collection(model, ent.Component, name="wipers")
)

model.hm_wadlinessetwipers(
    wiperEntities=elems, use_for_reference_line=False, use_for_wad_line=True
)

model.hm_wadlinesgetreferenceline(line_location=0)
model.hm_wadlinesgetreferenceline(line_location=1)
model.hm_wadlinesgetreferenceline(line_location=2)
model.hm_wadlinesgetreferenceline(line_location=3)
model.hm_wadlinesgetreferenceline(line_location=4)
model.hm_wadlinesgetreferenceline(line_location=5)
model.hm_wadlinesgetreferenceline(line_location=6)
model.hm_wadlinesgetreferenceline(line_location=7)

model.hm_wadlinesgetwadline(distance=1000.0)
model.hm_wadlinesgetwadline(distance=1500.0)
model.hm_wadlinesgetwadline(distance=1700.0)
model.hm_wadlinesgetwadline(distance=2100.0)

model.hm_wadlinesgetgridpoints(
    wad_child_min=1000.0,
    wad_child_max=1500.0,
    wad_adult_min=1700.0,
    wad_adult_max=2100.0,
    side_tolerance=50.0,
)

model.hm_wadlinesend()