Command Line Approach

 

This manual focuses on the operation of the Analysis Engine through windows and dialog boxes.  However, many of the plotting functions may also be carried out by line commands.  Line commands are useful for repetitive production of plots and are most often used when another program (e.g., the MIMS Framework) produces the plots as part of a series of actions.

To produce and save plots automatically, a template must first be saved to define the configuration.  This configuration file should be established through the user interface system.  The configuration specifications include formatting, filtering, sorting, and plotting parameters.  The configuration file path and name will then be included in the command line arguments.

The command line should then appear as follows:

java -classpath <classpath> gov.epa.mims.analysisengine.table.TableApp <required arguments> <optional arguments>

The <classpath> argument specifies the directories and compressed files (e.g., *.jar files) that contain all of the class files needed for the application.  To run the Analysis Engine, the <classpath> argument likely needs to appear as:

c:\mims\lib\mims.jar;c:\mims\lib\analysisengine_6_8.jar;c:\mims\lib\java_cup.jar;c:\mims\lib\colt.jar;c:\mims\

if c:\mims is the directory where the MIMS Framework and Analysis Engine are installed.

Descriptions of the required arguments are included below:

Syntax

Explanation

-fileNames <name>

<name> represents the input data file with information to be plotted.  At least one file name must be specified.

-fileType <type>

Description of the input data file format.  Valid types are Comma Separated File, Tab Delimited File, SMOKE Report File, TRIM.FaTE Sensitivity File, TRIM.FaTE Monte Carlo Inputs, COSU File, Fixed Column Width Format, Attribute-Relation File Format, DAVE Output File

-delimiter <delimiter>

<delimiter> represents a single character, such as a comma, tab, or | (pipe).  This syntax is required only for DAVE Output file types and is optional for SMOKE Report File types

-hRows <noOfRows>

NoOfRows represents the number of header rows in the input data file; required only if file type is set to Comma Separated File or Tab Delimited File

Descriptions of the optional arguments are included below:

Syntax

Explanation

-applyTableConfig <true/false>

When set to true, the plots are displayed with the filter/sort/format statements applied.  When set to false, the entire data set is used in the plot.  The default is true.

-configFile <path>

<path> represents the complete path and file name for the configuration file.  The configuration file specifies the filters, sorting, and formatting that should be applied to the input data file.  If -configFile is not specified, no configuration file is loaded and the user interface will appear to allow you to build the plots.

-exportFile <FileName>

<FileName> represents the name of the output plot image.  The -outputDir, -exportFile, and -exportFormat specifications together specify the full directory and file name path for the output.

-exportFormat <Format>

<Format> specifies the file type that should be created for the plot image.  Valid choices are PS, PDF, JPEG, PNG, or PTX.  The default is PDF.

-outputDir <directory>

<directory> represents the destination directory to which the plot images are saved.  If -outputDir <directory> is not specified, the user interface is displayed.

-showGUI <true/false>

This argument with an entry of true or false determines whether or not the user interface is shown.  The default setting is false.

-ShowPlots <true/false>

If showGUI is set to True, ShowPlots specifies that the plots be displayed using the Config File specified.  If show GUI is set to False, -ShowPlots has no effect.  The default setting for -ShowPlots is false.

-startPos <startidx>

<startidx> represents the first character of the file name that will be used to name the table during import.

-endPos <endidx>

<endidx> represents the first character of the file name that will be used to name the table during import.