SMS:ESMF - Earth System Modeling Framework

The Earth System Modeling Framework (ESMF) is used to couple the following models:

• ADCIRC – STWAVE

To create a coupled simulation using ESMF, perform the following steps:

1. Right-click in the Project Explorer.
2. Choose the menu New Simulation | Hurricane .
3. Change the simulation name if desired .
4. Create the elements to be include in the simulation and drag tree pointers representing them into the simulation. The following items can be linked to an Hurricane simulation:
   • ADCIRC – STWAVE
     • ADCIRC Mesh
     • STWAVE Grid
     • Hurricane Coverage
     • PBL Wind Coverage
     • WAM Simulation
5. Right-click on the Hurricane simulation in the Project Explorer.
6. Choose the menu Properties. This action will create a new Hurricane coverage containing polygons that identify overlapping grid sections and areas of interest defined. It will then bring up a Hurricane Mode Project Summary property sheet containing four tabbed dialogs.
   • Overview
   • ESMF
   • Spatial View
   • Timeline
7. Right-click on the ESMF simulation and choose Export ESMF Files. SMS will create a folder named ESMF in the same directory as the *.sms file of the current project. Inside of the ESMF folder will be a folder and input files for the ESMF Simulation. The ESMF simulation folder name will be the same as the name given to the ESMF simulations in the Project Explorer.

ESMF Hurricane Overview

The dialog gives an overview of the components of the Hurricane simulation. It also allows designating the number of processors to be use by each model in the simulation.

• Simulation Name – Name of the Hurricane simulation as set in the Project Explorer.
• Properties – Properties of the Hurricane simulation .
  • Model Name – Name of models found in the simulation.
    • ADCIRC <mesh name> (1 required) – Name of the adcirc mesh used in the hurricane simulation.
    • STWAVE <grid name> (1 required) – Name of the stwave cgrid used in the hurricane simulation.
    • PBL <pbl cov name> (optional) – Name of pbl wind coverage used in the hurricane simulation.
    • WAM <wam sim name> (optional) – Name of wam simulation used in the hurricane simulation.
• Projection – Projection type of model.
  • Geo – Geographic (Latitude/Longitude)
  • STPL <#> – State Plane number .
  • Other – Other type of projection .
• Start Time – Temporal starting time of model.
• End Time – Temporal ending time of model.
• Threads – Number of processor threads used by model for computation or I/O processing.
• Function – Function used to adjust the processor threads used by each model.
  • Set Threads – Set the number of processor threads for:
    • Computational or I/O processing (ADCIRC).
    • Grid Partition I and J processing (STWAVE).
  • NONE – WAM and PBL use only one processor thread.

Hurricane ESMF

Set the ESMF simulation options in the Data Exchange and Area Mapping sections of the dialog

• Data Exchange
  • Model A – The meshed based model to be use (hard-coded to ADCIRC).
  • Data Exchange – Controls how data is exchanged between the two models (↔ bi-directional, → uni-direction A to B, ← uni-directional B to A).
  • Model B – The grid based model to be use (hard-coded to STWAVE).
  • Model A → B – How frequently the results of Model A are passed to Model B.
  • Units – Frequency units for A to B exchange (days/hours/minutes/seconds).
  • Model A ← B – How frequently the results of Model B are passed to Model A.
  • Units – Frequency units for B to A exchange (days/hours/minutes/seconds).
• Area Mapping
  • ID – Polygon identifier correlated to the ids visible in the main graphics window.
  • Mapping
    • Single – Model A exchanges data with a single instance of Model B.
    • Combined – Model A exchanges data with multiple instances of Model B. Model A can receive either the average or maximum values from the instances of Model B.
  • Option – If the "Mapping" field is set to "Single" and multiple grids overlap the identified polygon, this field allows selecting which grid will be used. If the "Mapping" field is set to "Combined", this field select how the data from the grids will be combined (Average or Maximum).

Hurricane Spatial View

This dialog provides a view of any grid boundaries (WAM and STWAVE), grid frames (PBL), and the ADCIRC mesh boundary associated with the simulation.

Hurricane Timeline

This dialog displays the timelines for each simulation (WAM, STWAVE, PBL, and ADCIRC) that are part of the hurricane simulation. The start and end times need to be set for each simulation individually.

Related Topics

• Model Specific Coverages
• Steering