trick/trick_source/sim_services/ExternalApplications/docs/mm.dox_in
Alex Lin 19025d77ad Standardize directory names
Reorganized.  Created a new top level include directory that will hold all of Trick's header files. Moved all of the Trick headers to this directory.  Created a libexec directory that holds all of the executables that users don't need to execute directly.  Changed all of the executables remaining in bin to start with "trick-".  In the sim_services directories changed all source files to find the Trick headers in their new location.  Since all of the include files are gone in sim_services, removed the src directories as well, moving all of the source files up a level.  Moved the makefiles, docs, man, and other architecture independent files into a top level share directory.  Renamed lib_${TRICK_HOST_CPU} to lib64 or lib depending on the platform we're currently on.

refs #63
2015-06-09 08:44:42 -05:00

104 lines
4.1 KiB
Plaintext

/**
* @page MonteMonitorPage
* @section LEVEL3 Monte Monitor
*
* Monte Monitor (hereafter referred to as MM) is a graphical user interface that allows users to view and modify the states
* of slaves in a Monte Carlo simulation.
*
* @section LEVEL4 Launching
*
* MM can be launched from the command line via:
*
* @code ${TRICK_HOME}/bin/mm [options] @endcode
*
* Pass <code>--help</code> for a description of available options. For additional launching options, see
* @ref ExternalApplicationsAutomaticLaunching "Automatically Launching Applications".
*
* @section LEVEL4 The GUI
*
* The GUI pictured below may have a different look and feel based on the architecture of the machine on which it is running,
* but the functionality will remain the same.
*
* @image html ../../../doxygen/images/MonteMonitor.jpg
* @image rtf ../../../doxygen/images/MonteMonitor.jpg
*
* @section LEVEL5 Progress Bar
*
* The progress bar displays a visual and textual representation of how far the Monte Carlo has progressed. The format is
* <code>\<resolved runs\> / \<total runs\> (\<percent resolved\>)</code>.
*
* @section LEVEL5 Slave Table
*
* The slave table displays information on each of the slaves. From left to right, this information is:
*
* <ul><li><b>ID</b><br>
* The unique ID of the slave.
*
* <li><b>Status</b><br>
* The current status of the slave. It can be one of:
*
* <ul><li><b>Unitialized</b><br>
* The slave has yet to be spawned.
*
* <li><b>Initializing</b><br>
* The slave has been spawned, and the master is waiting for initialization information from it. Once initialized, the
* slave will be in the <code>Ready</code> state. Since Monte Carlo cannot determine if slaves spawn correctly, slaves
* that fail to spawn will remain in this state for the duration of the Monte Carlo.
*
* <li><b>Ready</b><br>
* The slave is awaiting a dispatch.
*
* <li><b>Running</b><br>
* The slave is processing a run. Once completed, the slave will be in the <code>Ready</code> state.
*
* <li><b>Stopping</b><br>
* The slave is processing a run. Once completed, the slave will be in the <code>Stopped</code> state.
*
* <li><b>Stopped</b><br>
* The slave is not accepting dispatches.
*
* <li><b>Finished</b><br>
* No runs remain to dispatch to the slave.
*
* <li><b>Unresponsive - Running</b><br>
* The slave has timed out and is also in the <code>Running</code> state.
*
* <li><b>Unresponsive - Stopping</b><br>
* The slave has timed out and is also in the <code>Stopping</code> state.
*
* <li><b>Disconnected</b><br>
* The connection to the slave has been lost.
*
* <li><b>Unknown</b><br>
* MM could not interpret the state of the slave as reported by the Monte Carlo simulation.
*
* </ul><li><b>Machine Name</b><br>
* The name of the machine on which the slave is running.
*
* <li><b>Current Run</b><br>
* The ID of the run the slave is currently processing.
*
* <li><b>Total Runs</b><br>
* The number of runs the slave has completed.
*
* @section LEVEL5 New Slave Field
*
* The new slave field allows the user to add a new slave by machine name while the Monte Carlo is running. Note that slaves
* that fail to spawn for any reason (a bad machine name, for instance) will nevertheless appear in the slave table with a
* status of <code>Initializing</code>.
*
* @section LEVEL5 Connection Panel
*
* The connection panel displays host and port information when MM is connected to a simulation, and allows the user to
* specify these parameters when disconnected.
*
* @section LEVEL4 Starting and Stopping
*
* Slaves can be started and stopped while the Monte Carlo is running via the <code>Monte Carlo</code> and
* <code>Slaves</code> menus. Selecting a command from the <code>Monte Carlo</code> menu is equivalent to applying the same
* command from the <code>Slaves</code> menu to all slaves in the slave table. Stopping a slave will prevent any further
* runs from being dispatched to it after its current dispatch completes. Starting a slave will resume dispatches to it.
*
* @see Trick::MonteMonitor
*/