Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

--- pispectro-installation [2025/06/18 11:16] – gelöscht - Externe Bearbeitung (Unbekanntes Datum) 127.0.0.1
+++ pispectro-installation [2025/06/25 09:54] (aktuell) – [piSpectro Installation] torsten.roehl
@@ Zeile 1: / Zeile 1: @@
+====== piSpectro Installation ======
+ ☚ [[0x0019| 🇩🇪 Deutsch]]
+Die Installation ist grundsätzlich einfach, wurde hier jedoch bewusst sehr detailliert beschrieben,
+um mögliche Unklarheiten oder Hürden von vornherein zu vermeiden.
+----
+===== Übersicht =====
+    - Voraussetzungen
+    - piSpectro Download
+    - Installation
+    - Programm starten
+<note tip>
+**Programm-Update nach der Installation: **
+Gehen Sie ins Menü **Help → Update piSpectro...** und installieren Sie per Klick die neueste Version.
+Es wird empfohlen, dies immer zu machen, wenn Sie das Programm längere Zeit nicht benutzt haben.
+Auf diese Weise arbeiten Sie immer mit der neuesten Version.
+</note>
+----
+===== Details =====
+==== ① Voraussetzungen ====
+  * Raspberry Pi (empfohlen: Raspberry Pi 4 ) mit installiertem Raspbian-Betriebssystem
+<WRAP center round tip 90%>
+Es ist immer gut, vorher das Raspbian-System zu aktualisieren:
+  sudo apt update
+  sudo apt upgrade
+Dies stellt sicher, dass alle Paketlisten aktuell sind und die neuesten Versionen installiert werden.
+</WRAP>
+==== ② ''piSpectro'' Download ====
+  * Nach dem Herunterladen die Datei entpacken ✔
+==== ③ Installation ====
+  * Das eigentliche Programm muss nicht installiert werden. Die Installation bezieht sich lediglich auf die benötigten Bibliotheken, um das Programm ausführen zu können.
+  * Um das Programm **sauber** zu installieren, wird auf dem Raspberry Pi eine eigene **piSpectro-Umgebung** eingerichtet.
+<WRAP center round info 90%>
+**  Vorteile dieser Methode:**
+    * Das Programm kann jederzeit rückstandsfrei deinstalliert werden.
+    * Bestehende Konfigurationen des Systems bleiben unverändert.
+    * Die Installation erfolgt durch einen einzigen Aufruf des mitgelieferten Installationsskripts.
+    * Nach der Installation muss nur noch in die **piSpectro-Umgebung** gewechselt werden – danach kann das Programm gestartet werden.
+</WRAP>
+Wechseln Sie in der Konsole in das Verzeichnis `pispectro/doc/readme`:
+  cd pispectro/doc/readme
+Machen Sie das Script `setup_pispectro.sh` ausführbar:
+  chmod 775 ./setup_pispectro.sh
+Starten Sie anschließend das Script:
+  ./setup_pispectro.sh
+<WRAP center round tip 90%>
+** Virtuelle Umgebung aktivieren und deaktivieren**
+Nach erfolgreicher Einrichtung muss die virtuelle Umgebung aktiviert werden:
+  source ~/.pispectro/bin/activate
+Dies aktiviert die Python-Umgebung `.pispectro`.
+Am Terminal-Prompt ist dies erkennbar: Es erscheint ein Präfix wie z. B.:
+  (.pispectro) user@raspberrypi:~/pfad/zum/projekt$
+Solange diese Umgebung aktiv ist, werden alle Python-Befehle in diesem Kontext ausgeführt (z. B. mit den installierten Bibliotheken wie `pyqtgraph`, `astropy`, etc.).
+Zum Verlassen bzw. Deaktivieren der Umgebung:
+  deactivate
+Danach verschwindet der Präfix aus dem Prompt, und es wird wieder das systemweite Python verwendet.
+</WRAP>
+====  ④ Programm starten ====
+  * Öffnen Sie ein Terminal und wechseln Sie in das Verzeichnis ''pispectro/src'', in dem sich das Programm ''pispectro.py'' befindet.
+  * Machen Sie das Programm ausführbar (nur einmal nötig):
+    chmod 775 ./pispectro.py
+  * Aktivieren Sie die virtuelle Umgebung:
+    source ~/.pispectro/bin/activate
+  * Starten Sie anschließend das Programm mit:
+    ./pispectro.py
+Dieser Befehl muss im Verzeichnis ausgeführt werden, in dem sich die Datei ''pispectro.py'' befindet.