hm_wadlinessetoptions

Sets various WAD lines module options.

Syntax

hm_wadlinessetoptions option1 value1 ?option2 value2? ... ?optionN valueN?

Type

HyperMesh Tcl Query Command

Description

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:

Inputs

active_hood_method: Active hood method for creation of the BRRL offset.; 0 - Off (default); 1 - On
blerl_height: The height from the ground to start the straight edge for creating the bonnet leading edge reference line. Default 600.0.
blerl_offset: The offset distance used to create the bonnet leading edge reference line. Default 82.5.
blerl_selen: The length of the straight edge used to create the bonnet leading edge reference line. Default 1000.0.
brrl_offset: The offset distance used to create the bonnet rear reference offset line. Default 82.5.
corner_gauge_height: The total height of the corner gauge (UN-R127). Default 236.0.
corner_height_max: The maximum value for the height of the center of the corner gauge (UN-R127). Default 1003.0.
corner_height_min: The minimum value for the height of the center of the corner gauge (UN-R127). Default 75.0.
cycling_impact_angle: The impact angle of cyclist headform impact points. Default 60.
cycling_zone_max: The WAD line where cycling impact zone ends. Used in regulation CNCAP 2021 and EuroNCAP 2022/2023. Default 0.
cycling_zone_min: The WAD line where cycling impact zone starts. Used in regulation CNCAP 2021 and EuroNCAP 2022/2023. Default 0.
groundz_cord: The height of the ground plane for which marking is done, stored as a structuralproperty. Default 0.0.
headform_adult_impact_angle: The impact angle used for adult headform points. Default 65.0.
headform_child_impact_angle: The impact angle used for child headform points. Default 50.0.
headform_forward_impact_angle: The impact angle used for horizontally projected headform points. Default 20.0.
horiz_proj_min_angle: The minimum angle used to determine if points should be horizontally projected (Euro NCAP 8.2). Default 60.0.
horiz_proj_min_dist: The minimum distance allowed between horizontally projected grid points and other grid points (Euro NCAP 8.2). Default 50.0.
impactor_mass: The mass of the impactor used to test upper legform impact point. Default 10.5.
impactor_mass_nominal: The nominal mass of the impactor used to test upper legform impact point. Default 7.4.
init_velocity: The initial velocity of the impactor. Default 11.11.
leg_offset: The offset distance from the corner bounds where legform points are not created. Default for GTR 42.0.
protocol_method: 0 - Euro NCAP (default); 1 - Homologation; 2 - ECER; 3 - UN-R127 for corners, Euro NCAP elsewhere; 4 - CNCAP
protocol_version: Used for Euro NCAP protocol, 8.4 (default if not specified), 7.0, 8.0 or 8.2.
side_ref_wad_dist: The WAD distance used for extending reference lines forward (Euro NCAP 8.2). Default 1000.
side_reference_resolution: The distance between adjacent side reference trace lines used to create the side reference line. Default 100.
srl_left_offset: The offset distance used to create the left bonnet side reference offset line. Default 82.5.
srl_right_offset: The offset distance used to create the right bonnet side reference offset line. Default 82.5.
upper_legform_max_energy: The upper limit for energy of the upper leg impactor. Default 457.0.
upper_legform_min_energy: The lower limit for energy of the upper leg impactor. Default 160.0.
upperlegbumper_lowerlimit: The lower limit used to create lower legform points. Default 425.0.
upperlegbumper_upperlimit: The upper limit used to create lower legform points. Default 500.0.
wad_method: 0 - Measures along the surface of the vehicle, not direct from bonnet to windshield; 1 - Measures along tangent (default)
zheight: The z height parameter for impact points created through the hm_wadlinesgetgridpoints command.

Example

To setup and extract WAD lines data, specifying Euro NCAP version 8.0:

hm_wadlinesinit
hm_wadlinessetoptions prototol_version 8.0
hm_wadlinessetparameters 45.0 50.0 100.0 100.0 50.0 20.0 25.0 60.0
hm_wadlinessetaxes 0.0 0.0 0.0 1.0 0.0 0.0 0.0 1.0 0.0
*createmark comps 1 "bonnet" "bumper" "fenderL" "fenderR"
*createmark comps 2 "windshield" "a-pillars"
hm_wadlinessetentities comps 1 comps 2
*createmark elems 1 "by collector" wipers
hm_wadlinessetwipers elems 1 0 1
hm_wadlinesgetreferenceline 0
hm_wadlinesgetreferenceline 1
hm_wadlinesgetreferenceline 2
hm_wadlinesgetreferenceline 3
hm_wadlinesgetreferenceline 4
hm_wadlinesgetreferenceline 5
hm_wadlinesgetreferenceline 6
hm_wadlinesgetreferenceline 7
hm_wadlinesgetwadline 1000.0
hm_wadlinesgetwadline 1500.0
hm_wadlinesgetwadline 1700.0
hm_wadlinesgetwadline 2100.0
hm_wadlinesgetgridpoints 1000.0 1500.0 1700.0 2100.0 50.0
hm_wadlinesend

Errors

Incorrect usage results in a Tcl error. To detect errors, you can use the catch command:

if { [ catch {command_name...} ] } {
   # Handle error
}

Version History

14.0.130

2020 - Added new options blerl_height, blerl_offset, blerl_selen, brrl_offset, groundz_cord, headform_adult_impact_angle, headform_child_impact_angle, headform_forward_impact_angle, impactor_mass, impactor_mass_nominal, init_velocity, leg_offset, srl_left_offset, srl_right_offset, upper_legform_max_energy, upper_legform_min_energy, upperlegbumper_lowerlimit and upperlegbumper_upperlimit. Added new protocol_method value 4.

2021 - Added new options cycling_impact_angle, cycling_zone_max, cycling_zone_min and zheight.

2021.1 - Added new options active_hood_method and side_reference_resolution.