FAQ & Troubleshooting

Frequently Asked Questions

This is a list of Frequently Asked Questions about the EnMAP-Box. Feel free to suggest new entries!

Installation

no module named pip

In case you run into problems during installation because pip is not available in your python environment (error message C:/.../python3.exe: No module named pip or similar), follow these steps:

Start the OSGeo4W installer from the OSGeo4W Shell by calling
```
setup
```
Now navigate through the first pages of the dialog, by selecting the following settings:
- Advanced Installation Next
- Installation from Internet Next
- default OSGeo4W root directory Next
- local temp directory Next
- direct connection Next
- Select downloadsite https://download.osgeo.org Next
Then use the textbox to filter, select and install the following packages:
- python3-pip
- python3-setuptools
Click on the symbol once, which should usually change the Skip setting to installing the most recent version. Only AFTER having selected both packages, click Next.

Demonstration of package selection in the Setup

Optional Python dependencies for SpecDeepMap

These dependencies are only required for using algorithms of the SpecDeepMap Application. Run the following command in the OSGeo4W Shell:
```
pip install --user lightning==2.5.0.post0 segmentation-models-pytorch==0.5.0 tensorboard==2.19.0 torch==2.6.0 torchvision==0.21.0 pandas==2.2.3 --no-warn-script-location
```

Importing PRISMA products: Install h5py and gdal-hdf5

Start the OSGeo4W installer by executing:
```
setup
```
Search for h5py, select the latest version of the python3-h5py package.

Now search for gdal-hdf5, select the latest version and finish the installation.

Error ensomap / numba / TypeError jitdebug

EnSoMAP requires Numba, a JIT compiler that translates python code into fast machine code. Numba is not part of a standard QGIS installation, and installing it on standard Windows/macOS installations can be tricky. If you want to use EnSoMAP and numba, we recommend using a Conda-based QGIS environment instead.
1. Install conda and create a conda environment with QGIS as described here.
2. Install Numba:
```
(qgis_stable) $>conda install numba --channel=conda-forge
```
3. Start the conda QGIS by:
```
(qgis_stable) $>qgis
```
4. If not already done, install the EnMAP-Box to your Conda-QGIS with the QGIS Plugin Manager.
Installing packages is terrible slow / takes too long

Conda can use different approaches to check which packages can be installed on your OS. To significantly speed up this process, it is highly recommended to use the libmamba solver.
1. First, check which solver is used:
```
conda config --show solver
```
2. If the used solver is not libmamba, you can install it with the following commands:
  
  conda update -n base conda conda install -n base conda-libmamba-solver conda config –set solver libmamba
For more details, see the Anaconda blog post on this topic.

General Installation Issues

Image Cube tool missing qtopengl / Missing OpenGL / QtOpenGL packages

On some systems we experience problems related to missing OpenGL support.
1. Ensure that you have installed OpenGL drivers that support your graphic card
2. Ensure that PyOpenGL is installed (python3 -m pip install PyOpenGL).
On Linux, it might be necessary to install the Python bindings for QtOpenGL in order to start the Image Cube tool:
```
sudo apt install python3-pyqt5.qtopengl
```

Exception: Unable to find full path for “dockpanel.ui”. Make its directory known to UI_DIRECTORIES

It’s likely that an update of the EnMAP-Box plugin failed to remove a previous version properly. The following workaround might help:
1. Navigate into the active QGIS profile folder via Settings ‣ User Profiles ‣ Open Active Profile Folder
2. Close QGIS. This is necessary to avoid any file handles on files or folders of the EnMAP-Box plugin.
3. Delete the EnMAP-Box plugin folder manually, e.g., default/python/plugins/enmapboxplugin if the active QGIS profile is default.
4. Restart QGIS and install the most-recent EnMAP-Box version.

Known Issues

Here is a list of known issues, that aren’t fixed easily, and/or only affect a specific version of QGIS or operating system:

https://github.com/EnMAP-Box/enmap-box/labels/known%20issue
Historic (old repository): https://bitbucket.org/hu-geomatics/enmap-box/issues?component=known+issue&status=on+hold

Bug report & feedback

Note

Your feedback is more than welcome! In case you encounter any problems with the EnMAP-Box or have suggestions of any kind for improving it (or this documentation), please let us know!

Please report issues here

For questions use GitHub Discussions

Contact

E-Mail: enmapbox@enmap.org

Newsletter: Subscribe to the EnMAP mailing list to be informed about new EnMAP-Box releases and other EnMAP related news. Click here for more information.

Citation

Please cite the EnMAP-Box as:

Jakimow, B., Janz, A., Thiel, F., Okujeni, A., Hostert, P., van der Linden, S., 2023. EnMAP-Box:
Imaging spectroscopy in QGIS. SoftwareX 23, 101507. https://doi.org/10.1016/j.softx.2023.101507

BibTeX:

@article{JAKIMOW2023101507,
title = {EnMAP-Box: Imaging spectroscopy in QGIS},
journal = {SoftwareX},
volume = {23},
pages = {101507},
year = {2023},
issn = {2352-7110},
doi = {10.1016/j.softx.2023.101507},
url = {https://doi.org/10.1016/j.softx.2023.101507},
author = {Benjamin Jakimow and Andreas Janz and Fabian Thiel and Akpona Okujeni and Patrick Hostert and van der Linden, Sebastian}
}