Questions/Problems/Requests - use the Users Forum
NOTE: Options with an asterisk* are not currently working - these are largely placeholders for future updates.

Download Example Configurations here

----------------------
Upload Custom Configuration Files here:

Property to Plot: Free Surface Elevation (m) Bathymetry/Topography (m) Bottom Friction Map Fluid Speed (m/s) East-West (x) Velocity (m/s) North-South (y) Velocity (m/s) Total Vertical Vorticity (m/s) Foam / Tracer Concentration Max Free Surface Elev (m) Mean Free Surface Elev (m) Mean Fluid Flux [Magn] (m^2/s) Mean Fluid Flux [E-W] (m^2/s) Mean Fluid Flux [N-S] (m^2/s) RMS Wave Height (m) Significant Wave Height (m) Difference from Baseline Hs (m) Depth Change due to Sed Transport Sediment Class 1 Concentration Sediment Class 1 Erosion Rate Design Component Map

Colorbar Choices: Ocean Parula Turbo HSV Gray Pink Bathy/Topo

Maximum Color Axis Value (in units of plotted property):
Update

Minimum Color Axis Value (in units of plotted property):
Update

Transport Overlays: Show Areas of Foam No Foam or Tracer Passive Tracer Conc

Google Maps / Aerial Image Overlay:
No Overlay Include Google Maps Overlay Include Satellite / Aerial Overlay

Show USACE & USC logos:
Yes No

View Mode: Design - 2D view, modify surfaces Explorer - 2D view, navigate scene

View Simulation in Full Screen

Component to Add: Coral Reef Mussel/Oyster Bed Mangroves Kelp Bed Light Vegetation (grass) Medium Vegetation (shrub/scrub) Rubblemound Structure Vegetated Dune Berm / Temporary Dune Seawall

Mannings n / Friction Factors
Coral Reef: Update
Mussel/Oyster Bed: Update
Mangroves: Update
Kelp Bed: Update
Grass: Update
Scrub: Update
Rubblemound: Update
Vegetated Dune: Update
Berm: Update
Seawall: Update

For surface cover components, radius of coverage to add on click:
Update

Left click (and hold) to add surface cover components (in Design Mode).

*For linear structures (breakwaters, dunes, seawalls), crest elevation (m):
Update

*For linear structures (breakwaters, dunes, seawalls), crest width (m):
Update

*For linear, sloping structures (breakwaters, dunes), side slope (give as decimal, e.g. 0.25 = 1/4):
Update

*Choose Linear Structure Start/Endpoint Coordinate to Edit: Start Location End Location

*Right-click on structure start/end location (in Design Mode) or input coordinates below

Location x-coordinate (m) :
Update

Location y-coordinate (m) :
Update

Add Linear Structure

Change in stil water level (m of surge, tide, SLR):
Update

Property to Edit: Bathymetry/Topography (m) Bottom Friction Passive Tracer Sources Ocean Surface Elevation

Change Property Continuously or Set to Specific Value:
Increase/Decrease on Click Set to Value on Click

Amount of Property to Change-on-Click / Value to Set on Click:
Update

Lengthscale (m) of Change-on-Click :
Update

Incident Wave Type: *Sine Wave (single harmonic) *TMA Spectrum *Transient Pulse (4 waves) *Solitary Wave Custom Spectum from loaded file *Time Series from loaded file

Height (m) of Sine Wave / Pulse / Solitary Wave, or Significant Wave Height of Spectrum:
Update

Period (sec) of Sine Wave / Pulse, or Peak Period of Spectrum [not used for Solitary Wave]:
Update

Wave Direction (deg CCW from E [-180 to 180]):
Update

West Boundary Type: Solid Wall Sponge Layer Incident Waves *Periodic Boundary

East Boundary Type: Solid Wall Sponge Layer Incident Waves *Periodic Boundary

South Boundary Type: Solid Wall Sponge Layer Incident Waves *Periodic Boundary

North Boundary Type: Solid Wall Sponge Layer Incident Waves *Periodic Boundary

BETA - currently no feedback w/ hydro

Sediment Class 1 D50 (mm):
Update

Sediment Class 1 porosity:
Update

Sediment Class 1 specific gravity:
Update

Sediment Class 1 psi parameter:
Update

Sediment Class 1 critical Shields #:
Update

Turn on/off Sediment Transport Model:
No Sediment Transport Include Sediment Transport

Wave Disturbance to Add: Solitary Wave *Earthquake *Submerged Landslide Subaerial Landslide

X-Coordinate of Source (m):
Update

Y-Coordinate of Source (m):
Update

Crest Amplitude / Earthquake Slip / Max Slide Thickness (m):
Update

Direction / Orientation / Strike of Source (deg CCW from E [-180 to 180]):
Update

Characteristic Width of Source (m, not used for Solitary Wave):
Update

Characteristic Length of Source (m, not used for Solitary Wave):
Update

Rake of Source (deg, only used for Earthquake):
Update

Dip of Source (deg, only used for Earthquake):
Update



Add Disturbance

Total Number of Time Series: 0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15

Duration of Time Series to Plot & Save (sec) :
Update
Model will save time series data once this duration is reached; a new data file will be generated every instance that the duration is reached (plot time reaches the duration). Data files will be located in your browser's default Downloads directory.

Time Series Location to Update: 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15

Right-click on time series location (in Design Mode) or input coordinates below

New Time Series x-location (m) :
Update

New Time Series y-location (m) :
Update

Store Baseline Wave Height Surface in Memory

Reset Mean & Max Surfaces

Reset Wave Height Surface

Files saved below will be located in your browser's default Downloads directory

Download Current Simulation Image (JPG)

For long duration movies, it is recommended to use various screen capture options, such as the "Snipping Tool" in Windows. Limitations of working within the browser / js environment make storing many frames and generating large animations challenging. The options below will allow the user to make short animated gifs (up to ~100 frames) and to save up to 256 jpeg images. Note that you can have only one of these operations ongoing at a time.

Animated gif Options:
Time between frames (sec) :
Update

Click the button below to start the creation of the animation. See the console for messages about the progress of the file generation.
Create Animated gif

JPEG Time Stack Options:
Time between jpeg images (sec) :
Update

Number of images to save (max: 256) :
Update

Click the button below to start the storage of the jpeg images in memory. Once all of the images are stored, they will be saved to file. See the console for progress messages.
Create JPEG stack

-------------------------
Files saved below will be located in your browser's default Downloads directory

Download Simulation Parameters JSON file


Write Single 2D Surface Options:
Property to Write to File: Free Surface Elevation (m) X-Dir Fluid Flux [E-W] (m^2/s) Y-Dir Fluid Flux [N-S] (m^2/s) Turbulent Eddy Viscosity (m^2/s) Foam / Tracer Concentration Bathymetry/Topography (m) Bottom Friction Map Design Component Map RMS Wave Height (m) Significant Wave Height (m) Max Free Surface Elev (m) Mean Free Surface Elev (m) Mean Fluid Flux [E-W] (m^2/s) Mean Fluid Flux [N-S] (m^2/s)

Download Single 2D Surface Data (binary)


Time Stacks of 2D Surface Data Write Options:
Time interval to write surface data (sec) :
Update

Write free surface elevation to file: Yes No

Write x-direction flux (HU) to file: No Yes

Write y-direction flux (HV) to file: No Yes

Write turbulent (breaking and mixing) eddy viscosity to file: No Yes

Click the button below to start the writing of 2D surface data to files. Data will be written in raw binary for surface data, and ASCII for time and coordinate data. You can use this example Matlab script to plot the data. Note that writing data to files will slow the simulation, and will tend to make the user interface sluggish; when writing data files frequently (>10 writes per wave period), no to minimal interaction with the simulation is recommended. See the console for progress messages.
Start Writing 2D Data to File

Stop Writing 2D Data to File

Simulation Type: NLSW Boussinesq

Theta value for MinMod, ranges from 1.0 (most dissipative, upwind differences) to 2.0 (least dissipative, centered differences) [default: 2.0 w/ breaking model]:
Update

Change Courant Number (0.1 or less for Explicit Scheme, 0.2 or less for Implicit Scheme):
Update

Bottom Friction Model: Quadratic Friction Drag Mannings Equation

Change Mannings n (typical value ~0.025) or Friction Factor (typical value ~0.002):
Update

Wave Breaking Model: Breaking Eddy Viscosity Model None; numerical dissipation only

Threshold to Start Wave Breaking [Default: 0.5]:
Update

Threshold to End Wave Breaking [Default: 0.15]:
Update

Breaking Transition Time Coefficient [Default: 5.0]:
Update

Breaking Eddy Viscosity Coefficient [Default: 2.0]:
Update

Turbulent Dispersion ([m^2/s]; for foam/scalar transport):
Update

Turbulence Decay Rate (1st Order Decay [1/s]; for foam/scalar transport):
Update

Dry Beach Infiltration Rate [m/s; Default: 0.001]]:
Update

Time Steps Between each Render Frame (1 or greater, 0 for auto-determine for max sim speed):
Update