The GUI

../../_images/manual_gui1.png

Toolbar

In the toolbar you can find the most common tasks. See table below for information on different buttons and their functionality.

Button Button Name Description
mActionDataSourceManager Adds a data source Here you can add data from different sources, e.g. raster and vector
viewlist_mapdock Open a map window Opens a new Map Window
viewlist_spectrumdock Open a spectral library window Opens a new spectral library window
viewlist_textview Open a text window Opens a new text window, you can for example use it to store metadata, take notes etc.
mActionPan Pan Map Moves the map. Can also be achieved by holding the mouse wheel
mActionZoomIn Zoom In Increases the zoom level. You can also scroll the mouse wheel forward.
mActionZoomOut Zoom Out Decreases the zoom level. You can also scroll the mouse wheel backwards.
mActionZoomActual Zoom to native resolution Zoom to the native resolution
mActionZoomFullExtent Zoom to full extent Changes the zoom level of the map you click to show the full extent of all layers visualized in it
select_location Identify Identify locations on the map where you click with the cursor. Use the three options on the right to specify what to identify
mActionIdentify option: Location value Shows pixel values of all layers at the selected position
profile option: Pixel profile Opens spectral library window (if not opened yet) and plots the spectral profile of the selected pixel
pan_center option: Center map Moves the map center to the selected cursor location
link_basic Specify the linking between different maps Opens the Map Linking Dialog

Data Sources

The Data Sources panel lists the data in your current project, comparable to the Layers panel in QGIS. The following data types and their corresponding metadata are available:

  • mIconRasterLayer Raster Data

    • File size: Metadata on resolution and extent of the raster

    • CRS: Shows Coordinate Reference System (CRS) information

    • Bands: Information on overall number of bands as well as band-wise metadata such as name, class or wavelength (if available)

      Note

      Depending on the type, raster layers will be listed with different icons:

      • mIconRasterImage for default raster layers (continuous value range)
      • mIconRasterMask for mask raster layers
      • mIconRasterClassification for classification raster layers

      Also see section on data types for further information.

  • mIconLineLayer Vector Data

    • File size: Shows the file size and extent of the vector layer
    • CRS: Shows Coordinate Reference System (CRS) information
    • Features: Information on number of features and geometry types
    • Fields: Attribute information, number of fields as well as field names and corresponding datatype
  • speclib Spectral Libraries

    • File size: Size of the file on hard disk
    • Profiles: Shows the number of spectra in the library
  • processingAlgorithm Models


Buttons of the Data Sources panel:

Button Description
mActionDataSourceManager This button lets you add data from different sources, e.g. raster and vector. Same function as add_datasource.
mActionRemove Remove layers from the Data Sources panel. First select one or more and then click the remove button.
mActionCollapseTree Collapses the whole menu tree, so that only layer type groups are shown.
mActionExpandTree Expands menu tree to show all branches.
qgis_icon Synchronizes Data Sources with QGIS.

Tip

  • If you want to remove all layers at once, right-click in the Data Sources panel and and select Remove all DataSources
  • The EnMAP-Box also supports Tile-/Web Map Services (e.g. Google Satellite or OpenStreetMap) as a raster layer. Just add them to your QGIS project as you normally would, and then click the qgis_icon Synchronize Data Sources with QGIS button. Now they should appear in the data source panel and can be added to a Map View.

Data Views

The Data Views panel organizes the different windows and their content. You may change the name of a Window by double-clicking onto the name in the list.

Buttons of the Data Views panel:

Button Description
symbology Open the Raster Layer Styling panel
mActionRemove Remove layers from the Data Views panel. First select one or more and then click the remove button.
mActionCollapseTree Collapses the whole menu tree, so that only layer type groups are shown.
mActionExpandTree Expands menu tree to show all branches.

Organization of the Data Views panel:

../../_images/example_data_views.png

Example of how different window types and their contents are organized in the Data Views panel. In this case there are two Map Windows and one Spectral Library Window in the project.


Map Window viewlist_mapdock

The map window allows you to visualize raster and vector data. It is interactive, which means you can move the content or zoom in/out.

  • In order to add a new Map Window click the viewlist_mapdock Open a Map Window button. Once you added a Map Window, it will be listed in the Data Views panel.
  • Add layers by either drag-and-dropping them into the Map Window (from the Data Sources list) or right-click onto the layer ‣ Open in existing map…
  • You can also directly create a new Map Window and open a layer by right-clicking the layer ‣ Open in new map

Linking

You can link multiple Map Windows with each other, so that the contents are synchronized. The following options are available:

  • link_mapscale_center Link map scale and center
  • link_mapscale Link map scale
  • link_center Link map center

In order to link Map Windows, go to View ‣ Set Map Linking in the menu bar, which will open the following dialog:

../../_images/map_linking.png

Here you can specify the above mentioned link options between the Map Windows. You may either specify linkages between pairs or link all canvases at once (the All Canvases option is only specifiable when the number of Map Windows is > 2). Remove created links by clicking link_open.

Demonstration of linking two Map Windows

Crosshair

  • Activate the crosshair by right-clicking into a Map Window and select Crosshair ‣ Show

  • You can alter the style of the crosshair by right-clicking into a Map Window and select Crosshair ‣ Style

    ../../_images/crosshair_style.png

Spectral Library Window viewlist_spectrumdock

See section on Spectral Libaries

Text Window viewlist_textview

Spectral Profile Sources

see Section on Spectral Profile Sources

Processing Toolbox

The processing toolbox is basically the same panel as in QGIS. Here you can find all EnMAP-Box processing algorithms listed under EnMAP-Box. In case it is closed/not visible you can open it by clicking the processingAlgorithm button in the menubar or View ‣ Panels ‣ QGIS Processing Toolbox.

../../_images/processing_toolbox.png

See QGIS Documentation - The toolbox for further information.

Cursor Location Values

This tools lets you inspect the values of a layer or multiple layers at the location where you click in the map view. To select a location (e.g. pixel or feature) use the select_location Select Cursor Location button together with the cursorlocationinfo Identify cursor location value option activated and click somewhere in the map view.

  • The Cursor Location Value panel should open automatically and list the information for a selected location. The layers will be listed in the order they appear in the Map View. In case you do not see the panel, you can open it via View ‣ Panels ‣ Cursor Location Values.
../../_images/cursorlocationvalues.png
  • By default, raster layer information will only be shown for the bands which are mapped to RGB. If you want to view all bands, change the Visible setting to All (right dropdown menu). Also, the first information is always the pixel coordinate (column, row).
  • You can select whether location information should be gathered for All layers or only the Top layer. You can further define whether you want to consider Raster and Vector layers, or Vector only and Raster only, respectively.
  • Coordinates of the selected location are shown in the x and y fields. You may change the coordinate system of the displayed coordinates via the mActionSetProjection Select CRS button (e.g. for switching to lat/long coordinates).