Color adjustment of TrueOrthos & Meshes based on already existing outputs

If the user wants to color balance TrueOrthos or Meshes processed without color balancing there are certain steps required to run.

Due to the fact that the color balancing of TrueOrthos requires to have color adjusted parameters pre-calculated, the user has to re-run the Analysis step, before the generation of the TrueOrtho / Mesh Texturing.

Only in the Analysis step the color adjustment parameters are calculated and later on they are invoked in the process of TrueOrtho and Mesh Texturing.

Step-by-step guide

In the GUI:

Load the Project.spr in SURE and perform the necessary updates

GUI: Update

Please be aware of the fact that opening an old SURE project in the current updated release requires the user to make some backups according to the info message:

Update the already processed SURE project 

Setup your project as usual and run the Analysis step. By default SURE will calculate in the project folder the color balancing parameters stored in the colorAdjustmentFile.txt. Therefore the Calculate Color Adjustments setting is active by default. For applying the color adjustments on the TrueOrtho/Mesh output activate the option of Apply Color Adjustments. Then in the Processing steps from the GUI rerun the processing steps of TrueOrtho etc.











CLI: Global color balancing

A faster way of processing the TrueOrthos and Meshes with color balancing is to use the CLI and the Modules as explained in the next steps. The CLI method offers more flexibility in processing. 

Or one can run Analysis in the GUI and the TrueOrtho/Mesh texturing with the help of the modules.

In the CLI:

  1. Run the Analysis with the same exact settings as the previous project. Thus the color adjustment file will be calculated.
  2. Analysis and TrueOrtho will run faster in case that you still have the image preparation results. Thus the folders of Init/ImgTexture/ImgMatch/Ori/Shapes/DSM/Mesh plus all the list files and all the control-files should be located in the project folder. Make a copy of the .log file.
  3. Generate the DSM extended / Mesh (if not existing) with the corresponding module: ModuleDsm / ModuleDsmMesh / Module3DMesh.
  4. In order to color balance the TrueOrthos/Meshes the user can benefit from the Analysis step and ModuleTrueOrtho/ModuleMeshTexturing. When using these modules the user can specify in the CLI (see below) the path to the needed color adjustment file for color balancing. If not provided, the module will automatically read and apply the color balancing parameters stored in the color adjustment file that is located in the project folder.
  5. The example below shows how to run the module from the CLI:


Generating color adjusted TrueOrthos/Meshes of earlier release SURE projects


#If the user wants to color balance the TrueOrthos or the Meshes of a previous release project the following steps have to be followed:

#Run the analysis with the same exact settings as the previous project. Thus the color adjustment file will be calculated. You can run Analysis from the GUI or from the CLI.
SURE.exe -basepath [...] ^
-analyze ^
-color_adjustment ^
-force_project_update ^
-no_dense_cloud ^
-no_true_ortho ^
-no_dsm ^
-no_dsmmesh ^
-no_dsmmeshtexturing ^
-no_filter ^
-no_mesh ^
-no_meshtexturing ^

#In case the ModuleDsm wasn't run before, and there is no DSM_Extended, the user has to run it using the ModuleDsm.exe as follows:
ModuleDsm.exe --output .\DSM_regenerated --cloud cloudlist.txt

# Generation of a color balanced TrueOrtho can be done in the CLI. The user can specify the flag of --color_adjustment in the CLI for the generation of the color corrected TrueOrtho:
ModuleTrueOrtho.exe --output .\ColorBalanced --color_adjustment .\colorAdjustmentFile.txt

# Generation of a color balanced DSM Mesh if you already have this product and you would like to re-texture it
ModuleMeshTexturing.exe --color_adjustment .\colorAdjustmentFile.txt --mesh .\DSM\DSM_Mesh\main.osgb  --mesh_type DSM_Mesh --output [...]

# Generation of a color balanced 3D Mesh by specifying the path to the color adjustment file.
ModuleCloudFilter.exe                         # OPTIONAL: in case there is no 3D Mesh the filtering is required, this step is not necessary if you already have a 3D Mesh  
Module3DMesh.exe                              # OPTIONAL: in case there is no 3D Mesh the generation of it is required this step is not necessary if you already have a 3D Mesh
ModuleMeshTexturing.exe --color_adjustment .\colorAdjustmentFile.txt --mesh .\Mesh\osgb\main.osgb  --mesh_type 3DMesh --output [...] # Color adjustment of an existing 3DMesh

The path to the colorAdjustmentFile.txt has to be specified only if the colorAdjustmentFile.txt is not located in the project folder basepath.

For more info see also: True Ortho , Mesh Texturing, SURE.exe