Processing tools¶

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 plug-in 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.)

Most of GSDView functionalities are performed using external tools. These tools are provided by GDAL, OTB or INNOVA ASI-GRID TEAM.

Each external tool can be configured through a GUI showing all its main parameters, which consists in almost all cases in two tabs (Base and Advanced).

These configuration windows are shown when related tool is selected in the menubar.

Common Parameters¶

Some parameters are common a lot of tools and they are described following.

Common Input parameters¶

Source Dataset: the full path of input dataset.

It requires file name and if you want to analyze a subdataset, the correct format to set includes also its path in file tree and its driver name in the following form: <DRIVER>:<FILENAME>://<SUBDATASET>[/<SUBDATASET>]. So. e.g. if you use a GDAL-based tool and 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. Note that if a valid dataset is selected when a configuration window is shown, source dataset is set correctly even if it is a subdataset.

If this string refers to an unsupported dataset or to a not existing one, the tool will crash showing an error dialog.

mandatory: true

type: string

default: path of opened dataset or empty string

range: –

cmdline flag: –

Note

Some tools requires two or more input datasets. In this case user can choose to add other inputs using GUI. Be careful to complete the path of selected files to point to valid datasets using GDAL format, adding, if necesary, driver and subdatasets.
Source Band: source band number

If band number isn’t shown, or it isn’t selected by the user all source datasets are processed.

mandatory: false

type: integer

default: 1

range: from 1 to dataset’s number of bands

cmdline flag: -b, --band

Note

the -b flag is not available for all Band Arithmetic tools.

Common Output parameters¶

Most common output parameters are:

Destination Dataset: the full path of destination dataset

It contains full path of the output. Its default value is the source file full name with a minor trailing modification.

If the tool is base on GDAL, it is in GDAL format, with file name, and if necessary dataset and driver names.

mandatory: true

type: string

default: dataset name built basing on opened dataset or empty string

range: –

cmdline flag: –
Output Data Type (only for GDAL-based tools): the data type for the output.

A value in output data types supported by GDAL can be chosen. If user force a not enough general transfer datatype, the operation could have an undesired result.

mandatory: false

type: string

default: –

range: GDAL supported datatypes

cmdline flag: --ot (-t for all Band Arithmetic tools)
Output Format (only for GDAL-based tools): it’s the format for the output.

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.

mandatory: false

type: string

default: GTiff

range: GDAL supported datatypes`_

cmdline flag: --of (-f for all Band Arithmetic tools)

Other Common Parameters¶

Spatial Reference System: The value may be any of the usual

GDAL/OGR forms. Some useful informations on available projections could be found at Proj.4 projection list

mandatory: false

type: –

default: –

range: –

cmdline flag: -a_srs

It is composed of several fields:
- Projection:
  
  mandatory: true
  
  type: string
  
  default: –
  
  range: (UTM, STEREOGRAPHIC, LATITUDE - LONGITUDE, LAMBERT, LAMBERT2, SINUS, ECKERT4, TRANSMERCATOR, MOLLOWEID)
  
  cmdline flag: –
- Datum: datum of the spatial reference system used
  
  mandatory: true
  
  type: string
  
  default: –
  
  range: (NAD27, NAD83, WGS84)
  
  cmdline flag: –
Basing on the projection chosen other specific parameters have to been set (for example Lambert projection needs origin latitude and longitude, 2 parallels, false easth and false north). Other parameters can be specified in an empty field too, following GDAL/OGR formats.

Source/Destination ROI¶

A lot of tools allow user to process only a part of entire image, other ones to decide the extension of the output file.

This selection can concern the row-column values or the geographic coordinates or the projected coordinates in some case. Obviously, if no area is selected, the entire image will be processed. For this reason this parameter is optional, so if user want to enable a ROI selection he/she has to enable the related checkbox. In most cases the selection window is shown pressing on a Source Window or Destination Extension button. Another way to choose the ROI is to select an area on the main window with the specific mouse tool and then launch a tool.

If user forces ROI limits to strange values (for example if they are external to image), undesired results could be obtained.

Following all selection modes are listed:

Pixel Coordinates:
	selection for row-column values of the ROI. They cannot exceed image size. Row and column values can be forced manually or selecting the interested area on image with mouse. This last kind of operation is performed on an overview of selected data or on a all-gray image if no overview is found. If image is too dark, a stretching can be performed selecting the range of pixel values for look-up table on color bar. When this selection finishes, the color bar zooms in on desired values. Zoom operations can be performed with mouse wheel too and it is possible to return to previous or following zoom values using CTRL+ARROW keyboard keys. Scrolling on colorbar is allowed using right mouse button. If no dataset with selected Source Dataset is found, the mouse mode selection isn’t permitted. 2 modes for both manually and mouse modes are allowed: 2 Corners: subimage corners: top-left and bottom-right column and row. Corner-Size: subimage top-left corner and dimensions: top-left column and row and size in x and y direction.
Geographic Coordinates:
	subimage to process in geographics coordinates. In this selection mode user can force latitude and longitude extension of the ROI. Obviously if these values are external to input image limits, strange results could be returned. Allowed modes: 2 Corners: subimage corners’ coordinates: top-left and bottom-right corners’ longitude and latitude. Corner-Size: subimage top-left corner’s coordinates and dimensions: top-left longitude and latitude and size in longitude and latitude direction.
Projected Coordinates:
	subimage to process in projected coordinates. The selection depends on selcted projection. Allowed modes: 2 Corners: subimage corners’ coordinates: top-left and bottom-right east and north coordinates. Corner-Size: subimage top-left corner’s coordinates and dimensions: top-left east and north coordinates and size in east and north direction.

General¶

This tool performs general operations such as extraction of portion of image, QuickLook and export data in different formats.

GSDView Tools Menu General

Quicklook¶

Allows to generate the quick look image referred to the input product.

Input:	source image
Output:	quicklook image
Menu Entry:	Tools –> General –> Quicklook
Cmdline tool:	quicklook.py
Provider:	gdalextras plug-in
External SW:	GDAL

Commandline help¶

$ quicklook.py -h

Parameters¶

Source Dataset: see Common Input Parameters
Source Band: see Common Input Parameters. If no band is specified, only the first band is processed
Destination Dataset: see Common Output Parameters
Source Window: see Common Input Parameters.
Output Format: see Common Output Parameters
Output Data Type: see Common Output Parameters
Type of Filtering: type of filtering performed (i.e. if no filtering is performed or if filter kernel size is computed automatically or forced by the user).

mandatory: true

type: string

default: auto

range: (auto, nofilter, manual)

cmdline flag: (– , --nofilter, --kernelsize) basing on value chosen

If filtering is manual kernel size has to be specified:
- Kernel: size of the kernel for filtering (positive odd values should be used)
  
  mandatory: true if manual filter is chosen
  
  type: positive odd integer
  
  default: 3
  
  range: –
  
  cmdline flag: --kernelsize
n. of nstddev: scale input values from [mean-N*stddev, mean+N*stddev] to the output dinamic [default: N=3.0]

mandatory: true

type: floating-point number

default: 3

range: –

cmdline flag: --nstddev
noscale: do not scale pixel values

mandatory: true

type: boolean

default: false

range: –

cmdline flag: --noscale
Output Image Size: output image size [default: fit in 300 kbytes]

mandatory: false

type: x and y size in image coordinates or in percentage of the input image

default: –

range: –

cmdline flag: --outsize

Data Export¶

Allows to export the input image into different formats.

It accepts one input.

Input:	source image
Output:	exported image
Menu Entry:	Tools –> General –> Data Export
Cmdline tool:	quicklook.py
Provider:	gdalextras plug-in
External SW:	GDAL

Commandline help¶

$ quicklook.py -h

Parameters¶

Source Dataset: see Common Input Parameters
Destination Dataset: see Common Output Parameters
Source Window: see Source/Destination ROI.
Output Format: see Common Output Parameters
Output Data Type: see Common Output Parameters

Portion extraction¶

Selects a subwindow from the source image for copying it into a different file. Other parameters can be set, for example file format, data type, etc.

Input:	source image
Output:	portion of the input image
Menu Entry:	Tools –> General –> Portion Extraction
Cmdline tool:	gdal_translate.py
Provider:	gdaltools plug-in
External SW:	GDAL

Commandline help¶

$ gdal_translate -h

Parameters¶

Source Dataset: see Common Input Parameters
Destination Dataset: see Common Output Parameters
Selection Mode: see Source/Destination ROI
Output Format: see Common Output Parameters
Output Data Type: see Common Output Parameters
Output Image Size: Set the size of the output file.

mandatory: false

type: x and y size in image coordinate or in percentage

default: –

range: –

cmdline flag: -outsize
Strict: This option should cause mismatches and data lost

mandatory: true

type: boolean

default: false

range: –

cmdline flag: -strict
Image Scaling: Rescale the input pixels values

mandatory: false

type: four integers

default: false

range: from 0 to max value allowed from data type

cmdline flag: -scale
Spatial Reference System: Override the projection for the output file. See Other Common Parameters

Conversion¶

This menu entry contains all tools performing various conversions of the input data according to the selected operation.

GSDView Tools Menu Conversion

File format conversion¶

Allows to convert the input image into different formats.

Input:	source image
Output:	image in a different file format
Menu Entry:	Tools –> General –> File Format Conversion
Cmdline tool:	gdal_translate.py
Provider:	gdaltools plug-in
External SW:	GDAL

Commandline help¶

$ gdal_translate -h

Parameters¶

Source Dataset: see Common Input Parameters
Destination Dataset: see Common Output Parameters
Source Window: see Source/Destination ROI.
Output Format: see Common Output Parameters

mandatory: true
Output Data Type: see Common Output Parameters
Output Image Size: See Portion Extraction
Strict: See Portion Extraction
Image Scaling: See Portion Extraction
Spatial Reference System: See Other Common Parameters

Data type conversion¶

Allows to convert the input image into a different data type.

Input:	source image
Output:	image in a different data type
Menu Entry:	Tools –> General –> Data Type Conversion
Cmdline tool:	gdal_translate.py
Provider:	gdaltools plug-in
External SW:	GDAL

Commandline help¶

$ gdal_translate -h

Parameters¶

Source Dataset: see Common Input Parameters
Destination Dataset: see Common Output Parameters
Source Window: see Source/Destination ROI.
Output Format: see Common Output Parameters
Output Data Type: see Common Output Parameters

mandatory: true
Output Image Size: See Portion Extraction
Strict: See Portion Extraction
Image Scaling: See Portion Extraction
Spatial Reference System: See Other Common Parameters

Detection¶

Performs the detection of the input image. Input image must be complex.

Input:	source image (complex)
Output:	detected image (real)
Menu Entry:	Tools –> General –> Detection
Cmdline tool:	swbDetection
Provider:	otbtools plug-in
External SW:	OTB

Commandline help¶

$ swbDetection -h

Parameters¶

Source Dataset: see Common Input Parameters
Destination Dataset: see Common Output Parameters
Source Window: see Source/Destination ROI

Gain conversion¶

Rescales the input pixels’ values from the selected range ([src_min, src_max]) to the desired output range ([dst_min, dst_max]).

Input:	source image
Output:	converted image
Menu Entry:	Tools –> General –> Gain Conversion
Cmdline tool:	gdal_translate.py
Provider:	gdaltools plug-in
External SW:	GDAL

Commandline help¶

$ gdal_translate -h

Parameters¶

Source Dataset: see Common Input Parameters
Destination Dataset: see Common Output Parameters
Source Window: see Source/Destination ROI.
Output Format: see Common Output Parameters
Output Data Type: see Common Output Parameters
Output Image Size: See Portion Extraction
Strict: See Portion Extraction
Image Scaling: See Portion Extraction

mandatory: true
Spatial Reference System: See Other Common Parameters

Pct2Rgb (Paletted image to RGB conversion)¶

Convert an 8bit paletted image to 24bit RGB

Input:	source 8bit paletted image
Output:	24 bits RGB image
Menu Entry:	Tools –> General –> Pct2Rgb (Paletted image to RGB conversion)
Cmdline tool:	gdal_translate.py
Provider:	gdaltools plug-in
External SW:	GDAL

Commandline help¶

$ gdal_translate -h

Parameters¶

Source Dataset: see Common Input Parameters
Destination Dataset: see Common Output Parameters
Source Window: see Source/Destination ROI
Output Format: see Common Output Parameters

Band Arithmetic¶

Several tools performing simple arithmetic operations on the input dataset(s) returning the resulting image.

For each tool the intermediate and output datatype can be forced by the user, otherwise they are calculated automatically. If user forces a datatype to a not enough general one, the operation should have an undesired result.

GSDView Tools Menu Band Arithmetic

Sum¶

It performs a sum between each pixel of first band and the corresponding ones of other bands and puts this value in a new band.

Input:	two or more images
Output:	sum image
Menu Entry:	Tools –> Band Arithmetic –> Sum
Cmdline tool:	gxmba.py sum
Provider:	gdalextras plug-in
External SW:	GDAL

Commandline help¶

$ gxmba.py -h

Parameters¶

Source Datasets List: List of Source Dataset and Source Band. See Common Input Parameters

mandatory: true

type: list of Source Dataset and Source Band

default: list of a single empty Source Dataset and Source Band with value 1

range: –

cmdline flag: –
Destination Dataset: see Common Output Parameters
Source Window: see Source/Destination ROI.
Output Format: see Common Output Parameters
Output Data Type: see Common Output Parameters
Transfer Data Type: transfer data type

mandatory: false

type: string

default: type avoiding data losing in operation depending on input image one

range: GDAL supported datatypes

cmdline flag: -x

Difference¶

It performs the difference between each pixel of first band and the corresponding ones of the other band and puts these values in a new band.

Input:	two images
Output:	difference image
Menu Entry:	Tools –> Band Arithmetic –> Difference
Cmdline tool:	gxmba.py diff
Provider:	gdalextras plug-in
External SW:	GDAL

Commandline help¶

$ gxmba.py -h

Parameters¶

Source Datasets List: List of Source Dataset and Source Band. See Sum
Destination Dataset: see Common Output Parameters
Source Window: see Source/Destination ROI.
Output Format: see Common Output Parameters
Output Data Type: see Common Output Parameters
Transfer Data Type: see Sum

Product With Conjugate¶

It performs a product between each pixel of first band and the corresponding complex conjugate ones of the other band and puts these values in a new one.

Input:	two images
Output:	complex image
Menu Entry:	Tools –> Band Arithmetic –> Product With Conjugate
Cmdline tool:	gxmba.py productWithConjugate
Provider:	gdalextras plug-in
External SW:	GDAL

Commandline help¶

$ gxmba.py -h

Parameters¶

Source Datasets List: List of Source Dataset and Source Band. See Sum
Destination Dataset: see Common Output Parameters
Source Window: see Source/Destination ROI.
Output Format: see Common Output Parameters
Output Data Type: see Common Output Parameters
Transfer Data Type: see Sum

Module¶

It performs a module of each pixel of selected band and puts this value in a new one.

Input:	source image
Output:	module image
Menu Entry:	Tools –> Band Arithmetic –> Product With Conjugate
Cmdline tool:	gxba.py module
Provider:	gdalextras plug-in
External SW:	GDAL

Commandline help¶

$ gxba.py -h

Parameters¶

Source Dataset: see Common Input Parameters
Source Band: see Common Input Parameters
Destination Dataset: see Common Output Parameters
Source Window: see Source/Destination ROI.
Output Format: see Common Output Parameters
Output Data Type: see Common Output Parameters
Transfer Data Type: see Sum

Phase¶

It calculates the phase of each pixel of band and puts this value in a new band.

Input:	source image
Output:	phase image
Menu Entry:	Tools –> Band Arithmetic –> Module
Cmdline tool:	gxmba.py phase
Provider:	gdalextras plug-in
External SW:	GDAL

Commandline help¶

$ gxba.py -h

Parameters¶

Source Dataset: see Common Input Parameters
Source Band: see Common Input Parameters
Destination Dataset: see Common Output Parameters
Source Window: see Source/Destination ROI.
Output Format: see Common Output Parameters
Output Data Type: see Common Output Parameters
Transfer Data Type: see Sum

Real Part¶

It extracts the real part of each pixel of the band and puts this value in a new band.

Input:	source image
Output:	real part image
Menu Entry:	Tools –> Band Arithmetic –> Real Part
Cmdline tool:	gxmba.py real
Provider:	gdalextras plug-in
External SW:	GDAL

Commandline help¶

$ gxba.py -h

Parameters¶

Source Dataset: see Common Input Parameters
Source Band: see Common Input Parameters
Destination Dataset: see Common Output Parameters
Source Window: see Source/Destination ROI.
Output Format: see Common Output Parameters
Output Data Type: see Common Output Parameters
Transfer Data Type: see Sum

Imaginary Part¶

It extracts the imaginary part of each pixel of the band and the puts this value in a new band.

Input:	source image
Output:	imaginary part image
Menu Entry:	Tools –> Band Arithmetic –> Imaginary Part
Cmdline tool:	gxba.py imag
Provider:	gdalextras plug-in
External SW:	GDAL

Commandline help¶

$ gxba.py -h

Parameters¶

Source Dataset: see Common Input Parameters
Source Band: see Common Input Parameters
Destination Dataset: see Common Output Parameters
Source Window: see Source/Destination ROI.
Output Format: see Common Output Parameters
Output Data Type: see Common Output Parameters
Transfer Data Type: see Sum

Conjugate¶

It performs for each pixel of the band its complex conjugate value and puts it in a new band.

Input:	source image
Output:	conjugate image
Menu Entry:	Tools –> Band Arithmetic –> Conjugate
Cmdline tool:	gxba.py conjugate
Provider:	gdalextras plug-in
External SW:	GDAL

Commandline help¶

$ gxba.py -h

Parameters¶

Source Dataset: see Common Input Parameters
Source Band: see Common Input Parameters
Destination Dataset: see Common Output Parameters
Source Window: see Source/Destination ROI.
Output Format: see Common Output Parameters
Output Data Type: see Common Output Parameters
Transfer Data Type: see Sum

Lin <-> Log¶

This tool allows to perform four arithmetic operations on the input image:

Amplitude -> Log
Intensity -> Log
Log -> Amplitude
Log -> Intensity

These operations would support only a non-complex positive input, but commandline tool accepts complex data too, ignoring its imaginary part. Notice that if input data has some negative values, the output will contain strange values (for example NaN). In fact amplitude and intensity are intended to be real and positive.

Input:	source image
Output:	output image
Menu Entry:	Tools –> Band Arithmetic –> Lin <-> Log
Provider:	gdalextras plug-in
External SW:	GDAL

Commandline help¶

$ gxba.py -h

Parameters¶

Parameters are the same for all four operations

Source Dataset: see Common Input Parameters
Source Band: see Common Input Parameters
Destination Dataset: see Common Output Parameters
Source Window: see Source/Destination ROI.
Output Format: see Common Output Parameters
Output Data Type: see Common Output Parameters
Transfer Data Type: transfer data type

mandatory: false

type: string

default: type depending on input images to avoid data losing

range: GDAL supported datatypes

cmdline flag: -x

Amplitude –> Log:
	transforms the input data amplitude from linear to logaritmic scale
Cmdline tool:	gxba.py lin2logAmplitude
Intensity –> Log:
	transforms the input data intensity from linear to logaritmic scale
Cmdline tool:	gxba.py lin2logIntensity
Log –> Amplitude:
	transforms the input data amplitude from logaritmic to linear scale
Cmdline tool:	gxba.py log2linAmplitude
Log –> Intensity:
	transforms the input data intensity from logaritmic to linear scale
Cmdline tool:	gxba.py log2linIntensity

Power <-> Amplitude¶

This tool allows to perform both Amplitude –> Power and Power –> Amplitude operations. Input data should be real and positive. The commandline tool accepts complex data too, ignoring its imaginary part. In fact amplitude is intended to be real. Notice that if input data has some negative values, the output will contain strange values (for example NaN). In fact amplitude and intensity are intended to be real and positive.

Input:	source image
Output:	Amplitude/Powered image
Menu Entry:	Tools –> Band Arithmetic –> Power<->Amplitude
Provider:	gdalextras plug-in
External SW:	GDAL

Commandline help¶

$ gxba.py -h

Parameters¶

There two operations have the same parameters:

Source Datasets: see Common Input Parameters
Source Band: see Common Input Parameters
Destination Dataset: see Common Output Parameters
Source Window: see Source/Destination ROI.
Output Format: see Common Output Parameters
Output Data Type: see Common Output Parameters
Transfer Data Type: transfer data type

mandatory: false

type: string

default: type depending on input images

range: GDAL supported datatypes

cmdline flag: -x

Amp–>Pow:
Cmdline tool:	gxba.py amp2pow
Pow–>Amp:
Cmdline tool:	gxba.py pow2amp

Filters¶

This menu entry supports linear and non-linear filtering operations.

GSDView Tools Menu Filters

Non Linear¶

This menu entry contains different kinds of non-linear filtering operations. Every filtering supports only real images.

Input:	source image (real)
Output:	filtered image
Menu Entry:

Tools –>Filters –>Non Linear->Lee
Tools –>Filters –>Non Linear->Frost
Tools –>Filters –>Non Linear->Median

Cmdline tool:

swbLeeFilter
swbFrostFilter
swbMedianFilter

Provider:	otbtools plug-in
External SW:	OTB

Commandline help¶

$  swbLeeFilter -h
$  swbFrostFilter -h
$  swbMedianFilter -h

Parameters¶

All non-linear filters have some common parameters:

Source Dataset: see Common Input Parameters
Destination Dataset: see Common Output Parameters
Source Window: see Source/Destination ROI.

Every filter has own specific parameters:

Lee¶

Radius:

mandatory: true

type: integer

default: 1

range: –

cmdline flag: -r
Number of looks:

mandatory: true

type: positive floating-point number

default: 1.0

range: –

cmdline flag: -l

Frost¶

Radius: see Lee
Deramp:

mandatory: true

type: positive floating-point number

default: 1.0

range: –

cmdline flag: -d

Median¶

X Radius:

mandatory: true

type: integer

default: 1

range: –

cmdline flag: -Rx
Y Radius:

mandatory: true

type: integer

default: 1

range: –

cmdline flag: -Ry

Multilook (in time domain)¶

This tool implements the space-domain multi-looking method by averaging the single look image with a small sliding window. If input is complex is first extracted the absolute value and then filtering is performed.

Input:	source image
Output:	Filtered image
Menu Entry:	Tools –>Filters –>Multilook
Cmdline tool:	swbMultiLook
Provider:	otbtools plug-in
External SW:	OTB

Commandline help¶

$  swbMultiLook -h

Parameters¶

Source Dataset: see Common Input Parameters
Destination Dataset: see Common Output Parameters
Number of looks in x direction:

mandatory: true

type: positive integer

default: 2

range: –

cmdline flag: -lx
Number of looks in y direction:

mandatory: true

type: positive integer

default: 2

range: –

cmdline flag: -ly
Source Window: see Source/Destination ROI.

Kernel convolution¶

This menu entry contains a set of convolutions with FIR filters. All kernel convolution filters support only real input images.

Input:	source image
Output:	Filtered image
Menu Entry:

Tools –>Filters –>Kernel convolution->Boxcar
Tools –>Filters –>Kernel convolution->Hamming
Tools –>Filters –>Kernel convolution->Hanning
Tools –>Filters –>Kernel convolution->Triang
Tools –>Filters –>Kernel convolution->Blackman
Tools –>Filters –>Kernel convolution->Bartlett
Tools –>Filters –>Kernel convolution->Parzen
Tools –>Filters –>Kernel convolution->Bohman
Tools –>Filters –>Kernel convolution->Blackmanharris
Tools –>Filters –>Kernel convolution->Nuttall
Tools –>Filters –>Kernel convolution->Barthann
Tools –>Filters –>Kernel convolution->Kaiser
Tools –>Filters –>Kernel convolution->Gaussian
Tools –>Filters –>Kernel convolution->General Gaussian
Tools –>Filters –>Kernel convolution->Slepian

Cmdline tool:

gxfir.py –fir_win boxcar
gxfir.py –fir_win hamming
gxfir.py –fir_win Hanning
gxfir.py –fir_win Triang
gxfir.py –fir_win Blackman
gxfir.py –fir_win Bartlett
gxfir.py –fir_win Parzen
gxfir.py –fir_win Bohman
gxfir.py –fir_win Blackmanharris
gxfir.py –fir_win Nuttall
gxfir.py –fir_win Barthann
gxfir.py –fir_win Kaiser
gxfir.py –fir_win Gaussian
gxfir.py –fir_win General Gaussian
gxfir.py –fir_win Slepian

Provider:	gdalextras plug-in
External SW:	GDAL

Commandline help¶

$  gxfir.py -h

Parameters¶

Source Dataset: see Common Input Parameters
Source Band: see Common Input Parameters
Destination Dataset: see Common Output Parameters
Destination Band: number of band where the result will be inserted

mandatory: false

type: integer

default: 1

range: –s

cmdline flag: --outrasterband
Output Format: see Common Output Parameters
Output Data Type: see Common Output Parameters
Source Window: see Source/Destination ROI

Filter windows type: filter type chosen

mandatory: true

type: string

default: –

range: (boxcar’, ‘hamming’, ‘hanning’, ‘bartlett’, ‘triang’, ‘barthann’, ‘blackman’, ‘kaiser’, ‘gauss’, ‘nuttall’, ‘blackmanharris’, ‘parzen’, ‘bohman’, ‘general_gaussian’, ‘slepian’)

cmdline flag: --fir_win

Normalized: if checked the coefficients are normalized

mandatory: true

type: boolean

default: true

range: –

cmdline flag: -n
Filter CutOff: frequency of filter

mandatory: true

type: positive floating-point number

default: 1.0

range: –

cmdline flag: –
Order of filter: number of taps

mandatory: true

type: positive odd integer

default: 3

range: –

cmdline flag: –

Some kind of filter require other parameters:

Slepian, Kaiser
- Width: the transition region (normalized so that 1 corresonds to pi) for use in kaiser FIR filter design. If width is not None, then assume it is the approximate width of the transition region.
  
  mandatory: true
  
  type: positive odd integer
  
  default: 3
  
  range: –
  
  cmdline flag: --fir_wid
General Gaussian, Gauss
- Stddev: Standard Deviation
  
  mandatory: true
  
  type: positive floating-point number
  
  default: 0.4
  
  range: –
  
  cmdline flag: --fir_wp
General Gaussian
- P: Power so for every line the output is:
  
  $e^{-0.5{(\frac{x}{stddev})}^{2p}}$
  
  mandatory: true
  
  type: floating-point number
  
  default: 0.4
  
  range: –
  
  cmdline flag: --fir_wp2

Resampling (spectral domain)¶

This menu entry contains tools for undersampling and oversampling of the input image. The input image can be real or complex.

GSDView Tools Menu Resampling

Oversampling¶

This utility performs oversampling using the zero padding in spectral domain. Doppler centroid is taken into account in the padding step for complex data.

Input:	source image
Output:	oversampled image
Menu Entry:	Tools –>Resampling–>Oversampling
Cmdline tool:	swbOversampling
Provider:	otbtools plug-in
External SW:	OTB

Commandline help¶

$  swbOversampling -h

Parameters¶

Source Dataset: see Common Input Parameters
Destination Dataset: see Common Output Parameters
Oversampling factor:

mandatory: true

type: positive floating-point number

default: 2.0

range: –

cmdline flag: -uds
Source Window: see Source/Destination ROI.
Spectral alignment: a flag which enables the spectral alignment before

zero padding.

mandatory: flase

type: check-box

default: false

range: –

cmdline flag: -align

Warning

It is up to the user to set an appropriate value of the Spectral alignment option. The flag should always be set for data, such as SPOTLIGHT ones, that are affected by spectral folding otherwise the processing will produce wrong results.

Undersampling¶

This utility performs undersampling using cutting and pass band filtering in spectral domain. Doppler centroid is taken into account in the cutting and filtering steps for complex data. It accepts one input.

Input:	source image
Output:	Undersampling image
Menu Entry:	Tools –>Resampling–>Undersampling
Cmdline tool:	swbUndersampling
Provider:	otbtools plug-in
External SW:	OTB

Commandline help¶

$   swbUndersampling  -h

Parameters¶

Source Dataset: see Common Input Parameters
Destination Dataset: see Common Output Parameters
Undersampling factor:

mandatory: true

type: positive floating-point number

default: 2.0

range: –

cmdline flag: -ovs
Source Window: see Source/Destination ROI.
Spectral alignment: a flag which enables the spectral alignment before

zero padding.

mandatory: flase

type: check-box

default: false

range: –

cmdline flag: -align

Warning

It is up to the user to set an appropriate value of the Spectral alignment option. The flag should always be set for data, such as SPOTLIGHT ones, that are affected by spectral folding otherwise the processing will produce wrong results.

Note

Due to bug #437 the Spectral alignment flag is always forced to True for undersampling.

Projection¶

This menu entry contins tools for different kinds of dataset projection. One of them uses a GDAL tool, while the others use OTB tools.

GSDView Tools Menu Projection

Very coarse map projection¶

The Very coarse map projection utility is an image re-projection and warping utility. The program can re-project to any projection supported by Proj.4 projection list.

If a portion of image is selected in the main window the extensions of the output file is set using its Geographic or Projected coordinates basing on selected target projection.

Image coordinates can set selected using mouse in related section too.

Input:	one image
Output:	projected image
Menu Entry:	Tools –> Projection –> Very coarse map projection
Cmdline tool:	gdal_warp.py
Provider:	gdaltool plug-in
External SW:	GDAL

Commandline help¶

$ gdal_warp.py -h

Parameters¶

Source Dataset: see Common Input Parameters
Destination Dataset: see Common Output Parameters
Spatial Reference System: see Other Common Parameters
Georeferenced extents of output file to be created: The extension of the output file . See Source/Destination ROI.
Output Format: see Common Output Parameters
Output Data Type: see Common Output Parameters
Thin plate spline transformer: Force use of thin plate spline transformer based on available GCPs. (Ground Control Points)

mandatory: true

type: boolean

default: false

range: –

cmdline flag: -tps
Resampling method: Resampling method to use.
Available methods are:
- near: nearest neighbour resampling (default, fastest algorithm, worst interpolation quality)
- bilinear: bilinear resampling
- cubic: cubic resampling
- cubicspline: cubic spline resampling.
- lanczos: Lanczos windowed sinc resampling.
mandatory: true

type: string

default: near

range: see previous list

cmdline flag: -r

Slant Range to Ground Range¶

This utility performs the ground projection of the input complex image: the input image is re-sampled in range direction in order to get a regular sampling grid on the reference surface represented by the WGS84 standard ellipsoid.

Coordinate mapping is performed using a least mean square polynomial evaluated at the azimuth central point of the target sub-image.

The slant range to ground range conversion removes one of the main geometric distortion effects that affect SLC SAL data.

it accepts one input.

Input:	source image
Output:	ground projected image
Menu Entry:	Tools –>Projection–>Slant Range to Ground Range
Cmdline tool:	swbGroundProjection
Provider:	otbtools plug-in
External SW:	OTB

Commandline help¶

$  swbGroundProjection  -h

Parameters¶

Source Datasets: see Common Input Parameters
Destination Dataset: see Common Output Parameters
X-Y Spacing: pixel spacing in x direction

mandatory: false

type: two integer

default: (1, 1)

range: –

cmdline flag: -sp
Interp Function: Interpolation Functions:

mandatory: false

type: string

default: LINEAR

range: LINEAR, NEAREST, SINC

cmdline flag: -i

If SINC is chosen user must select one of:
- BLACKMAN
- COSINE
- GAUSSIAN
- HAMMING
- LANCZOS
- WELCH
and set the value of radius

Map correction¶

This utility performs data registration in a selectable cartographic projection. The program only works on detected data in ground range projection.

Input:	source image
Output:	map-corrected image
Menu Entry:	Tools –>Projection–>Map Correction
Cmdline tool:	swbOrthoRectif
Provider:	otbtools plug-in
External SW:	OTB

Commandline help¶

$   swbOrthoRectif  -h

Parameters¶

Source Dataset: see Common Input Parameters
Destination Dataset: see Common Output Parameters
projection: Spatial reference system of the output image. See Other common parameters.
interp function: Interpolation Function: see Slant Range to Ground Range
Source Window: see Source/Destination ROI.
Spacing resolution in meter on x-y Axis: xSpacing, ySpacing: output spacing X, Y (optional). See Slant Range to Ground Range
Number of streaming divisions: number of streaming divisions (optional)

mandatory: false

type: positive integer

default: 0

range: –

cmdline flag: -n
Precise (slow) conversion LLH->RowCol: if set, the precise LLH->RowCol conversion is performed; the process should be very slow.

mandatory: true

type: boolean

default: false

range: –

cmdline flag: -p
Spacing in meters in the x and y direction for the sensor model grid: grid spacing.

mandatory: false

type: two integers

default: (0, 0)

range: –

cmdline flag: -gs

Note

In order to re-project data from a map projection to another the Very coarse map projection utility should be used.

Terrain correction¶

This utility performs ortho-rectification of the input image. It registers the input image into a cartographic projection and uses a DEM for compensating some of the geometric distortions.

The program only works on detected data in ground range projection.

It is expected the user points the program to the folder where the DEM data are stored. At the moment the only supported DEM is SRTM3 version 2_1 in in HGT format. It accepts one input.

Input:	source image
Output:	ortho-rectificated image
Menu Entry:	Tools –>Projection–>Terrain correction
Cmdline tool:	swbOrthoRectif
Provider:	otbtools plug-in
External SW:	OTB

Commandline help¶

$   swbOrthoRectif  -h

Parameters¶

Source Datasets: see Common Input Parameters
Destination Dataset: see Common Output Parameters
Path of DEM: path of DEM

mandatory: true

type: a path in file system

default: $HOME

range: –

cmdline flag: -d

Misc¶

This Tools menu section includes different kinds of useful tools, including the mosaicking of a set of images, correction of nearly black/white borders of an image and generation of small tiles starting from input image.

In mosaicking all the images must be in the same coordinate system and have a matching number of bands, but they may be overlapped, and at different resolutions. In areas of overlap, the last image will be copied over earlier ones.

GSDView Tools Menu Misc

Coarse Mosaic¶

It accepts one, two or more inputs. If a portion of image has been selected when configuration window is shown it will set the output file extension.

Input:	two or more images
Output:	mosaicked image
Menu Entry:	Tools –> Misc –> Coarse Mosaic
Cmdline tool:	gdal_merge.py - o
Provider:	gdaltool plug-in
External SW:	GDAL

Commandline help¶

$ gdal_merge.py -h

Parameters¶

Source Datasets List: List of Source Dataset see Common Input Parameters

mandatory: true

type: list of Source Dataset

default: list of a single empty Source Dataset

range: –

cmdline flag: –
Destination Dataset: see Common Output Parameters
Output Format: see Common Output Parameters
Output Pixel X Size and Y Size: pixel size to be used for the output file. If not specified, the resolution of the first input file will be used.

mandatory: false

type: two integers

default: (0, 0)

range: –
Select Extension of Output: the extents of the output file. If not specified the aggregate extents of all input files will be used. See Source/Destination ROI

Merge to RGB¶

Place each input file into a separate stacked band. If a portion of image has been selected when configuration window is shown it will set the output file extension.

It requires three inputs.

Input:	three images
Output:	mosaicked image
Menu Entry:	Tools –> Misc –> Merge To RGB
Cmdline tool:	gdal_merge.py
Provider:	gdaltool plug-in
External SW:	GDAL

Commandline help¶

$ gdal_merge.py -h

Parameters¶

Source Datasets List: List of Source Dataset see Common Input Parameters

mandatory: true

type: list of Source Dataset

default: list of a single empty Source Dataset

range: –

cmdline flag: –
Destination Dataset: see Common Output Parameters

cmdline flag: -o
Output Format: see Common Output Parameters
Output Pixel X Size and Y Size: pixel size to be used for the output file. If not specified the resolution of the first input file will be used. See Merge to RGB
Select Extension of Output: the extents of the output file. If not specified the aggregate extents of all input files will be used. See Source/Destination ROI

Nearblack¶

Convert nearly black/white borders to black. This utility will scan an image and try to set all pixels that are nearly black (or nearly white) around the collar to exactly black (or white). The processing is all done in 8bit (Bytes). No area selection is allowed and every operation interested the entire image. So if an area is selected on main window, it is ignored.

Input:	8 bit source image
Output:	image with nearly black/white borders modified
Menu Entry:	Tools –> Misc–> Nearblack
Cmdline tool:	nearblack.py
Provider:	gdaltool plug-in
External SW:	GDAL

Commandline help¶

$ nearblack -h

Parameters¶

Source Datasets: see Common Input Parameters
Destination Dataset: see Common Output Parameters

cmdline flag: -o
Output Format: see Common Output Parameters. Forced to HFA
White: Search for nearly white (255) pixels instead of nearly black pixels.

mandatory: true

type: boolean

default: false

range: –

cmdline flag: -white
threshold: select how far from black (or white) the pixel values can be and still considered near black (white).

mandatory: true

type: integer

default: 15

range: –

cmdline flag: -near
nonblack: number of non-black pixels that can be encountered before the giving up search inwards.

mandatory: true

type: integer

default: 2

range: –

cmdline flag: -nb

Tiles¶

This utility generates a directory with small tiles and metadata. No area selection is allowed and every operation interested the entire image. So if an area is selected on main window, it is ignored.

Input:	source image
Output:	directory with small tiles and metadata
Menu Entry:	Tools –> Misc–> Tiles
Cmdline tool:	gdal2tiles.py.
Provider:	gdaltool plug-in
External SW:	GDAL

Commandline help¶

$ gdal2tiles -h

Parameters¶

Source Dataset: see Common Input Parameters
Output Dir: output directory

mandatory: true

type: path in file system

default: current directory

range: –

cmdline flag: –
Profile: Tile cutting profile

mandatory: false

type: string

default: raster

range: (mercator, geodetic, raster)

cmdline flag: -p
Resampling: Resampling method

mandatory: alse

type: string

default: average

range: (average, near, bilinear, cubic, cubics`p, `line, lanczos, antialias)

cmdline flag: -r
Spatial reference system: The spatial reference system used for the source input data. See Other Common Parameters

cmdline flag: -s
zoom: Zoom levels to render (format:‘2-5’ or ‘10’)

mandatory: false

type: positive integer

default: 1

range: –

cmdline flag: -z
Resume: Resume mode. Generate only missing files.

mandatory: false

type: positive integer

default: 1

range: –

cmdline flag: --resume
Verbose: Print status messages to stdout

mandatory: true

type: boolean

default: false

range: –

cmdline flag: -v
Force KML: Generate KML for Google Earth - default for ‘geodetic’ profile and ‘raster’ in EPSG:4326. For a dataset with different projection use with caution!

mandatory: true

type: boolean

default: false

range: –

cmdline flag: --force-kml
No KML: Avoid automatic generation of KML files for EPSG:4326

mandatory: true

type: boolean

default: false

range: –

cmdline flag: --no-kml
Url: URL address where the generated tiles are going to be published

mandatory: true

type: string

default: –

range: –

cmdline flag: --url
Web Viewer: Web viewer to generate

mandatory: false

type: string

default: all

range: (all, google, openlayers, none)

cmdline flag: --webviewer
Title: title used for generated metadata, web viewers and KML files.

mandatory: false

type: string

default: –

range: –

cmdline flag: --title
Copyright: Copyright for the map

mandatory: false

type: string

default: –

range: –

cmdline flag: --copyright
Google Key: Google Maps API key

mandatory: false

type: string

default: –

range: –

cmdline flag: --googlekey
Yahoo Key: Yahoo Application ID

mandatory: false

type: string

default: –

range: –

cmdline flag: --yahookey

mandatory:	true
type:	string
default:	path of opened dataset or empty string
range:	–
cmdline flag:	–

mandatory:	false
type:	integer
default:	1
range:	from 1 to dataset’s number of bands
cmdline flag:	`-b`, `--band`

mandatory:	true if manual filter is chosen
type:	positive odd integer
default:	3
range:	–
cmdline flag:	`--kernelsize`

mandatory:	flase
type:	check-box
default:	false
range:	–
cmdline flag:	`-align`

mandatory:	alse
type:	string
default:	average
range:	(average, near, bilinear, cubic, cubics`p, `line, lanczos, antialias)
cmdline flag:	`-r`

mandatory:	true
type:	string
default:	–
range:	(UTM, STEREOGRAPHIC, LATITUDE - LONGITUDE, LAMBERT, LAMBERT2, SINUS, ECKERT4, TRANSMERCATOR, MOLLOWEID)
cmdline flag:	–

Navigation

Processing tools¶

Common Parameters¶

Common Input parameters¶

Common Output parameters¶

Other Common Parameters¶

Source/Destination ROI¶

General¶

Quicklook¶

Commandline help¶

Parameters¶

Data Export¶

Commandline help¶

Parameters¶

Portion extraction¶

Commandline help¶

Parameters¶

Conversion¶

File format conversion¶

Commandline help¶

Parameters¶

Data type conversion¶

Commandline help¶

Parameters¶

Detection¶

Commandline help¶

Parameters¶

Gain conversion¶

Commandline help¶

Parameters¶

Pct2Rgb (Paletted image to RGB conversion)¶

Commandline help¶

Parameters¶

Band Arithmetic¶

Sum¶

Commandline help¶

Parameters¶

Difference¶

Commandline help¶

Parameters¶

Product With Conjugate¶

Commandline help¶

Parameters¶

Module¶

Commandline help¶

Parameters¶

Phase¶

Commandline help¶

Parameters¶

Real Part¶

Commandline help¶

Parameters¶

Imaginary Part¶

Commandline help¶

Parameters¶

Conjugate¶

Commandline help¶

Parameters¶

Lin <-> Log¶

Commandline help¶

Parameters¶

Power <-> Amplitude¶

Commandline help¶

Parameters¶

Filters¶

Non Linear¶

Commandline help¶

Parameters¶

Lee¶

Frost¶

Median¶

Multilook (in time domain)¶

Commandline help¶

Parameters¶

Kernel convolution¶

Commandline help¶

Parameters¶

Resampling (spectral domain)¶

Oversampling¶

Commandline help¶