Configuration Files and Setup

Setup Extension

The setup script (setup.py) parses Config files and creates two small header files with preprocessor directives ( object/common-defines.fh and object/flash_defines.fh ). The files are included into the database fortran code.

In this version of the setup all Configs are equal and are parsed in the order determined by Modules file. Note that the problem Config is always the first; I found it is convinient for debugging purposes. For example, variables can be set there in an arbitrary order.

New Keywords in Configuration Files

The Config files have additional keywords. Old keywords are described in Flash 1.6 Documentation ; they are still valid, but not mentioned here. Current list of additional keywords:

VARIABLE	specifies names, properties, and number of named variables. The variables appears in unk in the order they were found in the Config files. The properties of unnamed variables (species) are set to ADVECT/RENORM/NOCONCERVE. The pointer to the array of unk indexes for variables with given propertities can be accessed with dBaseVarIndex. The number of variables with the property is returned by dBasePropertyInteger.
NUMSPECIES	specifies number of unnamed variables (ionmax). The setup sets number of species to the first found in Configs; if setup found two different values it issues a warning and exit; if none of the Configs have it, the default is 1.
GUARDCELLS	specifies number of guard cells (nguard). The setup sets number of guardcells to the largest found in Configs; if none of the Configs have it, the default is 4.

List of Known Variables and Their Properties

VARIABLE dens ADVECT NORENORM CONSERVE # density VARIABLE velx ADVECT NORENORM NOCONSERVE # x-velocity VARIABLE vely ADVECT NORENORM NOCONSERVE # y-velocity VARIABLE velz ADVECT NORENORM NOCONSERVE # z-velocity VARIABLE pres ADVECT NORENORM NOCONSERVE # pressure VARIABLE ener ADVECT NORENORM NOCONSERVE # specific total energy (T+U) VARIABLE temp NOADVECT NORENORM NOCONSERVE # temperature VARIABLE gamc NOADVECT NORENORM NOCONSERVE # sound-speed gamma VARIABLE game NOADVECT NORENORM NOCONSERVE # energy gamma VARIABLE enuc NOADVECT NORENORM NOCONSERVE # nuclear energy gen. rate VARIABLE gpot NOADVECT NORENORM NOCONSERVE # grav. potential at current step VARIABLE gpol NOADVECT NORENORM NOCONSERVE # grav. potential at previous step VARIABLE mgw1 NOADVECT NORENORM NOCONSERVE VARIABLE mgw2 NOADVECT NORENORM NOCONSERVE VARIABLE mgw3 NOADVECT NORENORM NOCONSERVE VARIABLE mgw4 NOADVECT NORENORM NOCONSERVE VARIABLE mgw5 NOADVECT NORENORM NOCONSERVE