HELIOS++ Workshop Vorbereitung¶

Drücke Leertaste oder nach Rechts um zur nächsten Seite zu gelangen
Drücke Escape zum Verkleinern

HELIOS++ herunterladen¶

Wir haben eine extra Release für die FOSSGIS vorbereitet. Wähle unten den Download Link für dein Betriebssystem.

Entpacke den Ordner.

Conda-Umgebung aufsetzen¶

Wir nutzen Anaconda, um Pakete zu installieren und Umgebungen zu verwalten. Wenn du bisher noch nicht mit Anaconda gearbeitet hast, lade Anaconda herunter:

Anaconda Individual Edition

Öffne nun eine neue "Anaconda prompt". Navigiere in den helios-Ordner, den du vorher heruntergeladen hast. Hier findest du eine .yml-Datei, mit der du die nötigen Pakete in eine Umgebung fossgis_pyhelios_env.yml laden kannst.

conda env create -f fossgis_pyhelios_env.yml

Conda-Umgebung aktivieren¶

Nun musst du die Umgebung noch aktivieren:

conda activate fossgis_pyhelios_env

Wir nutzen außerdem eine Erweiterung für Jupyter Notebook. Um diese zu installieren, führe folgenden Befehl aus:

conda install -c conda-forge jupyter_contrib_nbextensions

or alternatively with pip: pip install jupyter_contrib_nbextensions

And then:

jupyter contrib nbextension install --user

Für Linux-User¶

Diese Folie ist nur relevant für Linux-User

Navigiere in das helios-Verzeichnis und führe im Terminal das Shell-Skript heliosShell.sh aus, um die Umgebungsvariable LD_LIBRARY_PATH zu setzen:

. ./heliosShell.sh

Die Umgebungsvariable muss in jeder Sitzung neu gesetzt werden.

Installationen testen¶

In der neuen Umgebung in deiner Anaconda prompt, navigiere in den Ordner example_notebooks in deinem entpackten helios-Verzeichnis.

cd <Dateipfad-zum-Speicherort>/helios/example_notebooks

Starte hier Jupyter Notebook, indem du folgenden Befehl ausführst:

jupyter notebook

Öffne das Notebook test_install.ipynb.

Gehe das Notebook durch, um zu testen, ob alle Installationen erfolgreich waren.

CloudCompare installieren¶

Download CloudCompare from this Link: CloudCompare CloudCompare allows you to view and edit point clouds.

Troubleshooting (1/2)¶

In Linux könnt ihr auf folgenden Fehler stoßen, wenn ihr HELIOS++ mit run/helios ausführen wollt:

run/helios: error while loading shared libraries: libarmadillo.so.10: cannot open shared object file: No such file or directory

Dann müsst ihr vermutlich die Umgebungsvariable LD_LIBRARY_PATH setzen. Führt dazu das Bash-Skript im helios-Verzeichnis aus:

. ./heliosShell.sh

Die Umgebungsvariable ist nur für die aktuelle Sitzung gesetzt, in einem neuen Terminal oder nach einem Reboot muss sie erneut gesetzt werden.

Troubleshooting (2/2)¶

Eine andere mögliche Fehlermeldung auf Linux ist:

run/helios: error while loading shared libraries: libopenblas.so.0: cannot open shared object file: No such file or directory

Statt libopenblas.so.0 kann es sich auch um eine andere Bibliothek handeln, die nicht im run-Ordner liegt.

Um den Fehler zu beheben, könnt ihr die fehlende Bibliothek installieren, z.B.:

sudo apt-get install libopenblas0

Kontakt¶

Wenn etwas nicht funktioniert hat, kontaktiere mich per E-Mail:

h.weiser@uni-heidelberg.de