IdePix

IdePix Water Pixel Classification

I/O Parameters

Selecting the IDEPIX Generic classification of pixels... entry from the VISAT tool menu opens another sub-menu with the two entries 'Water...' and 'Land...'. Selecting 'Water' from this sub-menu pops up the 'IDEPIX Pixel Identification Tool - Water' dialog:

Idepix Water Processing Dialog

Source Products

MERIS L1b product: Here the user specifies the MERIS L1b source product. The combo box presents a list of all products open in VISAT. The user may select one of these or, by clicking on the button next to the combo box, choose a product from the file system.

Target Product Group

Name: Used to specify the name of the target product.

Save to: Used to specify whether the target product should be saved to the file system. The combo box presents a list of file formats, currently BEAM-DIMAP, GeoTIFF, and HDF5.

Open in VISAT: Used to specify whether the target product should be opened in VISAT. When the the target product is not saved, it is opened in VISAT automatically.

Processing Parameters

Selecting the Processing Parameters tab in the 'IDEPIX Pixel Identification Tool - water' dialog switches to the following view:

Idepix Water Processing Parameters

Parameters

Write TOA reflectances to the target product: This checkbox indicates if the TOA reflectances shall be written to the target product.

Write gas absorption correction flag to the target product: This checkbox indicates if the gas absorption correction flag shall be written to the target product. The coding of the gas absorption correction flag is shown in the figure below.

Idepix Water Gas Flags

Write Rayleigh corrected reflectances to the target product: This checkbox indicates if the Rayleigh corrected reflectances shall be written to the target product.

Write Spectral Unmixing Abundance Bands to the target product: This checkbox indicates if the abundance bands from the spectral unmixing process shall be written to the target product. For more details see the help documentation of the BEAM Spectral Unmixing Tool [4].

Write Cloud Probability Feature Value to the target product: This checkbox indicates if the Cloud Probability Feature Value shall be written to the target product. This value is a floating point number in the interval [1.0, 2.0] describing the increasing probability of a pixel being cloudy (1.0 = certainly clear, 2.0 = certainly cloudy).

Write Sea Ice Climatology Max Value to the target product: This checkbox indicates if the Sea Ice Climatology Max Value shall be written to the target product. This value is a probability in the interval [0.0, 100.0] describing the maximum probability of a pixel being covered by sea ice, with respect to a global sea ice climatology given on monthly resolution.

Width of cloud buffer (# of pixels): This value is the width of a cloud 'safety buffer' around a pixel which was classified as cloudy.

Cloud screening 'ambiguous' threshold: This value is the threshold of Cloud Probability Feature Value above which a cloud is regarded as still ambiguous. 'Ambiguous' means that this cloud is not 100% sure, and an atmospheric correction may be possible, depending on the performance of an atmospheric correction and the accuracy requirements.

Cloud screening 'sure' threshold: This value is the threshold of Cloud Probability Feature Value above which a cloud is regarded as sure.


Menu Bar

'File' Menu

Selecting the File entry in the Menu Bar opens the following view:

File Menu

Open Parameters...: When this entry is selected, an 'Open File' dialog will appear. Here, a BEAM GPF parameters XML file can be selected, containing IdePix water pixel classification parameters which were saved earlier. These parameters will be loaded and applied for an upcoming processing.

Save Parameters...: When this entry is selected, a 'Save File' dialog will appear. Here, the current set of IdePix water pixel classification parameters can be saved into a BEAM GPF parameters XML file for later re-usage.

Display Parameters...: When this entry is selected, the current set of IdePix water pixel classification parameters will be displayed in XML format (see below).

Water File Menu Display Parms

'Help' Menu

Selecting the Help entry in the Menu Bar opens the following view:

Help Menu

Help: When this entry is selected, this online help is opened in a separate window.

About...: When this entry is selected, an 'About' dialog for the current processor is opened (see below).

Help Menu About

Button Group

Button Group

Run: When this button is clicked, the processing will be started with the selected parameters.

Close: When this button is clicked, the processor tool window will be closed.



Processing from Command Line

Since the IdePix water pixel classification makes use of the BEAM graph processing framework, it can be used also with the 'gpt' command line tool outside BEAM-VISAT. The graph processing is invoked by the command
To obtain general help on the graph processing, use the command
Specific help on the IdePix water pixel classification can be obtained with
Information on the usage and a list of all available parameters are given.

IdePix water pixel classification parameters




The processing from the command line can also be invoked using graph XML files. For example, an IdePix water pixel classification could be started with
with a MERIS L1b input file 'MER_Idepix_test.dim' (given in BEAM Dimap format) in the current directory, and a graph XML file 'test_idepix_water.xml' as shown below.

IdePix water pixel classification