# Batch Mode

To start a batch mode process, run hvtrans.exe in a DOS command prompt on a PC or use a Unix shell. If you do not specify complete arguments in the command line, the HvTrans GUI is displayed for you to fill in more information.

hvtrans.exe is located in the following directories:
PC
\\Altair\hw2021\io\result_readers\bin\win64
Unix
/altair/scripts/
To specify the model information from the input deck, use the following syntax:
hvtrans.exe -c<config file> <result file> <model file> -o<output file> -z[percent]
Note: If you do not specify <model file>, the model information is not included in the H3D file. If the model data is from the result file, you need to specify the result file name for <model file>.
Table 1.
Option/<Parameter> Description
-a Translates all results to an H3D file without a configuration file.
-ar Saves the results only. No model information is translated.
-c<config file> The name of the configuration file(s).

Multiples configuration files can be specified by:

-c<config1>,<config2>,<configX>

This allows you to specify a second file that has Linear Superposition/Envelope combinations as a separate file, in addition to the standard configuration file.

-help or -h Help.
-m Saves the model only. No results are translated.
<model file> Specifies the solver input deck for model information or the result file name.
-o<output file> The name of the H3D output file.
<result file> The name of the result file.
-ns Saves the model without exporting sets.
-xml<FATXML file> The name of the FATXML file to be embedded in the H3D output file.
-xmlfile<file> The name of the FATXML file to be created from the FATXML contents from the result file.
-z [percent] Enables result compression. You can specify a desired percentage for allowable error. 0.01% is the default. The standard option for file compression is used.

## Examples

 hvtrans -a d3plot or hvtrans d3plot -a HvTrans extracts the model and all results from the d3plot file and saves them to the file d3plot.h3d. hvtrans -a d3plot model.key HvTrans extracts model information from the file model.key and the results from the d3plot file and saves the information to the file d3plot.h3d. hvtrans -a d3plot -o example_all_results.h3d HvTrans extracts the model and result information from the d3plot file and saves the information to the file example_all_results.h3d. hvtrans -a d3plot model.key -o example_all_results.h3d -zh0 HvTrans extracts model information from the model.key file and all results from the d3plot file and uses the highest lossless (0) compression to save the information to the file example_all_results.h3d. hvtrans -ar d3plotor hvtrans d3plot -ar HvTrans extracts the results only from the d3plot file and saves them to the file d3plot.h3d. No model information will be stored.
Note: Compression option may delay the translation process.