Transition from SURE version 3 to SURE version 4

SURE 4 introduced usability and internal changes directed towards improving the customer experience and the quality of the results. This document aims to provide you with detailed information regarding what changed between SURE 3 and SURE 4.

Due to the new improved project structure and workflows, SURE 3 Projects or older cannot be loaded in SURE 4.

General Changes

  • The Dense Cloud and Cloud Filter processing steps were renamed to Dense Matching and Point Cloud respectively.

  • The main products from the 2.5D workflow were renamed and moved to the Results folder.

SURE 3

SURE 4

DSM/DSM_Interpolated

Results/DSM/tif

DSM/Cloud_Interpolated

Results/DSM/las

DSM/Ortho_Refined

Results/True_Ortho

DSM/Cloud_Refined

Results/DSM/las

  • The main products from the 3D workflow were renamed and moved to the Results folder.

SURE 3

SURE 4

Cloud_Filtered

Results/Point_Cloud

Mesh

Results/Mesh

Project Folder Structure

The naming and location of SURE 4 results make it easy to find the right products. Additionally, the SURE 4 folder structure condenses all intermediate and configuration files into a separate folder.

See also Project Folder Structure.

 Click here to expand for further details

SURE version 3

SURE version 4

Intermediate and Final Results

3D_Points

Internal/Point_Cloud_Raw

Cloud_Filtered

Results/Point_Cloud

DSM/Cloud

Internal/DSM_Raw/DSM_raw/las

DSM/Cloud_Interpolated

Results/DSM/las (if DSM is produced, without True Ortho)

DSM/Cloud_Refined

Results/DSM/las (if True Ortho is produced)

DSM/DSM

Internal/DSM_Raw/DSM_raw/tif

DSM/DSM_BinaryMask

Results/DSM_Metainformation/DSM_Binary_Mask

DSM/DSM_DistanceMask

Results/DSM_Metainformation//DSM_Distance_Map

DSM/DSM_Extended

Internal/DSM_Raw/DSM_Extended

DSM/DSM_Interpolated

Results/DSM/tif

DSM/DSM_Mesh

Results/DSM_Mesh

DSM/DSM_ModelCount

Results/DSM_Metainformation/DSM_Point_Model_Count

DSM/DSM_StdDev

Results/DSM_Metainformation/DSM_Roughness

DSM/HIS

Results/DSM_Metainformation/DSM_Height_Colored

DSM/NUM

Results/DSM_Metainformation/DSM_Cell_Point_Count

DSM/Ortho

Results/DSM_Metainformation/DSM_Point_Color

DSM/Ortho_Interpolated

Results/DSM_Metainformation/DSM_Point_Color_Interpolated

DSM/Ortho_Refined

Results/True_Ortho

DSM/STD

Results/DSM_Metainformation/DSM_Cell_Standard_Deviation

Mesh

Results/Mesh

Other

ImgMatch

Internal/Images/Match

ImgTexture

Internal/Images/Color

Init

Internal/Init

Ori

Internal/Orientations

Rect

Internal/Rect

SGM

Internal/SGM

Shapes

Internal/Shapefiles

SubProjects

Internal/Subprojects

log files: log.txt | dp.log | .extended_dp.log

Internal: log.txt | dp.txt | .extended_dp.txt

control files (control*.txt)

Internal/Control_Files

list files (*list.txt)

Internal/Lists ← for results

Internal/Orientations ← for *.ori files

Internal/Images/Match and Internal/Images/Color ← for images

colorAdjustmentFile.txt

Internal/colorAdjustmentFile.txt

coordinate_system.wkt

Internal/coordinate_system.wkt

topology.tif

Internal/Topologies/topology.tif

chronicle.srdb | resources.srdb

Internal: chronicle.srdb | resources.srdb

Project.spr

Project.spr

Graphical User Interface (GUI)

In SURE 4 the GUI has been adapted as well, following the same principles stated above.

 Click here to expand for further details

Noticeable changes:

  • Resources Panel:

    • Consistent and intuitive naming of results

    • Structure according to output formats

  • Process Control Panel:

    • Consistent and intuitive naming of Processing Steps

    • Merging of 3D Mesh and 3D Mesh Texturing into one single Processing Step.

  • Advanced Configuration Panel:

    • Some parameters have been automated (optimal values are stored internally, depending on the scenario). Therefore, they have been removed from the interface.

    • Parameters list is more compact

    • Consistent and intuitive naming of options

Command Line Interface (CLI) Flags

General remarks:

  • The table below is structured according to the old list of Command Line options. Its purpose is to track the correspondence between old and new versions of CLI arguments. For the exhaustive list of CLI flags and for a more intuitive and readable enumeration, please consult the SURE version 4 Command Line Interface article.

  • short flags (one letter) are preceded by one dash sign ('-')

  • longer flags are preceded by two dash signs ('--')

  • in the longer flags, individual words are separated by one dash sign ('-')

 Click here to expand for further details

SURE version 3

SURE version 4

Input Images & Orientations

-img <path>

-i, --images <path>

-matchimg <path>

--matching-images <path>

-ori <path>

-o, --orientations <path>

-lidar <path>

-l, --lidar-clouds <path>

-no_lidar

--no-lidar-clouds

-lidar_trajectory <path>

-L, --lidar-trajectory <path>

-no_lidar_trajectory

--no-lidar-trajectory

General Parameters

-basepath <path>

-p, --project-directory <path>

-scenario <scenario> <forward> <sideward>

-s, --scenario <scenario> (<fw-overlap> <sw-overlap>)

-pyr <value = 0,1,2,3>

-q, --quality <quality = ULTRA, HIGH, MEDIUM, LOW>

-tilesize <value>

-t, --tile-size <size>

-gsd <value>

--gsd <gsd>

-coordinate_system <path>

-c, --coordinate-system <path>

-no_coordinate_system <path>

--no-coordinate-system

-area2d <xmin> <xmax> <ymin> <ymax>

-a, --area-2d <xmin> <xmax> <ymin> <ymax>

-area3d <xmin> <xmax> <ymin> <ymax> <zmin> <zmax>

--area-3d <xmin> <xmax> <ymin> <ymax> <zmin> <zmax>

-area_shape <path to shape file>

-A, --area-shapefile <path>

-no_area_shape

--no-area-shapefile

-apply_area_based_image_selection

--image-preselection-using-initial-terrain-height

-no_apply_area_based_image_selection

--no-image-preselection-using-initial-terrain-height

-initterrain <height>

--initial-terrain-height <height>

-no_initterrain

--no-initial-terrain-height

-distributed

-d, --distributed-processing

-subproject_size <tiles per dimension>

--subproject-size <tiles-per-dimension>

-waterbody <path>

-w, --waterbody-shapefile <path>

-color_adjustment

--global-color-balancing

-no_color_adjustment

--no-global-color-balancing

-custom_color_adjustment <path to custom color adjustment file>

--custom-color-adjustment-file <path>

Process control flags

-prep

--preparation-only

-prepimg

--preparation-only-with-images

-analyze

--analysis-only

-dense_cloud / no_dense_cloud

--dense-matching / --no-dense-matching

-dsm / -no_dsm

--dsm / --no_dsm

-true_ortho / -no_true_ortho

--true-ortho / --no-true-ortho

-dsmmesh / -no_dsmmesh

--dsm-mesh / --no-dsm-mesh

-dsmmeshtexturing / -no_dsmmeshtexturin

--dsm-mesh-texturing / --no-dsm-mesh-texturing

-filter / -no_filter

--point-cloud / --no-point-cloud

-mesh / -no_mesh

--mesh / --no-mesh

-meshtexturing / -no_meshtexturing

--mesh-texturing / --no-mesh-texturing

Analysis

-maxmodels <value>

Removed

-minperc

Removed

-minbase <value> / -maxbase <value>

Removed

-con <path>

--stereo-models <path>

-confix

Removed

Dense Cloud

-fold <value>

Removed

-minangle <value> / -maxangle <value>

Removed

-dog <threshold> <area>

Removed

-matchlvl <value>

Removed

-depth / -no_depth

Removed

2.5D Workflow

-interp / -no_interp

Removed

-interpiwd

Removed

-tfw / -no_tfw

--additional-tfws / --no-additional-tfws

-image_pyramids / -no_image_pyramids

--image-pyramids-in-tiffs / --no-image-pyramids-in-tiffs

-dsm_force_8bit_color

--force-8-bit-color-in-true-ortho-and-dsm

-dsm_output_default

Removed

-dsm_output_minimal

Removed

-dsm_binaryMask

--dsm-binary-mask

-dsm_distanceMask

--dsm-distance-map

-dsm_stdDev

--dsm-roughness

-dsm_modelCount

--dsm-point-model-count

-true_ortho_force_8bit_color

--force-8-bit-color-in-true-ortho-and-dsm

-true_ortho_output_default

Removed

Mesh Texturing

-mesh_texturing_export / -no_mesh_texturing_export

-m, --mesh-formats <format>..

Set mesh formats (osgb, cesium, slpk, lod_dae, lod_obj, obj and/or dae)

All mesh formats (lod and non-lod) can be specified with a single flag.

-mesh_texturing_format

-mesh_texturing_export_lod /

-no_mesh_texturing_export_lod

-mesh_texturing_lod_format <format>

-cesium_always_show_max_lod

Removed

-cesium_over_impose_heights_on_target_ellipsoid

--cesium-over-impose-heights-on-target-ellipsoid

-no_cesium_over_impose_heights_on_target_ellipsoid

--no-cesium-over-impose-heights-on-target-ellipsoid

Additional flags

-gpu / -cpu

--gpu / --cpu

-rs

Removed

-reprocess

Removed

-no_vis

Removed

-laz

--laz

-no_gui

Removed

-no_update

--no-update

-ignore_earth_curv

--ignore-earth-curvature

-v

-v, --version

-activate <key>

--activate <license-key>

-trial <key>

--activate-trial <license-key>