The GUI¶

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
Adds a data source Here you can add data from different sources, e.g. raster and vector
Open a map window Opens a new Map Window
Open a spectral library window Opens a new spectral library window
Open a text window Opens a new text window, you can for example use it to store metadata, take notes etc.
Pan Map Moves the map. Can also be achieved by holding the mouse wheel
Zoom In Increases the zoom level. You can also scroll the mouse wheel forward.
Zoom Out Decreases the zoom level. You can also scroll the mouse wheel backwards.
Zoom to native resolution Zoom to the native resolution
Zoom to full extent Changes the zoom level of the map you click to show the full extent of all layers visualized in it
Identify Identify locations on the map where you click with the cursor. Use the three options on the right to specify what to identify
option: Location value Shows pixel values of all layers at the selected position
option: Pixel profile Opens spectral library window (if not opened yet) and plots the spectral profile of the selected pixel
option: Center map Moves the map center to the selected cursor location
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:

• 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:

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

Also see section on data types for further information.

• 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
• Spectral Libraries

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

Buttons of the Data Sources panel:

Button Description
This button lets you add data from different sources, e.g. raster and vector. Same function as .
Remove layers from the Data Sources panel. First select one or more and then click the remove button.
Collapses the whole menu tree, so that only layer type groups are shown.
Expands menu tree to show all branches.
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 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
Open the Raster Layer Styling panel
Remove layers from the Data Views panel. First select one or more and then click the remove button.
Collapses the whole menu tree, so that only layer type groups are shown.
Expands menu tree to show all branches.

Organization of the Data Views panel:

Map Window ¶

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 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

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

• Link map scale and center
• Link map scale
• 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:

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 .

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

Spectral Library Window ¶

See section on Spectral Libaries

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 button in the menubar or View ‣ Panels ‣ QGIS Processing Toolbox.

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 Cursor Location button together with the 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.
• 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 Select CRS button (e.g. for switching to lat/long coordinates).