# Kapitel 0.: Wie installiere ich Jupyter Notebooks ?
## Installieren von IPython:
Im allgemeinen empfiehlt es sich als Einsteiger **IPython** bzw. **Jupyter Notebooks** über [**Anaconda**](https://anaconda.org/) zu beziehen. **Anconda** ist dabei eine Art Verwaltungsumgebung für Pyhton. Über Anconda könnt ihr eure Packages verwalten, Notebooksteilen und verschiedene Entiwcklungsumgebungen ausprobieren. Im folgenden wollen wir uns speziellen die **Jupyter**-Umgebung beschränken. Leider können wir aus zeitlichen Gründen nicht genauer auf Anaconda eingehen. Ihr könnt aber viele nützliche Videos auf Youtube finden bzw. einen Blick in die [Dokumentation](https://docs.anaconda.com/anaconda/) werfen.
Da es sich bei **Jupyter-Notebooks** um eine Webanwendung handelt, empfiehlt es sich auch einen gescheiten Browser zu nutzen. Zu empfehlen wären hier entweder **Firefox** oder **Google Chrome**.
### Installieren unter Windows:
Hier eine kurze Anleitung für das installieren von Jupyter unter Windows:
1. Geht auf **https://www.anaconda.com/download/** und klickt auf den großen grünen Button unter Python 3.7 und started den download.
2. Führt die `Anaconda3-2019.07-Windows-x86_64.exe` aus und folgt den Instellationsanweiungen.
* Sofern ihr nicht den Standardpfad verwenden wollt, könnt ihr auch euren Wunschpfad während der Installation angeben.
* Folgt anschließend der Installation mit den Standardeinstellungen.
* Am Ende werdet ihr noch gefragt ob ihr *Microsoft Visual Studio Code* installiern wollt. Diesen Schritt könnt ihr überspringen.
3. Glückwunsch ihr habt die Installation erfolgreich abgeschlossen. Ihr könnt IPython bzw. das Jupyter-Interface starten über Anaconda starten. Hierzu sucht entweder in der Suchleiste nach Anaconda, oder sofern ihr eine Verknüpfung in die Startleiste oder Desktop erstellt habt klickt ihr auf das Anaconda Logo.
4. Habt ihr Anaconda gestartet seht ihr nun das folgende Fenster:
* Im roten Kasten markiert mit der 1. seht ihr eure jetzige Programmierumgebung. Gerade für unterschiedliche Projekte kann es sich lohnen verschiedene projektspezifische Umgebungen anzulegen. Für euer Studentenalltag ist dies eher nicht der Fall, hier könnt ihr einfach die Standardumgebung verwenden.
* Über den *Launch*-Button markiert mit dem zweiten roten Kasten könnt ihr ein jupyter-notebook starten. Dieses wird sich in eurem Browser öffnen.
5. Im laufe des Kurses werden verschiedene so genannte "Packages" kennen lernen. Diese Pakete stellen uns je nach Zweck unterschiedliche und nützliche Funktionen zur Verfügung und werden in eurer Programmierumgebung gespeichert. Solltet ihr mal ein weiteres Paket installieren möchten ist dies relative einfach. Klickt hierfür zunächst den Button "Environments" an. Dies öffnet das folgende Fenster:
* Über "Create" (gekennzeichnet mit der 0.) könnt ihr für eine neues Projekt eine neue Umgebung erstellen.
* Sofern ihr nur eine bestehend Umgebung mit einem neuen Paket erweitern möchtet geht wie folgt vor:
* Klickt die Umgebung an (Kasten 1.)
* Wechselt in dem zweiten roten Kasten von *Installed* zu *Not Installed*.
* Sucht mit Hilfe des Suchfeldes in Kasten 3. nach dem Paket/en euer Wahl und setzt für dieses/diese ein Häkchen (Kasten 4.). Anschließen drückt auf das grüne Feld *Apply*.
### Installation unter Linux:
Die Installationsanweisung für LINUX können [hier](https://docs.anaconda.com/anaconda/install/linux/) gefunden werden.
1. Geht auf die Anconda Donwloadseite **https://www.anaconda.com/download/** wechselt auf LINUX und klickt auf den großen grünen Button unter Python 3.7 und started den download.
2. Nach dem ihr die Datei gedownlaoded habt installiert ihr sie mit dem Kommando `~/Downloads/Anaconda3-2019.07-Linux-x86_64.sh` folgt den Installtionsanweisungen.
* Sofern ihr den Standardpfad ändern möchtet könnt ihr dies tun. Ihr solltet lediglich aufpassen, dass der angegebene Pfad nur ein Dateipräfix ist welchem anaconda3 am Ende angefügt wird.
* Am Ende der Installation werdet ihr gefragt ob die `PATH`-Variable von anaconda eurer .bashrc angefügt werden soll. Dies solltet ihr bejahen. Solltet ihr den `PATH`-Eintrag manuell setzten wollen so könnt ihr dies auch tun indem ihr eurer .bashrc um den Eintrag `PATH=EurenPfadname\anaconda3\bin:$PATH` erweitert.
3. Sofern ihr den `PATH` richtig gesetzt habt könnt ihr dies testen in dem ihr im terminal conda list eintippt. Anschließend sollte eine Auflistung von allen installierten python packages erscheinen.
4. Glückwunsch ihr habt die Installation erfolgreich abgeschlossen.
5. Ihr könnt nun jupyter-notebooks über das Kommando `jupyter-notebook` in eurem Terminal starten.
### Installation ZDV-Rechner:
1. Sucht in der Suchleiste von Windows 10 nach den ZDV Apps V5.
2. Öffnet anschließend die **ZDV-Apps** Verwaltung.
3. Sucht innerhalb der Appverwaltuung nach **Jupyter** und fügt es zu euren Apps hinzu.
4. Meldet euch von eurem Rechner ab und wieder an, damit euren neuen Apps geladen werden.
5. Startet nun Jupyter über das entsprechende Symbol, oder sucht danach wieder in der Windows 10 Suchleiste.
### Jupyter Starten
Sehr gut, da wir nun alle IPython installiert haben können wir es das erste mal Starten. Dazu müsst ihr wie folgt vorgehen:
* Windows/Medienraum-Rechner: Ihr startet *Jupyter Notebook* über das entsprechnde Verknüpunfsicon. Habt ihr kein Icon auf dem Desktop oder in der Startleiste erstellen lassen. Nutzt die Suchfunktion von Windows bzw. ruft ein Terminal mit **cmd** auf und nutzt den Befehl `jupyter notebook`.
* Linux: Ihr tippt in eure Konsolenleiste `jupyter-notebook` ein.
In beiden Fällen sollte nach einer kurzen Wartezeit automatisch euer standard Browser (Firefox) starten und euch die Home-Seite von Jupyter anzeigen. Diese sieht wie im nachfolgenden Bild dargestellt aus (unter Linux fehlt der Reiter Conda).
Erstellt anschließend über den Reiter **New** unter **Notebooks** ein neues Python-Notebook.
Mit Hilfe des Reiters **File** -> **Rename** können wir unser erstes Notebook umbennenen. Benennt es in *MeinErstesNotebook*.
## Installieren der Kursmaterialien:
Verschiebt nun das gedownloadete Kursmaterial in das Home-Verzeichnis von IPython. Sofern ihr das Home-Verzeichnis nicht kennt können wir dieses ganz einfach heraus finden. Tippt dazu das nachfolgende in *MeinErstesNotebook* ein:
```python
import os
print(r'%s'% os.path.abspath(''))
```
Anschließend speichert ihr das Notebook in dem ihr oben Links auf das Disketensymbol klickt (wisst ihr überhaupt was eine Diskette ist :-P ?). Um euren ersten Code-Schnippsel auszuführen müsst ihr entweder **Strg** + **Enter** oder **Shift** + **Enter** drücken. Verschiebt nun den Kursmaterialordner in den angegeben Pfad und anschließend *MeinErstesNotebook* in den Kursmaterialsordner.
#### Installieren eines Stylesheets
Als letztes wollen wir im Rahmen unseres Kurses den Style der verwendeten Notebooks etwas aufhübschen. Dies ist eines der vielen Vorteile die Jupyter bietet. Um dies zu tun führt in *MeinErstesNotebook* die folgende Zeile aus.
```python
%run Custom_Set_Up.ipynb
```
Sofern ihr zu einem späteren Zeitpunkt wieder den standard Style verwenden wollt führt ihr diese Codezeile einfach erneut aus.
```python
```