Linux without ArcGIS

Prerequisites

  • 64-bit x86 processor

  • Recent build of a Debian-based distribution; we have only tested Ubuntu and Mint

  • Python 3.9 or later; we have only tested CPython (i.e. the reference implementations of Python released on python.org). Currently, 3.13 is recommended for maximum compatibility with other software MGET needs.

  • GDAL 3.8.0 or later, with its Python bindings. 3.9.0 is highly recommended for numpy 2.x compatibility, which many other recent packages require, which many newer Python packages now require. Please look up instructions on how to install GDAL for your distro, if it doesn’t come with it already.

You may be able to get MGET working on other processors, distributions, or Python implementations if you build MGET from scratch, but we are not currently able to support this. These instructions are written as if you are running an Ubuntu derivative and installing an MGET wheel that we built.

Optional software

These are required to run certain parts of MGET. You can wait to install them later if desired. MGET will report detailed error messages when missing optional software is needed.

  • MATLAB Runtime R2026a (free) or the full version of MATLAB R2026a (not free). Either one is OK. These are required for front detection, larval dispersal simulation, and certain interpolation tools. You must install version R2026a; other versions will not work. Multiple versions can be installed at the same time, so if you use a different version of MATLAB for your own work, you can continue to do so, providing you install the R2026a Runtime for MGET’s use.

Step 1: Verify your Python version

Start a terminal and run:

python3 --version

It should report Python 3.9 or later. If you need to install a new version of Python instead of using what comes with your Linux distribution, we recommend pyenv for managing additional installations.

Step 2: Verify your GDAL version

MGET depends heavily on GDAL. GDAL 3.8.0 or later must be installed, along with its Python bindings. To validate GDAL is installed, start a terminal and run:

gdalinfo --version

If this doesn’t work or reports that GDAL is older than 3.8.0, please install 3.8.0 or later using the package management system appropriate for your Linux distribution. As noted above, we strongly recommend 3.9.0 or later.

Step 3: Create a Python virtual environment (or activate an existing one)

We strongly recommend you not install MGET into the site-packages directory of your system’s default Python installation. Instead, create a virtual environment and install it there. If you don’t know about virtual environments, you should read up on them now.

When you’re ready, start a terminal, change directory to the location where you want the virtual environment to live, and run:

python3 -m venv .venv
source .venv/bin/activate

Replace .venv with a different name, if you prefer.

Your bash prompt should change to something like this:

(.venv) user@hostname:~$

assuming you created the virtual environment in your home directory. The critical thing is that you now see (.venv) at the beginning of the command prompt.

If you know what you’re doing, you can use other virtual environment managers instead of venv. Also, we will use pip below to install MGET, but you can use other wheel-compatible installers such as uv instead.

Step 4: Install MGET

From the same virtual environment:

python -m pip install mget3

This will install MGET and the other packages it depends upon.

Click here for some examples of accessing MGET from Python.

Uninstalling MGET

To uninstall MGET from your virtual environment:

python -m pip uninstall mget3

Or, if you don’t need the virtual environment anymore, you can delete its directory entirely.