SMS:CSTORM-MS: Difference between revisions

From XMS Wiki
Jump to navigationJump to search
No edit summary
 
(19 intermediate revisions by the same user not shown)
Line 1: Line 1:
__NOINDEX__
{{Not Released}}
{{Not Released}}


==Create HPC scripts==
The model is currently only available to model developers. If you are a developer working with Aquaveo, see the [http://www.xmsdevwiki.com/wiki/SMS:CSTORM-MS Aquaveo developers wiki]. (log in required)
[[Image:Create HPC Scripts.jpg|thumb|500 px|''Create HPC Script'' dialog]]
CSTORM-MS is a set of models organized into a system that work together to create models relative to ''coastal storms''. Many of the models in the system are very compute intensive models and may run for long periods of time. Often it is desirable to run these models in a HPC (supercomputer) environment to take advantage of many processors.
 
Some users may not be as familiar with the HPC environment or want a system to help regenerate scripts as needed. The '''Create HPC Scripts''' tool within SMS helps users create scripts from parameters. The parameters may be changed and the scripts regenerated as necessary. The parameters can be saved with the project, exported/loaded into other projects, and stored as the default parameters for future CSTORM-MS simulations.
 
The '''Create HPC Scripts''' tool is accessed by right-clicking on the CSTORM-MS simulation and selecting the '''Create HPC Scripts''' command.
===Platforms===
Platforms are the term used for a collection of script parameters because often the scripts will be created to target a specific HPC platform. However, a user could create multiple sets of scripts for the same platform if there are different run parameters for different types of simulations. The user can create, delete, or copy the scripts from one platform to a new platform.
 
===Programs===
Each of the programs within the CSTORM-MS system has its own script within the platform. Each program has its own run requirements which are handled through SMS defined variables (see below).
 
===Variables===
Variables are used to modify the script text for export. Variables can make it easier to change a script by identifying the items that should be changed in a script and giving a description for the variable. When the script is generated, every instance of the variable within the script will be replaced with the text in the 'value' column. It is recommended but not required that variables use a naming convention similar to the SMS defined variables for easy identification.
 
====SMS defined variables (program specific)====
SMS defined variables provide information to scripts based upon simulation parameters. These parameters are specified elsewhere but may need to be incorporated into individual scripts. One example of this type of variable is the number of processors to use for ADCIRC. SMS knows how many processors ADCIRC wants to use and can automatically make this part of the script.
 
====User defined variables (global)====
User defined variables allow scripts to be generated generically and give descriptions for the script parameters needed. User defined variables are global (shared between all programs/platforms). If you wish to have a similar variable specified differently for separate programs, add the program name to your variables. For example, if PBL and ADCIRC both needed a walltime but it should be different use $PBL_WALLTIME and $ADCIRC_WALLTIME rather than $WALLTIME within your scripts.
 
==Model Project Summary==
The ''ERDC-CSTORM-MS Model Project Summary'' dialog is accessed by right-clicking on the CSTORM-MS simulation and selecting '''Properties''' from the menu. The dialog has several tabs and options as follows:
===Overview===
[[Image:CSTORM Model Project Sum Over.jpg|thumb|450 px|''ERDC-CSTORM-MS Model Project Summary'' dialog showing the ''Overview'' tab]]
The dialog gives an overview of the components of the Hurricane simulation. It also allows the user to designate 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 explore
* Properties – Properties of the Hurricane simulation
<blockquote>
* Model Name &ndash; Name of models found in the simulation
** ADCIRC <mesh name> (1 required) &ndash; Name of the adcirc mesh used in the hurricane simulation.
** STWAVE <grid name> (1 required) &ndash; Name of the stwave cgrid used in the hurricane simulation.
** PBL <pbl cov name> (optional) &ndash; Name of pbl wind coverage used in the hurricane simulation.
** WAM <wam sim name> (optional) &ndash; Name of wam simulation used in the hurricane simulation.
</blockquote>
* Projection &ndash; Projection type of model.
<blockquote>
* Geo &ndash; Geographic (Latitude/Longitude)
* STPL <#> &ndash; State Plane number
* Other &ndash; Other type of projection
</blockquote>
* Start Time &ndash; Temporal starting time of model.  
* End Time &ndash; Temporal ending time of model.  
* Threads &ndash; Number of processor threads used by model for computation or I/O processing.
* Function &ndash; Function used to adjust the processor threads used by each model.
<blockquote>
* Set Threads &ndash; Set the number of processor threads for:
** Computational or I/O processing (ADCIRC)
** Grid Partition I and J processing (STWAVE)
* NONE &ndash; WAM and PBL use only one processor thread.
</blockquote>
 
:{|
|-
|[[Image:CSTORM Set Thread1.jpg|thumb|none|left|200 px|CSTORM-MS ''Set Thread Count'' dialog for ADCIRC]]
|[[File:CSTORM St Thread2.jpg|thumb|none|left|200 px|CSTORM-MS ''Set Thread Count'' dialog for STWAVE]]
|}
 
===ESMF===
[[Image:CSTORM Model Project Sum ESMF.jpg|thumb|450 px|''ERDC-CSTORM-MS Model Project Summary'' dialog showing the ''ESMF'' tab]]
* Set the ESMF simulation options in the ''Data Exchange'' and ''Area Mapping'' sections of the dialog
<blockquote>
* Data Exchange
<blockquote>
* Model A &ndash; The meshed based model to be use (hard-coded to ADCIRC)
* Data Exchange &ndash; Controls how data is exchanged between the two models (&harr; bi-directional, &rarr; uni-direction A to B, &larr; uni-directional B to A)
* Model B &ndash; The grid based model to be use (hard-coded to STWAVE)
* Model A &rarr; B &ndash; How frequently the results of Model A are passed to Model B
* Units &ndash; Frequency units for A to B exchange (days/hours/minutes/seconds)
* Model A &larr; B &ndash; How frequently the results of Model B are passed to Model A
* Units &ndash; Frequency units for B to A exchange (days/hours/minutes/seconds)
</blockquote> </blockquote>
* Area Mapping
<blockquote>
* ID &ndash; Polygon identifier correlated to the ids visible in the main graphics window.
* Mapping
<blockquote>
* Single &ndash; Model A exchanges data with a single instance of Model B
* Combined &ndash; 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.
</blockquote>
* Option &ndash; If the "Mapping" field is set to "Single" and multiple grids overlap the identified polygon, this field allows the user to select which grid will be used. If the "Mapping" field is set to "Combined", this field allows the user to select how the data from the grids will be combined (Average or Maximum.)
</blockquote>
 
===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.
:[[Image:CSTORM Model Project Sum Spatial.jpg|thumb|none|left|450 px|''ERDC-CSTORM-MS Model Project Summary'' dialog showing the ''Spatial View'' tab]]
 
===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.
:[[Image:CSTORM Model Project Sum.jpg|thumb|none|left|450 px|''ERDC-CSTORM-MS Model Project Summary'' dialog showing the ''Timeline'' tab]]


==Related Topics==
==Related Topics==
*[[SMS:ESMF - Earth System Modeling Framework|ESMF - Earth System Modeling Framework]]
*[[SMS:ESMF - Earth System Modeling Framework|ESMF &ndash; Earth System Modeling Framework]]




{{Template:Navbox SMS}}
{{Template:Navbox SMS}}
[[Category:SMS Dev|C]]
[[Category:CSTORM-MS]]
[[Category:Archived]]
[[Category:Upcoming feature]]
[[Category:External Links]]

Latest revision as of 14:41, 4 June 2019

The model is currently only available to model developers. If you are a developer working with Aquaveo, see the Aquaveo developers wiki. (log in required)

Related Topics