macOS-Installation

Wir empfehlen die Installation einer 64-bit Version, wenn du ein 64-bit Betriebssystem benutzt. Wenn du dir nicht sicher bist: Heutzutage ist fast jedes System 64-bit.

Es müssen alle Schritte (Installieren, Testen, Aktualisieren) ausgeführt werden!

Falls du nicht am LaTeX-Kurs teilnimmst, ist MacTeX optional. Dann kannst du allerdings kein TeX in matplotlib benutzen (führt zu weniger schönen Plots).

Falls du nur am LaTeX-Kurs teilnehmen willst, solltest du mindestens VSCodium (oder einen anderen Texteditor) und MacTeX installieren.

Installation

Wichtig: Befehle im Terminal Zeile für Zeile eingeben und mit Enter bestätigen!

Terminal

• Das Terminal ist in jeder OS X Distribution enthalten
• Im Spotlight nach “Terminal” suchen
• Das Programm befindet sich in Programme/Dienstprogramme/Terminal.app

Command Line Tools

Die Command Line Tools beinhalten unter anderem Git und einen C/C++ Compiler. Zur Installation gibst du Folgendes im Terminal ein

xcode-select --install

und führst den Befehl mit Enter aus. Danach “Installieren” auswählen und warten. Der Download wiegt etwa 130 MB.

Python Installation: Miniforge3

Hier müssen im Terminal die folgenden Zeilen einzeln nacheinander eingegeben werden:

cd

curl -LO "https://github.com/conda-forge/miniforge/releases/latest/download/Miniforge3-$(uname)-$(uname -m).sh"

bash Miniforge3-$(uname)-$(uname -m).sh

Die Lizenzvereinbarung muss je nach Größe des Terminals mit Enter bis zum Ende erweitert werden. Und kann mit yes akzeptiert werden. Den Ort der Installation kannst du mit Enter akzeptieren. Do you wish the installer to initialize Miniforge3 by running conda init? yes.

Damit ist die allgemeine Python Umgebung installiert. Jetzt muss noch eine spezielle Python Umgebung für den Toolbox Workshop installiert werden. Dafür musst du erst ein neues Terminal öffnen, dann:

mamba create -y -n toolbox python=3.11 ipython numpy matplotlib scipy uncertainties sympy

Diese startest du mit

mamba activate toolbox

Nach erfolgreicher Installation kannst du die Installationsdatei noch löschen. Diese sollte im aktuellen Ordner liegen, um das zu überprüfen, gib einmal

ls

im Terminal ein. In der ausgegebenen Liste sollte Miniforge3-Darwin-arm64.sh, oder ähnlich, auftauchen. Wenn das so ist, kannst du sie mit dem folgenden Befehl löschen

rm Miniforge3-Darwin-arm64.sh

oder dem entsprechenden Dateinamen. Falls du dir nicht sicher bist, kannst du uns für diesen Punkt auch im Workshop ansprechen.

Texteditor VSCodium

Die Binärdateien, die Microsoft bei VSCode zur Verfügung stellt, sind proprietär und enthalten Tracking Software. Deswegen empfehlen wir VSCodium, eine Open-Source-Variante von VSCode.

• Lade die neuste Version der Datei VsCodium-darwin-<VERSION>.zip von dieser Webseite herunter.
• Das Programm “VSCodium.app” befindet sich dann in der ZIP-Datei im Downloadordner und muss nach Programme verschoben werden.
• Als nächsten Schritt die App öffnen. Bei neueren macOS Versionen verhindert macOS eventuell den Start und du musst zunächst in den Systemeinstellungen unter “Allgemein” und “Sicherheit” auf den “Dennoch öffen” Button klicken.
• In VSCodium mit Shift + cmd + p die Kommando-Palette öffnen und Shell Command: Install 'codium' command in PATH ausführen. Nun wird VSCodium auch geöffnet, wenn im Terminal codium eingeben wird.

Um git beizubringen, VSCodium zu benutzen, im Terminal eingeben:

git config --global core.editor "codium --wait"

MacTeX

Für die Installation von LaTeX kannst du von dieser Webseite MacTeX.pkg herunterladen. Nach dem Download musst du nur noch das Paket installieren.

Jetzt noch die Installation testen!

Testen

Git

Terminal öffnen

git

Es sollte die Git-Hilfe erscheinen.

Für git kannst du im Terminal noch etwas einstellen. Tippe die folgenden Zeilen nacheinander in dein Terminal und bestätige sie mit Enter, aber trage deine eigenen Daten ein!!!:

git config --global user.name "Max Mustermann"
git config --global user.email "max.mustermann@udo.edu"
git config --global rebase.stat true
git config --global merge.conflictstyle diff3

Python

Um python zu testen, musst du erst im Terminal die oben installierte Umgebung installieren:

mamba activate toolbox

Danach kannst du das Programm ipython starten:

ipython

ipython sollte gestartet sein und du hast statt dem $-Zeichen einen nummerierten Prompt. Jetzt gibst du jeweils den Teil der Zeile nach dem : ein (und bestätigst jeweils mit Enter.

In [1]: %matplotlib
In [2]: import matplotlib.pyplot as plt
In [3]: import numpy as np
In [4]: import scipy
In [5]: import sympy
In [6]: import uncertainties
In [7]: plt.plot([1, 2, 4])

Es sollte ein Fenster mit einem Plot erscheinen, dieses kannst du schließen und ipython beenden mit

In [8]: quit

Make

Tippe

make

im Terminal und führe es aus. Es sollte folgende Ausgabe oder das deutsche Äquivalent erscheinen:

make: *** No targets specified and no makefile found.  Stop.

TeX

Im Terminal:

luatex

Es sollte folgende Ausgabe erscheinen:

This is LuaTeX, Version 1.17.0 (TeX Live 2023)
restricted system commands enabled.
**

Mit Strg + c beenden.

biber

Es sollte die Biber-Hilfe erscheinen.

texdoc texlive

Es sollte die Dokumentation von TeXLive geöffnet werden (in einem PDF-Betrachter).

Aktualisieren

Python Update

Im Terminal:

mamba update -n toolbox --all

TeXLive

Im Terminal:

sudo tlmgr update --self --all --reinstall-forcibly-removed