run
===
The ``flmake run`` command executes a FLASH simulation from a binary generated by 
the build command and a runtime parameters ``flash.par`` file.  The runtime 
parameters file is initialize by the setup command but may be altered by the 
run control ``flashrc.py`` file.  This is a Python file which is located within the 
project directory.  If this file contains a parameters dictionary, 
the original ``flash.par`` is updated with these items.  If the run control file
instead contains a parameters function which returns a dictionary, this return 
value is used to update ``flash.par``.

The run command automatically generates a universally unique id for this specific 
run of FLASH.  This id ensures that runs from various systems may be placed correctly
identified and is needed for ensuring total reproducibility.  The run is executed 
within a new directory within the project that is named by concatenating the 
``run_dir_prefix`` with the run id.

**USAGE**:: 

    flmake run [options]

All supplemental options are passed down to ``MPIRUN_CMD`` as specified with is flmake
metadata.  This allows you to, among various other options, change the number of 
processors to run FLASH with.  See ``flmake help run`` for a full listing of these options.

examples
~~~~~~~~
A sample ``flashrc.py`` file that changes the runtime parameters present in 
the ``<rundir>/flash.par`` file::

    import numpy as np

    default_laser_power = np.array([[0.0, 4.69724771e+11, 3.22935780e+11, 4.69724771e+10, 0.0]])

    parameters = {
        # Use HLLC Riemann Solver
        "RiemannSolver": "HLLC",
        "order": 3,
        "slopeLimiter": "mc", # mc or limited
        "cfl": 0.4,

        # adjust laser power
        "ed_power": default_laser_power * 0.5,

        # Always use 
        "addThermalFlux": False,
        "plot_var": ["dens", "depo", "tele", "tion", "ye  ", "sumy", "pele", "targ"],
        }