SMS:CMS-Flow/Save Points

From XMS Wiki
Jump to navigationJump to search

This coverage is used to define special output locations from the computation.

Creating Save Points

Save points are cell-specific output that is used for CMS-Flow simulations. To create save points do one of the following:

  1. Create Save Points from an existing CMS_FLOW grid.
    • Click on the Select Grid Cell tool on the active grid.
    • Right-click on one or more selected cells and select Add Save Point(s)...
      The CMS Save Point Manager is displayed showing the new cell(s). If no save points existed prior to this, a new save point coverage is created and a link will appear under the grid in the tree item data.

      – OR –
  2. Right-click on Map Data and select New Coverage. Find CMS-Flow Save Points under CMS-FLOW and click Ok. A new save point coverage is created. Click on the new coverage so its active, then click the Create Feature Point tool. Click out some feature points. When finished, right-click on the new coverage and select Properties. The CMS Save Point Manager is displayed showing the new cells.

Save Point Manager Dialog

The CMS Save Point Manager dialog is a spreadsheet showing individual save point cells. By default the "Name" column will display the grid cell id (if the save point was created from a grid). Attributes such as hydro, sediment salinity and waves and be turned on/off by toggling the values in the column. If the save points were loading into sms from a *.sp file, the cell row will be highlighted to indicate this.

Storing Save Points in the *.cmcards File

When saving the *.sms project. the save points get stored in the *.cmcards file. An example looks like this:

!Save Points
HYDRO_OUTPUT_INTERVAL 5.0 MINUTES
SEDIMENT_OUTPUT_INTERVAL 5.0 MINUTES
SALINITY_OUTPUT_INTERVAL 5.0 MINUTES
WAVE_OUTPUT_INTERVAL 5.0 MINUTES
SAVE_POINT "6, 61" -2867.5 2022.0 HYDRO SEDIMENT WAVE
SAVE_POINT "20, 59" -2517.5 1966.0 HYDRO
SAVE_POINT "10, 31" -2767.5 1182.0 SEDIMENT
SAVE_POINT "11, 31" -2742.5 1182.0 SEDIMENT
SAVE_POINT "10, 32" -2767.5 1210.0 SALINITY
SAVE_POINT "11, 32" -2742.5 1210.0 WAVE


The SAVE_POINT is formatted [name][x location][y location][hydro (if on)][sediment (if on)][salinity(if on)][wave(if on)]

*.sp/*.spx File for Reading in Save Point Information

Simulation output data gets stored in *sp and *.spx file. The *.sp file is and individual output file. The *.spx file simply identifies all of the *.sp files that should be loaded for a simulation. An *.sp file looks something like this:

SAVE_POINT_OUTPUT eta
REFERENCE_TIME 2001/01/01 00:00 -0000 GMT
CREATION_DATE 2012/05/28 09:02 -0600 GMT
CMS_VERSION 4.00.11
TIME_UNITS HOURS
OUTPUT_UNITS 'm'
NUMBER_POINTS 2


NAME_BEGIN
'6, 61'
'20, 59'
NAME_END


XY_BEGIN
-2867.5000 2022.0000
-2517.5000 1966.0000
XY_END


SCALAR_TS_BEGIN
0.0000 0.0000E+00 0.0000E+00
0.0333 1.7545E-09 1.7434E-09
0.0667 1.4042E-08 1.3971E-08
0.1000 4.6679E-08 4.6524E-08
0.1333 1.1143E-07 1.1117E-07


SMS will read in a *.sp file and create a CMS-Flow save point coverage with the points.

Time Series Plot Wizard

SP files that are read into sms can be plotted into a time series curve. To view the curve do the following:

  1. Load a *.sp file into SMS
  2. Right-click on Display→Plot Wizard from the menu dialog.
  3. Select CMS Save Points from the plot type then click next.
  4. Change the coverage to Specified object(s).
  5. Now select the points that are to be plotted.
  6. Now select the Solutions and Datasets then click Ok.
  7. A time series plot is created.

Related Topics