Valid D3PLOT Command Line Arguments
Valid D3PLOT command-line arguments
| Selecting a display device | -d=< device type > |
Device types that are valid are:
(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
|
-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
|
-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
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
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 | ||||||||||||||||||
|
|||||||||||||||||||
| 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:
|
|||||||||||||||||
|
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 " |