D3PLOT 22.1

Valid D3PLOT Command Line Arguments

Valid D3PLOT command-line arguments

Selecting a display device -d=< device type >

Device types that are valid are:

opengl Default 3D OpenGL graphics, which is standard on both Windows and Linux platforms.
stereo Stereo OpenGL on hardware which will support this. It will revert to standard (mono) OpenGL if not available on that platform.
batch Default OpenGL, but with the display not shown on the screen, used for batch processing.
tty No graphics. Has a very limited functionality and should not be used without advice from Oasys Ltd Support.

(Older versions of D3PLOT also supported 2d X11 graphics on Linux platforms. This was withdrawn in D3PLOT 14.0, and 2d graphics is no longer supported.)

Flag to start with window maximised (full screen) -maximise (No argument)
Specifying window placement on a multi-display desktop

By default the top right corner of the desktop is used.

The most common arrangement is two screens side by side, for which "left" and "right" may be used. However "top" and "bottom" are also available for the case of two screens one above the other, and the options may be concatenated for a 2x2 display.

These options can be combined with -maximise to fill the relevant screen.

Users on Windows platforms where tools such as NVidia's "NView" are available may find that it is better to leave window placement to that tool, so that D3PLOT's windows behave in a fashion consistent with other application windows.

-placement=< where >

This option is intended for use where the desktop is spread as a "Single Logical Screen" over multiple monitors.

< where > values Meaning
left Left hand monitor
right Right hand monitor
top Upper monitor
bottom Bottom monitor

The above may be concatenated for a 2x2 display, for example

top_left Top left monitor
bottom_right Bottom right monitor

Command file name
Flag to exit when command file run complete if desired

-cf=< filename >
-exit
A valid command file name (usually *.tcf)
(No argument)

JavaScript

-js=< filename > Any valid D3PLOT JavaScript file

JavaScript Arguments

-js_arg=< argument > Any valid string
The arguments can be accessed in the script by using the global arguments array.
Multiple arguments can be given to a script by using more than one -js_arg command line argument.

Checkpoint file to replay
Number of lines to execute in checkpoint file

-replay=< filename >
-rlines= <nnnn>
A valid D3PLOT ckeckpoint file (usually cp_d3plot nnnn )
Where < nnnn > is a positive integer
Alternate "start in" directory (redefines current working directory) -start_in=< pathname > A valid directory (eg c:\my_files, /data/my_files)

Optional "project" working directory.

This specifies an alternate initial location for view, cut-section, group, settings and external data files. Useful if the directory containing analysis data is read-only so that these files have to be located elsewhere

-pcwd=< pathname > A valid directory (eg c:\proj_files, /data/proj_files)

Specifying a custom "oa_pref" file.

This causes an extra, optional "oa_pref" file to be read.

-pref=<filename>

<filename> must be a valid "oa_pref" file.

If it has no path prefixed, the file is assumed to be in the OA_INSTALL directory. Any legal filename may be used.

Specify a file that contains commands to create a cutdown version of the ptf file (see [WRITE] CUTDOWN D3PLOT/PTF File ). -ptfcut=<filename>
As above but allows creation of cutdown ptf files (see Disk Format of Binary Database Files ) in true batch mode (-d=tty) using easily readable/editable options. Subsidiary options may be specified either on the command line or fed in from a file. -ptfcut_batch
<=filename>
The following data components are accessible using this flag:
Flag Component
-acc Acceleration
-plastic Plastic strain
-strain Strain tensor
-stress Stress tensor
-vel Velocity
-von_stress (reordered format only) Von mises stress
-von_strain (reordered format only) Von mises strain

The following output formats are available:

Flag Format
-reorder Reordered
<none> Original

Specific states may be selected as follows:

Flag Meaning
-states=odd All odd states
-states=even All even states
-states=start,end,optional_inc States between 'start' and 'end' with a step size of 'optional_inc'; end can be "last" (minus quoes)

-states=all

<none>

All states selected
...continued...

Two new methods of generating cutdown models are available:

Method 1 involves feeding all relevant options on the command line. This can only produce one cutdown model. Eg:

-ptfcut_batch -reorder
<-vel/-acc/-plastic/-stress/
-strain/-von_stress/-von_strain>
-states=<[start, end, optional_inc]/odd/even>
-o=<output> <input>

Method 2 involves specifying options in a file and invoking that using the -ptfcut_batch= flag. This method can be used to generate multiple cutdown models, each with its own components, formats and states

-ptfcut_batch=<options_file> <input>

Example options_file:

-reorder -vel -states=odd -o=vel.ptf
-acc -o=acc.ptf

There is currently no option to select specific parts for the cutdown model. All parts are processed by default.

Write out a HDF5 file with envelope data.
-env_out

Methods of writing out the HDF5 envelope data file using the batch mode:

To write out the HDF5 file with envelope data, we need to set '-d=batch' flag to run D3PLOT in batch mode.

-env_out writes out the HDF5 file for the 'filename.ptf' model file provided.

Users need to provide a settings file with all the necessary options already set like integration points, reference frames and data components etc.  

<install-dir>d3plot22_x64.exe -d=batch -env_out -set="<settings file path>\d3plot001.set" "<model_path>\filename.ptf"

We write out envelope data for all the states by default through batch. Selection of subset of states through the settings file is not supported for batch writing.

Specify a GLB output file for 3D Export. -glb=<file> Generate a compressed GLB file
-glb_uncompressed=<file> Generate an uncompressed GLB file
The following options can be used with this flag to control the component and states captured in the 3D Viewer Export.
-components=A,B,C

A comma separated list of components, where each component generates a separate GLB file.

The component names can either be the JavaScript Data component names or the D3PLOT button label names.

-components=svon
-components=X_DIRECT_STRESS

Each component can be followed by a surface (top/middle/bottom/max/min/mag) or a specific layer number if required.

-components=svon@top
-components=X_DIRECT_STRESS@1

A special component "none" can also be specified in the list to generate a Shaded plot.

-components=svon@top,X_DIRECT_STRESS@1,none,vm

would generate 4 output files

  • Von Mises Stress (Top Surface)
  • X Direct Stress (Layer 1)
  • Shaded Plot
  • Velocity Magnitude

-frame_rate=N

Specifies the default playback frame rate for D3PLOT Viewer ( www.d3plotviewer.com ).

-states=N

Select single state N

-states=odd

All odd states

-states=even

All even states

-states=start,end,inc

States between 'start' and 'end' with a step size of 'inc'; end can be "last" (minus quotes), inc is optional

-states=all

<none>

All states selected. This is the default, unless D3PLOT reads a settings file along with the model, in which case the default is to export a single state (the current state specified by the settings file).
Specify a D3PLOT template file that contains information on which models are loaded into each window and any model offsets for each window (see Template File ). -tpl=<filename>
Specify the name of a model database file to open (see Select Models From Database ). -mdb=<filename>
Specify an alternate location for a ZTF file to read. This option can be useful if PRIMER is unable to create a ZTF file in the same location as the D3PLOT PTF files (see Open a Single Model ). -ztf=<filename>
Do not read a ZTF file. -no_ztf
Specify an alternate location for a D3PLOT settings file. By default D3PLOT will look in the directory containing the PTF files for a setting file to read (see Open a Single Model ). -set=<filename>
Do not read a D3PLOT settings file. -no_set
Specify an alternate location for a D3PLOT properties file. By default D3PLOT will look in the directory containing the PTF files for a properties file to read (see Open a Single Model ). -prop=<filename>
Do not read a D3PLOT properties file. -no_prop
Specify an alternate location for a D3PLOT groups file. By default D3PLOT will look in the directory containing the PTF files for a groups file to read (see Open a Single Model ). -group=<filename>
Do not read a D3PLOT groups file. -no_group

Using this option will prevent D3PLOT from reading a human-readable ASCII groups file (group nnn .asc) but it will still read any cached binary groups file ( jobname .grp) that is left over from an earlier D3PLOT session which used groups in this model.

For more information see the GROUPS section of this manual.

Specify a file containing a list of models for D3PLOT to automatically open. -ml=<filename>

The model list file should contain the full pathname of one file from each model that D3PLOT should open. Each file should be on a separate line and it should be the first item on each line.

By default each model will be read into Window 1, but you can specify which windows a model is read into by specify a bitwise encoded number after the model name (W1=1, W2=2, W3=4, W4=8, etc.)

e.g. if you read in 4 models with the following file:

model1.ptf 1

model2.ptf 2

model3.ptf 4

model4.ptf 3

model1.ptf would go into W1, model2.ptf into W2, model3.ptf into W3 and model4.ptf into W1 and W2. Contact Oasys Ltd Support if you need further explanation.

Do not read a file with interface force segments and data. -no_ifs
Do not read a file with springs, masses, joints etc. -no_xtf
Do not read a spotweld, SPC etc. data file. -no_lsda

Run D3PLOT in "batch" mode where the main application window is not displayed on the screen. For this option to work you must also specify a command file " -cf=filename " and the name of the PTF file to open.

This option will automatically set " -exit " so that D3PLOT terminates after playing the command file.

-batch

Redirect output from the console window to a file on Windows.

To redirect output on Unix/Linux use the shell redirection options (typically > for <stdout>, & for <stderr>)

-eo=<filename>
-eo
-eo=default

-eo=<filename> is designed for the user to suppress the console and redirect logfile output to the specified filename. In order to permit multiple sessions to coexist on the same machine the process id will be appended to the <name> part of the filename to give <name>_pid.<ext>.

If plain "-eo" or "-eo=default" are found then filename generation is automatic, and the first valid of:

%TEMP%\this_log_<pid>.txt
%TMP%\this_log_<pid>.txt
%HOMESHARE%\this_log_<pid>.txt
%USERPROFILE%\this_log_<pid>.txt

will be used.

Read/Write checkpoint files

Start writing the checkpoint files upon D3PLOT startup

Read checkpoint files and Show checkpoint playback panel upon D3PLOT startup.

Directory path to write checkpoint files


write_checkpoint_files=< TRUE/FALSE >

show_checkpoint_files=< TRUE/FALSE >

checkpoint_dir=< directory >

TRUE/FALSE, turn on/off the writing of the checkpoint files (default is FALSE)

TRUE/FALSE, turn off the initial checkpoint files panel (default is FALSE)

If the writing of the checkpoint files is OFF, the reading will also be OFF

< directory > must be a valid directory name on your system.

If the value is <none> then the checkpoint files are not recorded for the D3PLOT session.

Run D3PLOT without the console window.

-noconsole Windows only.
Input database filename.

(The extra time history ( .xtf ) and contact force ( .ctf ) databases are also opened if present.)

< filename >

eg run_1.ptf
A valid input file type:

name.ptf (Complete state file)
d3plot ( ditto )

Some examples for D3PLOT might be:

pathname/d3plot18.exe -maximise run_2.ptf (Use full -screen, open file run_2.ptf)

Note that no spaces should be left in the syntax <arg>=<value>.

For example:

Correct syntax is:

" -eo = default " is illegal.

" -eo=default "