Running the Templates in Batch Mode
Running the templates in batch mode
As well as running the templates interactively they can also be run in batch mode, in which case the user is not prompted with questions, but must supply the information through a command line argument.
To run a template in batch, type in the following at a command prompt:
reporter 22.exe -batch -file= template_name -varTEMPLATE_ARGS= args_filename
[Add the -pdf, -html, -pptx command line arguments to write the report out in the format you want].
Where:
| template_name |
The full path and filename of the template you want to use, e.g. C:\oasys 22\reporter_library\templates\EuroNCAP_Front_ODB_Impact_2017.ortx Note that you should enclose it in "s if the path contains any spaces. |
| args_filename |
The full path and filename of the arguments file, e.g. C:\my_directory\arguments_file.txt Note that you should enclose it in "s if the path contains any spaces. |
The args_filename is a CSV file containing the arguments to pass to the template in comma separated 'arg_name','arg_value' pairs. For the EuroNCAP Front ODB Impact template the file can contain the following:
KEYWORD_FILE,<keyword_filename> CSV_FILE,<csv_filename> [OPTIONAL] RESULTS_DIR,<results_directory> [OPTIONAL] IMAGES_DIR,<images_directory> [OPTIONAL]
As with the interactive case where the template behaves differently depending on the users response to the questions, the interactive case will work differently depending on what arguments are supplied, e.g.:
| KEYWORD_FILE specified | Post *END data in keyword file | CSV_FILE specified | Outcome |
| No | - | - | Template will not run |
| Yes | No | No | Template will not run |
| Yes | Yes | No | Template will run using the post *END data |
| Yes | Yes | Yes | Template will run using the CSV file data |
| Yes | No | Yes | Template will run using the CSV file data |
If RESULTS_DIR or IMAGES_DIR are not specified then they are set to the keyword file directory.
A description for each argument is given in the table below:
| Argument | Description |
| CSV_FILE | Filename of the CSV file containing the extra data (entity IDs, etc). For single analysis templates, if CSV_FILE is not specified then the data needs to be specified in the keyword file as post-*END data. |
| JSON_FILE | Used instead of CSV_FILE by ICFD Assessment template. Note that ICFD Assessment template does not support post-*END data. |
| IMAGES_DIR | Model keyword filename. |
| RESULTS_DIR | Directory to look for results. If this is not specified the template will look for results in the same directory as the keyword file. |
| SIDE_EXCURSION_FILE | Used by the Euro NCAP Far Side Impact 2022 template to provide the CSV file containing the side excursion information containing (generated by Euro NCAP Side MDB or Side Pole 2020 templates). |
| ADULT_LST_FILE | Adult .lst filename. For head impact templates, at least one of ADULT_LST_FILE, CHILD_LST_FILE_FILE or CYCLIST_LST_FILE needs to be specified. |
| CHILD_LST_FILE | Child .lst filename. For head impact templates, at least one of ADULT_LST_FILE, CHILD_LST_FILE_FILE or CYCLIST_LST_FILE needs to be specified. |
| CYCLIST_LST_FILE | Cyclist .lst filename. For head impact templates, at least one of ADULT_LST_FILE, CHILD_LST_FILE_FILE or CYCLIST_LST_FILE needs to be specified. |
| LOWER_LEG_LST_FILE | Lower leg .lst filename. For leg impact templates, at least one of LOWER_LEG_LST_FILE or UPPER_LEG_LST_FILE needs to be specified. |
| UPPER_LEG_LST_FILE | Upper leg .lst filename. For leg impact templates, at least one of LOWER_LEG_LST_FILE or UPPER_LEG_LST_FILE needs to be specified. |
The list of arguments required for each template is given in the table below. Note that for the single analysis templates, CSV_FILE is required unless the input data is stored in your keyword file as post-*END data.
| Template | Required arguments | Optional arguments |
| C-NCAP Front ODB Impact 2018 | KEYWORD_FILE | CSV_FILE, IMAGES_DIR, RESULTS_DIR |
| C-NCAP Head Impact 2021 | (At least one of ADULT_LST_FILE, CHILD_LST_FILE or CYCLIST_LST_FILE) | ADULT_LST_FILE, CHILD_LST_FILE, CYCLIST_LST_FILE, IMAGES_DIR |
| C-NCAP Leg Impact 2021 | (At least one of LOWER_LEG_LST_FILE or UPPER_LEG_LST_FILE) | LOWER_LEG_LST_FILE, UPPER_LEG_LST_FILE, IMAGES_DIR |
| C-NCAP MPDB 2022-23 Compatiblity Assessment | DEFAULT_DIR, DEFAULT_JOB, CSV_FILE | IMAGES_DIR |
| C-NCAP MPDB 2022 Occupant Assessment | KEYWORD_FILE | CSV_FILE, IMAGES_DIR, RESULTS_DIR |
| Euro NCAP Far Side Impact 2022 | KEYWORD_FILE, SIDE_EXCURSION_FILE | CSV_FILE, IMAGES_DIR, RESULTS_DIR |
| Euro NCAP Front FFB Impact 2017 | KEYWORD_FILE | CSV_FILE, IMAGES_DIR, RESULTS_DIR |
| Euro NCAP Front ODB Impact 2017 | KEYWORD_FILE | CSV_FILE, IMAGES_DIR, RESULTS_DIR |
| Euro NCAP Head Impact 2023 | (At least one of ADULT_LST_FILE and CHILD_LST_FILE) | ADULT_LST_FILE, CHILD_LST_FILE, CYCLIST_LST_FILE, IMAGES_DIR |
| Euro NCAP Leg Impact 2023 | (At least one of LOWER_LEG_LST_FILE or UPPER_LEG_LST_FILE) | LOWER_LEG_LST_FILE, UPPER_LEG_LST_FILE, IMAGES_DIR |
| Euro NCAP MPDB 2020-23 Compatiblity Assessment | DEFAULT_DIR, DEFAULT_JOB, CSV_FILE | IMAGES_DIR |
| Euro NCAP MPDB 2020 Occupant Assessment | KEYWORD_FILE | CSV_FILE, IMAGES_DIR, RESULTS_DIR |
| Euro NCAP Side MDB Impact 2020 | KEYWORD_FILE | CSV_FILE, IMAGES_DIR, RESULTS_DIR |
| Euro NCAP Side Pole Impact 2020 | KEYWORD_FILE | CSV_FILE, IMAGES_DIR, RESULTS_DIR |
| General LS-DYNA Vehicle Model | KEYWORD_FILE | CSV_FILE, IMAGES_DIR, RESULTS_DIR |
| GTR Head Impact 2020 | (At least one of ADULT_LST_FILE and CHILD_LST_FILE) | ADULT_LST_FILE, CHILD_LST_FILE, IMAGES_DIR |
| GTR Leg Impact 2019 | (At least one of LOWER_LEG_LST_FILE or UPPER_LEG_LST_FILE) | LOWER_LEG_LST_FILE, UPPER_LEG_LST_FILE, IMAGES_DIR |
| IIHS Front ODB Impact 2021 | KEYWORD_FILE | CSV_FILE, IMAGES_DIR, RESULTS_DIR |
| IIHS Front ODB Impact 2021 – Structure Only | KEYWORD_FILE | CSV_FILE, IMAGES_DIR, RESULTS_DIR |
| IIHS Front SOB Impact 2021 | KEYWORD_FILE | CSV_FILE, IMAGES_DIR, RESULTS_DIR |
| IIHS Front SOB Impact 2021 – Structure Only | KEYWORD_FILE | CSV_FILE, IMAGES_DIR, RESULTS_DIR |
| IIHS Side MDB Impact 2021 | KEYWORD_FILE | CSV_FILE, IMAGES_DIR, RESULTS_DIR |
| IIHS Side MDB Impact 2021 – Structure Only | KEYWORD_FILE | CSV_FILE, IMAGES_DIR, RESULTS_DIR |
| JNCAP Leg Head Impact 2018 | (At least one of LOWER_LEG_LST_FILE or UPPER_LEG_LST_FILE) | LOWER_LEG_LST_FILE, UPPER_LEG_LST_FILE, IMAGES_DIR |
| KNCAP Leg Head Impact 2019 | (At least one of LOWER_LEG_LST_FILE or UPPER_LEG_LST_FILE) | LOWER_LEG_LST_FILE, UPPER_LEG_LST_FILE, IMAGES_DIR |
| USNCAP Front FFB Impact 2015 | KEYWORD_FILE | CSV_FILE, IMAGES_DIR, RESULTS_DIR |
| USNCAP Side MDB Impact 2015 | KEYWORD_FILE | CSV_FILE, IMAGES_DIR, RESULTS_DIR |
| USNCAP Side Pole Impact 2015 | KEYWORD_FILE | CSV_FILE, IMAGES_DIR, RESULTS_DIR |