====== 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.