SURE.exe
The SURE executable incorporates the entire software package. It enables you to process complete 2.5D and/or 3D pipelines with just one call, while still being highly configurable using the various CLI options.
Add executables to system PATH variable
During software installation, the SURE program folder can optionally be added to the system's path variable. By doing so you will be able to call all SURE executables, including SURE.exe, SURE-Node.exe, and the Modules executables, from every directory. This way you don't have to change directory to the SURE installation folder or specify the complete executables path.
Open GUI
Calling SURE --gui <path-to-project.spr-file> will open up the Graphical User Interface and load the specified project. Such a command would be incompatible with all the other flags, designed for Command Line use.
Help text
Calling SURE -h or SURE.exe --help will print a comprehensive list of the CLI options/parameters.
Pause a process
Pressing the "Pause" key on the keyboard will pause a currently running SURE process.
Resume an interupted process
If a SURE process has been interrupted, e.g. through cancelation by user, it can be resumed by calling sure -p <path-to-project-directory>. Calling the same command again that had been used to initally create the project, will recreate it in the same directory. For more details, see also Pause and Resume Processing.
CLI options and arguments
Option / CLI flag | Description |
|---|---|
Basic | |
-p, --project-directory <path> | Set project directory |
-i, --images <path> | Set path to input images |
-o, --orientations <path> | Set path to input orientations |
-l, --lidar-clouds <path> | Set path to input LiDAR clouds |
-L, --lidar-trajectories <path> | Set path to input LiDAR trajectories |
-s, --scenario <scenario> (<fw-overlap> <sw-overlap>) | Set scenario (DEFAULT, AERIAL_OBLIQUE or AERIAL_NADIR with overlaps, e.g. AERIAL_NADIR 80 60) |
-c, --coordinate-system <path> | Set coordinate system from WKT file |
--tiling-scheme-origin <x> <y> | Set 2D origin of tiling scheme that the output products align with |
-t, --tile-size <size> | Set tile size |
--gsd <gsd> | Set the output cell size for raster products. The GSD value specified should be equal or greater than the GSD resulting from the quality setting (see -q,--quality). |
-z, --z-range <zmin> <zmax> | Set z range |
-A, --area-shapefile <path> | Set shapefile defining region of interest |
-w, --waterbody-shapefile <path> | Set shapefile defining waterbodies |
-m, --mesh-formats <format> [<format> ...] | Set mesh formats (osgb, 3d_tiles, slpk, lod_dae, lod_obj, obj and/or dae) |
-q, --quality <quality> | Set quality (ULTRA, HIGH, MEDIUM or LOW). Each reduction in quality level doubles the output cell size of the raster products. Exception: output cell size for scenario DEFAULT and quality HIGH is not doubled to allow for full resolution DSM and True Ortho outputs in the standard processing setting. |
-d, --distributed-processing | Activate distributed processing |
--gpu | Allow GPU (CUDA) processing if possible. GPU processing is allowed by default for compatible hardware. |
--activate <license-key> | Activate a license |
--gui <project-file-path> | Open project with GUI (incompatible with all other options except --no-update) |
-v, --version | Print version and license details |
Input | |
-i, --images <path> | Set path to input images (optional for certain orientation formats with valid image paths) |
-o, --orientations <path> | Set path to input orientations |
--matching-images <path> | Set path to separate input images for matching |
-l, --lidar-clouds <path> | Set path to input LiDAR clouds |
--no-lidar-clouds | Disable use of input LiDAR clouds |
-L, --lidar-trajectories <path> | Set path to input LiDAR trajectories |
--no-lidar-trajectories | Disable use of input LiDAR trajectories |
Processing Steps | |
--dense-matching | Enable dense matching step |
--no-dense-matching | Disable dense matching step |
--dsm | Enable DSM step |
--no-dsm | Disable DSM step |
--true-ortho | Enable true ortho step |
--no-true-ortho | Disable true ortho step |
--dsm-mesh | Enable DSM mesh step |
--no-dsm-mesh | Disable DSM mesh step |
--dsm-mesh-texturing | Enable DSM mesh texturing step |
--no-dsm-mesh-texturing | Disable DSM mesh texturing step |
--point-cloud | Enable point cloud step |
--no-point-cloud | Disable point cloud step |
--mesh | Enable mesh step |
--no-mesh | Disable mesh step |
--preparation-only | Only prepare project |
--preparation-only-with-images | Only prepare project and input images |
--analysis-only | Only analyze project |
Network Processing | |
-d, --distributed-processing | Activate distributed processing |
--no-distributed-processing | Disable distributed processing |
--network-image-directory <path> | The network location where images will be prepared to. In case of cloud processing this can be a GDAL virtual file system path |
--network-optimized-image-preparation | Prepare all images as 8 bit MRFs with compression to optimize file transfer (incompatible with --output-16-bit-color-in-true-ortho-and-dsm) |
--no-network-optimized-image-preparation | Prepare images in original bit depth |
--subproject-size <tiles-per-dimension> | Set subproject size for distributed processing (use default setting for best mesh/DSM mesh texturing performance) |
General Parameters | |
-p, --project-directory <path> | Set project directory |
-s, --scenario <scenario> (<fw-overlap> <sw-overlap>) | Set scenario (DEFAULT, AERIAL_OBLIQUE or AERIAL_NADIR with overlaps, e.g. AERIAL_NADIR 80 60) |
-q, --quality <quality> | Set quality (ULTRA, HIGH, MEDIUM or LOW). Each reduction in quality level doubles the output cell size of the raster products. Exception: output cell size for scenario DEFAULT and quality HIGH is not doubled to allow for full resolution DSM and True Ortho outputs in the standard processing setting. |
-c, --coordinate-system <path> | Set coordinate system from WKT file |
--no-coordinate-system | Remove coordinate system |
-t, --tile-size <size> | Set tile size |
--tiling-scheme-origin <x> <y> | Set 2D origin of tiling scheme that the output products align with |
--tiling-scheme-origin-3d <x> <y> <z> | Set 3D origin of tiling scheme that the output products align with |
--gsd <gsd> | Set the output cell size for raster products. The GSD value specified should be equal or greater than the GSD resulting from the quality setting (see -q,--quality). |
-z, --z-range <zmin> <zmax> | Set z range |
-A, --area-shapefile <path> | Set shapefile defining region of interest |
--no-area-shapefile | Remove shapefile defining region of interest |
--automatic-area-shapefile | Use automatically generated area shapefile |
--no-automatic-area-shapefile | Do not use automatically generated area shapefile |
-w, --waterbody-shapefile <path> | Set shapefile defining waterbodies |
--waterbody-height-estimation | Enable height estimation for waterbody shapefiles (Beta) |
--correction-shapefile <path> | Set shapefile defining corrections for results |
--global-color-balancing | Enable global color balancing |
--no-global-color-balancing | Disable global color balancing |
--area-based-image-selection | Allow image selection based on manual area |
--no-area-based-image-selection | Prevent image selectin based on manual area |
--terrain-height-for-image-selection <height> | Set initial terrain height for image preselection |
--no-terrain-height-for-image-selection | Remove initial terrain height for image preselection |
--las | Set point cloud output format to .las |
--laz | Set point cloud output format to .laz (default) |
--cpu | Only allow CPU processing. This flag will disable GPU processing. |
--gpu | Allow GPU (CUDA) processing if possible. GPU processing is allowed by default for compatible hardware. |
--ignore-earth-curvature | Ignore earth curvature and refraction in .prj input orientations |
--stereo-models <path> | Set stereo models from connectivity matrix file. It is required to have ones (non-zero values) on the main diagonal for the positions corresponding to the images that have at least one stereo partner. |
--no-automatic-stereo-model-selection | Disable automatic stereo model selection |
2.5D Workflow | |
--output-8-bit-color-in-true-ortho-and-dsm | Output 8 bit per color channel in DSM and true ortho results (enabled by default) |
--output-16-bit-color-in-true-ortho-and-dsm | Output 16 bit per color channel in DSM and true ortho results (only for 16bit input images; incompatible with --network-optimized-image-preparation) |
--dsm-required-points-per-cell <minimum-number-of-points> | Set DSM required points per cell |
--dsm-depth-buffer <buffer-size> | Set DSM depth buffer size |
--dsm-binary-mask | Enable export of DSM binary mask image for non-interpolated pixels |
--dsm-point-color | Enable export of DSM with point colors |
--dsm-distance-map | Enable export of DSM distance map to next non-interpolated pixel |
--dsm-roughness | Enable export of local DSM roughness |
--dsm-point-model-count | Enable export of map with stereo model count of final point |
--additional-tfws | Enable export of additional .tfw files |
--no-additional-tfws | Disable export of additional .tfw files |
--image-pyramids-in-tiffs | Enable export of image pyramids in .tif files |
--no-image-pyramids-in-tiffs | Disable export of image pyramids in .tif files |
--true-ortho-enhance-texture | Enhance True Ortho texture |
--no-true-ortho-enhance-texture | Disable enhancement of True Ortho texture |
--true-ortho-5-0 | Generate SURE 5.0 True Ortho version |
--no-true-ortho-5-0 | Generate default True Ortho version |
Mesh Parameters | |
-m, --mesh-formats <format> [<format> ...] | Set mesh formats (osgb, 3d_tiles, slpk, lod_dae, lod_obj, obj, local_obj and/or dae) |
--3d-tiles-over-impose-heights-on-target-ellipsoid | Overimpose heights on target ellipsoid |
--no-3d-tiles-over-impose-heights-on-target-ellipsoid | Do not overimpose heights on target ellipsoid (default) |
--mesh-enhance-texture | Enhance mesh/DSM mesh texture |
--no-mesh-enhance-texture | Disable enhancement of mesh/DSM mesh texture |
--mesh-force-export-single-file | Force exporting non-lod formats as single mesh file. This functionality should only be enabled for small meshes (e.g. up to 16000x16000 GSDs) because of the relation of rendering performance and memory usage with the mesh size if this is active. |
--no-mesh-force-export-single-file | Do not force exporting non-lod formats as single mesh file |
Other | |
--gui <project-file-path> | Open project with GUI (incompatible with all other options, except --no-update) |
--no-update | Avoid automatic update |
--activate <license-key> | Activate a license |
--activate-trial <license-key> | Activate a trial license |
-v, --version | Print version and license details |
-h, --help | Print this help |