REPORTER
REPORTER
Left click on this option to access REPORTER. This program is an automatic report generator for use with Ansys LS-DYNA, D3PLOT and T/HIS.
REPORTER Options
Press "Batch" button below the REPORTER button to show the menu below. Selecting this option tab will cause the following window to appear.
In addition to being accessed from the REPORTER Options menu this panel can also be selected from the Ansys LS-DYNA Submit menu.
Input List
This option can be used to select a predefined LIST file containing multiple sets of inputs for REPORTER. The list file can be read by clicking on Read button. This option can not be modified if this panel was accessed from the Ansys LS-DYNA Submit menu.
Note: An attempt is made to determine a sensible name for the summary output directory based on the inputs in this file. If a summary input file is given, then the pathname to this is used. If not, then if all the individual input files have the same pathname, then this is used.
Input Directory
This option can be accessed by clicking on 'Input List' popup and can be used to read keyword files from the sub-directories of the selected directory. Users can click on Read button to read keyword files. This populates 'Input file' and 'Root Output File Path' in the REPORTER Options panel.
Table
Users can manipulate entries in the table section using 'Insert above', 'Insert below', 'Delete'.
Insert above: inserts empty row above the selected row.
Insert below: inserts empty row below the selected row.
Delete: deletes the selected row.
Rows can be brought into selection by clicking on the row header buttons (buttons with row indices). Initially all the rows are under selection.
If REPORTER Options panel has multiple entries in the table section (more than 10), then users can use 'Page Up' and 'Page Down' buttons to quickly navigate the table section. In case of large number of jobs, users can drag the bottom edge of the REPORTER Options panel to increase the number of visible entries in the table section.
Input Options
Each Ansys LS-DYNA job can have the following options set.
|
Input File |
Name of the Ansys LS-DYNA input file for post processing. This option cannot be modified if this panel was accessed from the Ansys LS-DYNA Submit menu. |
| Template | Defines a REPORTER template file for the job |
| Root Output File Path | By default, the output directory for any files generated by REPORTER will be set to the directory containing the input file and the root of the input filename will be used as the default filename for any output files generated by REPORTER, i.e. rootname.pdf, rootname.html etc. The root output file path includes output directory and root output filename. For example, in C:\Demo\C1\example_head_C1, C:\Demo\C1 is the output directory and example_head_C1 is the root output filename. |
| Variables | This option can be used to setup variables for use within REPORTER , see Variables |
| Pre-Commands | Specify additional commands which are inserted before calling the REPORTER executable (Linux only) |
| Post-Commands | Specify addtional commands post REPORTER executable commands (Linux only) |
| DISPLAY | Specify the DISPLAY environment variable (Linux only) |
In addition to setting up options for individual Ansys LS-DYNA jobs this panel can also be used to generate a summary report. The options for the summary report are the same as for individual Ansys LS-DYNA jobs except that the Input file is optional.
If this panel was accessed from the REPORTER Options
Output Formats
| REPORTER | Write a REPORTER report (orrx/orr) file after REPORTER has finished generating a report |
| HTML | Write an HTML file after REPORTER has finished generating a report |
| Write a PDF file after REPORTER has finished generating a report | |
| PowerPoint | Causes REPORTER to write a Powerpoint file once it has finished generating a report |
Combined Output Options
The normal Output formats allow REPORTER to write a PDF, HTML, or PowerPoint file for each analysis. However if you are doing lots of analyses it might be useful to combine all of the output together into a single PDF file or single PowerPoint file. The section allows you to do this.
To do this REPORTER saves each analysis as a REPORTER report (orrx/orr) file after generating each file. Then it does an extra step, reading all of the report files and combining the outout. In the above example a combined PDF file is going to be created.
If the report files already exist and so the reports do not need to be generated you can use and the shell will only do the combining step.
Run REPORTER
This option starts REPORTER once for each Ansys LS-DYNA job that has been defined and passes any input options that have been defined for that job to REPORTER. If a set of summary report options have been defined then an additional instance of REPORTER will be started to generate the summary report.
This option is not available if this panel was accessed from the Ansys LS-DYNA Submit menu as REPORTER will be started automatically after each Ansys LS-DYNA job has finished.
Clear Panel
This option can be used to quickly clear any options that have been set. This option is not available if this panel was accessed from the Ansys LS-DYNA Submit menu.
Write
This option can be used to save the currently defined set of REPORTER options to a new LIST file. By default this option will overwrite the Input List.
Variables
This window allows the user to define variables for individual REPORTER job. Click on '+' button to add new variables and click on 'x' button to remove existing variables. Variables can be declared temporary by clicking on tick box adjacent to the variable under Temp column. Users can dismiss this panel by clicking on Close button.
LIST File Format
The LIST file can be used to set up multiple inputs for REPORTER. The LIST file format consists of lines containing either Job information or Keywords.
| Keyword | |
| $VARIABLES |
Defines a new list of comma seperated Variable names for any following Job Lines. Any Variables defined before this Keyword are deleted. $VARIABLES, 1st Variable, 2nd Variable, 3rd Variable |
| $VARIABLES_ADD |
Adds new Variables to the existing list of Variables $VARIABLES_ADD, 1st Variable, 2nd Variable, 3rd Variable |
| $REPORTER_SUMMARY |
Defines a set of inputs used to generate a summary report after a set of jobs have been run in Ansys LS-DYNA. $REPORTER_SUMMARY, Input file, REPORTER Template, 1st Variable, 2nd Variable, 3rd Variable |
| $REPORTER_SUMMARY_DIR |
Defines the directory used for summary output files $REPORTER_SUMMARY_DIR, Directory |
| $REPORTER_OUTPUT |
Defines a list of output formats, possible options are REPORTER, HTML, PDF, POSTSCRIPT, POWERPOINT $REPORTER_OUTPUT, format, format, format... |
| $REPORTER_ICONISE |
Turns on/off the switch to iconise REPORTER when running $REPORTER_ICONISE,true or false |
| $REPORTER_OA_BATCH |
Turns on/off the switch to run D3PLOT and T/HIS in batch $REPORTER_OA_BATCH,true or false |
| $REPORTER_STOP_ON_ERROR |
Turns on/off the switch to stop REPORTER if an error occurs. $REPORTER_ON_ERROR,true or false |
| $RUN_REPORTER_IN_BATCH | Opposite to REPORTER_STOP_ON_ERROR. When $RUN_REPORTER_IN_BATCH is true, it skips errors. $RUN_REPORTER_IN_BATCH,true or false |
| $REPORTER_EXIT |
Turns on/off the switch to exit REPORTER after running $REPORTER_EXIT,true or false |
| $ | Comment Line |
|
All other lines are assumed to contain Job information in the following format. Input file, REPORTER Template, 1st Variable, 2nd Variable, 3rd Variable |
e.g.
$ Define 4 variables for the following jobs
$
$VARIABLES,ID,X-COOD,Y-COORD,Z-COORD
$
$ Setup 4 jobs using the "head_impact.ort" template, with 4 variable values
$
C:\head_impact
1\head.key,c:\templates\head_impact.ort, RUN 1, 0.03, 0.050, 0.06
C:\head_impact
2\head.key,c:\templates\head_impact.ort, RUN 2, 0.03, 0.075, 0.06
C:\head_impact
3\head.key,c:\templates\head_impact.ort, RUN 3, 0.03, 0.100, 0.06
C:\head_impact
4\head.key,c:\templates\head_impact.ort, RUN 4, 0.03, 0.125, 0.06
$
$ Define a new set of variables
$
$VARIABLES,SUMMARY_ID
$
$ Add another variable
$
$VARIABLES_ADD,
$
$ Set up a summary report
$
$REPORTER_SUMMARY, , c:\templates\head_summary.ort
$REPORTER_SUMMARY_DIR,c:\head_impact\summary
$
$ Specify output file formats
$
$REPORTER_OUTPUT,REPORTER,HTML,PDF