5.1 Setup Arguments

The setup script accepts a large number of command line arguments which affect the simulation in various ways. These arguments are divided into three categories:

  1. Setup Options (example: -auto) begin with a dash and are built into the setup script itself. Many of the most commonly used arguments are setup options.
  2. Setup Variables (example: species=air,h2o) are defined by individual units. When writing a Config file for any unit, you can define a setup variable. Sec:setupvariables explains how setup variables can be created and used.
  3. Setup Shortcuts (example: +ug) begin with a plus symbol and are essentially macros which automatically include a set of setup variables and/or setup options. New setup shortcuts can be easily defined, see Sec:SetupShortcuts for more information.

Table 5.1 shows a list of some of the basic setup arguments that every FLASH user should know about. A comprehensive list of all setup arguments can be found in Sec:ListSetupArgs alongside more detailed descriptions of these options.


Table 5.1: List of Commonly Used Setup Arguments
Argument Description
-auto this option should almost always be set
-unit=<unit> include a specified unit
-objdir=<dir> specify a different object directory location
-debug compile for debugging
-opt enable compiler optimization
-n[xyb]b=# specify block size in each direction
-maxblocks=# specify maximum number of blocks per process
-[123]d specify number of dimensions
-maxblocks=# specify maximum number of blocks per process
+cartesian use Cartesian geometry
+cylindrical use cylindrical geometry
+polar use polar geometry
+spherical use spherical geometry
+noio disable IO
+ug use the uniform grid in a fixed block size mode
+nofbs use the uniform grid in a non-fixed block size mode
+pm2 use the PARAMESH2 grid
+pm40 use the PARAMESH4.0 grid
+pm4dev use the PARAMESH4DEV grid
+uhd use the Unsplit Hydro solver
+usm use the Unsplit Staggered Mesh MHD solver
+splitHydro use a split Hydro solver