Transcript Presenter 9.2 - Oasys Software

REPORTER 9.2
Contents
•
•
•
•
•
•
•
•
•
•
•
•
Introduction to Reporter
User interface – menu layout
Creating a template – first steps
Text
Editing objects
Variables
D3PLOT images
T/HIS graphs
Lines, arrows, etc
Library programs
Ordering objects
Managing pages
•
•
•
•
•
•
•
Lining up objects neatly
Error log
Comparing two or more models
Saving and exporting reports
Batch mode operation
User-written scripts
Summary reports for multiple
analyses
LS-DYNA is a registered trademark of Livermore
Software Technology Corporation
back to contents
Reporter - Introduction
• Reporter offers automatic extraction of results and generation of
report files from LS-DYNA output files
– Integration of several scripts and command files into single report
– Reports can be generated for a series of analyses
– Accessed through Oasys shell, or typing the executable name (unix) or
by double-clicking the executable or its icon (PC)
back to contents
Example Report 1
Example
Report
Page
Output from
D3PLOT
Information extracted
from the otf file
(d3hsp)
back to contents
Example Report 2
Example
Report
Page
Output from
T/HIS
Numerical values
from analysis
back to contents
File name preference
• Before creating your first template, we recommend setting
Reporter’s preference for LS-DYNA output file names according to
how the files are written by LS-DYNA on your system.
• LSTC file names = d3plot, d3thdt, d3hsp, etc
• OASYS file names = name.ptf, name.thf, name.otf, etc
back to contents
User Interface
Drop-Down Toolbar Menu
Template /
Presentation
View Toggle
Switch
Style and Colour
Object
Selector
Button
Lines, Shapes
and Text
Objects
Output from
External
Programs
back to contents
User Interface: Object Icons
Object selector
Line
Rectangle
Text
Report
viewing
Arrow
Ellipse
Image
Output from user’s Program
D3Plot image
T/HIS graph
Text from file
Image file to be read when
generating report
Library image (e.g. logo)
Table from multiple analyses
Library program
Script
back to contents
Creating a Template File
Page size /
orientation
Create a new template
by selecting ‘New’
from File menu or the
New File icon
Preference
settings
back to contents
Creating a Template: Text
To insert text,
1) select text box icon
or ‘Text..’ from drop
down menu
3) Text
properties
2) Click on page at
desired location
4) Enter text and
press ‘OK
This cross is at the point where
you clicked (see Justify settings
in text box menu
back to contents
Creating a Template: Editing objects
To move/resize
an object, first
right-click the
object to make
the yellow drag
handles appear.
Then use the
drag handles or
drag the object
Right click an
object, edit
Enter updated
text
back to contents
Variables
• Variables can be any character or numerical data
• Can change the variable values before generating a report
• Used to globally substitute throughout a report (e.g. analysis name
and directory, allowing the whole report to be generated quickly for
different models
• Variables can be created by and exchanged with external programs
–
–
–
–
FAST-TCF scripts for T/HIS
D3Plot command files
Library programs and scripts
User-written programs
• Managed through a single menu
• Examples:
–
–
–
–
–
Titles
File or directory names
Numerical values from input/output files
Maxima/minima etc from graphs
Node/element ID in FAST-TCF scripts
back to contents
Variables: Menu
Create, edit and delete
variables through
‘Variables’ menu
Default
Reporter
variables
back to contents
Variables: Editing
Directory containing
LS-DYNA output files
Analysis root filename
eg tube if tube.key
Set variable name, description
and value. If the variable is a
directory or file name, a
browse button is available.
back to contents
Using variables in text objects
When in a text box,
right click and Insert
Variable
… or type the variable
name enclosed with %, e.g.
%VAR_NAME%
back to contents
Variables: Output values
Select ‘Presentation’
view toggle switch to
see displayed value
Interpreted values
of variables
back to contents
Creating new Variables
Give variable name and type. Setting the type to
Directory or File enables Browse button.
Options for File, e.g /data/RUN1/basename.key:
File(absolute) = /data/RUN1/basename.key
File(basename) = basename
File(extension) = key
File (tail) = basename.key
back to contents
D3PLOT Object: Creating
Select D3PLOT object
and drag screen area
to insert onto page
Press ‘Capture’ to
start D3PLOT
back to contents
D3PLOT Object: Capturing
Perform D3PLOT
operations as
normal to achieve
desired view
Once finished
select ‘=>
Reporter’ in drop
down ‘File’ menu
back to contents
D3PLOT Object: Capturing
D3PLOT command file now
embedded within template
Right click on
object to edit
Job file automatically uses the
DEFAULT_DIR and DEFAULT_JOB
variables if they match the file opened.
back to contents
D3PLOT Object: Generating
Select ‘Presentation’
mode to view
resulting output
Right click on object, then Generate.
Or, to generate the whole report,
press CTRL-G or File=>Generate
back to contents
D3PLOT Object: Copy / Paste
Copy an existing object
through right click, Ctrl-C
or Edit->Copy
Paste copied object using CtrlV or Edit->Paste, or right click
at a specific location
back to contents
D3PLOT Object: modifying the picture
Pressing ‘Capture’ for an
existing object: re-opens
D3PLOT with the chosen
view
Perform additional
operations in
D3PLOT and return
to Reporter
back to contents
D3PLOT Object: Output
Right click
‘Generate’ on
newly
created
object
Switch to
Presentation
view to see
resulting
output
Ctrl-G
generates the
full report
back to contents
T/HIS graphs – using FAST-TCF
Select T/HIS object
and screen drag an
area
Load an existing
FAST-TCF script …
... or press ‘Capture’ to
start T/HIS
back to contents
FAST-TCF Object: Capturing
Perform T/HIS
operations as
normal to achieve
desired plot. The
graph may show
one or many
curves.
Once finished,
select ‘Return to
Reporter’ in drop
down ‘File’ menu
back to contents
FAST-TCF Object: Creating
FASTTCF script
now embedded
within template
Analysis path
should
usually be
replaced with
a variable
Press ‘Capture’ again if you
want to modify the graph
back to contents
FAST-TCF Object: Editing
Additional commands
from a second ‘Capture’
are automatically
appended to script
Save script for use
outside Reporter
back to contents
FASTTCF Object: Generating
Right click and
‘Generate’ to
execute script
Select ‘Presentation’
mode to view
resulting output
back to contents
FASTTCF Objects: Variables
Variables can be created within the FASTTCF
script: this line is typed manually into the
script (see section on FAST-TCF syntax in the
T/HIS manual). It finds the maximum value on
the curve with tag “forcekn” and stores it in a
variable MAX_FORCE
Variable
reference
within text box
back to contents
FASTTCF Objects: Variables
Select ‘Presentation’
mode to view
resulting output
Switch back to
‘Template’ mode to
continue editing the
template
Interpreted value
of variable
back to contents
Image Objects
Three further methods of inserting an image:
– Standard image
• Any existing bitmap, jpeg or gif image
– Image File
• Named image file to be inserted when generating the
report
– Library Image
• Image from Reporter’s library, e.g. company logo
back to contents
Drawing Objects
Formatting
options
Rectangles
to frame
images
Drawing
Objects
Image from
image library
Lines
back to contents
Library Programs
Reporter has a library of programs to
extract information from the LSDYNA keyword and printed output
files (*.key, *.otf or d3hsp)
Select library tool
icon and drag across
a suitable screen area
(OTF file =d3hsp file)
back to contents
Library Programs: Inserting
Expand /
contract list
Select
program
Arguments passed to
program – e.g. for
d3hsp file this should
be
%DEFAULT_DIR%/d3hsp
‘OK’ to insert
selected program
back to contents
Library Programs: Formating
Can apply
conditional
formatting
based on
output
back to contents
Library Programs: Generating
Select and right
click ‘Generate’
to execute
program
Conditional
formating
Select ‘Presentation’
mode to view
resulting output
Switch back to
‘Template’ mode to
continue editing the
template
back to contents
Library Programs: Generating
Create a summary table by
inserting several library programs
back to contents
Ordering Objects
When generating a report, Reporter
processes objects in order. If a
variable is created by object A and
used in object B, then object A must
be generated before object B.
E.g. text object
using variable
MAX_FORCE
must occur after
FAST-TCF object
that created the
variable
Use to
adjust the
order of an
object
back to contents
Managing Pages
Insert page from
another template
or library
Export Page
Define master
page to apply
consistent format
back to contents
Lining up objects neatly
When in presentation mode, click
the Selector tool, then click on an
object and drag or nudge.
Another method is to use the
geometry data (corner coordinates
and size) in the Object Edit menu
to set several objects to have the
same X or Y coordinates and size.
back to contents
Error Log
The Logfile records all operations
executed by Reporter with
associated warnings and errors.
It can be useful for debugging
templates
Errors/warnings
appear in red
Search for next
error or warning
back to contents
Comparing two or more models
• Pictures and graphs comparing two (or more) models can be made.
• First, create a new variable for the directory of the second model
(e.g. BASE_DIR)
• If using OASYS filenames (jobname.thf, jobname.ptf, etc), create a
new variable for the second model name (e.g. BASE_JOB)
• Now capture graphs and pictures in the normal way; when in T/HIS
or D3PLOT, open two (or more) models and create the desired
pictures or graphs.
back to contents
Comparing two or more models
In D3PLOT, use File=>Open new
model to open the second model.
Window=>Edit Window can be
used to control which models
appear in which windows, and
change the colour of each model.
File=> return to Reporter as before.
back to contents
Comparing two or more models
• The Job file text box now
shows a list of the models
opened by D3PLOT. Use
the left/right arrow keys to
scroll through the text box.
• Change the directories
shown to
%DEFAULT_DIR% and
%BASE_DIR%
• Now, by editing the
variables BASE_DIR and
DEFAULT_DIR, any two
models may be compared.
back to contents
Comparing two or more models
In T/HIS, use Read=>LSDYNA and
New Model to open two (or more)
models.
Perform any necessary operations
to display the desired graph.
File => return to Reporter as before
As with the D3PLOT object, the
Job File text box now contains a list
of models. Change the directories
to %BASE_DIR% and
%DEFAULT_DIR% as before.
back to contents
Saving / Exporting
Save Reporter template file (*.ort):
contains all the information required to
generate a report
Write a Reporter report file (*.orr): same
as template file, but also includes
pictures and graphs generated during
the current session, i.e. the report can
be viewed in Reporter without needing
to re-generate
back to contents
Saving / Exporting
Postscript: better definition for printing.
Viewable in Ghostscript. File may be
large.
PDF: Adobe Acrobat format. Can be
printed.
Html: suitable for on-line usage.
Powerpoint VBA: a Visual Basic macro run macro to generate powerpoint
version of report (this is available on
any computer)
Powerpoint: generate a powerpoint file
directly. This can be done only on a PC
that has Powerpoint installed
back to contents
Running in Batch
Reporter can be run
in batch mode using
the following
command line
options
back to contents
Running in Batch
Example:
(path)/reporter92.exe –batch –file=(path)/example.ort
–varDEFAULT_DIR=/data/example/RUN1 –pdf=(path)/example.pdf –exit
In this example, the LS-DYNA results in directory /data/example/RUN1 will be
processed using Reporter template example.ort, and the report saved to a
pdf file named example.pdf. Reporter will then exit.
When the path includes spaces (on PCs), it should be enclosed by quote
marks, e.g. “C:\Documents and Settings\example”
-batch indicates that Reporter should not ask questions or expect any
interaction with the user. Reporter still displays the images on-screen during
report generation when in batch mode.
back to contents
Unicode Characters
If your computer has Unicode
fonts (e.g. Chinese, Japanese,
Korean), these characters may be
included in Text objects and
Variables, displayed in Reporter,
and written to all output formats
except postscript.
back to contents
Advanced Topics: User Written Program
Select a user
written external
program (can
be a script
written in Perl,
Python etc or
be an
executable).
The output to
“stdout” from
the program
will be
displayed
Insert a
program
object
Define arguments
required by
program
back to contents
Advanced topics: D3PLOT added commands
Add extra command-file lines to a
D3PLOT object through the ‘Edit’
button. This is rarely needed – all the
necessary commands are stored
automatically while Capturing.
Load existing command
files, add further commands
to automatically-generated
command files, or save a file
for use outside Reporter
back to contents
Advanced Topics: Multiple Analyses
Key list
Whole
process can
be controlled
by Oasys
Shell if
required
Run1.key
Run2.key
Run3.key
LS-DYNA
LS-DYNA
LS-DYNA
Results 1
Results 2
Results 3
Reporter
Reporter
Reporter
Report
Report
Report
Variables
file
Variables
file
Variables
file
Template 1
Shell
Reporter
Summary Report
Template 2
Template 1 postprocesses each
analysis separately,
and writes a file
containing the
values of the
variables
Template 2 creates
a summary report,
using the variable
values generated
by Template 1
back to contents
Advanced Topics: Multiple Analyses
In Template 1 (used
to post-process
each analysis
separately):
Request a Reporter
variables file
Variable values
are written to a
plain text file
back to contents
Advanced Topics: Auto Table
Template 2:
Reporter can
generate a table of
results from
multiple analyses
Insert an
Autotable object
by screen
dragging an area
back to contents
Advanced Topics: Auto Table
Select root
directory
containing
analyses
Variable value
to enter into
column - can
be the output
from a
program
Add / Remove
columns
Apply
conditional
formatting and
create
hyperlinks to
other files
Table
Dimensions
back to contents
Advanced Topics: Auto Table
Values
extracted from
Reporter
variables files
Conditional
formatting
based on value
Hyperlinks to
individual
report files
back to contents
Advanced Topics: “Blob” plots
Variable values (e.g.
HIC) and corresponding
X,Y & Z co-ordinates
extracted from all
analyses contained
within root directory.
Each “blob” represents
one analysis.
This requires two
objects:
(1) A library script that
creates a data file, and
(2) A D3PLOT object that
reads and displays the
data
back to contents
Advanced Topics: “Blob” plots
Insert a library
program object
and select
D3PLOT data file
Root directory
containing analyses
Variable values to
extract from
variables files
back to contents
Advanced Topics: “Blob” plots
D3PLOT data file
library program
Insert a D3PLOT
object and select
the data file
generated by the
library program
Press Capture to
load D3PLOT
using the data file
back to contents
REPORTER 9.2