Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

--- jupyter-basic [2021/05/20 09:48]
egor
+++ jupyter-basic [2021/10/26 14:58] (aktuell)
martin
@@ Zeile 1: / Zeile 1: @@
-//**Jupyter Notebook - Basic Tutorial => Muss mit Screenshots und Files von fertigen Notebooks ergänzt werden!!!**//
+=====Einführung Jupyter Notebook=====
-Jupyter Notebook kann direkt aus Anaconda Navigator gestartet werden:
+Ein //Jupyter Notebook// kann bei einer //Anaconda//-Installation direkt aus dem //Anaconda Navigator// gestartet werden:
-{{:wiki:jupyter_start.png?600|}}
+{{:wiki:jupyter_start.png?400|}}
-Nach dem Start wird automatisch ein Webbrowser geöffnet, der einen lokalen Filebrowser-Interface beinhaltet. Dort kann dann das gewünschte Notebook ausgewählt werden (heir wird es ebenfalls angezeigt ob ein bestimmtes Notebook bereits geöffnet ist und die entsprechende Python-Instanz geöffnet wurde):
+Bei einer //Miniconda//-Installation muss zum Starten der Jupyter-Notebooks ein Befehlsfenster (//Window Command//, //Power Shell//, //Annaconda Prompt// etc.) geöffnet und der Befehl //jupyter-notebook.exe// eingegeben werden. \\
+Bei einigen Windows-Versionen befindet sich ein neues Icon //Jupyter-Notebook (HfM_...)// im Start-Menu, das man einfach anklicken kann. Die Jupyter-Notebooks öffnen sich dann in Browser.
-{{:wiki:jupyter_browse.png?600|}}
+Nach dem Start wird im Browser automatisch ein lokales Datenverzeichnis anzeigt. Dort kann das gewünschte Notebook ausgewählt werden. Dazu muss die entsprechende Datei zuvor in diesem Datenverzeichnis gespeichert werden (Rechtsklick -> Ziel speichern unter). \\
+Außerdem wird angezeigt ob ein bestimmtes Notebook bereits geöffnet ist (geöffnete Notebooks werden grün Angezeigt):
-Die Jupyter Notebooks haben intern eine hierarchische Struktur, die sich in Text- und Code-Zellen unterteilt. Man kann immer anhand der ausgewählten Modus (in Abbildung rot markiert) erkennen, ob in der Zelle Text (Markdown-Modus) oder Code (Code-Modus) ausgeführt werden kann:
+{{:wiki:jupyter_browse.png?500|}}
-{{:wiki:jupyter-mode.png?600|}}
+Die Jupyter Notebooks unterteilen sich in aufeinander folgende Text- und Code-Zellen. Anhand des ausgewählten Modus (in Abbildung rot markiert) kann man jeweils erkennen, ob in der Zelle Text (Markdown-Modus) steht oder Python-Code (Code-Modus) ausgeführt werden kann:
-Python-Code kann dann entsprechend lokal für jede Zelle mit Run-Button ausgeführt werden. Wichtig ist dabei zu merken, dass die Code-Zellen in der Regel der Reihe nach (von oben nach unten) ausgeführt werden. Die genau Reihenfolge der Code-Ausführung wird durch die Zahl links von der Code-Zelle (in Abbildung rot markiert) angezeigt:
+{{:wiki:jupyter-mode.png?500|}}
-{{:wiki:jupyter_order.png?600|}}
+Sowohl Markdown-Zellen als auch Code-Zellen können von jedem User verändert und bearbeitet werden, indem innerhalb eines Blocks die Eingabetaste gedrückt wird. So können etwa Textkommentare ergänzt werden (Markdown) oder Veränderungen im Code vorgenommen werden.
+Eigene, veränderte Versionen des Notebooks können unter neuem Namen lokal abgespeichert werden (Menu: File -> Save as), damit das Original-Notebook unverändert bleibt.
-Will man alle Code-Zellen automatisiert nacheinander Ausführen, dann wählt man "Restart & Run all" in der Kernel-Spalte aus:
+Der **Code** in jeder Zelle kann mit dem Run-Button ausgeführt werden. Während der Ausführung erscheint oben im Browser-Tab eine Sanduhr. Die Code-Zellen werden in der Regel der Reihe nach (von oben nach unten) ausgeführt; die Code-Zellen sind durchnummeriert (in Abbildung rot markiert):
-{{:wiki:jupyter_runall.png?600|}}
+{{:wiki:jupyter_order.png?500|}}
-Generell sind in Jupyter-Notebooks immer ausführliche Informationen zu dem ausgeführten Code und den darin enthaltenen Objekten enthalten, so ist es in der Regel ohne Probleme möglich den Code an eigene Bedürfnisse anzupassen und es getrennt zu speichern. Hierfür verwendet man am besten die "Make a Copy" oder "Save as" Funktionen in der File-Spalte aus:
+Will man alle Code-Zellen nacheinander ausführen, dann wählt man "Restart & Run all" in der Kernel-Spalte aus:
-{{:wiki:jupyter_save.png?600|}}
+{{:wiki:jupyter_runall.png?500|}}
-Ebenso nützlich die "Save and Checkpoint" Funktion - diese ermöglicht Erstellung eines lokalen Sanpshots, damit man bequem verschiedene Werte/Zustände des Notebooks ausprobierten kann. Beim Ausschalten des Jupyter-Noteboooks wird in der Regel der letzte erstellte Snapshot mitgespeichert.
+ACHTUNG: Angesichts der großen Datenmengen in Notendateien dauert es bisweilen ziemlich lange, bis ein Code-Befehl ausgeführt ist. Will man die Ausführung unter- bzw. abbrechen, so geschieht dies über den Menupunkt //Kernel - Interrupt// bzw. //-Shutdown//.
-Will man nun die Arbeit mit dem Jupyter-Noteboook beenden, wählt man die "Close and Halt" Option aus der File-Spalte aus:
+In Jupyter-Notebook-Tutorials wird der Code in der Regel durch ausführliche Informationen ergänzt, die hinter ein #-Zeichen platziert sind. Dabei werden alle Zeilen hinter einer # nicht ausgeführt; dies bietet die Möglichkeit, Erläuterungen zum Code in den Code cells zu vermerken, z.B. wie der Code an die eigenen Bedürfnisse angepasst werden kann - etwa indem eine andere Datei geladen oder indem die Takt- oder Stimmenauswahl geändert wird.\\
+Hierfür verwendet man am besten die //Make a Copy// oder //Save as// Funktionen in der File-Spalte aus:
+{{:wiki:jupyter_save.png?500|}}
+Eine neue Zelle wird mit dem +-Button oder den Menu-Punkt Insert erzeugt und kann dann als Markdown- oder Code-Zelle festgelegt werden.
+Die //Save and Checkpoint//-Funktion ermöglicht es, einen lokalen Snapshots zu erstellen, damit man bequem verschiedene Werte/Zustände des Notebooks ausprobieren kann. Beim Ausschalten des Jupyter-Noteboooks wird in der Regel der letzte erstellte Snapshot mitgespeichert.
+Will man die Arbeit mit dem Jupyter-Notebook beenden, wählt man die //Close and Halt// Option aus der File-Spalte aus. Dies ist notwendig, damit der Python-Kernel ebenfalls beendet werden kann (beim einfachen Schließen des Tabs läuft dieser sonst weiterhin im Hintergrund).
+{{:wiki:jupyter_close.png?500|}}
-{{:wiki:jupyter_close.png?600|}}
-Dies ist notwendig, damit der Python-Kernel ebenfalls mit beendet werden kann (beim einfachen Schlißen des Tabs läuft dieser sonst weiterhin im Hintergrund).