pgp1-python-einfuehrung/documentation/Kapitel 0. Wie installiere ich Jupyternotebooks .md

# 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.
    
    <img src =/images/MaterialPythonkurs092018/DownloadAnacondaWindows.png width = 60%>
    
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:
    
    <img src = "./images/MaterialPythonkurs092018/AnacondaNavigatorStartseite.png" width = 60%>

    * 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: 

    <img src = "./images/MaterialPythonkurs092018/AnacondaNavigatorEnvSeite.png" width = 60%>

    * Ü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.