_____________________________________________________Introduction to MIMS ___________________________________________________Carolina Environmental Program An Introduction to the Multimedia Integrated Modeling System (MIMS) Examples for Integrating Environmental Models Kim Hanisak April 21, 2004

_____________________________________________________Introduction to MIMS ___________________________________________________Carolina Environmental Program MIMS Background (courtesy Steve Fine) lMIMS = Multimedia Integrated Modeling System lDeveloped by EPA ORD (Steve Fine, Steven Howard) lProvides user interface to support connecting and interchanging compatible models / modules lAid repetitive work, such as modeling multiple locations and sensitivity and uncertainty studies lProvide user interfaces for programs when desired (in most cases with no programming required) lManage computations on one or more computers lData management and manipulation

_____________________________________________________Introduction to MIMS ___________________________________________________Carolina Environmental Program Potential MIMS Benefits for Environmental Modelers lGUI for running Models (e.g., CMAQ and SMOKE) lAlternative to scripting lArchive and share configurations for simulations lAutomate repetitive work lManage model executions on remote computers lData Management (eventually) lJava implementation should make it portable lData Analysis Engine currently in development provides multiple plotting and analysis tools

_____________________________________________________Introduction to MIMS ___________________________________________________Carolina Environmental Program CEP’s Role lSupporting MIMS for Models-3 applications via CMAS lImplemented pieces of MIMS lUsing MIMS in other applications lTesting lIntegrated specific models within MIMS –CMAQ –SMOKE –TRIM (APEX, HAPEM, FATE) –REMSAD-ST –BENMAP –AIRNET (formerly called ControlNet)

_____________________________________________________Introduction to MIMS ___________________________________________________Carolina Environmental Program Projects lContainer for all of the building blocks (MIMS Objects) used in a study lBuilding blocks include modules, parameters, domain objects, and scenarios lMultiple projects are accessed via the Project Selection Window

_____________________________________________________Introduction to MIMS ___________________________________________________Carolina Environmental Program Key MIMS Building Blocks lModule: A software program, code fragment, or collection of programs to be executed by MIMS lParameter: A piece of information about a MIMS building block –(e.g. a file name, true false value, a grid) lDomain Object: –Represents a concept, thing, or part of the environment to be modeled (a noun) –Contains both information (parameters), and functions (processes) lScenario: Connects building blocks into a particular configuration to perform one or more model runs

_____________________________________________________Introduction to MIMS ___________________________________________________Carolina Environmental Program Container Structure within MIMS

_____________________________________________________Introduction to MIMS ___________________________________________________Carolina Environmental Program Project Window lManages multiple types of building blocks in the project lAvailable operations include: rename, duplicate, open, delete, import, export

_____________________________________________________Introduction to MIMS ___________________________________________________Carolina Environmental Program Module Window lSoftware program, scenario, or code fragment to be executed by MIMS (e.g. SMOKE, CCTM, BASINS, MM5, Java code fragment)

_____________________________________________________Introduction to MIMS ___________________________________________________Carolina Environmental Program Parameters lA piece of information about a building block –E.g. Input file, start date, run duration, AQM grid lEvery parameter has an associated type. Boolean Flag Chemical Mechanism Date Directory Distribution Duration File Floating Point Floating Point Series Grid Family Group Integer List Long Integer M3IO File Regular Grid String Choice String Typed File

_____________________________________________________Introduction to MIMS ___________________________________________________Carolina Environmental Program Parameters Table - Columns give parameter name, environment variable name, value, access to special GUIs, input vs. output, etc. - Operations on toolbar include: expand/compress, print, undo, redo, cut, copy, paste, paste values, delete, edit type, add new, clear value, edit description, set from file, copy top value, reorder

_____________________________________________________Introduction to MIMS ___________________________________________________Carolina Environmental Program Group Parameter lUsed to organize large numbers of parameters lE.g. Scenario File Management Parameters –Note: parameter language used for some values

_____________________________________________________Introduction to MIMS ___________________________________________________Carolina Environmental Program Special Parameter GUIs lSome parameters have special GUIs (e.g. Chemical mechanism, Grid Family, Distribution)

_____________________________________________________Introduction to MIMS ___________________________________________________Carolina Environmental Program Domain Objects lRepresent a concept, thing, or part of the environment to be modeled (should be a noun) –E.g. surface water, atmosphere, area source emissions lContain processes (behavior / functions) –E.g. evolve meteorology, process inventory lAlso contain parameters (data) –E.g. wind speed, temperature, start date, emissions inventory lUsed to pass information between modules –Input data is provided to its processes / module instances –Then processes are executed and output data is made available to other modules via the domain object (I.e. modules do not communicate directly)

_____________________________________________________Introduction to MIMS ___________________________________________________Carolina Environmental Program Domain Object Window

_____________________________________________________Introduction to MIMS ___________________________________________________Carolina Environmental Program Process lDescribes a single action to be executed by the MIMS framework. lWhen a module is assigned to a process to implement its functions, a copy is made called a Module Instance.

_____________________________________________________Introduction to MIMS ___________________________________________________Carolina Environmental Program Module Instance lUnchangeable copy (except parameter values) of the module for a single application lParameter values set independently from other instances

_____________________________________________________Introduction to MIMS ___________________________________________________Carolina Environmental Program Scenario lArranges all of the MIMS building blocks (domain objects, framework objects, processes/module instances and parameters) in a fashion meaningful to their application. lMultiple Scenarios can exist in a project (e.g. base case and control strategies) lLinkages from output files (parameters) to input files (parameters) are defined via Parameter Connections –These are used to determine execution order lExecutes processes / module instances lLocal and remote execution (via ssh) is supported

_____________________________________________________Introduction to MIMS ___________________________________________________Carolina Environmental Program Scenario Window Both tree and directed graph views are supported ( Data flows along the arrows) Execution status is show in circular icons

_____________________________________________________Introduction to MIMS ___________________________________________________Carolina Environmental Program Scenario Parameter Values lAccessible to all Domain Objects and Module Instances (thus good for global information)

_____________________________________________________Introduction to MIMS ___________________________________________________Carolina Environmental Program Parameter Connection lLinks Parameter values from one Module Instance or Domain Object to another (or to the Scenario). lExamples: –If the output Parameter from Process A is also the input Parameter for Process B, the Parameter Connection tells MIMS that Process A must run before Process B can run. –A Parameter Connection can be used to link multiple items to a common data source (I.e. a domain object or the scenario)

_____________________________________________________Introduction to MIMS ___________________________________________________Carolina Environmental Program Execution lExecution commands are on Scenario menu –Execute all, reset all, execute selected processes lExecution status is indicated –Not ready, ready, running, completed, failed lAfter execution, right click on process to: –View run script, view output log, view error log

_____________________________________________________Introduction to MIMS ___________________________________________________Carolina Environmental Program Local/Remote/Condor Execution lPrograms can be run on remote computers via SSH lInitial set up is required lA number of limitations and assumptions apply lCan also use Condor method

_____________________________________________________Introduction to MIMS ___________________________________________________Carolina Environmental Program Example Models-3 Project

_____________________________________________________Introduction to MIMS ___________________________________________________Carolina Environmental Program Framework Objects lRepresent a task or management function to perform, typically independent of environmental models (e.g. clear files from disk, iterate) lIterators can sequence multiple runs with: –Different time periods (e.g. days / months / years) –Different emission control strategies –Different model input values (e.g. Monte Carlo simulation) lCurrently available Iterators: –Temporal Iterator –Synchronized List Iterator –Simple Monte Carlo Iterator

_____________________________________________________Introduction to MIMS ___________________________________________________Carolina Environmental Program File Viewers lFile parameters can be viewed using default Windows programs (e.g. MS Word, notepad) lCustom viewers can be assigned in Administration Information (e.g. IOAPI file viewer) lAccessed by right clicking on file parameter and choosing View File lViewer is chosen based on file extension or file type (for Typed File Parameters)

_____________________________________________________Introduction to MIMS ___________________________________________________Carolina Environmental Program Plotters lAvailable for quick 2D plots of data –Histogram, time series, x-y lThe new analysis engine will provide more full featured plotting capabilities –Based on R –Program built around the analysis engine (DAVE) has been used with TRIM to visualize and analyze outputs from specific models – can build similar customized GUI’s around other models –Provides for scatter, categorized, discrete, and basic bar plots –Customizable plots (font, legends, bar size, tic marks, etc.)

_____________________________________________________Introduction to MIMS ___________________________________________________Carolina Environmental Program My MIMS Work lSMOKE –Integrated SMOKE 1.5 – waiting on funding to upgrade to 2.0 (includes Mobile6) lCMAQ –Integrated CMAQ v4.2.1 – can easily update for newest 4.3 release lPhoenix Framework –Created a framework for running AirNet (control strategies model), REMSAD-ST, and BenMAP (benefits model) and additional models for economic and environmental benefits lTRIM –Integrated Total Risk Integrated Methodology model parts including TRIM.Fate, HAPEM, and TRIM.Inhalation –Created scenarios to iterate over multiple pollutants, benefits, etc. lTraining –Teach introduction to MIMS course for Community Modeling and Analysis System (CMAS) lTesting –Created test suites to be used as new MIMS source code is created