Influential environment variables and options
DUST_WORKDIR_ROOT
: an environment variable which sets
the root working directory for compilation of your
code. Normally, we use the session-specific directory, which is a good
choice. You might want to change this in a few cases:
- You want to generate models from a process and you want these to outlive the lifetime of that process (e.g., for running models on an HPC)
- You want to cache the compilation across sessions
If you set this environment variable, then we’ll create models here,
each with a name in the pattern dust_<hash>
where
<hash>
is the hash of the generated code. This means
that if your model changes we’ll still recompile it.
DUST_QUIET
: an environment variable which controls the
default level of verbosity when compiling dust models. Set this to a
truthy value (e.g., TRUE
) to change the default. This can
always be overridden by providing a value for the quiet
argument to dust_compile()
and
dust_package()
.
DUST_DEBUG
: an environment variable which controls how
pkgload::compile_dll()
compiles the C++ code. Set this to a
truthy value (e.g., TRUE
) to disable optimisation, which
allows faster compilation at the cost of slower runtime. This can be
overridden by the debug
argument to
dust_compile()
.