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 icon
in the QGIS toolbar or via from the menubar.
Furthermore, the EnMAP-Box Processing Algorithms provider is available in the Processing Toolbox.
![]()
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 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:
Click the
Open a map view button to add a second map view. This view will appear below the first map view (Map #1).
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.
In the Map #1 list in the Data Views panel, select
hires_berlin.bsq
and drag the layer into Map #2 (you can drag them directly into the map view or the respective menu item under Data Views).In the next step we link both map views, so that zoom and center are synchronized between both: Click the
button or go to and select
Link map scale and center.
Move the map (using
or holding the mouse wheel
) and notice how both map views are synchronized now.
Now we want to change the RGB representation of the enmap_berlin.bsq
image:
- In the Data Views panel click the
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!
- In the RGB tab, look for Predefined and click on the dropdown menu
. You will find several band combination presets. Select Colour infrared.
![]()
Raster Layer Styling panel with selected Color infrared preset
- Try out other renderers and band combinations!
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 150 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.
- First of all, make sure the Processing Toolbox window is opened. If not, activate it via
- Open the Rasterize categorized vector layer algorithm under
- Use the following settings:
- Categorized vector layer:
landcover_berlin_polygon.gpkg
- Grid:
enmap_berlin.bsq
Specify an output filepath under Output Classification and click Run.
Result of the Classification from Vector algorithm (right) and the input grid (left) and polygon dataset (middle)
5. What’s next?¶
Todo
- Tutorials
- Advanced raster algebra using Raster math
See also
If you face issues or have questions, head over to the GitHub Discussions page and start a new discussion.