Geo-Visualization Tools

ASCOS satellite image correction tool - Documentation

This text describes the use of the ascos tool that implements a simple correction for atmosphere and shading influences in satellite images.

ASCOS stands for atmosphere and shading compensation of satellite images.

Compiling the program

ASCOS requires the external linkCImg image processing library to be built and should be compilable on all platforms supported by the library.

Program options

the program offers the following command line options:

Input Color image file to correct (required)
Input DEM image file to use (required)
Output image file name (required)
Write output image with 16 bit per sample. The file format has to support this. Default: off.
enable interactive mode (the image is displayed and parameters can be adjusted interactively). Default: off.
The brightness adjustment for the image display in interactive mode. Default: 1.0.
Gamma correction of the input color image. Default: 2.2.
Correction weights for the atmosphere correction. Red, Green and Blue channel separated by colons. Default: 0.1:0.1:0.1.
Atmosphere correction exponent. To be chosen between purely multiplicative (1) and additive (0) correction. Default: 1.0
Reference height where no correction is applied. Unit: DEM image units. Values < 0 result in use of the maximum height in the image. Default: -1.
Zero height level of the DEM image. Default: 32767.
Height multiplier for the DEM image. Default: 1.0.
Horizontal resolution of the color image. The resolution of the DEM is calculated from this. Unit: DEM image units. Default: 30.0.
Sun azimuth for the shading correction (Degrees). Default: 0.0.
Sun elevation for the shading correction (Degrees). Default: 90.0.
Correction weights for the shading correction. Red, Green and Blue channel separated by colons. Default: 0.1:0.1:0.1.
show available options

Interactive operation

Without the -interactive option the program reads and processes the input image using the chosen options and writes the results to the output image. In interactive mode the algorithm parameters can be adjusted using the following controls:

Legal stuff

This program is licensed under the GNU GPL version 3. A copy of the license should be included in the program package. If you can not find it you can read it on external link

Christoph Hormann, April 2006 - July 2007