The following lists environment variables that can effect the way MESA runs.
Location of the MESA source code.
Location of the GYRE source code (only needed if running GYRE). If
you haven’t moved it from the
$MESA_DIR then set as
Number of threads MESA will run with. Should be between 1 and 2 * number of logical cores.
Location of the SDK.
Location where MESA will store and read cache files. See star_job.defaults cache directories for more details. Beware when using this and changing MESA versions; best practice would be to remove its contents upon changing versions.
Location where MESA will write the cache file temporarily before moving to
$MESA_CACHES_DIR. If set, this folder MUST be unique for each
MESA run. If not set defaults to
Location of the OP_MONO data files.
See the radiative levitation test suite
for more details.
By default MESA will look for a file called
inlist in the local
working directory for its configuration. This overrides the filename
and can point to a file somewhere else.
If set, this shell variable will override the inlist variable
If set to either
TRUE MESA will act as if the user had set
pgstar_flag=.true. in their inlist.
If set to either
FALSE MESA will act as if the user had set
pgstar_flag=.false. in their inlist.
If set to anything else (or not set at all) MESA will use the value as set in the inlists.
If set then when running a test_suite case, then certain optional inlists will be skipped. If not set, then all inlists will be run.
Useful things that are not environment variables.
Command line arguments
./star can accept one argument that overrides the location of the
inlist file. This will also override the environment variable
Empty file. If present in
$MESA_DIR then no compiling is done when
./install is invoked.
If present in a sub folder (e.g
$MESA_DIR/eos) then no compiling is done in the sub-folder.
Empty file. Similar to
skip_build, but this will skip the compile time tests.
If placed in a sub-folder, then only the tests in that folder are skipped.
These options are for developers; you do not need them for normal usage. If you use them and things break then stop using them.
Bypass checks done at compile time for checking if
$MESA_DIR is set.
If set, then we do not use the temp cache mechanism, writing cache
files directly to the
If set, disables the generation of backtraces when we call
This is mostly helpful on macs, as they don’t generate useful backtraces.
When set to 1 this will turn on a series of compile time checks as well as certain inlist options designed to catch floating point exceptions. This should not be set during a normal run.
If set to a value other than 1, then
time_delta_coeff will be multiplied by its value, and
max_model_number will be multiplied by its inverse.
For example, this can be set to 0.5 to double the space and time resolution
as well as the maximum model number.
During a normal run, this should be either set to 1, or not set.