Changes

Page history
WIP: general linux install instructions authored by Alan De Smet's avatar Alan De Smet
Show whitespace changes
Inline Side-by-side
installation.md
View page @ f737bd2c
...@@ -114,60 +114,38 @@ You will need: ...@@ -114,60 +114,38 @@ You will need:
- git - git
- python3 - python3
- python3's venv support - python3-venv (python3's venv support)
- python3-dev (python3's development support)
- build-essential (gcc, g++, make)
- cmake
On Debian or Ubuntu, this might do the job if you have sudo access: On Debian or Ubuntu, this might do the job if you have sudo access:
``` ```
sudo apt install git python3 python3-venv sudo apt install git python3 python3-venv build-essentials python3-dev cmake
``` ```
For other distributions you'll need to adjust package installation to your system. For other distributions you'll need to adjust package installation to your system.
**Optionally**, you can install other dependencies system-wide. On Debian/Ubuntu this looks like: <details>
<summary>Using distribution provided dependencies on Debian/Ubuntu with sudo/root</summary>
```
sudo DEBIAN_FRONTEND=noninteractive apt-get install -y build-essential python3-numpy python3-matplotlib python3-mako python3-mock python3-scipy python3-pil python3-cartopy python3-pil python3-netcdf4 python3-h5py libgeos-dev python3-venv python3.10-venv python3-setuptools-whl python3-pip-whl
```
If you don't do so, the `pip` command later will handle installing from PyPI.
**Optionally**, if you want the GUI, you'll need QT5 installed. If you're on Debian or Ubuntu, this might work: You can install most or all of the dependencies using the Debian or Ubuntu distribution repositories using the following command. If you install them all, the `pip install` commands later should do nothing.
``` ```
sudo DEBIAN_FRONTEND=noninteractive apt-get install -y libqt5gui5 sudo DEBIAN_FRONTEND=noninteractive apt-get install -y build-essential python3-numpy python3-matplotlib python3-mako python3-mock python3-scipy python3-pil python3-cartopy python3-pil python3-netcdf4 python3-h5py libgeos-dev python3-venv python3.10-venv python3-setuptools-whl python3-pip-whl
``` ```
**Optionally**, you can install the pyqt5 dependencies system-wide as well: If you want the GUI, add python3-pyqt5:
``` ```
sudo DEBIAN_FRONTEND=noninteractive apt-get install -y python3-pyqt5 sudo DEBIAN_FRONTEND=noninteractive apt-get install -y python3-pyqt5
``` ```
</details>
Finally, as a user install glance. If you want to force a local install, perhaps for testing, omit `--system-site-packages`. Run these as your normal user:
**If** you didn't install the system-wide packages, you'll need basic build tools to install some modules (at least cartopy). In that case, you'll need this. It's about 100 MiB on a _minimal_ Ubuntu install.
As root:
```
apt install -y build-essentials python3-dev
```
**IF** you didn't install the system-wide packages, and you want GUI support, you'll need the QT5 library. It's about 360 MiB on a _minimal_ Ubuntu install.
As root:
```
apt install -y libqt5gui5
```
Finally, as a user install glance. The `pip install` should do no actual installs for any system-wide modules that are present. Alternatively, you can omit `--system-site-packages` to force local installed, perhaps for testing.
As a user:
``` ```
git clone https://gitlab.ssec.wisc.edu/evas/UW-Glance.git glance git clone https://gitlab.ssec.wisc.edu/evas/UW-Glance.git glance
... ...
......