Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

--- pispectro-installation [2025/06/20 10:44] – torsten.roehl
+++ pispectro-installation [2025/06/25 09:54] (aktuell) – [piSpectro Installation] torsten.roehl
@@ Zeile 1: / Zeile 1: @@
 ====== piSpectro Installation ======
-[[0x0019|☚ HOME]]
-<WRAP center round tip 90%>
+ ☚ [[0x0019| 🇩🇪 Deutsch]]
-Step by Step
-</WRAP>
+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
+    - Voraussetzungen
-  - Installation
+    - piSpectro Download
-  - Programm starten
+    - 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 ====
+==== ① Voraussetzungen ====
-  * Raspberry Pi (5) - mit Raspian
-        * sudo apt update
+  * Raspberry Pi (empfohlen: Raspberry Pi 4 ) mit installiertem Raspbian-Betriebssystem
-        * sudo apt upgrade
+<WRAP center round tip 90%>
-==== ''piSpectro'' Download ====
+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.