Processing tools¶
Todo
this chapter should be completely rewritten
Expected contents:
- general description of available command line tools (GDAL, OTB)
- command line interface and configuration files (??)
- for each tool:
- general description
- provider (??)
- SW package (es. GSDView plugin for GDAL tools or standalone package for OTB tools)
- detailed description of the tool and algorithms
- detailed description of command line parameters (or configuration file
parameters). For each parameter:
- name
- description
- expected type
- range (if applicable)
- default
- reference to the corresponding menu entry description in the GUI section
- note: supported formats, limitations (eg. process only one band, etc.)
GSDView allows to execute different type of processing on the input product.
GDAL based tools configuration¶
Most of GSDView functionalities are performed using external tools. Each external tool can be configured through a GUI showing all its main parameters. These configuration windows are shown when related tool is selected in the menubar.
All tools are similar, and they consists of three separated sections:
- input section
- output section
- specific section
First two sections are almost identical for all tools, while the third one concerns selected tool specific configuration.
Some parameters are optional, so they are considered only if related checkbox is selected.
Input Section¶
In this section input dataset is configured. Main parts are:
Source Dataset: the full path of input dataset in GDAL format. It requires file name and if you want to analyse a subdataset also its path in file tree and its driver name. So if you want to use dataset SBI of S01 branch of file c:\data\cosmo\CSKS1_type_sensor_acquisitiontime.h5 you have to insert following string: HDF5:c:\data\cosmo\CSKS1_type_sensor_acquisition time.h5://S01/SBI. If this string refers to an unsupported dataset or to a not existing one, the tool ends withouth any output. Default value for this field is the path of the selected dataset (in GDAL format).
Some tools require two input dataset, so for them two parameters of this type are shown.
Source Band: With it you can select the band to be processed. it isn’t present in all tool configurations. If band number 0 is selected, all source dataset is processed.
Source Window (optional): if it’s configured, only part of input image is considered. This selection can be performed through:
- pixel coordinates: they cannot exceed image size
- geographic coordinates
- projected coordinates
Output Section¶
In this section the output path, data type and format can be chosen. So most common parameters are:
- Destination Dataset: it contains full path of the output in GDAL format, with file name, and if necessary dataset and driver names. Its default value is the source dataset full path with a minor trailing modification.
- Destination Raster Band (optional): it’s the number to assign to output raster band. A value between 1 and 10 can be usually chosen.
- Output Data Type (optional): it’s the data type for the output. A value in output data types supported by GDAL can be chosen. If no value is selected destination dataset will be of the same type of the source one.
- Output Format (optional): it’s the format for the output. This value can be selected from GDAL supported formats. Every time a new format is selected, the Destination Dataset field changes its value according to it. Only if user has changed Destination Dataset default value, these two fields are not synchronized. If no output format is selected, GTiff is used.
General¶
| Quicklook: | it allows to generate quick look image referred to input product |
|---|---|
| Data Export: | @TBW |
| Portion extraction: | |
| @TBW | |
| Image flip horizontal: | |
| @TBW | |
| Image flip vertical: | |
| @TBW | |
| Image transpose: | |
| @TBW | |
Conversion¶
| File format conversion: | |
|---|---|
| @TBW | |
| Data type conversion (binary transform): | |
| @TBW | |
| Detection - Complex to Amplitude/Power conversion: | |
| @TBW | |
| Stretching (gain conversion?): | |
| @TBW | |
| Pct2Rgb (Paletted image to RGB conversion): | |
| @TBW | |
| Rgb2Pct (RGB to paletted image conversion): | |
| @TBW | |
Band Arithmetic¶
| Sum: | @TBW |
|---|---|
| Difference: | @TBW |
| Product With Conjugat: | |
| @TBW | |
| Module: | @TBW |
| Phase: | @TBW |
| Real: | @TBW |
| Imaginary: | @TBW |
| Conjugate: | @TBW |
| Lin <-> Log: | @TBW |
| Amp <-> Pow: | @TBW |
Filtering¶
| Multilook (in time domain): | |
|---|---|
| @TBW | |
| Kernel convolution: | |
| @TBW - Boxcar (moving window mean): @TBW - Hamming: @TBW - Hanning: @TBW - Triang: @TBW - Blackman: @TBW - Bartlett: @TBW - Parzen: @TBW - Bohman: @TBW - Blackmanharris: @TBW - Nuttall: @TBW - Barthann: @TBW - Kaiser: @TBW - Gaussian: @TBW - General Gaussian: @TBW - Slepian: @TBW | |
| Non linear: | @TBW - Lee (despeckle): @TBW - Frost (despeckle): @TBW - Median: @TBW - GammaMap: @TBW |
Re-sampling (spectral domain)¶
| Oversampling: | @TBW |
|---|---|
| Undersampling: | @TBW |
Projection¶
| Flip to north: | @TBW |
|---|---|
| Very coarse map projection: | |
| @TBW | |
| Slant Range to Ground Range: | |
| @TBW | |
| Map correction: | @TBW |
| Terrian correction: | |
| @TBW | |
Misc¶
| Merge (coarse mosaic): | |
|---|---|
| @TBW | |
| Merge to RGB: | @TBW |
| Nearblack: | @TBW |
| Contour: | @TBW |
| Tiles: | @TBW |
Todo
@TBW other GDAL based tools
