setup
=====
The ``flmake setup`` command is typically first command in the FLASH workflow.  This 
command is a replacement for the FLASH setup script which is otherwise used.  It 
assembles the source code needed to build an executable for the simulation specified.
This source is placed within a ``setup/`` directory inside of the project directory.

This command takes many potential options depending on the simulation desired.  For 
a complete listing please execute ``flmake help setup``.  For a more detailed 
description of the individual options and variables please refer to the 
`FLASH User's Guide`_.

A distinct advantage that ``flmake setup`` has over the setup script is that this
version allows the user to setup from anywhere on the file system.  
*The user need not be in FLASH source directory!* Moreover, it will search the 
``simulations_path`` for simulation directories, not only ``Simulations/SimulationsMain/``
in the FLASH source directory.

**USAGE**:: 

    flmake setup <simulation-name> [options] [VAR=VALUE]...

The ``<simulation-name>`` argument is the name of a directory on the ``simulations_path``.  
For example, the ``Sedov`` problem is often used in testing.  Other options are 
available depending on the simulation chosen.

.. _FLASH User's Guide: http://flash.uchicago.edu/site/flashcode/user_support/flash4b_ug.pdf