Waterbody enhancement using shapefiles

Strong reflections and changing appearance due its moving surface prohibit the accurate reconstruction of waterbodies from images employing stereo vision methods.

In order to acquire the highest quality True Orthos and Meshes, SURE software provides the possibility to crop & replace sparse and noisy data generated on water bodies with smooth data interpolated from 2D and 3D polygons. These polygons can be specified in terms of shapefiles (e.g. along coastlines, lakes, rivers, etc.), where each polygon vertex also has an attached/approximated height value (z coordinate). During the DSM's interpolation stage and/or Cloud Filter processes the specified polygons will be applied to either the raw DSM's or the raw Dense Clouds on-the-fly, leading to enhanced 2.5D and 3D surface models. Note that the raw DSM's and dense clouds themselves will remain unaltered by this process.

Follow these easy steps to enhance your surface models by applying water body polygons:



Step 1 - digitize waterbody polygons

In case shape files containing 3D polygons in the required format are already existing you can skip this step and directly move on to step 2. Otherwise, in order to digitize the 3D polygons, use any available data source, e.g.

  • digital terrain models (DTM)
  • LiDAR data
  • DSM or True Ortho data from previous projects

and capture the polygons along coastlines, lakes, and river shores using your preferred GIS tool.

If no data is available in order to digitize the polygons, proceed as following

  1. Setup your project with SURE as usual, disregarding the waterbody polygons. See also this article for further information.
  2. Process your project up until the DSM stage is finished.
  3. Use the produced DSMs  (representing height). The QA layers which can optionally be produced by SURE can be beneficial for the digitizing process, for example, thebinary mask and the DSM_Point_Color (colorized TIFFs) in order to digitize the required waterbody polygons.
  4. Continue with step 2 and use either the 2.5D Tool or the command line Modules to generate the enhanced surface models and True Orthos.

Shapefile coordinate system

The waterbody shapefile, should have defined the same coordinate system as the one used throughout your SURE project. See also the related article about WKT format specification.

2D Waterbody Shapefiles - automatic height estimation

SURE can approximate the heights of a 2D waterbody shapefile during the Analysis step. The user has only to check the option of Approximate waterbody heights during the project parametrization and import a 2D waterbody shapefile.


Single shapefile

You can only specify one shapefile (.shp) that contains all relevant polygons for your entire project. This shapefile, however, can contain multiple polygons within a single layer.

Digitization or automatic detection of waterbody polygons

Step 2 - apply waterbody polygons

Either you already processed the dense matching clouds in the previous step 1 or you're setting up the project from scratch, you can use both the graphical user interface (GUI) or the command line interface (CLI) to apply the waterbody polygons defined in a shapefile.

... using the GUI

If you're setting up a SURE project from scratch (Analysis and Dense  yet to be processed) and a shapefile containing water polygons is already available, specify the path to the shapefile among the Key Parameters during project configuration.

If the dense clouds and/or DSMs have been processed already, either reset & reprocess the DSM stage or use the 2.5D Tool to reprocess the existing data together with the polygons:

  • If available, open your existing SURE project in the GUI.
  • From the program's menu bar, choose "Tools" > "2.5D Tool"
  • Apart from specifying the waterbody shapefile, adjust parametrization as required, e.g. specify
    • ground sampling distance (GSD)
    • tile size
    • area (ROI)
  • In case you're processing already rasterized DSM clouds, additionally
    • reduce the number of Required points per cell from the 2.5D workflow parameters to 1.
... using the CLI

If shapefiles containing the waterbodies are already available, use SURE's command-line interface like this:

  • SURE.exe -i ... -o ... --scenario ... --waterbody-shapefile <path>

Otherwise, if you need to produce data in order to digitize the polygons still, first process the DSM stage separately, e.g. like this:

  • SURE.exe -i ... -o ... --scenario ... --dsm --no-true-ortho --no-mesh...

and use the standalone modules to apply the digitized polygons to the already existing DSM's:

  • ModuleDsm.exe --point-cloud-raw <path-to-DSM_RAW-las-folder> --waterbody-shapefile <path>
  • ModulePointCloud.exe --waterbody-shapefile <path-to-shapefile>



Affected results

During the 2.5D workflow (DSM, True Ortho, DSM Mesh), the waterbody polygons will be applied to the raw DSM's on-the-fly, so the raw DSM's themselves will remain unaltered by this process. The interpolated areas inside the waterbody will be noticed in the final products stored in the Results folder.

When processing 3D workflows, the waterbody polygons will be applied to the raw dense clouds on-the-fly. The raw dense clouds themselves will not be affected.



GUI interface