The Graphical User Interface

Functionalities overview

Todo

move this sub-section to the overview chapter (??)

GSDView has been designed to handle COSMO-SkyMed products. But it can operate with several other missions (ERS, ENVISAT, ALOS, Radarsat, TerraSAR-X, etc.).

In the current version you can open images from different geo-spatial missions and perform different kinds of operations on it, such as:

  • keep multiple datasets opened at the same time
  • modify application settings through an user-friendly GUI
  • create a low resolution overview (quicklook) of a dataset (complex too)
  • execute basic viewing operations such as zoom, stretching (pixels value scaling), scroll, pan and displaying coordinates of mouse pointer
  • display meta-data of products
  • set parameters and launch GDAL tool (such as gdal_translate, gdalwarp, gdal2tiles, gdalmerge, nearblack, pct2rgb) using a user friendly GUI
  • perform some basic operations between images, e.g sum 2 or more images, compute difference, product, extract module, phase, real/imaginary part of a complex dataset, etc.
  • perform kernel based filtering: * with pre-configured kernels and user * provided custom kernel (not yet implemented)
_images/basicfunc_screenshot.jpeg

GSDView main window

Main MDI area

Using GSDView it’s possible to keep and view multiple images at the same time.

_images/main_mdi_area.jpeg

MDI area

Dock panels

Tool windows are used in GSDView to display information and properties of the currently selected data product or a component. These panels are draggable and dockable. If they are not docked you can close them to get more work space. To reactivate a closed window you can go to the toolbar Settings entry in the View menu and enabled the window again.

Todo

use a better figure

_images/dock_panel.jpeg

Dock panels

Data Browser

The Data Browser is a convenient tool for managing your data products. It let’s you organize your product datasets and allows you to manage multiple products within a tree view. If a product is opened, a directory is displayed with small tiles referred to different datasets that shows dataset name, size, level and data type. Under each tile are showed one or more subtiles named Raster Band n.#, referred to a different product raster band. Clicking on one of these tiles, image referred to that raster band is showed on the main window and on the Band Overview Window. Under Raster Band tile are shown one or more subtiles named Overview n.#, each showing image overview at different resolution.

_images/data_browser.jpeg

Dataset browser

Band Overview

Band OverView window shows image at low resolution and size. It displays a selected area over image, whose position follows mouse moving the main window and vice versa.

_images/band_overview.jpeg

Band overview panel

Metadata Viewer

This panel shows a list of input product metadata, whose items are name and value for each metadata.

World Map Panel

When working with satellite data, it is often not obvious at first sight which region of the world is covered by the data product. For this GSDView allows to localize image on o word map, simply looking at World Map Panel.

_images/world_map_panel.jpeg

World map panel

Output Log

Just clicking Output Log button allowed check output log referred to all GSDView current operations. Allowed values of logging are: DEBUG, INFO, WARNING, ERROR and CRITICAL.

Other tools

Zoom

Zoom functionalities are allowed in GSDView to improve customize image overview. By scrolling mouse is allowed to zoom in or zoom out current image view. User can restore the right image view using zoom 1:1 function.

_images/zoom.jpeg

Zoom tools

Pixel Stretching

Pixel Stretching functionality improves pixel viewing by scaling pixels values. GSDView allow to set up lower and upper level of stretching range.

_images/stretching.jpeg

Image stretching tool

Coursor position

This functionality allow to trace Cursor position, showing latitude, longitude and image coordinates values referred to current pointer position.

x:display horizontal image coordinate
y:display vertical image coordinate
lon:display longitude coordinate in east direction
lat:display latitude coordinate in east direction

Preferences Dialog

In order to change GSDView settings it needs to modify Preferences GUI values.

_images/preferences.jpeg

Preferences dialog

Preferences Interface shows two sections: GENERAL and GDAL. :GENERAL: section allows to set up log level, cache directory, maximum cache size and working directory. The cache cleanup button allows the user to clean the data cache folder.

_images/general_preferences.jpeg

General preferences page

GDAL section allows to configure some GDAL environment variables. The GDAL library is used by GSDView to perform several functionalities such as file opening and main tool execution. You can set up maximum size of GDAL libraries, GDAL libraries directory, GDAL libraries not to be used by GSDView, directory in which GDAL plugins linked to GSDView are located and directory containing plugins for OGR drivers.

_images/gdal_preferences.jpeg

GDAL preferences page

Clicking ‘Show detailed GDAL info’ provides a list of available GDAL driver. For each driver are shown ‘Short Name’, ‘Long Name’ ‘Description’, ‘Help Topic’, ‘Extension’, ‘Mime Type’, ‘Creation Data Type’, ‘Creation Option List’, ‘Metadata’.