CMS-Flow Boundary Conditions/WSE Nesting
Extracted Water Levels from a Parent Simulation
CMS supports automated one-way nesting within parent CMS and ADCIRC models. When using this feature, the CMS automatically extracts the boundary condition information from the parent model solution. The user only has to specify to point to the boundary cellstring and the location and name of the parent model simulation. The user may force the CMS with either water levels or water levels and velocities extracted from the parent simulation.
Example 1: Extracting water levels from parent ADCIRC simulation
Since the ADCIRC simulation files do not contain information on the starting date or horizontal projection, this information needs to be provided in the model input.
BOUNDARY_BEGIN
- NAME "Nested Boundary"
- CELLSTRING "Flow_mp.h5" "PROPERTIES/Model Params/Boundary"
- WSE_BEGIN !All settings for wse at the boundary set here
- OFFSET 0.1 m !optional, positive is upwards
- TIME_INTERP_ORDER 2 !optional, temporal interpolation
- SPACE_SMOOTH_ITER 1 !optional, spatial smoothing iterations
- SPACE_SMOOTH_WIDTH 3 !optional, spatial smoothing window width
- WSE_END
- PARENT_BEGIN !All settings for parent simulation set here
- GRID_FILE "..\ADCIRC_Regional\fort.14"
- WSE_SOL_FILE "..\ADCIRC_Regional\fort.63" !Optional
- STARTING_DATE_TIME 2012-12-01 00:00:00 UTC
- HORIZ_PROJ_BEGIN !Optional, assumed if not specified
- DATUM NAD83 !NAD27 | NAD83 | LOCAL
- SYSTEM GEOGRAPHIC !UTM | STATE_PLANE| GEOGRAPHIC | LOCAL
- UNITS DEGREES !METERS | FEET | DEGREES | etc.
- HORIZ_PROJ_END
- PARENT_END
BOUNDARY_END
Example 2: Extracting water levels from parent CMS simulation
If a parent CMS simulation is used, all of the necessary information including horizontal projection, grid file name, and water level solution file are extracted from the CMS Card File.
BOUNDARY_BEGIN
- NAME "Nested CMS Boundary"
- CELLSTRING "Flow_mp.h5" "PROPERTIES/Model Params/Boundary"
- WSE_BEGIN
- WSE_SOLUTION PARENT !required
- WSE_OFFSET 0.1 m !optional, positive is upwards
- TIME_INTERP_ORDER 2 !optional, temporal interpolation
- SPACE_SMOOTH_ITER 1 !optional, spatial smoothing iterations
- SPACE_SMOOTH_WIDTH 3 !optional, spatial smoothing window width
- WSE_END
- PARENT_BEGIN
- CONTROL_FILE "..\CMS_Regional\Flow_Reg.cmcards"
- !All other settings are obtained from the control file
- PARENT_END
BOUNDARY_END
Because the CMS-Flow Control (Card) File contains all of the information regarding the horizontal projection, simulation time period, and output files, nothing else needs to be specified except the parent CMS-Flow simulation Card File.
Nested Water Level and Velocity Boundary Condition
CMS supports automated one-way nesting within parent CMS and ADCIRC models. When using this feature, the CMS automatically extracts the boundary condition information from the parent model solution. The user only has to specify to point to the boundary cellstring and the location and name of the parent model simulation. The user may force the CMS with either water levels or water levels and velocities extracted from the parent simulation.
If the ADCIRC simulation is 3D, it is important to export the depth- averaged current velocity file (fort.63 or *_.h5) so that this file can be used for current velocity extraction. Additional support for other models is currently in development. A description of both with examples is provided below.
Example 3: Extracting water levels and velocities from parent ADCIRC simulation.
BOUNDARY_BEGIN
- NAME "Nested ADCIRC wse and velocity boundary"
- CELLSTRING "Flow_mp.h5" "PROPERTIES/Model Params/Boundary"
- WSE_BEGIN
- WSE_OFFSET 0.1 m
- TIME_INTERP_ORDER 2 !optional, temporal interpolation
- SPACE_SMOOTH_ITER 1 !optional, spatial smoothing iterations
- SPACE_SMOOTH_WIDTH 3 !optional, spatial smoothing window width
- WSE_END
- VEL_BEGIN
- VEL_END
- PARENT_BEGIN
- GRID_FILE "..\ADCIRC_Regional\fort.14"
- WSE_FILE "..\ADCIRC_Regional\fort.63"
- VEL_FILE "..\ADCIRC_Regional\fort.64"
- STARTING_DATE_TIME 2012-12-01 00:00:00 UTC
- HORIZONTAL_PROJECTION_BEGIN !Optional, assumed if not specified
- DATUM NAD83 !NAD27 | NAD83 | LOCAL
- SYSTEM GEOGRAPHIC !UTM | STATE_PLANE| GEOGRAPHIC | LOCAL
- UNITS DEGREES !METERS | FEET | DEGREES | etc.
- HORIZONTAL_PROJECTION_END
- PARENT_BEGIN
BOUNDARY_END
It is noted that since the ADCIRC simulation files do not contain information on the starting date or horizontal projection, this information should to be provided in the model input. If the horizontal projection is not specified, then it is assumed to be NAD83 Geographic in degrees.
In the example below, only the CMS Card file is specified for the parent simulation. The model automatically obtains the parent simulation starting time, horizontal projection, and output file names. The water level and velocity blocks are left empty so all of the default parameters are used.
Example 4: Interpolated water levels and velocities from parent CMS simulation.
BOUNDARY_BEGIN
- CELLSTRING "Flow_mp.h5" "PROPERTIES/Model Params/Boundary"
- WSE_BEGIN
- WSE_END
- VEL_BEGIN
- VEL_END
- PARENT_BEGIN
- CONTROL_FILE "..\CMS_Regional\Flow_Reg.cmcards"
- PARENT_END
BOUNDARY_END
Example 5: Multiple water level and velocity boundary specification using a block structure (new)
BOUNDARY_BEGIN
- CELLSTRING "Flow_mp.h5" "PROPERTIES/Model Params/Boundary"
- WSE_BEGIN
- WSE_FILE "Flow_mp.h5" "PROPERTIES/Model Params/Boundary" !Optional
- WSE_OFFSET 0.1 m !Optional
- WSE_GRADIENTS 1.E-5 0.0 !Optional
- TIME_INTERP_ORDER 2 !Temporal interpolation
- TIME_SMOOTH_ITER 1 !Temporal smoothing iterations
- TIME_SMOOTH_WIDTH 3 !Temporal smoothing window width
- SPACE_SMOOTH_ITER 1 !Spatial smoothing iterations
- SPACE_SMOOTH_WIDTH 3 !Spatial smoothing window width
- WSE_END
- VEL_BEGIN
- VEL_FILE "Flow_mp.h5" "PROPERTIES/Model Params/Boundary" !Optional
- TIME_INTERP_ORDER 2 !Temporal interpolation
- TIME_SMOOTH_ITER 1 !Temporal smoothing iterations
- TIME_SMOOTH_WIDTH 3 !Temporal smoothing window width
- SPACE_SMOOTH_ITER 1 !Spatial smoothing iterations
- SPACE_SMOOTH_WIDTH 3 !Spatial smoothing window width
- VEL_END
BOUNDARY_END