Startup options allow BatchMesher to be launched with a specific behavior or with specific settings defined.

The options are provided as command line options to the application startup script.

For example, on Windows:

<altair_home>\hm\batchmesh\hw_batchmesh.bat -nogui -cad_translator catia -cad_model_dir C:\work\models -cad_model_ext CATPart -criteria_file C:\work\10mm.criteria -param_file C:\work\10mm.param -user_procedure PRE_GEOMETRY_LOAD C:\work\mytcl.tcl myprocedure "myarg1 myarg2" -user_procedure POST_BATCHMESH C:\work\NastranOutput.tcl nastranexport

<altair_home>\hm\batchmesh\hw_batchmesh.bat -config_file C:\work\bm.cfg -multicpu 4 -batch

For example, on Linux:

<altair_home>/altair/scripts/hw_batchmesh -nogui -cad_translator catia -cad_model_dir /work/models -cad_model_ext CATPart -criteria_file /work/10mm.criteria -param_file /work/10mm.param -user_procedure PRE_GEOMETRY_LOAD /work/mytcl.tcl myprocedure "myarg1 myarg2" -user_procedure POST_BATCHMESH /work/NastranOutput.tcl nastranexport

<altair_home>/altair/scripts/hw_batchmesh -config_file /work/bm.cfg -multicpu 4 -batch

 

BatchMesher startup options:

---

This mode uses the BatchMesher GUI.

-batch

Used to automatically run jobs via a config file.

This must be used with the -config_file option.

-config_file <path>

Specifies the full path and file name of the config file to use.

If used without -batch, this simply configures the BatchMesher GUI.

If used with -batch, this configures the BatchMesher GUI and automatically runs the jobs.

-file_wait_timeout <minutes>

Model loading and PRE_GEOMETRY_LOAD user procedure run time.  May be required if some models need more than the default time (20 minutes) to load.  Also may be required if the user specified PRE_GEOMETRY_LOAD procedure has a long run time. See also -timeout_scale.

-help

Print out the BatchMesher usage message.

-multicpu <number>

The number of CPUs to use for simultaneous BatchMesher jobs.  This overrides any value set in -config_file.

-relocate_to_input

Moves all .hm output files to the corresponding directory of the input model.

-submit_time <time>

Defines the future submission time of the current GUI configuration.  The time format depends on the OS and localization settings on the machine.  Refer to the value of the Submit At button on the Batch Mesh tab to see an example of the format required for your environment.  An example is "8/8/11 12:27:00 PM".

-time_limit_default <minutes>

Model batch meshing step timeout.  May be required if some steps need more than the default time (15 minutes).  The actual timeout is the maximum of -time_limit_default and the value read from the time_limit.txt file (updated automatically after each step).  This is ignored if <=0.  See also -timeout_scale.

-timeout_scale <scale>

Proportionally increase/decrease -file_wait_timeout, -time_limit_default and the value read from the time_limit.txt file.  The default value is 1.0.  Ignored if <=0.0.

-total_timeout <minutes>

Total timeout for whole batch mesh job. May be required if model batch meshing require more than the default time (240 minutes).

-work_dir <path>

Specifies the directory where the output files are to be written.

 

BatchMesher "watchdog" startup options:

---

This mode runs a single BatchMesher job with no GUI.  This is useful for grid computing job submission.

-cad_model_dir <directory>

Specifies the directory where CAD/HM input files are located.  This is used for multiple file jobs.

This must be used with the -cad_model_ext option.  This cannot be used with the -cad_model_file option.  This is a mandatory argument if -cad_model_file is not specified.

-cad_model_ext <extension>

Specifies the file extension to use when scanning the -cad_model_dir for CAD/HM input files.  All input files with found with this extension will be batch meshed.  This should be simply the extension, not including the period (.)  For example, CATPart instead of .CATPart.

This must be used with the -cad_model_dir option.  This cannot be used with the -cad_model_file option.  This is a mandatory argument if -cad_model_file is not specified.

-cad_model_file <path>

Specifies the full path and file name of the CAD/HM input file.

This cannot be used with the -cad_model_dir and -cad_model_ext options.  This is a mandatory argument if -cad_model_dir is not specified.

-cad_translator <type>

Specifies the CAD file type being used.

Valid values are:

acis

catia

ct-ug

Detect

dxf

hm

iges

inspire

intergraph

jt

pdgs

parasolid

proe

step

solidworks

tribon

ug

vdafs

-criteria_file <path>

Specifies the full path and file name of the criteria input file.  This is a mandatory argument.

-file_wait_timeout <minutes>

Model loading and PRE_GEOMETRY_LOAD user procedure run time.  May be required if some models need more than the default time (20 minutes) to load.  Also may be required if the user specified PRE_GEOMETRY_LOAD procedure has a long run time. See also -timeout_scale.

-help

Print out the BatchMesher usage message.

-nobg

Used to force BatchMesher to run in the foreground on Linux.

-nogui

Used to run BatchMesher in no GUI mode.  This is a mandatory argument.

-param_file <path>

Specifies the full path and file name of the parameter input file.  This is a mandatory argument.

-recurse <value>

A true|false value that specifies whether to include sub-directories when using the -cad_model_dir option.  This is not recommended for use in grid computing job submission.

-qi_post_procedure <value>

A true|false value that specifies whether to generate the HTML quality reports for the run.

-run_results <path>

Specifies the full path and file name of the results output file to write/append to.

-run_tcl_file <path>

Specifies the full path and file name of the Tcl script containing a procedure to run.  If this option is used, then all other options except -run_tcl_proc are ignored.

This must be used in conjunction with the -run_tcl_proc option.

-run_tcl_proc <proc>

Specifies the name of the Tcl procedure to run.

This must be used in conjunction with the -run_tcl_file option.

-time_limit_default <minutes>

Model batch meshing step timeout.  May be required if some steps need more than the default time (15 minutes).  The actual timeout is the maximum of -time_limit_default and the value read from the time_limit.txt file (updated automatically after each step).  This is ignored if <=0.  See also -timeout_scale.

-timeout_scale <scale>

Proportionally increase/decrease -file_wait_timeout, -time_limit_default and the value read from the time_limit.txt file.  The default value is 1.0.  Ignored if <=0.0.

-total_timeout <minutes>

Total timeout for whole batch mesh job. May be required if model batch meshing require more than the default time (240 minutes).

-user_procedure <type> <path> <proc> <args>

Specifies user-registered procedures.  This option can be used multiple times, once for each type.

type - Specifies the type of procedure to register.  Valid values are PRE_GEOMETRY_LOAD, PRE_BATCHMESH, POST_BATCHMESH.

path - Specifies the full path and file name of the Tcl script containing a procedure to run.

proc - Specifies the name of the Tcl procedure to run.

args - The list of arguments to pass into the procedure.  This can be empty.  If there are multiple arguments, they must be enclosed in quotes.

-work_dir <path>

Specifies the directory where the output files are to be written.

 

 

See Also:

Starting BatchMesher

Grid Computing

Error Codes

Customization