Tools

Add Product

The Add Product menu allows to import satellite products into the EnMAP-Box. It is also possible to drag&drop products from the file explorer (e.g. Windows Explorer). The different import algorithms assign proper metadata like wavelength, band names and data offset and scale, resulting in analysis ready raster data.

Usage

  1. Choose the product type from the Project > Add Product menu.

../../_images/AddProduct.png

  1. Select the associated (metadata) file.

../../_images/AddProduct_2.png
Live demonstration

Add Web Map Services (WMS)

The Add Web Map Services (WMS) menu allows to add predefined WMS to the Data Sources panel:

Usage

  1. Choose a WMS from the Project > Add Web Map Services (WMS) menu.

../../_images/AddWebMapServices.png

  1. Add the WMS to a Map View.

Live demonstration

Band Statistics

The Band Statistics tool reports band histograms and basic statistics like min, max, mean and standard deviation.

Usage

  1. Start the tool from the Tools > Band Statistics menu or from the layer context menu inside the Data Views panel.

  2. Select a raster layer.

  3. Add some bands.

  1. Interactively explore the map.

../../_images/BandStatistics.png
Live demonstration

Bivariate Color Raster Renderer

The Bivariate Color Raster Renderer allows to visualize two bands using a 2d color ramp. Find a mapping example here: https://www.joshuastevens.net/cartography/make-a-bivariate-choropleth-map/

Usage

  1. Start the tool from the Tools > Bivariate Color Raster Renderer menu or from the layer context menu inside the Data Views panel.

  2. Select a raster layer.

  3. Select two bands.

  4. Select or define a color plane.

  5. Interactively explore the map.

../../_images/BivariateColorRasterRenderer.png
Live demonstration

Class Fraction/Probability Renderer and Statistics

The Class Fraction/Probability Renderer and Statistics tool allows to visualize arbitrary many fraction/probability bands at the same time, using a weighted average of the original class colors, where the weights are given by the class fractions/probabilities.

Usage

  1. Start the tool from the Tools > Class Fraction/Probability Renderer and Statistics menu or from the layer context menu inside the Data Views panel.

  2. Select a class fraction layer or a class probability layer.

  3. Select approriate class colors or paste a matching style from another layer.

  4. Interactively explore the map.

../../_images/ClassFractionRenderer.png

Note that the visibility of individual classes can be turned on and off.

Live demonstration

Classification Statistics

The Classification Statistics tool reports class histograms and area covered in percentage, pixel and map units.

Usage

  1. Start the tool from the Tools > Class Fraction/Probability Renderer and Statistics menu or from the layer context menu inside the Data Views panel.

  2. Select a categorized raster layer.

  3. Interactively explore the map.

../../_images/ClassificationStatistics.png
Live demonstration

CMYK Color Raster Renderer

The CMYK Color Raster Renderer allows to visualize 4 bands using the CMYK (Cyan, Magenta, Yellow, and Key/Black) color model. Find a mapping example here: https://adventuresinmapping.com/2018/10/31/cmyk-vice/

Usage

  1. Start the tool from the Tools > CMYK Color Raster Renderer menu or from the layer context menu inside the Data Views panel.

  2. Select a raster layer.

  3. Select CMYK bands.

  4. Interactively explore the map.

../../_images/CMYKColorRasterRenderer.png
Live demonstration

Color Space Explorer

The Color Space Explorer allows a) to select random and predefined RBG band combinations, and b) to animate RGB bands.

Usage

  1. Start the tool from the Tools > Color Space Explorer menu or from the layer context menu inside the Data Views panel.

  2. Select a raster layer.

  3. Select RGB bands:

    1. manually

    2. randomly

    3. from predefined list of RGB band combinations

  4. Animate bands using the Color Space Gradient Step Size settings.

  5. Interactively explore the map.

GUI
../../_images/ColorSpaceExplorer.png
Live demonstration

Decorrelation Stretch Renderer

The Decorrelation Stretch Renderer allows to visualize 3 band. It removes the high correlation commonly found in optical bands to produce a more colorful color composite image.

Usage

  1. Start the tool from the Tools > Decorrelation Stretch Renderer menu or from the layer context menu inside the Data Views panel.

  2. Select a raster layer.

  3. Select RGB bands.

  4. Interactively explore the map.

GUI
../../_images/DecorrelationStretchRenderer.png

Enhanced Multiband Color Renderer

The Ehanced Multiband Color Renderer allows to visualize arbitrary many bands at the same time using individual color canons for each band.

Usage

  1. Start the tool from the Tools > Enhanced Multiband Color Renderer menu or from the layer context menu inside the Data Views panel.

  2. Select a color for each band.

  3. Interactively explore the map.

GUI
../../_images/EnhancedMultibandColorRenderer.png

HSV Color Raster Renderer

The HSV Color Raster Renderer allows to visualize 3 bands using the HSV (Hue, Saturation, Value/Black) color model. Find a mapping example here: https://landmonitoring.earth/portal/ ; select Maps > Global Landcover Dynamics 2016-2020

Usage

  1. Start the tool from the Tools > HSV Color Raster Renderer menu or from the layer context menu inside the Data Views panel.

  2. Select HSV bands.

  3. Interactively explore the map.

GUI
../../_images/HSVColorRasterRenderer.png

Todo

Find a good dataset, that is comparable to the Global Landcover Dynamics 2016-2020 from GeoVille.

Image Cube

The Image Cube tool visualizes a raster image in an interactive 3D view:

../../_images/imagecube_animation.gif

  1. Select the raster image.

  2. Specify the:

    • Top Plane renderer. It can be any raster renderer known from QIGS, e.g. a Multiband

      color renderer that shows the true color bands

    • Cube & Slice renderer. This must be a render that uses a single band only, e.g. a Singleband grey or Pseudocolor renderer. It will colorize the band-related pixel values of the 3D image cube and planes relating to the X, Y or Z slice.

  3. Press Load Data to (re)load and render the raster image values.

../../_images/imagecube_gui.png

The 3D scene contains the following elements:

  • Top Plane - a raster layer for spatial orientation

  • Image Cube - a volumetric representation of the raster image, showing the raster bands on the z axis

  • X Slice - a slice along the raster’s X / column / sample dimension

  • Y Slice - a slice along the raster’s Y / row / line dimension

  • Z Slice - a slice along the raster’s Z / band dimension

  • Box (Image) - a 3D bounding box along the maximum image extent

  • Box (Subset) - a 3D bounding box to show the extent of the spatial subset that migh be used to focus on specific image areas

../../_images/imagecube_gui_slices.png

Metadata Viewer

The Metadata Viewer allows to view and edit GDAL metadata of a raster source.

Usage

  1. Start the tool from the Tools > Metadata Viewer menu.

  2. Select a raster source.

  3. View and edit metadata.

GUI
../../_images/MetadataViewer.png

Multisource Multiband Color Raster Renderer

Todo

WriteTheDocs (use FORCE TSI stacks with TCB/G/W)

Raster Layer Styling

The Raster Layer Styling panel allows to quickly select a RGB, Gray or Pseudocolor visualizations.

Usage

  1. Show the panel via the View > Panels > Raster Layer Styling menu or click symbology Open Raster Layer Styling panel in the Data Views panel.

  2. Select a raster source.

  3. View and edit metadata.

GUI
../../_images/MetadataViewer.png
Live demonstration

It also supports the linking of the style between multiple raster layer.

GUI
../../_images/RasterLayerStyling_2.png
Live demonstration

Raster Source Band Properties Editor

The Raster Source Band Properties Editor allows to view and edit band properties of GDAL raster sources, with special support for ENVI metadata.

Usage

  1. Start the tool from the Tools > Raster Source Band Properties Editor menu.

  2. Select a raster source.

  3. View and edit metadata.

GUI
../../_images/RasterSourceBandPropertiesEditor.png

Reclassify

The Reclassify tool is a convenient graphical user interface for reclassifying classification rasters.

Specify the file you want to reclassify under Input File. Either use the dropdown menu to select one of the layers which are already loaded or use the mActionAddRasterLayer button to open the file selection dialog.

Under Output Classification you can specify the classification scheme of the output classification which will be created.

  • You can import schemes from existing rasters or text files by clicking the plus_green button.

  • Use the classinfo_add button to manually add classes.

  • To remove entries select the respective rows and click the classinfo_remove button.

  • So save a classification scheme select the desired classes (or use Crtl + A to select all) and click on the mActionFileSaveAs button.

  • Likewise, you can copy and paste classes by selecting them and clicking the mActionEditCopy Copy Classes mActionEditPaste Paste Classes buttons.

../../_images/reclassifytool1.png

  • The table is sorted by the Label field in ascending order. The value in Label will become the pixel value of this class and can not be altered.

  • Double-click into the Name field in order to edit the class name.

  • Double-click into the Color field to pick a color.

Under Class Mapping you can reassign the old classes (From) to values of the new classification scheme (To)

../../_images/reclassifytool2.png

Specify the output path for the reclassified image under Output File

Click OK to run the tool.

Scatter Plot

The Scatter Plot allows to plot two raster bands, or a raster band and a vector field against each other. The visualization of both, denstity and scatter is supported.

Plotting Raster Band vs. Raster Band

When plotting raster data against each other, we usually want to display the bin counts as colorized density.

Usage

  1. Start the tool from the Tools > Scatter Plot menu or from the layer context menu inside the Data Views panel.

  2. Select two raster layer bands used for x and y values.

  3. Select Density option for Coloring and choose a color ramp.

  4. Interactively explore the map.

GUI
../../_images/ScatterPlot.png
Live demonstration:

Plotting Raster Band vs. Vector Field

The tool can also be used to plot raster data versus vector attribute values, e.g. for accuracy assessment of quantitative maps.

Usage

  1. Start the tool from the Tools > Scatter Plot menu or from the layer context menu inside the Data Views panel.

  2. Select a raster layer band used as x values, and vector layer field used as y values.

  3. Select Scatter option for Coloring, choose a color and a symbol.

  4. Active 1:1 line and Fitted line in the Analytics section.

GUI
../../_images/ScatterPlot_2.png

Virtual Raster Builder

See https://virtual-raster-builder.readthedocs.io/en/latest/