"Wenn Sie auf Probleme stoßen, werfen Sie einen Blick auf den [ausgezeichneten Problembehandlungsabschnitt](https://carstenbauer.github.io/WorkshopWizard.jl/dev/troubleshooting/) aus dem WorkshopWizard-Paket von Carsten Bauer (das von `install.jl` verwendet wird)."
"Wenn Sie auf Probleme stoßen, werfen Sie einen Blick auf den [ausgezeichneten Problembehandlungsabschnitt](https://carstenbauer.github.io/WorkshopWizard.jl/dev/troubleshooting/) aus dem WorkshopWizard-Paket von Carsten Bauer (das von `install.jl` verwendet wird)."
]
]
},
},
{
"cell_type": "markdown",
"id": "9161160b-87ff-4b12-bd5a-bca54228672d",
"metadata": {},
"source": [
"## Information about notebooks\n",
"\n",
"Notebooks are tools to interactively run code and display output. They are quite convenient for experimenting with code.\n",
"\n",
"The julia commands are run in a backend julia instance, the browser let's you interact with the notebooks (create new ones, run them, modify them). If the backend program is closed, the browser editor will stop working.\n",
"\n",
"However, if the browser is closed, the backend will keep running. You can get back to it by opening the address:\n",
"[http://localhost:8888](http://localhost:8888)"
]
},
{
"cell_type": "markdown",
"id": "ff3c6951-2bc8-42b9-b2f4-acbb473300c6",
"metadata": {},
"source": [
"## Informationen zu Notebooks\n",
"\n",
"Notebooks sind Werkzeuge, um interaktiv Code auszuführen und die Ausgabe anzuzeigen. Sie sind sehr praktisch, um mit Code zu experimentieren.\n",
"\n",
"Die Julia-Befehle werden in einer separaten Julia-Instanz im Hintergrund ausgeführt, der Browser ermöglicht die Interaktion mit den Notebooks (das Erstellen neuer Notebooks, das Ausführen und Modifizieren von ihnen). Wenn das Backend-Programm geschlossen wird, funktioniert der Browser-Editor nicht mehr.\n",
"\n",
"Wenn jedoch der Browser geschlossen wird, läuft das Backend weiter. Sie können darauf zugreifen, indem Sie die Adresse öffnen:\n",
"[http://localhost:8888](http://localhost:8888)"
]
},
{
"cell_type": "markdown",
"id": "a915cd2f-dc38-4679-8d79-c2204e2073cf",
"metadata": {},
"source": [
"### Notebooks\n",
"\n",
"Notebooks are files characterized by the extension `.ipynb`. Using the interactive file explorer you can open them.\n",
"\n",
"The notebooks contain code, the output of the code, and can contain additional comments (like these ones). All the material of the course does not contain yet the output of the code, you will get it by running the code first.\n",
"\n",
"The notebooks are automatically saved every now and then, however to make sure they are saved, you can press Ctrl + S."
]
},
{
"cell_type": "markdown",
"id": "c974b7c0-119c-4223-ad80-dce5a3ceead3",
"metadata": {},
"source": [
"### Notebooks\n",
"\n",
"Notebooks sind Dateien, die durch die Erweiterung `.ipynb` gekennzeichnet sind. Mit dem interaktiven Datei-Explorer können Sie sie öffnen.\n",
"\n",
"Die Notebooks enthalten Code, die Ausgabe des Codes und können zusätzliche Kommentare enthalten (wie diese hier). Das gesamte Material des Kurses enthält noch nicht die Ausgabe des Codes, Sie erhalten sie, indem Sie den Code zuerst ausführen.\n",
"\n",
"Die Notebooks werden automatisch alle paar Minuten gespeichert, um jedoch sicherzustellen, dass sie gespeichert sind, können Sie Strg + S drücken.\n"
]
},
{
"cell_type": "markdown",
"id": "93606623-16a4-4263-9906-a79dd3fae22f",
"metadata": {},
"source": [
"### Cells\n",
"\n",
"Notebooks are made up of **cells**. There are two main types: **code** and **markdown**. This is a markdown cell, it is used to display text in a formatted way.\n",
"\n",
"The next is a code cell, it is used to run code and display its output. To run it, click on it and press Shift + Enter."
]
},
{
"cell_type": "markdown",
"id": "8c98e5f5-5a92-415a-b9ec-865972d45b6f",
"metadata": {},
"source": [
"### Zellen\n",
"\n",
"Notebooks bestehen aus **Zellen**. Es gibt zwei Hauptarten: **Code** und **Markdown**. Dies ist eine Markdown-Zelle, sie wird verwendet, um Text auf eine formatierte Weise anzuzeigen.\n",
"\n",
"Die nächste ist eine Code-Zelle, sie wird verwendet, um Code auszuführen und dessen Ausgabe anzuzeigen. Um sie auszuführen, klicken Sie darauf und drücken Sie Shift + Enter."
]
},
{
"cell_type": "code",
"execution_count": null,
"id": "8074a659-e100-49db-b83c-f0738b25cf28",
"metadata": {},
"outputs": [],
"source": [
"println(\"Hello World!\")"
]
},
{
"cell_type": "markdown",
"id": "5fc38ba1-65d0-490f-8c06-4136a7ff1372",
"metadata": {},
"source": [
"When you click on a code cell, you can also modify its content.\n",
"To modify a markdown cell, you need to double click on it (however this is not required by this course).\n",
"\n",
"It is also possible to transform a code cell in a markdown cell, or the other way around. To do so, go in the top menu, Run, Cell Type.\n",
"\n",
"Finally, new cells can be added by using the `+` symbol in the top menu.\n",
"\n",
"Every time there is an exercise left to the reader, we added an empty code cell."
]
},
{
"cell_type": "markdown",
"id": "192dac00-072c-4699-bd06-9af6ae4e3055",
"metadata": {},
"source": [
"Wenn Sie auf eine Code-Zelle klicken, können Sie auch deren Inhalt ändern. Um eine Markdown-Zelle zu ändern, müssen Sie darauf doppelklicken (dies ist jedoch für diesen Kurs nicht erforderlich).\n",
"\n",
"Es ist auch möglich, eine Code-Zelle in eine Markdown-Zelle oder umgekehrt zu ändern. Gehen Sie dazu im oberen Menü auf Ausführen, Zellentyp.\n",
"\n",
"Schließlich können neue Zellen hinzugefügt werden, indem Sie das `+`-Symbol im oberen Menü verwenden.\n",
"\n",
"Jedes Mal, wenn eine Übung für den Leser übrig bleibt, haben wir eine leere Code-Zelle hinzugefügt."
]
},
{
{
"cell_type": "markdown",
"cell_type": "markdown",
"id": "d3d75953",
"id": "d3d75953",
"metadata": {},
"metadata": {},
"source": [
"source": [
"## Verifying everything works\n",
"## Verifying that everything works\n",
"\n",
"\n",
"A few quick commands to run:"
"To check if the installation was successfull, run the following cell."
]
]
},
},
{
{
...
@@ -119,9 +240,9 @@
...
@@ -119,9 +240,9 @@
"id": "e7730114-5064-46d1-b724-e92277ff2f90",
"id": "e7730114-5064-46d1-b724-e92277ff2f90",
"metadata": {},
"metadata": {},
"source": [
"source": [
"## Überprüfung, ob alles funktioniert\n",
"## Überprüfen, ob alles funktioniert\n",
"\n",
"\n",
"Ein paar schnelle Befehle zum Ausführen:"
"Um zu überprüfen, ob die Installation erfolgreich war, führen Sie die folgende Zelle aus."
The course requires various things: a working installation of [Julia 1.9](https://julialang.org/downloads/), [Jupyter](https://jupyter.org/), [IJulia.jl](https://github.com/JuliaLang/IJulia.jl), the course material and various dependencies. To get everything follow these steps:
The course requires various things: a working installation of [Julia 1.9](https://julialang.org/downloads/), [Jupyter](https://jupyter.org/), [IJulia.jl](https://github.com/JuliaLang/IJulia.jl), the course material and various dependencies. To get everything follow these steps:
### 1) Getting Julia
### 1) Getting Julia
For following the course you will need **Julia 1.9**.
For following the course you will need **Julia 1.9**.
Julia can be easily obtained in binary form from [Julia downloads](https://julialang.org/downloads/).
Julia can be easily obtained in binary form from [Julia downloads](https://julialang.org/downloads/).
### 2) Getting all the rest
### 2) Getting all the rest
To get the remaining files and dependencies start up `julia` and in the resulting REPL shell, copy and paste the following:
To get the remaining files and dependencies start up `julia` and in the resulting REPL shell, copy and paste the following:
This [downloads the install.jl script](https://gitlab.mathematik.uni-stuttgart.de/stammbn/julia-seminar/-/raw/main/install.jl?ref_type=heads) and runs it from julia.
This [downloads the install.jl script](https://gitlab.mathematik.uni-stuttgart.de/stammbn/julia-seminar/-/raw/main/install.jl?ref_type=heads) and runs it from julia.
### 2) Getting all the rest (expert version)
### 2) Getting all the rest (expert version)
As an alternative you can also also run the following commands manually (this requires to have `git` and `julia` available from the commandline):
As an alternative you can also also run the following commands manually (this requires to have `git` and `julia` available from the commandline):
To start the notebook make sure to be in the folder `Julia-seminar` and then run `julia`: an interactive Julia command line will open. In there run this command
To start the notebook make sure to be in the folder `Julia-seminar` and then run `julia`: an interactive Julia command line will open. In there run this command
```
```
using IJulia; notebook(dir=pwd())
using IJulia; notebook(dir=pwd())
```
```
and the notebook will automatically open in a browser.
and the notebook will automatically open in a browser.
### Troubleshooting
### Troubleshooting
If you are facing issues, check out
If you are facing issues, check out
the [great troubleshooting section](https://carstenbauer.github.io/WorkshopWizard.jl/dev/troubleshooting/)
the [great troubleshooting section](https://carstenbauer.github.io/WorkshopWizard.jl/dev/troubleshooting/)
from the WorkshopWizard package by Carsten Bauer (which is being used by `install.jl`).
from the WorkshopWizard package by Carsten Bauer (which is being used by `install.jl`).
Der Kurs erfordert verschiedene Dinge: eine funktionierende Installation von [Julia 1.9](https://julialang.org/downloads/), [Jupyter](https://jupyter.org/), [IJulia.jl](https://github.com/JuliaLang/IJulia.jl), das Kursmaterial und verschiedene Abhängigkeiten. Um alles zu bekommen, befolgen Sie diese Schritte:
Der Kurs erfordert verschiedene Dinge: eine funktionierende Installation von [Julia 1.9](https://julialang.org/downloads/), [Jupyter](https://jupyter.org/), [IJulia.jl](https://github.com/JuliaLang/IJulia.jl), das Kursmaterial und verschiedene Abhängigkeiten. Um alles zu bekommen, befolgen Sie diese Schritte:
### 1) Julia herunterladen
### 1) Julia herunterladen
Um dem Kurs zu folgen, benötigst du **Julia 1.9**.
Um dem Kurs zu folgen, benötigst du **Julia 1.9**.
Julia kann leicht in binärer Form von den [Julia-Downloads](https://julialang.org/downloads/) bezogen werden.
Julia kann leicht in binärer Form von den [Julia-Downloads](https://julialang.org/downloads/) bezogen werden.
### 2) Alles andere herunterladen
### 2) Alles andere herunterladen
Um die verbleibenden Dateien und Abhängigkeiten zu erhalten, starte `julia` und kopiere im resultierenden REPL-Shell folgenden Code:
Um die verbleibenden Dateien und Abhängigkeiten zu erhalten, starte `julia` und kopiere im resultierenden REPL-Shell folgenden Code:
Das [lädt das install.jl-Skript herunter](https://gitlab.mathematik.uni-stuttgart.de/stammbn/julia-seminar/-/raw/main/install.jl?ref_type=heads) und führt es in Julia aus.
Das [lädt das install.jl-Skript herunter](https://gitlab.mathematik.uni-stuttgart.de/stammbn/julia-seminar/-/raw/main/install.jl?ref_type=heads) und führt es in Julia aus.
### 2) Den Rest bekommen (Experten-Version)
### 2) Den Rest bekommen (Experten-Version)
Als Alternative können Sie auch die folgenden Befehle manuell ausführen (dies setzt voraus, dass `git` und `julia` von der Kommandozeile aus verfügbar sind):
Als Alternative können Sie auch die folgenden Befehle manuell ausführen (dies setzt voraus, dass `git` und `julia` von der Kommandozeile aus verfügbar sind):
Um das Notebook zu starten, stellen Sie sicher, dass Sie sich im Ordner `Julia-seminar` befinden, und führen Sie dann `julia` aus: Eine interaktive Julia-Befehlszeile wird geöffnet. Führen Sie darin folgenden Befehl aus:
Um das Notebook zu starten, stellen Sie sicher, dass Sie sich im Ordner `Julia-seminar` befinden, und führen Sie dann `julia` aus: Eine interaktive Julia-Befehlszeile wird geöffnet. Führen Sie darin folgenden Befehl aus:
```
```
using IJulia; notebook(dir=pwd())
using IJulia; notebook(dir=pwd())
```
```
und das Notebook wird automatisch im Browser geöffnet.
und das Notebook wird automatisch im Browser geöffnet.
### Fehlerbehebung
### Fehlerbehebung
Wenn Sie auf Probleme stoßen, werfen Sie einen Blick auf den [ausgezeichneten Problembehandlungsabschnitt](https://carstenbauer.github.io/WorkshopWizard.jl/dev/troubleshooting/) aus dem WorkshopWizard-Paket von Carsten Bauer (das von `install.jl` verwendet wird).
Wenn Sie auf Probleme stoßen, werfen Sie einen Blick auf den [ausgezeichneten Problembehandlungsabschnitt](https://carstenbauer.github.io/WorkshopWizard.jl/dev/troubleshooting/) aus dem WorkshopWizard-Paket von Carsten Bauer (das von `install.jl` verwendet wird).
Notebooks are tools to interactively run code and display output. They are quite convenient for experimenting with code.
The julia commands are run in a backend julia instance, the browser let's you interact with the notebooks (create new ones, run them, modify them). If the backend program is closed, the browser editor will stop working.
However, if the browser is closed, the backend will keep running. You can get back to it by opening the address:
Notebooks sind Werkzeuge, um interaktiv Code auszuführen und die Ausgabe anzuzeigen. Sie sind sehr praktisch, um mit Code zu experimentieren.
Die Julia-Befehle werden in einer separaten Julia-Instanz im Hintergrund ausgeführt, der Browser ermöglicht die Interaktion mit den Notebooks (das Erstellen neuer Notebooks, das Ausführen und Modifizieren von ihnen). Wenn das Backend-Programm geschlossen wird, funktioniert der Browser-Editor nicht mehr.
Wenn jedoch der Browser geschlossen wird, läuft das Backend weiter. Sie können darauf zugreifen, indem Sie die Adresse öffnen:
Notebooks are files characterized by the extension `.ipynb`. Using the interactive file explorer you can open them.
The notebooks contain code, the output of the code, and can contain additional comments (like these ones). All the material of the course does not contain yet the output of the code, you will get it by running the code first.
The notebooks are automatically saved every now and then, however to make sure they are saved, you can press Ctrl + S.
Notebooks sind Dateien, die durch die Erweiterung `.ipynb` gekennzeichnet sind. Mit dem interaktiven Datei-Explorer können Sie sie öffnen.
Die Notebooks enthalten Code, die Ausgabe des Codes und können zusätzliche Kommentare enthalten (wie diese hier). Das gesamte Material des Kurses enthält noch nicht die Ausgabe des Codes, Sie erhalten sie, indem Sie den Code zuerst ausführen.
Die Notebooks werden automatisch alle paar Minuten gespeichert, um jedoch sicherzustellen, dass sie gespeichert sind, können Sie Strg + S drücken.
Notebooks are made up of **cells**. There are two main types: **code** and **markdown**. This is a markdown cell, it is used to display text in a formatted way.
The next is a code cell, it is used to run code and display its output. To run it, click on it and press Shift + Enter.
Notebooks bestehen aus **Zellen**. Es gibt zwei Hauptarten: **Code** und **Markdown**. Dies ist eine Markdown-Zelle, sie wird verwendet, um Text auf eine formatierte Weise anzuzeigen.
Die nächste ist eine Code-Zelle, sie wird verwendet, um Code auszuführen und dessen Ausgabe anzuzeigen. Um sie auszuführen, klicken Sie darauf und drücken Sie Shift + Enter.
Wenn Sie auf eine Code-Zelle klicken, können Sie auch deren Inhalt ändern. Um eine Markdown-Zelle zu ändern, müssen Sie darauf doppelklicken (dies ist jedoch für diesen Kurs nicht erforderlich).
Es ist auch möglich, eine Code-Zelle in eine Markdown-Zelle oder umgekehrt zu ändern. Gehen Sie dazu im oberen Menü auf Ausführen, Zellentyp.
Schließlich können neue Zellen hinzugefügt werden, indem Sie das `+`-Symbol im oberen Menü verwenden.
Jedes Mal, wenn eine Übung für den Leser übrig bleibt, haben wir eine leere Code-Zelle hinzugefügt.
%% Cell type:markdown id:d3d75953 tags:
%% Cell type:markdown id:d3d75953 tags:
## Verifying everything works
## Verifying that everything works
A few quick commands to run:
To check if the installation was successfull, run the following cell.