WIP: general linux install instructions authored by Alan De Smet's avatar Alan De Smet
......@@ -114,60 +114,38 @@ You will need:
- git
- 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:
```
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.
**Optionally**, you can install other dependencies system-wide. On Debian/Ubuntu this looks like:
```
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.
<details>
<summary>Using distribution provided dependencies on Debian/Ubuntu with sudo/root</summary>
**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
```
</details>
**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:
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:
```
git clone https://gitlab.ssec.wisc.edu/evas/UW-Glance.git glance
......
......