diff --git a/Kapitel 0. Wie installiere ich Jupyternotebooks .ipynb b/Kapitel 0. Wie installiere ich Jupyternotebooks .ipynb new file mode 100644 index 0000000..5865b65 --- /dev/null +++ b/Kapitel 0. Wie installiere ich Jupyternotebooks .ipynb @@ -0,0 +1,159 @@ +{ + "cells": [ + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "# Kapitel 0.: Wie installiere ich Jupyternotebooks ?" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Download des Kursmaterials:\n", + "\n", + "Das Kursmaterial befindet sich auf Ilias...\n" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Installieren von IPython:\n", + "\n", + "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 werden wir im speziellen die **Jupyter**-Umgebung nutzen und uns aus zeitlichen Gründen leider nicht tiefgründiger mit **Anaconda** beschäftigen.\n", + "\n", + "Da wir in diesem Kurs **Jupyter Notebooks** verwenden werden und **Jupyter** eine Webanwendung ist empfiehlt es sich auch einen schnellen und etwas besseren Browser zu nutzen. Zu empfehlen wären hier entweder **Firefox** oder **Google Chrome**. " + ] + }, + { + "cell_type": "markdown", + "metadata": { + "collapsed": true + }, + "source": [ + "### Installieren unter Windows:\n", + "\n", + "Hier eine kurze Anleitung für das installieren von Jupyter unter Windows:\n", + "\n", + "1. Geht auf **https://www.anaconda.com/download/** und klickt auf den großen grünen Button unter Python 3.6 und started den download.\n", + "2. Führt die gedownloadete Anaconda3-5.2.0-Windows-x86_64.exe aus und folgt den Instellationsanweiungen. \n", + " DonwloadAnacondaWindows\n", + " * Sofern ihr nicht den Standardpfad verwenden wollt, könnt ihr auch euren Wunschpfad während der Installation angeben.\n", + " * Bei der Frage *\"Add Anaconda to my path environment\"* setzt ihr einen Hacken, dies erlaubt es euch später Jupyter einfacher zu starten.\n", + " DonwloadAnacondaWindows\n", + " * Später werdet ihr noch gefragt ob ihr *Microsoft Visual Studio Code* installiern wollt. Diesen Schritt könnt ihr überspringen, da es für das programmieren mit IPython und unserem Kurs irrelevant ist.\n", + "3. Um nun zu testen ob bei der Installation die *path environment* korrekt konfiguriert wurden müssen wir ein Terminal öffnen. Ein Terminal in Windows könnt ihr öffnen wenn ihr in die Windowssuchleiste **cmd** eintipp. In das sich geöffnete Terminal führt ihr anschließend die beiden Befehle `where python` und `where conda`. In beiden Fällen sollte im Terminal der Pfad zurück gegeben werden. \n", + "4. Glückwunsch ihr habt die Installation erfolgreich abgeschlossen. Ihr könnt IPython bzw. das Jupyter-Interface starten indem ihr `jupyter notebook` in das **cmd**-Terminal eintippt." + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "### Installation unter Linux:\n", + "\n", + "1. Als erstes müsst ihr die installations Datei beziehen. Dies könnt ihr in dem ihr ein Terminal öffnet und `wget http://repo.continuum.io/archive/Anaconda3-5.2.0-Linux-x86_64.sh` (dies ist eine 64 bit Datei solltet ihr eine 32 bit Datei benötigen müsst ihr die Endung `_64` weglassen.) \n", + "2. Nach dem ihr die Datei gedownlaoded habt installiert ihr sie mit dem Kommando `bash Anaconda3-5.2.0-Linux-x86_64.sh` folgt den Installtionsanweisungen.\n", + " * 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.\n", + " * 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. \n", + "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.\n", + "4. Glückwunsch ihr habt die Installation erfolgreich abgeschlossen. " + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "### Installation ZDV-Rechner:\n", + "\n", + "1. Sucht in der Suchleiste von Windows 10 nach den ZDV Apps V5.\n", + "2. Öffnet anschließend die **ZDV-Apps** Verwaltung.\n", + "3. Sucht innerhalb der Appverwaltuung nach **Jupyter** und fügt es zu euren Apps hinzu.\n", + "4. Meldet euch von eurem Rechner ab und wieder an, damit euren neuen Apps geladen werden.\n", + "5. Startet nun Jupyter über das entsprechende Symbol, oder sucht danach wieder in der Windows 10 Suchleiste." + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "### Jupyter Starten\n", + "Sehr gut, da wir nun alle IPython installiert haben können wir es das erste mal Starten. Dazu müsst ihr wie folgt vorgehen:\n", + "\n", + "* 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`. \n", + " \n", + "* Linux: Ihr tippt in eure Konsolenleiste `jupyter-notebook` ein. \n", + "\n", + "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). \n", + "\n", + "\n", + "\n", + "Erstellt anschließend über den Reiter **New** unter **Notebooks** ein neues Python-Notebook. \n", + "\n", + "\n", + "\n", + "Mit Hilfe des Reiters **File** -> **Rename** können wir unser erstes Notebook umbennenen. Benennt es in *MeinErstesNotebook*." + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Installieren der Kursmaterialien:\n", + "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: \n", + "\n", + "```python \n", + "import os \n", + "print(r'%s'% os.path.abspath(''))\n", + "```\n", + "\n", + "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." + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "#### Installieren eines Stylesheets\n", + "\n", + "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.\n", + "\n", + "```python\n", + "%run Custom_Set_Up.ipynb\n", + "```\n", + "\n", + "Sofern ihr zu einem späteren Zeitpunkt wieder den standard Style verwenden wollt führt ihr diese Codezeile einfach erneut aus." + ] + }, + { + "cell_type": "code", + "execution_count": null, + "metadata": {}, + "outputs": [], + "source": [] + } + ], + "metadata": { + "kernelspec": { + "display_name": "Python 3", + "language": "python", + "name": "python3" + }, + "language_info": { + "codemirror_mode": { + "name": "ipython", + "version": 3 + }, + "file_extension": ".py", + "mimetype": "text/x-python", + "name": "python", + "nbconvert_exporter": "python", + "pygments_lexer": "ipython3", + "version": "3.6.5" + } + }, + "nbformat": 4, + "nbformat_minor": 1 +} diff --git a/Vorbereitung_Kapitel_1.ipynb b/Vorbereitung_Kapitel_1.ipynb index 26ceba9..6381498 100644 --- a/Vorbereitung_Kapitel_1.ipynb +++ b/Vorbereitung_Kapitel_1.ipynb @@ -44,7 +44,7 @@ "\n", "Sie können auch den durch die ZDV angebotenen Jupyter Hub (https://jupyterhub.zdv.uni-mainz.de/hub/login) zur Bearbeitung Ihrer Notebooks verwenden. Hier müssen Sie sich zunächst mit Ihrem Uni-Account anmelden. Danach erscheint eine Auswahlseite, auf der Sie die Art der Jupyter Umgebung auswählen. Für das Praktikum ist die Standardumgebung die richtige Wahl, s. Bild unten.\n", "\n", - "![Screenshot_ZDV_JupyterHub.png](attachment:Screenshot_ZDV_JupyterHub.png)\n", + "![images/Screenshot_ZDV_JupyterHub.png](attachment:Screenshot_ZDV_JupyterHub.png)\n", "\n", "Klicken Sie auf die Schaltfläche **Spawn**, dann öffnet sich, wie bei der lokalen Installation, das Notebook Dashboard.\n", "\n", diff --git a/Screenshot_ZDV_JupyterHub.png b/images/Screenshot_ZDV_JupyterHub.png similarity index 100% rename from Screenshot_ZDV_JupyterHub.png rename to images/Screenshot_ZDV_JupyterHub.png