Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

--- pispectro-installation [2025/06/20 10:55] – [Installation] 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
+  * 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'' Download ====
+    ./pispectro.py
-  * Nachdem Herunterladen die Datei extrahieren ✔
-==== Installation ====
-  * Das eigentliche Programm braucht nicht installiert zu werden. Die Installation bezieht sich hier lediglich auf die benötigten Bibliotheken um das Programm ausführen zu können.
-  * Um das Programmm "sauber" zu installiren wirht einen piSpectro-Environment in Raspberry-PI eingerichtet, der Vorteils ist das es damit jederzeit Rückstandsfrei deinstallieet werden kann und außerdem bestehenden Konfigurationen nicht verändertnwerden. Außerdem kann die Instllatoin mit nur einen Aufgruaf des scpts installaerit werden. Anschließen muss nur in die piScpreotr  umgebunggewschescht werden und das progrmm kann gestartet werden.
-## 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.
+Dieser Befehl muss im Verzeichnis ausgeführt werden, in dem sich die Datei ''pispectro.py'' befindet.
-- Um das Programm **sauber** zu installieren, wird auf dem Raspberry Pi eine eigene **piSpectro-Umgebung** eingerichtet.
-  Der Vorteil dabei ist:
-  - Das Programm kann jederzeit rückstandsfrei deinstalliert werden.
-  - Bestehende Konfigurationen des Systems werden nicht verä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.