SCALGO Live Documentation

print

Modelspaces - Introduction and use

SCALGO Live supports importing, visualizing, and sharing results from hydrodynamic model simulations, including time-series data, through hydrodynamic modelspaces. To create a modelspace you need access to the SCALGO Live Modelspace add-on.

Creating modelspaces

To create a modelspace you can follow these steps:

  1. Go to the Library ("Add" in the bottom-left corner).
  2. Click the Modelspaces tab, and click Create new modelspace.
  3. Select a file to open.
  4. Check the spatial reference if necessary.
  5. Choose the layers, and their types, from the file you want imported into SCALGO Live.
  6. Click import.

When importing large files, remember to use a computer with a fast and stable internet connection, if the process is interrupted it has to be restarted. Also note that older versions of Microsoft Edge and Firefox do not support uploading files larger than 2-4 GB. Once the modelspace is created, you can of course use any computer you would normally use for SCALGO Live to interact with the results.

Selecting layer types

In step 5 of the workspace creation process you tell the system how to map the data in the file to the types of data supported in a SCALGO Live Modelspace. Currently the 5 basic types supported are:

  • Elevation data
  • Absolute or directional flux
  • Absolute or directional velocity
  • Water depth (relative)
  • Water level (absolute)

The system will try to detect what type the data in your file corresponds to, but this is not always possible and you can therefore tweak it. Here is an example of this process inside SCALGO Live:

In our test file the system should use the Bathymetry layer for the elevation data, the Surface elevation layer for water depth (and this layer stores absolute, not relative, water depth), we have no velocity data and P-flux and Q-flux should be combined into the Flux layer.

On the left side we show the different types supported by SCALGO Live and on the right side the layers from the file that will be used for each type is shown. If you want a different layer to be used, or do not want to import a given type at all, you can use the drop-down box to change the selection.

Adding and removing data

If the output of your simulation is stored in multiple files covering the same area, use one to create the modelspace, and then click Import more data... in the modelspace dialog to import each of the remaining files. This is currently only supported for dfs2 data.

To remove superfluous layers, simply click the trash can showing next to the layer name while hovering your mouse.

Deleting a layer

Layer removal is permanent, if you change your mind you will have to re-upload the data to the workspace.

Hydrodynamic data types and visualization

Flux & Velocity

For flux and velocity we support vector fields, typically represented by an x- and y-component or absolute value and angle. If two components are present in the input data, they will be combined into a single layer, with the option of showing the data using a gradient where the colour depends on the absolute value (Euclidean norm) of the two components, or using arrows showing the direction. The size of the arrows again depends on the absolute value of the vector. If the data is represented as one component, this is assumed to be the absolute flux or velocity, and only the gradient visualization is available.

Combined visualization of flux as a gradient and velocity as arrows.

When using arrow visualization (default for data with two components), the slider is used to control the maximum flux or velocity. Arrows representing values larger than this maximum are drawn in red.

When using gradient visualization, the slider is used to control the minimum flux or velocity shown.

Point queries on layers with direction return both the absolute flux or velocity and the compass direction (azimuth) with respect to grid north in the visualization projection.

Water depth & Water level

Water depth data is displayed similarly to the water-depth visualization for the flash-flood map and sea-level rise, with a default blue gradient and the option of "banded" visualization. Water depth layers are also rendered in the profile window, and update with the time slider (see below).

Depth profile

During import, water level data is converted to water depth by subtracting heights from the supplied elevation model.

Time-series data

If the input data represents a time-series of steps in a simulation run, both the individual time steps as well as the maximum value over all time steps can be visualized. A time-slider is presented to browse through the steps of the simulation. The time shown is relative to the start of the simulation.

Sharing modelspaces

Modelspaces can be shared with other users of SCALGO Live in the same way as workspaces, however, receiving users that do not have access to the hydrodynamic add-on will only be able to view them for a limited amount of time.

Supported file types

SCALGO Live supports both raster- and mesh-based file formats for importing hydrodynamic simulation results. Mesh-based data is rasterized on import, and you'll be asked to select a rasterization resolution. The default selected value roughly corresponds to the cell size of the mesh.

DFS2 (raster)

The items in a DFS2 file should have the following types:

  • Elevation data: Bathymetry
  • Flux, one or two components: Flow Flux (when using two components, the items should be called P flux and Q flux)
  • Velocity: u-velocity component and v-velocity component
  • Water depth: Water Depth
  • Water level: Water Level

The names of the individual items are used as layer names in SCALGO Live.

Instead of using the Create new modelspace button, DFS2 files can also be dragged directly onto the dock from your file manager. Depending on the type of data (elevation model only, or files containing other data types), you'll be prompted to create a new workspace or hydrodynamic modelspace based on the contents of the file.

DFSU (mesh)

See DFS2 above for the supported item types. The elevation model can be extracted from the mesh itself (choose "From Mesh").

HEC-RAS HDF (mesh)

Specifically, the .pXX.hdf files generated by HEC-RAS 5 & 6.

The following outputs are currently recognized:

  • Elevation: Cells Minimum Elevation (choose "From Mesh")
  • Velocity: Face Velocity
  • Water level: Water Surface
  • Water depth: Depth

Maximum water surface and velocity are also read from the file.

TUFLOW XMDF (mesh)

Select the .xmdf output file as well as the .2dm model and corresponding .xmdf.sup file.

The following outputs are currently recognized:

  • Elevation from the mesh model
  • Depth and Water Level
  • Vector Velocity
  • Velocity

Maximum values are also read from the file.

Infoworks ICM .dat export (mesh)

See the Innovyze manual for information on how to export results to binary files. Select the .dat output file as well as the 2D simulation elements.shp, .shx, .prj, and .dbf files. Currently, only single-zone simulation results are supported with simulation elements shaped as triangles or quadrilaterals.

The following output fields are currently recognized:

  • Elevation from the mesh model
  • Water depth: depth2d
  • Velocity: speed2d
  • Flux: unitflow2d

Flow directions are read from the angle2d field.

Additional analyses

If you select an elevation model for your modelspace, SCALGO Live will automatically compute additional analyses based on this model for your convenience. Currently we compute the depression map, which is available as a layer in the workspace, and we enable the watershed tool allowing you to dynamically query (depression-free) watersheds in your elevation model.

The elevation model in the imported modelspace is shown along with the associated depression map and an active watershed tool.

Note, elevation data in a mesh is rasterized upon import and the analyses are computed on this rasterized model.