Getting Started

EnMAP-Box Introduction and basic features:


1. Launching the EnMAP-Box

Once you successfully installed the EnMAP-Box, you can access the plugin via the enmapbox icon in the QGIS toolbar or via Raster ‣ EnMAP-Box from the menubar. Furthermore, the EnMAP-Box Processing Algorithms provider is available in the Processing Toolbox.

../_images/manual_gui.png

Fig. 4 The Graphical User Interface (GUI) of the EnMAP-Box on first open

Tip

Have a look at the User Manual for a detailed description of the GUI.

2. Loading data

You can load an example dataset into your project by selecting Project ‣ Add Example Data in the menu bar. On a fresh installation you will be asked to download the dataset, confirm with OK. The data will be added automatically into a single map view and will be listed in the Data Sources panel as well.

3. First steps in the GUI

By default the example data is loaded into a single map view. Let’s rearrange those for better visualisation and in order to get to know the GUI functionalities:

  1. Click the viewlist_mapdock Open a map view button to add a second map view. This view will appear below the first map view (Map #1).

  2. We want to arrange the windows so that they are next to each other (horizontally): Click and hold on to the blue area of Map #2 and drag it to the right of Map #1 (see figure below). The translucent blue rectangle indicates where the map window will be docked once you stop holding the left mouse button.

    ../_images/mapviewshift.png
  3. In the Map #1 list in the Data Views panel, select aerial_potsdam.tif and drag the layer into Map #2 (you can drag them directly into the map view or the respective menu item under Data Views).

  4. In the next step we link both map views, so that zoom and center are synchronized between both: Click the link_basic button or go to View ‣ Set Map Linking and select link_all_mapscale_center Link map scale and center.

  5. Move the map (using mActionPan or holding the mouse wheel mouse_wheel) and notice how both map views are synchronized now.

Now we want to change the RGB representation of the enmap_potsdam.tif image:

  1. In the Data Views panel click the symbology Open Raster Layer Styling button, which will open a new panel. Here you can quickly change the renderer (e.g., singleband gray, RGB) and the band(s) visualized. You can do so manually using the slider or by selecting the buttons with predefined wavelength regions based on Sentinel-2 (e.g. G = Green, N = Near infrared). The raster layer needs to have wavelength information for the latter to work!

  2. In the RGB tab, look for Predefined and click on the dropdown menu combo. You will find several band combination presets. Select Colour infrared.

../_images/rasterlayerstyling.png

Fig. 5 Raster Layer Styling panel with selected Color infrared preset

  1. Try out other renderers and band combinations!

Tip

Once you selected/activated the slider (i.e., clicked mouse_leftclick on it) you can use the arrow keys / to switch back and forth between bands!

4. Use a Processing Algorithm

In this section we will use a processing algorithm from the EnMAP-Box algorithm provider. The EnMAP-Box adds more than 180 Processing Algorithms to the QGIS processing framework. Their scope ranges from general tasks, e.g. file type conversions or data import to specific applications like machine learning. In this example we are converting a polygon dataset with information on different landcover types into a classification raster, i.e., we are going to rasterize the vector dataset.

  1. First of all, make sure the Processing Toolbox window is opened. If not, activate it via View ‣ Panels ‣ Processing Toolbox

  2. Open the Rasterize categorized vector layer algorithm under EnMAP-Box ‣ Vector conversion

  3. Use the following settings:

  • Categorized vector layer: landcover_potsdam_polygon.gpkg

  • Grid: enmap_potsdam.tif

  1. Specify an output filepath under Output Classification and click Run.

    ../_images/example_rasterize_classification.png

    Fig. 6 Result of the Classification from Vector algorithm (right) and the input grid (left) and polygon dataset (middle)

5. What’s next?

See also

If you face issues or have questions, head over to the GitHub Discussions page and start a new discussion.