Changes

Page history
Update setting up development installation on Ubuntu authored by Alan De Smet's avatar Alan De Smet
Show whitespace changes
Inline Side-by-side
installation.md
View page @ e0818bad
...@@ -79,9 +79,9 @@ glance is available as `glance/anaconda/bin/glance` ...@@ -79,9 +79,9 @@ glance is available as `glance/anaconda/bin/glance`
Minimal Development Install for Ubuntu and other Linux distributions Minimal Development Install for Ubuntu and other Linux distributions
==================================================================== ====================================================================
(Verified on 2022-09-29 by Alan De Smet on the ubuntu:22.04 docker image, using the optional "Using distribution provided dependencies" step) (Verified on 2025-02-03 by Alan De Smet on Ubuntu 24.04)
You will need: You will need these packages:
- git - git
- python3 - python3
...@@ -97,23 +97,13 @@ On Debian or Ubuntu, this might do the job if you have sudo access: ...@@ -97,23 +97,13 @@ On Debian or Ubuntu, this might do the job if you have sudo access:
sudo apt install git python3 python3-venv build-essential python3-dev cmake sudo apt install git python3 python3-venv build-essential python3-dev cmake
``` ```
For other distributions you'll need to adjust package installation to your system. The following packages aren't necessary, but if installed they'll be used instead of copies installed later by pip.
<details>
<summary>Click here for using distribution provided dependencies on Debian/Ubuntu with sudo/root</summary>
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 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 sudo 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-pyqt5
``` ```
If you want the GUI, add python3-pyqt5:
```
sudo DEBIAN_FRONTEND=noninteractive apt-get install -y python3-pyqt5
```
</details>
If you want to force a local install, perhaps for testing, omit `--system-site-packages`. Run these as your normal user: If you want to force a local install, perhaps for testing, omit `--system-site-packages`. Run these as your normal user:
...@@ -126,10 +116,9 @@ python3 -mvenv --system-site-packages venv ...@@ -126,10 +116,9 @@ python3 -mvenv --system-site-packages venv
# modules are present on the system already # modules are present on the system already
pip install numpy matplotlib mako mock scipy pillow cartopy netcdf4 h5py pip install numpy matplotlib mako mock scipy pillow cartopy netcdf4 h5py
pip install pyqt5 # Only needed for glance gui pip install pyqt5 # Only needed for glance gui
cd pyglance pip install --editable .
python3 setup.py develop
deactivate deactivate
cd ../.. cd ..
``` ```
At this point glance can be run as `glance/venv/bin/glance` At this point glance can be run as `glance/venv/bin/glance`
... ...
......