PRIMER 22.1
Command Line
Command Line
The pedestrian markup tool can also be run from the command line:
primer.exe -js= pedestrian_impact_marking_program.js -js_arg= arguments_file vehicle.key
Where:
| primer.exe | Is the full pathname of the PRIMER executable to run. |
| pedestrian_impact_marking_program.js | Is the full pathname of the pedestrian markup script. This can be found in the primer_library/scripts directory where the PRIMER executable has been installed. |
| arguments_file | Is the full pathname to a file containing arguments for the script. The format is described below. |
| vehicle.key | Is the full pathname to the vehicle model to markup. |
The arguments_file is a comma separated file of variable name , variable value pairs that pass the information required for the script to markup the vehicle and build models.
Below is a list of all the variables that can be passed to the script. Some of them have to be set for the script to do anything, but most of them do not in which case default values are used.
| Name | Description |
| adult_head_angle | Orientation angle for adult head impacts |
| adult_head_csv_filename | CSV filename for ADULT Head impacts |
| adult_head_impactor | Filename of ADULT Head impactor to use in the model build. This will overwrite the impactor defined in the template file. |
| adult_head_template_filename | Template filename for ADULT Head impacts |
| ble_angle | Bonnet Leading Edge stick angle |
| ble_beam_length | Bonnet Leading Edge beam length |
| ble_offset_distance | Bonnet Leading Edge offset distance |
| ble_offset_line | Switch for Bonnet Leading Edge offset line (set to true or false) |
| ble_line | Switch for Bonnet Leading Edge line (set to true or false) |
| bonnet_parts | List of bonnet parts separated by commas, e.g. bonnet_parts,100,200,300 |
| bonnet_surfaces | List of bonnet surface for CAD input separated by commas, e.g. bonnet_surfaces,100,200,300 |
| bumper_beam_length | Bumper lines beam length |
| bumper_beam_parts | List of bumper beam parts separated by commas, e.g. bumper_beam_parts,100,200,300 |
| bumper_beam_surfaces | List of bumper beam surfaces for CAD input separated by commas, e.g. bumper_beam_surfaces,100,200,300 |
| bumper_corner_point | Switch for Bumper Corner Point (set to true or false) |
| bumper_head_angle | Orientation angle for child head impacts on/in front of the bonnet leading edge |
| bumper_lines | Switch for Bumper lines (set to true or false) |
| bumper_lower_line | Switch for Bumper Lower Line (set to true or false) |
| bumper_upper_line | Switch for Bumper Upper Line (set to true or false) |
| bumper_parts | List of bumper parts separated by commas, e.g. bumper_parts,100,200,300 |
| bumper_surfaces | List of bumper surfaces for CAD input separated by commas, e.g. bumper_surfaces,100,200,300 |
| child_head_angle | Orientation angle for child head impacts |
| child_head_csv_filename | CSV filename for CHILD Head impacts |
| child_head_impactor | Filename of CHILD Head impactor to use in the model build. This will overwrite the impactor defined in the template file. |
| child_head_template_filename | Template filename for CHILD Head impacts |
| corner_bumper_angle | Bumper Corner stick angle |
| cowl_adult_head_angle | Orientation angle for COWL ADULT Head impacts |
| cowl_adult_head_csv_filename | CSV filename for COWL ADULT Head impacts |
| cowl_child_head_angle | Orientation angle for COWL CHILD Head impacts |
| cowl_child_head_csv_filename | CSV filename for COWL CHILD Head impacts |
| cyclist_head_angle | Orientation angle for cyclist head impacts |
| cyclist_head_csv_filename | CSV filename for CYCLIST Head impacts |
| cyclist_head_impactor | Filename of CYCLIST Head impactor to use in the model build. This will overwrite the impactor defined in the template file. |
| cyclist_head_template_filename | Template filename for CYCLIST Head impacts |
| default_green_parts | List of default green parts separated by commas, e.g. default_green_parts,100,200,300 |
| distance_between_points | Distance between points |
| exit | Exit from the script if set to true |
| error_filename | Filename for writing any errors |
| gm_transform_filename | Transform filename if using the "gm" head label style |
| gm_transform_title | Transform title if using the "gm" head label style |
| ground_z | Ground z coordinate |
| head_label_style | style for head impacts (standard, coordinate, gm, or linelabels) |
| impact_auto_method | Automatic method for calculating impact points (N_Points, NxM_Points, Define_Distance or Nothing) |
| impact_m_points | Number of 'm' points for automatic method NxM_Points |
| impact_m_spacing | Spacing between 'm' points for automatic method NxM_Points |
| impact_n_points | Number of 'n' points for automatic methods N_Points and NxM_Points |
| impact_n_spacing | Spacing between 'n' points for automatic methods N_Points and NxM_Points |
| impact_type | Impact type (Head, Upper_Leg_Bonnet, Upper_Leg_Bumper or Lower_Leg) |
| lower_bumper_angle | Lower Bumper stick angle |
| lower_leg_impactor | Filename of Lower Leg impactor to use in the model build. This will overwrite the impactor defined in the template file. |
| lower_leg_z | Lower Leg Z coordinate |
| lower_leg_csv_filename | CSV filename for Lower Leg impacts |
| lower_leg_template_filename | Template filename for Lower Leg impacts |
| master_model | Filename of Vehicle model to use in the model build. This will overwrite the model defined in the template file. |
| outer_parts | List of outer vehicle parts separated by commas, e.g. outer_parts,100,200,300 |
| outer_surfaces | List of outer vehicle surfaces for CAD input separated by commas, e.g. outer_surfaces,100,200,300 |
| obscuration_parts | List of windscreen obscuration parts separated by commas, e.g. obscuration_parts,100,200,300 |
| obscuration_surfaces | List of windscreen obscuration surfaces separated by commas, e.g. obscuration_surfaces,100,200,300 |
| protocol | Protocol type (EuroNCAP_8_2, EuroNCAP_9_0, CNCAP_2018, CNCAP_2021, GTR_2022 or GTR (for GTR pre 2022), GB_24550_202X) |
| roof_head_angle | Orientation angle for adult/cyclist head impacts on the roof (behind the windscreen rear reference line) |
| rootdir | Directory where models should be built. This will overwrite the directory defined in the template file |
| rrl_beam_length | Rear Reference Line beam length |
| rrl_offset_distance | Rear Reference Line offset distance |
| rrl_offset_line | Switch for Rear Reference offset line (set to true or false) |
| rrl_line | Switch for Rear Reference Line (set to true or false) |
| srl_angle | Side Reference Line stick angle |
| srl_beam_length | Side Reference Line beam length |
| srl_offset_distance | Side Reference Line offset distance |
| srl_offset_line | Switch for Side Reference offset line (set to true or false) |
| srl_line | Switch for Side Reference Line (set to true or false) |
| upper_bumper_angle | Upper Bumper stick angle |
| upper_leg_angle | Angle for Upper Leg impacts (used if upper_leg_calculation is set to manual) |
| upper_leg_calculation | Angle, Velocity and Mass calculation method for Upper Leg impacts (auto or manual) |
| upper_leg_impactor_filename | Filename of Upper Leg impactor to use for auto calculation of angle, velocity and mass. |
| upper_leg_mass_value | Mass value for Upper Leg impacts (used if upper_leg_calculation is set to manual) |
| upper_leg_mass_parameter | Mass parameter for Upper Leg impacts (used if upper_leg_calculation is set to manual) |
| upper_leg_csv_filename | CSV filename for Upper Leg impacts |
| upper_leg_impactor | Filename of Upper Leg impactor to use in the model build. This will overwrite the impactor defined in the template file. |
| upper_leg_template_filename | Template filename for Upper Leg impacts |
| upper_leg_units | Unit system for Upper Leg auto method calculation (S2 or S3) |
| upper_leg_velocity | Velocity value for Upper Leg impacts (used if upper_leg_calculation is set to manual) |
| wad_lines | Switch for WAD Lines (set to true or false) |
| wad1 | 1st WAD value |
| wad2 | 2nd WAD value |
| wad3 | 3rd WAD value |
| wad4 | 4th WAD value |
| wad5 | 5th WAD value |
| wad6 | 6th WAD value |
| wad7 | 7th WAD value |
| windscreen_parts | List of windscreen parts separated by commas, e.g. windscreen_parts,100,200,300 |
| windscreen_surfaces | List of windscreen surfaces for CAD separated by commas, e.g. windscreen_surfaces,100,200,300 |
| windscreen_adult_head_angle | Orientation angle for WINDSCREEN ADULT Head impacts |
| windscreen_adult_head_csv_filename | CSV filename for WINDSCREEN ADULT Head impacts |
| windscreen_child_head_angle | Orientation angle for WINDSCREEN CHILD Head impacts |
| windscreen_child_head_csv_filename | CSV filename for WINDSCREEN CHILD Head impacts |
| windscreen_zone | Switch for Windscreen Zone (set to true or false) |
| write_boundary_lines | Write boundary lines to file |
| write_boundary_zone | Write boundary zone (All, Head, Upper_Leg_Bonnet, Upper_Leg_Bumper or Lower_Leg) |
| write_boundary_type | Write boundary type (All, Lines or Test_Fields) |
| write_boundary_file_type | Write boundary file type (Keyword, IGES or CSV) |
| write_boundary_directory | Write boundary directory |
| wrrl_angle | Windscreen rear reference line stick angle when calculating the wrrl using the stick method |
| wrrl_stick_method | Use the stick method to calculate the windscreen rear reference line |
| wz_beam_length | Windscreen zone beam length |
| wz_front_offset | Windscreen zone front line offset distance |
| wz_obsc_offset | Windscreen zone pseudo obscuration width |
| wz_rear_offset | Windscreen zone rear line offset distance |
| wz_side_offset | Windscreen zone side line offset distance |
| wz_use_windscreen | Windscreen zone 'No obscuration part' option (set to true or false) |
To markup the vehicle the folllowing need to be defined:
- protocol
- outer_parts
- bumper_beam_parts - not required for GTR / UN R127
- bonnet_parts
- windscreen_parts
e.g.
protocol,EuroNCAP_8_2
outer_parts,100,200,300,400,500,600
bonnet_parts,100
windscreen_parts,200
bumper_beam_parts,300
If you want to write out CSV files of the impact points you also need to specify at least one of the following (depending on the impact type selected):
- adult_head_csv_filename
- child_head_csv_filename
- cyclist_head_csv_filename
- lower_leg_csv_filename
- upper_leg_csv_filename
e.g.
impact_type,Lower_Leg
lower_leg_csv_filename,C:\lower_leg.csv
To build models you also need to specify at least one of the following (depending on the impact type selected):
- adult_head_template_filename
- child_head_template_filename
- cyclist_head_template_filename
- lower_leg_template_filename
- upper_leg_template_filename
e.g.
impact_type,Lower_Leg
lower_leg_template_filename,C:\lower_leg_template.csv