Command Line Options
This topic summarizes the command line options that are supported by hwCFDReport.
Execute Commands
Command line utilities require zero or more options to run. These options may be supplied on the command line.
For example, to invoke hwCFDReport for problem with input file
aero.img, you can either issue the
command:
hwcfdReport --img aero.img (Linux)
hwcfdReport.bat –img aero.img (Windows)
Note: The application is installed within the HMDesktop
distribution at the following location:
- InstallationFolder\scripts\hmcfdreport (Linux, scripts location)
- InstallationFolder\hwdesktop\hwx\plugins\hwd\profiles\HyperworksCfd\hwcfdReport (Linux)
- InstallationFolder\hwdesktop\hwx\plugins\hwd\profiles\HyperworksCfd\hwcfdReport.bat (Windows)
To get the list of executable options along with their current values, issue the
command with the -h (or --help) option. This causes the executable to print a usage
message and exit. For example,
hwcfdReport --help
prints a
message such as the following and exits:MESSAGE:
Accepted Arguments:
help:
help
h
outputs all accepted arguments.
input file:
input_file <file>
img <file>
this is a required argument
output directory:
run_directory <directory>
dir <directory>
if no directory is given, it will create output.dir in the current working directory.
compare directory:
compare <directory>
if this is given, images in given directory will be used to generate a comparison pptx.
compare display format:
compare_format <string>
determines the display format of comparison slides.
Defaults to "parallel".
value: "para" as parallel, side by side on one slide
"seq" as sequential, one after one on two slides,
this is an optional argument
append directory:
append_directory <directories>
concatenates multiple existing output directories into a single PowerPoint report.
append_directory can be a single directory (Local or absolute path) or a comma separated
list of directories to pull .png and .avi/.mp4 files from.
<directories> could not empty.
this is an optional argument
report generation
rep <bool>
generate_report <bool>
determines whether report is generated or not. Defaults to true. Values passed are either "true" or "false".
animation
animation_format <string>
can be either mp4 or avi. Default is mp4
picture resolution:
res <string>
picture_resolution <string>
determines the resolution of picture file.
Defaults to "high".
value: "high" as high, 9000 x 6000
"medium" as medium, 6000 x 4000
"low" as low, 3000 x 2000
this is an optional argument
other:
--delete : if given, all files in output directory are deleted. If not given
and output directory is not empty, exit signal is given
Example use case:
.\launcher input_file "../smxMixer.img" run_directory "../output.dir" res "low"
reads file smxMixer.img in <local_directory>/
outputs to <local_directory>/output.dir
output includes images and report PowerPoint, if generated
Commands
- help or h (boolean)
- If set, the program prints a usage message and exits. The usage message includes all available options, their current values, and the place where each option is set.
- input_file or inp (string)
- The input file name (file.inp) to be used in the templated report generation
- run_directory or dir (string)
- The location of the run directory
- compare (string)
- If this is given, images in given directory will be used to generate a comparison .pptx.
- compare_format (string)
- Valid options are "seq" or "para".
- append_directory (string)
- Concatenates multiple existing output directories into a single PowerPoint report, where (string) is a single directory (local or absolute path) or a comma separated list of directories to pull .png and .avi/.mp4 files from.
- generate_report or rep (boolean)
- Generate report containing images.
- animation_format (string)
- This option sets the format of the animation. Valid options are .mp4 and .avi. Default is .mp4.
- picture_resolution or res (string)
- Determines the resolution of picture file.
- delete (boolean)
- If given, all files in output directory are deleted. If not given and output directory is not empty, exit signal is given.