HyperWorks Desktop Startup Options
Startup options launch HyperWorks Desktop with specific behaviors or with specific settings defined.
The options are provided as command line options to the application executable or startup script.
HyperWorks Desktop
- -b
- Used in conjunction with either the -tcl, -hwc, or -c options to enable batch (non-GUI or non-interactive) mode. HyperWorks Desktop will exit immediately upon completion of the Tcl, HWC script, or command file.
- -clientconfig <client_config_filename>
- Specifies the client configuration file to load, which defines the client that is loaded and which clients are available. If no file is specified, the default clients.dat file is used.
- -f
- Alternate: -file. Runs a script specified by the file.
- <filename>
- Performs various behaviors, depending on the value of -clientconfig.
- Known Result Files: Start HyperWorks Desktop with the HyperView client and load the result file as both model and result files
-
- -clientconfig hwtext.dat
- .mvw files - Load the .mvw file. The active client is determined from the .mvw file.
- -clientconfig hwvideo.dat
- .mvw files - Load the .mvw file. The active client is determined from the .mvw file.
- -clientconfig is not specified
- .mvw files - Load the .mvw file. The active client is determined from the .mvw file.
- Known Result Files: Automatically use -clientconfig hwpost.dat and load the result file as both model and result files
-
- -clientconfig hwpost.dat
- .txt, .html, .tpl files - Automatically use -clientconfig hwtext.dat and load the text file.
- -f <filename>
- Same as <filename>. This is required when passing in a file in conjunction with other options. For example, "-f model.hm -tcl model.tcl."
- -h
- Print out the HyperWorks Desktop usage message.
- -help
- Displays the list of command line options used with HyperWorks Desktop.
- -hm2go
- This option is valid only if specified along with -lch. Specifies whether to use HM2GO or not while launching help. You can specify "0" to not use HM2GO, and "1" to use HM2GO. By default, HM2GO is used.
- -hwc <hwc_filename>
- Automatically run the specified HWC script.Note: There is a space between -hwc and the filename.
- -landscape
- Used in conjunction with the -p option to print all pages in a landscape orientation.
- -lc
- Alternate: -logconsole. A flag to indicate whether to log messages to the console.
- -lch
- This argument is valid in batch mode only. This option is used to specify that HyperWorks should only launch the client help and then exit.
- -ll
- Alternate: -loglevel. The minimum level of log messages that can be logged.
- -nal
- Alternate: -noautoload. A flag indicating not to load auto load plugins.
- -ngs
- No getting started. A flag indicating not so show the getting started dialog.
- -nobg
- Used in conjunction with the -b option to force HyperWorks Desktop to run in the foreground on Linux.
- -p <mvw_file> [ps_file]
- Prints all pages in mvw_file with the specified orientation. If ps_file is specified, instead of going to the printer, the pages are printed to a Postscript file named ps_file.
- -p
- Alternate: -plugin. Load the specified plugins.
- -portrait
- Used in conjunction with the -p option to print all pages in a portrait orientation.
- -prver
- Valid only if specified along with -lch.
- -s <width>x<height>+<x>+<y>
- Alternate: -size. Opens HyperWorks Desktop in a window of the specified width and height in pixels.
- -shell
- Runs HyperWorks in batch (non-GUI and interactive) mode Name of interpreter used in shell mode should be passed as argument.
- -tcl <tcl_filename>
- Automatically run the specified Tcl script. Note: There is a space between -tcl and the filename.
- -tv
- Changes the theme version used by the framework (for example, -tv 2019).
- -v
- Alternate: -version. Version to be used in the path of the settings file directory.
- -version
- Print out the HyperWorks Desktop version.
- -wait
- Used in conjunction with the -b option to wait for a key press before exiting if running under Windows.
Invalid Options
- -c
- Alternate: -client. Loads the specified client and creates a client object.
- -gvi
- Alternate: -generateversionimage. Specifies the file generated for the installer splash screen using the config/splash .xml file to compose a splash screen and exit.
- -kc
- Alternate: -keepconsole. Keep open the Windows command console and write any text messages into it. By default, release builds always release the console and discard text messages. Unnecessary if a batch mode option (-b, -batch, -shell) was specified. Windows only. Ignored on other platforms.
- -l
- Alternate: -locale. Internationalization language. Generally only used during the first run. Subsequent runs will use the language used in the previous run (as stored in personalized settings, see -v), so this argument will be ignored.
- -ns
- Alternate: -nosplash. Flag indicating not to show the splash screen.
- -o
- Alternate: -open. Open the specified file with the given client. Should be used along with the -client option.
- -port
- Port number of the server. Should be used along with -server option.
- -pr
- Alternate: -profile. Set the given profile for the current client object. Should be used along with -client option.
- -server
- Run HyperWorks in Server mode in a different thread.
- -sf
- Alternate: -splashfile. Specify the file to be used as splash screen. This is deprecated since switching to the splash .xml support.
- -style
- Flag to indicate not to use HyperWorks style.
HyperMesh Client
- -a<subprofile_name>
- Used in conjunction with -u<profile> to specify a
HyperMesh user profile sub-profile.
Note: There is no space between -a and the subprofile name.
- -batch
- Used in conjunction with the -tcl or -c options to enable batch mode. HyperMesh will exit immediately upon completion of the Tcl script or command file.
- -batchcontext
- Used in conjunction with the -b option to setup an OpenGL batch context. This is required for machines that require the context to successfully run HyperMesh. The DISPLAY environment variable must be defined and working in order to use this option.
- -c <command_filename>
- Automatically run the specified command file. Note: There is no space between -c and the filename.
- -continue
- Always continue (do not prompt) on errors when processing a command file.
- <filename>
- Automatically load the specified .hm file.
- -g
- Force the display of the HyperMesh user profile dialog at startup.
- -h
- Print out the HyperMesh usage message.
- -nobatchcontext
- Used in conjunction with the -b option to not setup an OpenGL batch context. This is required for machines that cannot use a batch context to successfully run HyperMesh.
- -nobg
- Used in conjunction with the -batch option to force HyperMesh to run in the foreground on Linux.
- -nocommand
- Prevent HyperMesh from creating or writing to the command file.
- -nouserprofiledialog
- Prevent the display of the HyperMesh user profile dialog at startup.
- -nowriteviewcommands
- Prevent HyperMesh from writing view commands to the command file.
- -r<result_filename>
- Set the name of the HyperMesh results file
to either the input filename with a .res suffix, or
to the specified file. Note: There is no space between -r and the filename.
- -s<width>x<height>+<x>+<y>
- Opens HyperMesh in a window of the specified
width and height in pixels. Optionally, the x and y location of the
upper left corner of the window can be specified. Note: There is no space between -s and any of the arguments.Note: There is no space between -s and between any of the arguments.
- -templex
- Allow Templex statements within command files.
- -t<template_filename>
- Set the global template to the specified file. Note: There is no space between -t and the filename.
- -tcl<tcl_filename>
- Automatically run the specified Tcl script.
- -u<profile_name>
- Used to specify a HyperMesh user profile at
startup. Note: There is no space between -u and the profile name.
- -version
- Print out the HyperMesh version.
Example: Startup Options
- Windows
- <altair_home>/hw/bin/<platform>/hw.exe -clientconfig hwfepre.dat -tcl /home/user/my_script.tcl
- Linux
- <altair_home>/altair/scripts/hw -clientconfig hwfepre.dat -tcl /home/user/my_script.tcl