README.1ST MULTIMED Multimedia Exposure Assessment Model Version 1.01 PREMED Interactive Data Preprocessor Program for MULTIMED Version 1.01 POSTMED Interactive Graphics Postprocessor Program for MULTIMED Version 1.01 June 1991 Center for Exposure Assessment Modeling (CEAM) U.S. Environmental Protection Agency Office of Research and Development Environmental Research Laboratory College Station Road Athens, Georgia 30613-0801 404/546-3549 or (FTS) 250-3549 __________________________________________________________________ DETAILED INSTALLATION INSTRUCTIONS NOTE: The symbol "" represents pressing the or carriage return key. Responses and key strokes that can be typed by the user are underlined with the hyphen character (-). This section provides a detailed step-by-step listing of the installation commands and procedures, and a text description of each step. Included in this procedure are o a detailed description of required and optional DOS commands o installation steps for users capable of utilizing GKS o optional installation steps to decompress all MULTIMED model FORTRAN source code files and DOS compile and link command files from a compressed transfer and storage file. To install the MULTIMED model and the PREMED and POSTMED programs on an IBM PC or compatible microcomputer system, execute the following step-by-step instructions to transfer the contents of all CEAM distribution diskettes to a hard disk drive and decompress the model and programs and all support files and programs. NOTE: It is important to notice that the installation instructions refer to the floppy diskette drive as "A:" and the hard disk drive as "C:". Since it is possible for machines to be configured differently, the user can make the appropriate substitution(s) when reference is made to drive(s) A: and/or C:. However, if the user has GKS, the MULTIMED installation procedure and command file assume that the GKS software is on drive C: in the \GKS sub-directory (i.e., C:\GKS). Remember, "" represents pressing the Enter or carriage return key and is not to be typed in by the user. Character and/or numeric responses that can be typed by the user are underlined with the hyphen character (-). First, create and/or edit the configuration/environment system file \CONFIG.SYS on the "boot" or start-up disk drive to contain the statements suggested in the DEVELOPMENT SYSTEM section. Remember, these changes will not be in effect until the system is re-booted (i.e. power off/power on or use the warm boot procedure by holding down the keys at the same time and pressing the key). Step Number and Description Command at DOS Prompt ___________________________ _____________________ 1 - Set the default drive to the C: hard disk: -- 2 - Create a MULTIMED sub-directory MKDIR \MULTIMED from the root directory: --------------- NOTE: The DOS Make Directory command MKDIR can be abbreviated with MD. 3 - Change default directory to the CHDIR \MULTIMED MULTIMED sub-directory: --------------- NOTE: The DOS Change Directory command CHDIR can be abbreviated with CD. 4 - Request verification of VERIFY ON disk-to-disk copy (optional): --------- 5 - Transfer files from the COPY A:\*.* C:*.* supplied distribution diskettes in ----------------- drive "A:" to the hard disk (drive "C:"). Make sure that there are at least 5.1M bytes of free space on drive C: for the run time files: NOTE: Repeat step 5 for each distribution diskette. 6 - Remove verification of copy VERIFY OFF (optional): ---------- 7 - Install run time support files INSTALL and decompress all essential ------- MULTIMED, PREMED, and POSTMED run time files and selected FORTRAN source code and support files from the compressed files: 8 - Refer to GRAPHICS SUPPORT section before continuing. - If user has GKS, go to step 9. - If user does NOT have GKS, go to step 10. 9 - Edit the GKS device driver C: configuration file C:\GKS\CGI.CFG -- where "edit" is the name of a text CD \GKS or file editor that saves files in ------- ASCII (text) format (optional): edit CGI.CFG ------------ C: -- CD \MULTIMED ------------ 10- Decompress all MULTIMED, INSTALLC PREMED, and POSTMED FORTRAN source -------- code files and compile and link command files from the compressed file (optional): 11- Execute the PREMED program and PREMED follow the menu and data entry ------ screen prompts and instructions. NOTE: To execute an interactive tutorial session a) press the <@> key (e.g., <2>) immediately after starting the PREMED program. A prompt box will be displayed at the top right-hand corner of the screen. b) at the prompt "Enter macro name," type the file name DETER.LOG or MONTE.LOG c) press the key d) follow the tutorial instructions (inserted/overlayed) on the monitor screen. 12- Execute the MULTIMED MULTIMED model using the test input data -------- files provided. The RUN TIME AND PERFORMANCE section contains a table that shows the file names for each of these input data files. 13- Compare test output file produced COMP TEST1.RUN TEST1.OUT (example: TEST1.RUN - as selected ------------------------ by the user) with the one supplied (TEST1.OUT). See the FILE NAME AND CONTENT and ROUTINE EXECUTION sections. NOTE: For MS DOS, the file compare command is "FC". 14- To continue the installation and testing of the MULTIMED model, execute steps 12 and 13 above for each test data file provided on the distribution diskettes. The RUN TIME AND PERFORMANCE section contains a table that shows the model name, file names, and options that are appropriate to use with each data file. 15- Refer to GRAPHICS SUPPORT section before continuing. - If user has GKS, go to step 16. - If user does NOT have GKS, skip step 16. 16- Execute the POSTMED program and POSTMED follow the menu and data entry ------- screen prompts and instructions. __________________________________________________________________ ROUTINE EXECUTION NOTE: The symbol "" represents pressing the or carriage return key. Responses and key strokes that can be typed by the user are underlined with the hyphen character (-). 1) Complete the installation instructions shown in the DETAILED INSTALLATION INSTRUCTIONS section to make all models, programs, and related files resident on the hard disk drive (usually designated as "C:") and modify the \CONFIG.SYS system environment file. This step needs to be completed only once for a given installation. 2) Set the default drive to the hard disk containing the MULTIMED sub-directory: (i.e., hard disk "C:") A:\> C: -- 3) Change the DOS default sub-directory to the MULTIMED sub-directory by using the DOS CD (change directory) command at the DOS system prompt: C:\> CD \MULTIMED ------------ 4) To execute the PREMED program, type: C:\MULTIMED> PREMED ------ Follow the menu and parameter options presented on the display screen. Execution of this program is optional. However, prior to execution, the MULTIMED model will require input data files that have been built either with PREMED or manually using a word processor or text editor that can save a file in ASCII (text) format. NOTE: To link the Ryan-McFarland RMFORT FORTRAN run time error message library to the MULTIMED model, type the following command at the DOS system prompt prior to executing either model: SET \RMFORT.ERR=C:\MULTIMED\RMFORT.ERR where "C:" is the disk drive designation where the MULTIMED model is installed. For example: C:\MULTIMED> SET \RMFORT.ERR=C:\MULTIMED\RMFORT.ERR -------------------------------------- 5) To execute the MULTIMED model, type: C:\MULTIMED> MULTIMED -------- The model will begin prompting the user for information needed for this run of the model the model will prompt the user one line at a time for the information that follows: Type name of input file: TEST1.IN -------- Type name of output file: TEST1.RUN --------- 7) To execute the POSTMED program, type: C:\MULTIMED> POSTMED ------- Follow the menu and parameter options presented on the display screen. Execution of this program is optional. However, prior to execution, this program requires a plot data file (see "Special Run Time File" in FILE NAME AND CONTENT section). This file can be generated by executing the MULTIMED model. 8) The response entered by the user for any file name must be a unique and valid DOS file name. A MULTIMED model input file name must be a valid file name either 1) as furnished with the distribution package (see FILE NAME AND CONTENT section) or 2) as designated and/or generated by the user using the PREMED program. This data file will be processed during the execution of the MULTIMED model. File names used for the input data and/or output listing files (except for the test input and output cases provided) are arbitrary, but must follow the rules for DOS file names. A file name should assist the user in identifying the contents or purpose of a file (e.g., INPUT.DAT, OUTPUT.LST). Any MULTIMED, PREMED, or POSTMED file name can be from 1 to 8 characters and can have an optional 1 to 3 character file name extension. Any characters beyond 8 in the file name or beyond 3 in the file name extension will be truncated by the DOS operating system. See the DOS Reference Manual for further information on file names and disk file input/output procedures, rules, and commands. This implementation of the PREMED and POSTMED programs and the MULTIMED model have the same function and will follow the same execution sequence as the current VAX/VMS implementation for the same release versions. __________________________________________________________________ RUN TIME AND PERFORMANCE NOTE: The symbol "" represents pressing the or carriage return key. Responses and key strokes that can be typed by the user are underlined with the hyphen character (-). The following run times (approximate) were observed using the test data files furnished with the distribution version of the MULTIMED model. Remember that these times were obtained using test data files that may not be representative of a "real world" problem and/or data. The test data files have been furnished for testing the installation of the MULTIMED model. In general, these input test data files are not intended to be representative of full scale model simulations. They were developed to test the installation of significant sections of model code. The following run times were produced on an IBM PC/AT 80286 microcomputer running under DOS 3.30 and using 640k bytes of random access memory, a 338 megabyte hard disk, an 8 megahertz clock, and an 80287 math coprocessor chip. ** Test Data Files for MULTIMED Test Runs Approx. Input Output Run Time File Name File Name hr:min:sec _________ _________ __________ a) TEST1.IN TEST1.OUT 00:22:16 b) TEST2.IN TEST2.OUT 00:04:26 c) TEST3.IN TEST3.OUT 00:18:16 d) TEST6.IN TEST6.OUT 00:11:15 Note that program run time and performance can be affected by many microcomputer system and program parameters such as o available disk space o available memory o application program overlay structure o CONFIG.SYS file options and parameter values o disk storage fragmentation o use of a math coprocessor chip __________________________________________________________________ ADDITIONAL INFORMATION The document README.TOO contains additional information: o documentation o distribution diskettes o file names and content o development system o graphics support o detailed installation o routine execution o run time and performance o minimum file configuration o modification o technical help contacts o disclaimer o bibliography ######################### SHT/sht - June 1991 - C:\MULTIMED\README.1ST