Results Data Location

For the initializeOutputDataLocationRoot parameter, specify the root directory under which VELMA will place simulation output files for a particular model run.

Parameter Definitions

Parameter Name	Parameter Description
initializeOutputDataLocationRoot	Root directory under which to place per-simulation-run directories. If this property is left unspecified per- simulation-run directories for output files will be placedunderneath a default root created in the ../data subdirectory of the VELMA simulator's installationdirectory. When specified this property must be a fully- qualified path name. Whitespace in the name does nothave to be escape-delimited or double-quoted and the "/" can (and should!) be used as the pathseparator for both Unix and Windows paths. EXAMPLE: initializeOutputDataLocationRoot = C:/MyVelmaResults/VelmaResultsRoot For the above example subdirectories for each VELMA simulator run are placed underneath the directory "C:/My VelmaResults/VelmaResultsRoot/"

Parameter Name

Parameter Description

initializeOutputDataLocationRoot

Root directory under which to place per-simulation-run directories. If this property is left unspecified per- simulation-run directories for output files will be placedunderneath a default root created in the ../data subdirectory of the VELMA simulator's installationdirectory. When specified this property must be a fully- qualified path name. Whitespace in the name does nothave to be escape-delimited or double-quoted and the "/" can (and should!) be used as the pathseparator for both Unix and Windows paths. EXAMPLE: initializeOutputDataLocationRoot = C:/MyVelmaResults/VelmaResultsRoot For the above example subdirectories for each VELMA simulator run are placed underneath the directory "C:/My VelmaResults/VelmaResultsRoot/"

2.1 - Results Data Directory Name (Results data placed in directory with this name)

Specify a unique simulation filename in the value column for the run_index parameter.

Parameter Definitions

Parameter Name	Parameter Description
run_index	Watershed Name (used as core name for the simulation model run data files).

Use this parameter to specify a unique name for each simulation run that you do. For example, a useful run_indexname might include the watershed name, date and other identifiers that will make it easier to determine when asimulation configuration was built and how it differs from others. VELMA will use the run_index name to create:

- the Simulation Run Name listed in the upper left corner of the Run Parameters GUI
- the .XML file name that VELMA writes when the user saves a configuration file ("Ctrl-S", or "File/SaveConfiguration To VELMA XML File" using the menu at the top of the Run Parameters GUI). This XML filecontains all parameter names and values for the saved configuration. VELMA will not save this information if theuser does not save it in an XML file;
- the name of the subdirectory (along with the full path) to which model output data files are written.

2.2 - Results Directory Logfile Names

Specify a filename in the Value column for the globalStateLogFilename parameter.

Parameter Definitions

Parameter Name	Parameter Description
globalStateLogFilename	The name of the global log file. The Global log file records console messages emitted during a simulation run. When left blank ("") or commented-out no global logfile is created.
csvTraceLogFilename	The name of the trace log file. The trace log file records any low-level debugging messages emitted during a simulation run. When left blank ("") or commented-out notrace log file is created.

VELMA will use the globalStateLogFilename to record the stream of runtime console messages (see Consoletab) generated during a simulation run. This is optional, but we recommend creating a globalStateFileNameto help identify any problems with the simulator configuration file. For example, the console messagesrecorded in the globalStateLogFilename provide a complete, sequential log of runtime information aboutsuccessful or unsuccessful loading of input files, activation of disturbance events (harvest, fertilization,etc.), saving results to output directories/files, and so on.

///// IMPORTANT NOTE /////

For important additional details on configuring, saving and understanding simulator results, please see Appendix 4: Overview of VELMA Simulator Output.