diff --git a/NOTES.adoc b/NOTES.adoc deleted file mode 100644 index f409318..0000000 --- a/NOTES.adoc +++ /dev/null @@ -1,43 +0,0 @@ -= Notizen - -== TODOs für Vorlesung -* Visualisierung von -** Funktionsaufrufen -** Arrays -* Besser erklären -** Dokumentation lesen -** Funktionsaufruf -** Googeln - -Das war wirklich Neuland für die, dass alles irgendwo mit einem Beispiel erklärt ist. Funktionen aufzurufen war für sie totale Verwirrung und Magie. Die Logik dahinter zu erklären und wie der Computer das Programm "liest" war echt 20x nötig. - - -== Infos von Oliver - -- link:https://www.youtube.com/watch?v=_DUuzZd0iVA[Jupiter Installation] -- link:https://www.youtube.com/watch?v=1S4Cgtkxqhs[Grundlagen zu Notebooks] - - -== Bücher zu Jupyter - -Die folgenden Bücher waren für Kurs nur sehr bedingt hilfreich :( - - -=== Jupyter Cookbook - Over 75 Recipes ... (Packt) - -NOTE: von 2018, default Python 2 - -* Installation verschiedener Kernel -* Beispiele verwenden Python, R, JS, Julia -> nicht alles brauchbar -* Notebooks mit Widgets interaktiv machen -* Security - jeder Jupyter-Kernel kann beliebigen Code ausführen -* JupyterLab = Next Generation Jupyter - neue Features ausprobieren - - -=== Thoughtful Data Science (Packt) - -NOTE: von 2018 - -* eigentlich Werbung/Beschreibung für link:https://github.com/pixiedust/pixiedust[PixieDust] -* evtl einfacher als Pandas/MathPlotLib/... aber wieder etwas ungewartetes. - diff --git a/README.adoc b/README.md similarity index 81% rename from README.adoc rename to README.md index 2df5c22..691bc94 100644 --- a/README.adoc +++ b/README.md @@ -1,6 +1,6 @@ -= Digital Basics: Einführung in die Programmierung mit Python +# Digital Basics: Einführung in die Programmierung mit Python -== Ziele +## Ziele Wir werden gemeinsam @@ -10,7 +10,7 @@ Wir werden gemeinsam * die Basis zur Lösung komplexere Programmieraufgaben schaffen * einige Denkweisen von Informatikern kennen lerenen -== Zielgruppe +## Zielgruppe Das Seminar richtet sich an @@ -19,7 +19,7 @@ Das Seminar richtet sich an * Absolventen und Doktoranden aller Fachrichtungen, die ohne jegliche Voraussetzungen ihre ersten Computerprogramme schreiben möchten. -== Inhalte +## Inhalte * Wie rede ich mit dem Rechner * Erste Schritte mit Python @@ -27,7 +27,7 @@ die ohne jegliche Voraussetzungen ihre ersten Computerprogramme schreiben möcht * Funktionen und Module * Programme aus Funktionen zusammenbauen -== Methoden +## Methoden * Vortrag * Übungen @@ -36,8 +36,8 @@ die ohne jegliche Voraussetzungen ihre ersten Computerprogramme schreiben möcht * Diskussion -*Seminardauer:* 5 UE +**Seminardauer:* 5 UE -*Teilnehmerzahl:* 6-20 +**Teilnehmerzahl:** 6-20 -*Referent:* Christoph Giess, MARS +**Referent:** Christoph Giess, MARS diff --git a/README_Install.md b/README_Install.md new file mode 100644 index 0000000..e141a01 --- /dev/null +++ b/README_Install.md @@ -0,0 +1,24 @@ +Für den Python-Kurs wird Jupyter verwendet. Damit brauchen die Studenten nur einen Webbrowser und müssen nichts auf ihren Geräten installieren. + +Im Verzeichnis `jupyter_book` liegt der Kurs in Form mehrer Jupyter-Notebook-Dateien (Suffix `ipynb`) vor. Aus diesen lässt sich mittels [Jupyter Book](https://jupyterbook.org/) das Vorlesungsskript als PDF und HTML erstellen. Dazu muss Jupyer Book und LaTeX (für PDF) installiert sein. + + +Installation Jupyter Book +``` +python3 -m venv packages +cd packages/ +source ./bin/activate +python3 -m pip install -U pip +pip install matplotlib pandas jupyter-book sphinx-intl +``` + +Vorlesungsscript erstellen: +``` +cd /sq_01_python_intro/jupyter_book/ +make +``` + +Das Ergebnis findet sich dann in `_build/html` bzw. `_build/latex` + +Hinweis: Ich habe es nicht geschafft mit Jupyter Book-Mitteln ein A4-Dokument zu erzeugen und den Namen auf dem Titelbild sauber anzuordnen. Aus dem Grund wird im `Makefile` vor dem `latex`-Aufruf das `.tex`-Dokument manipuliert. +