The Analysis Engine has been packaged within the MIMS Framework. The MIMS framework relies on the operation of other publicly available software programs (Java Runtime Environment and R), so these programs must also be installed to operate the Analysis Engine. The MIMS framework is designed to operate in the Java Runtime Environment (version 1.4 or higher). Below you will find instructions on:
Checking your current version of the Java Runtime Environment in Windows
Installing the Analysis Engine for Windows Systems
Installing the Analysis Engine for UNIX Systems
Installing R Statistical Software
Checking your current version of the Java Runtime Environment in Windows:
Using the Windows Start menu:
Select Find
Select the File or Folder menu option
Search for java.exe on local drives. Check the Include subfolders check box and then click the Find Now button.
If you find the file, use a DOS prompt to put yourself in the file's directory. If you have more than one copy, check the one in the Windows or WINNT directory first.
If, for example, java.exe is in the folder c:\Windows\system\, you would type
> cd windows\system
at a command prompt (i.e., a DOS window). Note that in DOS, file names must be reduced to 8 characters or fewer.
Then type:
> java -version
at the command prompt. The Analysis Engine has not been tested with versions higher than Java 1.4.
Installing the Analysis Engine for Windows Systems:
Install the Java 1.4 Java Runtime Environment (for non-developers) or Java Development Kit, available for free from Sun at http://java.sun.com/j2se/. Note that some problems have been observed with Java 1.4.1 on Windows XP operating systems, and Java 1.4.2 is recommended.
Download the MIMS Framework installation file from http://www.epa.gov/asmdnerl/mims/software/index.html.
Execute the downloaded zip file (mims_rel.exe) or run PKUNZIP on (mims_rel.zip) to extract the MIMS files.
Edit the batch file bin\runTable.bat to set the TABLEAPPHOME variable to the directory where MIMS is installed (default is c:\mims).
Put Java 1.4 (or higher) and the R software on the path (using system properties on NT; this will not take effect until after a system reboot) or edit runTable.bat to explicitly refer to the Java and R executables. The Java installations from Sun contain a bin directory, which contains the Java executable.
After the R statistical software is installed (see below), double-click runTable.bat or its shortcut (Windows 98/Me) to start the Analysis Engine.
On-line help is available.
Installing the Analysis Engine for UNIX Systems and MacOS:
Have the system administrator install the Java 1.4 Java Runtime Environment (for non-developers) or Java Development Kit, available for free from Sun at http://java.sun.com/j2se/.
Download the MIMS installation file from http://www.epa.gov/asmdnerl/mims/software/index.html.
Expand and untar the downloaded compressed tar file.
Edit the shell script file bin/runTable.sh to set the TABLEAPPHOME variable to the directory where the MIMS framework is installed (default is ${USER}/mims). For MacOS installations, the path should be edited to "/Users/${USER}/mims" to take advantage of the usual installation path. Also make sure that the path to the Java executable (variable "JAVA") is correct in the runTable.sh script.
Put Java and R on the path and set the JAVA_HOME environment variable to point to the installation of Java.
After the R statistical software is installed (see below), execute the runTable.sh to start the Analysis Engine.
On-line help is available.
Installing R Statistical Software:
The R software provides options for plot types, layouts, and output formats not found in the Analysis Engine or the MIMS framework alone. The Analysis Engine will work only if R has been installed and is in the runTable.bat paths.
Click "Download CRAN" at http://www.r-project.org/ and choose the appropriate link and operating system. Then download the base version of the R statistical software. The R versions 1.9.1 and 2.0.1 have been successfully used with MIMS.
Read the Readme file for instructions on installing the package. Then install the base R package according to these instructions. Note the directory where the package is installed.
Open the runTable.bat file with a text editor (e.g., Microsoft WordPad). In the line following the statement "add location of R executable to PATH (used for generating plots)," be sure that the directory path matches the one you specified in Step 2. Save and close this file.
For on-line Help within the Analysis Engine, select the Help/User Guide menu option.
