installation.md

@@ -103,35 +103,82 @@ Known to work on:
 The resulting executable is in glance/anaconda/bin/glance
 
 
-General Linux Install
-=====================
 
-Tested 2022-09-26 on Ubuntu (Kubuntu) 22.04
+Minimal Development Install for Ubuntu and other Linux distributions
+====================================================================
 
-Assuming most of the required modules are already installed, this might be as small as 100 MiB. If most modules are needed (or you omit `--system-site-packages`), it might be 600 MiB, which is similar to a miniconda install.
 
-You'll need libgeos-dev (`sudo apt install libgeos-dev`) and likely various libqt libraries. 
+This is tested on a minimal Ubuntu 22.04 docker image (`docker pull ubuntu:22.04; docker run -it ubuntu:22.04`) as of 2022-09-27 by Alan De Smet.
+
+For non-Ubuntu systems, you'll need to adjust package installation to your system.
+
+You need git (to get glance) and python's venv module (to at least isolate glance's install, but also any other modules you need that aren't available from the system).
+
+As root:
+
+```
+apt update
+apt install -y git python3-venv
+```
+
+**Optional**: To allow glance to use system-wide module installations, do this. This takes about 933 MiB on a _minimal_ Ubuntu install.
+
+As root:
+
+```
+DEBIAN_FRONTEND=noninteractive apt-get install -y python3-numpy python3-matplotlib python3-mako python3-mock python3-scipy python3-pillow python3-cartopy python3-pil python3-netcdf4 python3-h5py libgeos-dev
+```
+
+
+**Optional**: This provide a system-wind module isntall for the GUI components. It takes about 430 MiB on a _minimal_ Ubuntu install.
+
+As root:
+
+```
+apt install -y python3-pyqt5 
+```
+
+**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
 cd glance
-# You can omit "--system-site-packages" to ensure you're using fresher versions
-# of software from PyPI instead of what is already installed. The install will
-# almost certainly be much larger.
 python3 -mvenv --system-site-packages venv
-source venv/bin/activate
-pip install pyqt5 numpy matplotlib mako mock scipy pillow cartopy pyqt5 netcdf4 h5py
-cd pyglance/
+. venv/bin/activate
+# These "pip install" lines will do nothing if all of the required
+# modules are present on the system already
+pip install numpy matplotlib mako mock scipy pillow cartopy netcdf4 h5py
+pip install pyqt5 # Only needed for glance gui
+cd pyglance
 python3 setup.py develop
-cd ../..
 deactivate
+cd ../..
 ```
 
-Launch with `glance/venv/bin/glance`
+At this point glance can be run as `glance/venv/bin/glance`
+
 
-Packages you might install on Ubuntu:
 
-- python3-cartopy