# 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
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 so that the image
is displayed in full extent
Identify
Identify loactions on the map where you click.
Use the three options on the right to specify
what to identify
Identify cursor location value
Cursor Location Values. Shows pixel values of
all layers at the selected position.
Select pixel profiles
from map
Opens spectral library window (if not opened yet) and
plots the spectral profile of the selected pixel
Center map on clicked location
This tool will move the center of the map
view to the pixel you click on
different maps

## 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 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
Collapses the whole menu tree, so that only
layer type groups are shown.
Expands menu tree to show all branches.

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

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 ¶

The Spectral Library Window can be used to visualize, collect and label spectra. It directly interacts with the Map Window(s), which means spectra can be directly collected from an image. Furthermore, external libraries (ENVI Spectral Library) can be imported.

• Add a new Spectral Library Window using the Add Spectral Library Window button in the toolbar or from the menu bar View ‣ Add Spectral Library Window
• You can import and open existing libraries using the Import Spectral Library button

Buttons of the Spectral Library Window:

Button Description
to the spectral library
into the spectral library
Import Spectral Library
Save Spectral Library
Selects all elements in
the spectral library
Inverts the current selection
Remove selection (deselect everything)
Toggle editing mode
Cut selected rows to clipboard
Copy selected rows to clipboard
Paste features from clipboard
Delete selected features
Save edits
Delete field
Enter the Spectral Library Layer Properties
Switch to form view
Switch to table view

Collecting spectra:

• Make sure to enable the button in the menu bar and open a raster you want to collect spectra from in a Map Window.
• Click in a desired location in the Map Window. The pixels spectral profile at this location will now be shown in the plot in the Library Window. Mind that this will only visualize the spectrum, but nothing is saved at this point.
• To add/save a selected spectrum to the library, click the button. Mind the new table entry on the right of the window. If spectra should be directly added to the library while a pixel is selected/clicked, enable the button.

Tip

Have a look at the Spectral Profile Sources window for more advanced settings for collecting spectra.

Managing spectra:

• You can add additional fields to the table, for example in order to add information to every spectrum (id, name, classification label, …). To do so, enable the editing mode by clicking the Toggle Editing Mode button. Now you can use the New field button to add a new field (mind the type!). After the new field is added, click inside a cell to alter/add its content. To delete a field use the Delete Field button.

• Location of spectra (if available) can be visualized as a point layer by right-clicking into a map window, and selecting Add Spectral Library

• Spectra can be selected in the table and in the plot window itself. Selected spectra will be highlighted (blue background in the table; thicker line in the plot window). Hold the Shift key to select multiple spectra. A selection can be removed by clicking the Deselect All button.

• Remove spectra using the Remove Spectrum button.

• You can save the collected spectra using the Save Profiles in spectral library button.

Colorize spectra by attribute:

• Open the Spectral Library Properties using the button on the lower right.

• Switch to the Symbology tab and select the Categorized renderer at the top

• In the Column droplist select the desired column and click Classify

• Confirm with Apply and close the window.

## Spectral Profile Sources¶

This menu manages the connection between raster sources and spectral library windows.

Button Description
add a new profile source entry
remove selected entries
• In the Source column you can specify a source raster dataset. Double-clicking in the cell will open up a dropdown menu where you can select from all loaded raster datasets.
• Sampling: Here you can choose how spectra are sampled. Double-click into the cell to open the dropdown menu, where you have several options available:
• SingleProfile: Extracts the spectral signature of the pixel at the selected location
• Sample3x3: Extracts spectral signatures of the pixel at the selected location and its adjacent pixels in a 3x3 neighborhood.
• Sample5x5: Extracts spectral signatures of the pixel at the selected location and its adjacent pixels in a 5x5 neighborhood.
• Sample3x3Mean: Extracts the mean spectral signature of the pixel at the selected location and its adjacent pixels in a 3x3 neighborhood.
• Sample5x5Mean: Extracts the mean spectral signature of the pixel at the selected location and its adjacent pixels in a 5x5 neighborhood.
• Destination: Into which spectral library should the extracted spectra be imported. Double-click to open the dropdown menu.
• Scale: Scale factor for on-the-fly conversion (e.g. if your raster is scaled between 0-10000 but you want to store values between 0 and 1 in the spectral library)

## Processing Toolbox¶

The processing toolbox is basically the same panel as in QGIS, i.e. it is mirrored into the EnMAP-Box GUI. Here you can find all the processing algorithms that come with the EnMAP-Box listed under EnMAP-Box. In case it is closed/not visible you can open it via 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 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).