initial push

README.md

@@ -0,0 +1,122 @@
+# Benutzerhandbuch
+
+Dieses Handbuch dokumentiert die Installation und Nutzung der AQUA-Vorlage für Präsentationen mit der LaTeX Beamer Class. Ergänzungen an Handbuch und Vorlage sind immer willkommen und können gerne per [EMail](mailto:simon.dierl@cs.tu-dortmund.de) eingereicht werden.
+
+## Voraussetzungen
+
+Um die Vorlage zu nutzen, sind mehrere Komponenten nötig, die vom Nutzer installiert werden müssen.
+
+#### TeX
+
+Die Vorlage ist zur Verwendung mit einer aktuellen TeX-Distribution gedacht und wird nicht mit alten TeX-Compilern oder -Paketen funktionieren. Empfohlen wird eine der folgenden Distributionen:
+
+- [MacTeX](https://www.tug.org/mactex/) 2019 oder höher für Mac OS
+- [MiKTeX](https://miktex.org/) für Windows oder Linux
+- [TeXLive](https://www.tug.org/texlive/) 2019 oder höher für Windows oder Linux
+
+Wichtig ist, dass die vollständige TeX-Distribution installiert wird. Insbesondere in Linux-Distributionen ist es möglich, nur einen Teil der Distribution zu installieren. In diesem Fall funktioniert die Vorlage nicht und die fehlenden Teile müssen installiert werden.
+
+Unter Linux-Distributionen wie Ubuntu werden leider oft nur veraltete TeXLive-Versionen durch die Paketverwaltung bereitgestellt. In diesem Fall ist ein Update des Betriebssystems nötig oder TeXLive muss manuell installiert werden. Für Debian und Ubuntu stellt die TUG dazu einen [Leitfaden](https://www.tug.org/texlive/debian.html) bereit.
+
+#### Pygments
+
+Zum Setzen von Quellcode müssen das Python-Paket Pygments (sowie ein Python-Interpreter) auf dem System installiert sein. Pygments übernimmt dann das Parsen und syntaktische Auszeichnen der Codeelemente.
+
+Auf Linux-Distributionen sollte das Paket durch den Paketmanager installiert werden, hier ist darauf zu achten, dass das Programm `pygmentize` ebenfalls installiert wird (einige Distributionen trennen Bibliothek und Programm).
+
+Auf anderen Betriebssystemen ist die Verwendung des Python-Paketmanagers `pip` notwendig. Dazu wird auf einer Kommandozeile `pip install Pygments` ausgeführt.
+
+## Kompilieren des Dokumentes
+
+Das Kompilieren eines TeX-Dokuments erfordert mehrere Schritte, um u.A. Hilfsdateien zu erzeugen, zu verarbeiten und Referenzen im Text korrekt aufzulösen. Üblicherweise wird dazu die lokale TeX-Installation genutzt, es existieren aber auch Alternativen.
+
+#### Lokale TeX-Installation
+
+Viele TeX-Editoren wie [TeXStudio](https://www.texstudio.org/) automatisieren den Kompiliervorgang, ohne dass weitere Konfiguration nötig ist. In TeXStudio ist es allerdings nötig, die Erzeugung des Glossars manuell durchzuführen.
+
+Zur Automatisierung des Kompiliervorgangs sind bereits folgende Werkzeuge eingerichtet, die mit TeXLive ausgeliefert werden:
+
+1. [Arara](https://github.com/cereda/arara) wird über `% arara:`-Direktiven in der `thesis.tex` konfiguriert. In der mitgelieferten Konfiguration wird allerdings bei jedem Kompiliervorgang jeder Schritt durchgeführt, was zu langen Bauzeiten führt. Im Wurzelverzeichnis der Vorlage kann ein Bauvorgang mit `arara thesis` ausgelöst werden.
+2. [Latexmk](http://personal.psu.edu/jcc8/software/latexmk-jcc/) wird in der `latexmkrc` konfiguriert und ist selbstständig in der Lage, den Kompiliervorgang auf notwendige Schritte zu reduzieren. Im Wurzelverzeichnis der Vorlage kann ein Bauvorgang mit `latexmk` ausgelöst werden.
+
+Manuelles Kompilieren der Vorlage erfordert folgende Schritte im Wurzelverzeichnis der Vorlage:
+
+1. `lualatex --shell-escape slides` kompiliert das Dokument. Hier ist zu beachten, dass der LuaLaTeX-Compiler genutzt wird, ein Kompilieren mit dem veralteten pdfLaTeX-Compiler ist *nicht* möglich. Die Option `--shell-escape` ermöglicht es, aus dem Dokument beliebige Programme aufzurufen. In der Vorlage wird dies nur zum Aufruf von `pygmentize` genutzt.
+2. `biber slides` verarbeitet die Bibliografie. Biber gehört zum modernen BibLaTeX-Paket, welches anstelle das alten BibTeX genutzt wird.
+4. `lualatex --shell-escape slides` kompiliert das Dokument erneut. In diesem Schritt werden die Bibliografie, der Glossar usw. korrekt eingebunden.
+5. `lualatex --shell-escape slides` kompiliert das Dokument ein letztes Mal, um alle Referenzen zu bereinigen.
+
+Sollte sich die Bibliografie nicht geändert haben, kann auf die entsprechenden Schritte verzichtet werden. Auch können wiederholte Kompiliervorgänge eingespart werden, wenn sich Referenzen in einem früheren Schritt stabilisieren.
+
+#### Nutzung von GitLab CI
+
+Wenn die Arbeit auf einem GitLab (wie z.B. [dem des LS14](https://ls14-scm.cs.tu-dortmund.de/) entwickelt wird, kann die CI-Unterstützung des GitLabs benutzt werden, um die Versionsstände im Git zu bauen. Eine entsprechende Steuerdatei, die `.gitlab-ci.yml`, ist in der Vorlage enthalten. Die Vorlage muss dazu in der Wurzel des Git-Repositorys liegen.
+
+Der Kompiliervorgang wird von Latexmk gesteuert. Veränderungen an der Latexmk-Konfiguration wirken sich also unmittelbar auf die CI-seitige Kompilierung aus.
+
+Für andere CI-Systeme muss eine entsprechende Datei selber verfasst werden, entsprechende Patches sind willkommen.
+
+#### Lokales Docker-Image
+
+Das Docker-Image, welches zum CI-seitigen Kompilieren genutzt wird, kann auch lokal verwendet werden. Das Image umfasst allerdings mehrere GB und der Kompiliervorgang kann mehrere Minuten dauern. Eine lokale TeX-Installation ist also vorzuziehen.
+
+Im Wurzelverzeichnis der Vorlage kann ein Docker-Bauvorgang mit `docker run -v $(realpath .):/doc nopreserveroot/texlive-full latexmk` ausgelöst werden, wobei statt `$(realpath .)` auch der *absolute* Pfad des aktuellen Verzeichnisses angegeben werden kann.
+
+## Konfigurieren der Metadaten
+
+Die Metadaten des Dokumentes werden in der `config.tex` eingerichtet. Die Hilfsdatei `configsupport.tex` sollte dabei nicht verändert werden.
+
+In der Datei werden zunächst die eigentlichen Metadaten definiert:
+
+- Der Title des Vortrags wird mit `\settalktitle{Titel}` definiert.
+- Der oder die Autoren können auf zwei Weisen definiert werden:
+    - `\settalkauthor{Autor}` definiert einen einzelnen Autor und überschreibt dabei die bisherige Liste,
+    - `\addtalkauthor{Autor}` fügt einen weiteren Autor hinzu. Dieses Kommando kann mehrfach benutzt werden.
+- Das Vortragsdatum wird via `\settalkisodate{YYYY-MM-DD}` gesetzt und muss dazu im ISO-Format YYYY-MM-DD angegeben werden.
+
+Nun müssen noch die Daten des zugeordneten Lehrstuhls bzw. der betreuenden Arbeitsgruppe angegeben werden. Für die Arbeitsgruppe AQUA kann einfach der Befehl `\aquaheader` verwendet werden. Ansonsten müssen folgende Variablen gesetzt werden:
+
+- `\setfaculty{Fakultät}` definiert den Namen der Fakultät,
+- `\setchair{Lehrstuhl}` den des Lehrstuhles,
+- `\setworkgroup{Arbeitsgruppe}` den der Arbeitsgruppe (so vorhanden).
+
+Als letztes wird ausgewählt, ob der Vortrag auf Deutsch (`\germantalk`) oder englisch (`\englishtalk`) verfasst wird.
+
+## Konfiguration und Nutzung der eingebundenen Pakete
+
+Die Vorlage bindet in der `header.tex` eine große Menge Pakete ein und nimmt einige notwendige Konfigurationsschritte bereits vor. Es empfiehlt sich, die Handbücher der Pakete zumindest zu überfliegen. Dies kann über die aufgeführten Links geschehen, in einer vollständigen TeX-Installation können die Handbücher für ein Paket aber auch über den Befehl `texdoc Paketname` aufgerufen werden. In TeXstudio öffnet ein Control-Klick auf den Paketnamen die Dokumentation in der PDF-Vorschau.
+
+Die Pakete und Konfigurationsoptionen sind hier in der Reihenfolge ihrer Verwendung in der `header.tex` aufgeführt.
+
+- [`beamer`](http://mirrors.ctan.org/macros/latex/contrib/beamer/doc/beameruserguide.pdf) stellt das Grundgerüst des Dokumentes bereit. Dazu gehören Kommandos wie `\section` und das Format der Folien. Änderungen an der Konfiguration können in den Optionen der `\documentclass` vorgenommen werden. Folgende Pakete werden dabei mit geladen:
+    - [`hyperref`](http://mirrors.ctan.org/macros/latex/contrib/hyperref/doc/manual.pdf) ermöglicht das Setzen von Hyperlinks und wandelt Referenzen automatisch in Hyperlinks um.
+    - [`xcolor`](http://mirrors.ctan.org/macros/latex/contrib/xcolor/xcolor.pdf) ermöglicht die farbige Gestaltung von Dokumenten. Die Option `svgnames` ermöglicht die Verwendung von [SVG-Farbnamen](https://www.w3.org/TR/2011/REC-SVG11-20110816/types.html#ColorKeywords).
+- [`fontspec`](http://mirrors.ctan.org/macros/latex/contrib/fontspec/fontspec.pdf) dient zum Laden von Schriftarten. Konfiguration ist nicht nötig.
+- [`amsmath`](http://mirrors.ctan.org/macros/latex/required/amsmath/amsldoc.pdf) und [`unicode-math`](http://mirrors.ctan.org/macros/latex/contrib/unicode-math/unicode-math.pdf) stellen mathematische Symbole bereit.
+- [`libertinus`](http://mirrors.ctan.org/fonts/libertinus/doc/libertinus-doc.pdf) ersetzt die Standardschriftarten durch die [Libertinus-Schriftenfamilie](https://github.com/alif-type/libertinus).
+- [`polyglossia`](http://mirrors.ctan.org/macros/latex/contrib/polyglossia/polyglossia.pdf) dient zur Unterstützung nicht-englischer Dokumente. Das Kommando `\languagesetup` konfiguriert das Paket passend zur Schriftenauswahl in der `config.tex`.
+- [`datetime2`](http://mirrors.ctan.org/macros/latex/contrib/datetime2/datetime2.pdf) ist für die sprachspezifische Formatierung von Datumsangaben zuständig. Es wird primär innerhalb der Vorlage verwendet.
+- [`algorithm2e`](http://mirrors.ctan.org/macros/latex/contrib/algorithm2e/doc/algorithm2e.pdf) ermöglicht den Satz von Algorithmen in Pseudocode. Dazu stehen zahlreiche Konfigurationsoptionen bereit, auch die Verwendung deutscher Schlüsselwörter ist möglich.
+- [`authoraftertitle`](http://mirrors.ctan.org/macros/latex/contrib/authoraftertitle/authoraftertitle.pdf) ermöglicht die Nutzung von Autor, Titel und Datum durch die Makros `\MyAuthor`, `\MyTitle` und `\MyDate` im Textkörper.
+- [`biblatex`](http://mirrors.ctan.org/macros/latex/contrib/biblatex/doc/biblatex.pdf) ist eine moderne Alternative zum Setzen von Literaturverzeichnissen und bietet zahllose Konfigurationsoptionen. Hier gilt es zu beachten, dass die von Verlagen bereitgestellten BibTeX-Exporte oft die Möglichkeiten von BibLaTeX nicht ausnutzen. Hier empfiehlt sich ein Nachbearbeiten des Exportes. Das Handbuch dokumentiert im Detail die möglichen Eintragstypen und Felder sowie Zitierkommandos. Eine Lektüre ist ratsam. Das zugehörige Kommandozeilentool ist [`biber`](http://mirrors.ctan.org/biblio/biber/documentation/biber.pdf).
+- [`booktabs`](http://mirrors.ctan.org/macros/latex/contrib/booktabs/booktabs.pdf) stellt Kommandos bereits, um Tabellen für Druckerzeugnisse zu setzen. Üblicherweise missachten LaTeX-Tabellen gängige typographische Leitsätze durch zu geringe Abstände der Linien sowie die Verwendung vertikaler Linien. Das Handbuch dokumentiert die Verwendung und gibt eine Einführung in den korrekten Satz von Tabellen.
+- [`draftwatermark`](http://mirrors.ctan.org/macros/latex/contrib/draftwatermark/draftwatermark.pdf) versieht Seiten mit einem Wasserzeichen. Das Paket wird standardmäßig nicht geladen, kann aber zusammen mit der Beispielkonfiguration einkommentiert werden, um *ENTWURF α.1* in den Seitenhintergrund zu setzen. Dies kann helfen, Ausdrucke schnell auseinander zu halten.
+- [`graphicx`](http://mirrors.ctan.org/macros/latex/required/graphics/grfguide.pdf) ermöglicht das Einbinden diverser Grafikdateien in das Dokument.
+- [`microtype`](http://mirrors.ctan.org/macros/latex/contrib/microtype/microtype.pdf) aktiviert die LaTeX-eigene Unterstützung für Mikrotypographie. Dabei werden unsichtbare Veränderungen der Schrift (z.B. Skalieren auf 99% der Breite) vorgenommen, um Silbentrennungen oder das Bedrucken des Seitenrandes zu vermeiden. 
+- [`minted`](http://mirrors.ctan.org/macros/latex/contrib/minted/minted.pdf) dient zum Satz von syntaktisch ausgezeichnetem Quellcode. Zur Verarbeitung des Quellcodes wird das Werkzeug [Pygments](http://pygments.org/) genutzt.
+- [`mleftright`](http://mirrors.ctan.org/macros/latex/contrib/oberdiek/mleftright.pdf) stellt Makros `\mleft` und `\mright` bereit, die einige Probleme im mathematischen Textsatz mit `\left` und `\right` beseitigen.
+- [`pdfpages`](http://mirrors.ctan.org/macros/latex/contrib/pdfpages/pdfpages.pdf) ermöglicht das Einbinden externer PDF-Dokumente als komplette Seite.
+- [`relsize`](http://mirrors.ctan.org/macros/latex/contrib/relsize/relsize-doc.pdf) stellt Befehle bereit, um die Schriftgröße relativ zur aktuell genutzten zu verändern.
+- [`tikz`](http://mirrors.ctan.org/graphics/pgf/base/doc/pgfmanual.pdf) ermöglicht das programmatische Erzeugen komplexer Grafiken aus LaTeX heraus. Das Handbuch dokumentiert die Möglichkeiten des Paketes, im Internet lassen sich zahllose Beispiele für die Verwendung des Paketes finden. Wird der Befehl `\tikzexternalize` einkommentiert, werden TikZ-Grafiken in einem separaten Prozess gerendert und dann eingebunden. Dies funktioniert jedoch nicht, wenn ein Text z.B. eine Referenz oder einen Abkürzungsverweis enthält. Folgende Bibliotheken werden in der Vorlage aktiviert:
+    - `babel` beseitigt einen Fehler in TikZ, der bei der Verwendung von Umlauten auftreten kann,
+    - `calc` erweitert Koordinatenausdrücke um Berechnungen,
+    - `external` erlaubt das externe Rendern von Bildern, um die Kompilation zu beschleunigen und
+    - `positioning` erweitert die zulässige Syntax für relative Positionen.
+- [`pgfplots`](http://mirrors.ctan.org/graphics/pgf/contrib/pgfplots/doc/pgfplots.pdf) ermöglicht das Setzen von Diagrammen auf Basis von TikZ.
+- [`csquotes`](http://mirrors.ctan.org/macros/latex/contrib/csquotes/csquotes.pdf) stellt den Befehl `\enquote` bereit, der korrekte Anführungszeichen für die gewählte Sprache um ein Stück Text setzt. Dies wird auch von `biblatex` genutzt.
+- `\def\UrlBreaks{\do\/\do-}` erlaubt das Umbrechen von URLs an `/` und `-`. Diese Liste kann nach Belieben erweitert werden.
+- Im Block `% Neat + for et al` wird das Plus-Zeichen für lange Autorenlisten (z.B. *[ABC+03]*) verkleinert. Eine ähnliche Technik lässt sich nutzen, um z.B. den Namen *C++* zu setzen.
+- Die Blöcke `% Remove algorithm captions, see examples` und `% Use minted's line numbers for algorithm2e` vereinheitlichen die Gestaltung von Algorithmen und Quellcode.
+- Der Befehl `\usemintedstyle` wählt ein Farbschema für die Syntaxauszeichnung in Quellcode aus. `friendly` eignet sich zum Druck besser als die leuchtenden Standardfarben.
+- Der Befehl `\addbibresource` teilt `biblatex` die verwendeten Bibliographien mit. Standard ist die `bibliography.bib`.
+- Im Abschnitt `% Internal metadata setup` werden die in der `config.tex` gewählten Metadaten geladen.

assigns.py

@@ -0,0 +1,35 @@
+from plt2 import *
+import numpy as np
+
+
+#probability that one thesis is not going to be picket
+
+students=15
+topics=15
+
+def by_picks(picks=3):
+    return (1-(((topics-picks)/topics)**students))**topics
+
+print(by_picks(1))
+
+#print(by_picks(1))
+#print(by_picks(2))
+#print(by_picks(3))
+
+
+picks=np.arange(1.0,5.0,0.1)
+probs=[by_picks(pick) for pick in picks]
+
+
+plt.plot(picks,probs)
+plt.title("Probability of everybody being assigned a favorable topic")
+plt.ylabel("Probability")
+plt.xlabel("Average number of favored topics")
+plt.savefig("assigns.png")
+plt.savefig("assigns.pdf",format="pdf")
+plt.show()
+
+
+
+
+

beamercolorthemeTUDo.sty

@@ -0,0 +1,47 @@
+% Basierend auf dem LaTeX-Beamer-Theme der TU Dortmund
+% Erstellt von Maximilian Nöthe <maximilian.noethe@tu-dortmund.de>
+% Version 1.1 vom 27.5.2014
+% Vielen Dank an Carsten Raas für seine Mithilfe
+
+\mode<presentation>
+
+\xdefinecolor{TUgreen}{RGB}{132, 186, 26}       % 0
+\xdefinecolor{TUdarkgreen}{RGB}{75, 98, 44}     % 1
+\xdefinecolor{TUolive}{RGB}{83, 145, 45}        % 2
+\xdefinecolor{TUorange}{RGB}{227, 105, 19}      % 3
+\xdefinecolor{TUyellow}{RGB}{242, 189, 0}       % 4
+\xdefinecolor{TUcitron}{RGB}{249, 219, 0}       % 5
+\xdefinecolor{TUlime}{RGB}{215, 215, 0}         % 6
+\xdefinecolor{TUlightgreen}{RGB}{226, 241, 195} % 7
+
+\setbeamercolor*{author}{fg=black, bg=white}
+\setbeamercolor*{institute}{fg=black, bg=white}
+
+\setbeamercolor*{header}{fg=TUgreen, bg=white}
+\setbeamercolor*{footline}{fg=TUgreen, bg=white}
+
+\setbeamercolor*{title page title}{fg=black, bg=white}
+\setbeamercolor*{title page header}{fg=TUgreen, bg=white}
+\setbeamercolor*{title page image}{fg=TUgreen, bg=white}
+\setbeamercolor*{title page}{fg=TUgreen, bg=white}
+\setbeamercolor*{headsepline}{fg=black, bg=white}
+\setbeamercolor*{frame number}{fg=TUgreen, bg=white}
+
+\setbeamercolor*{frametitle}{fg=black, bg=white}
+
+\setbeamercolor*{item}{fg=TUgreen, bg=black}
+
+\setbeamercolor*{section in toc}{fg=TUgreen, bg=white}
+\setbeamercolor*{section number projected}{fg=TUlightgreen, bg=TUgreen}
+\setbeamercolor*{subsection number projected}{fg=TUlightgreen, bg=TUgreen}
+
+\setbeamercolor*{block title}{fg=black, bg=TUgreen}
+\setbeamercolor*{block body}{fg=black, bg=TUlightgreen}
+
+\setbeamercolor*{block title alerted}{fg=black, bg=TUorange}
+\setbeamercolor*{block body alerted}{fg=black, bg=TUlightgreen}
+
+\setbeamercolor*{block title example}{fg=black, bg=TUyellow}
+\setbeamercolor*{block body example}{fg=black, bg=TUlightgreen}
+
+\mode<all>

beamerfontthemeTUDo.sty

@@ -0,0 +1,19 @@
+% Basierend auf dem LaTeX-Beamer-Theme der TU Dortmund
+% Erstellt von Maximilian Nöthe <maximilian.noethe@tu-dortmund.de>
+% Version 1.1 vom 27.5.2014
+% Vielen Dank an Carsten Raas für seine Mithilfe
+
+\mode<presentation>
+
+\RequirePackage{libertinus}
+
+\setbeamerfont{author}{size=\footnotesize}
+\setbeamerfont{date}{size=\footnotesize}
+\setbeamerfont{page number in head/foot}{size=\footnotesize}
+
+\setbeamerfont{institute}{size=\footnotesize}
+
+\setbeamerfont{section in head/foot}{size=\footnotesize}
+\setbeamerfont{subsection in head/foot}{size=\footnotesize}
+
+\mode<all>

beamerinnerthemeTUDo.sty

@@ -0,0 +1,52 @@
+% Basierend auf dem LaTeX-Beamer-Theme der TU Dortmund
+% Erstellt von Maximilian Nöthe <maximilian.noethe@tu-dortmund.de>
+% Version 1.1 vom 27.5.2014
+% Vielen Dank an Carsten Raas für seine Mithilfe
+
+\mode<presentation>
+
+% Blocks
+\setbeamertemplate{blocks}[rounded][shadow=false]
+\setbeamertemplate{theorems}[numbered]
+
+% Items
+\setbeamertemplate{sections/subsections in toc}[square]
+\setbeamertemplate{items}[square]
+
+\usepackage{xcolor,pgf}
+
+% Title page
+\defbeamertemplate*{title page}{TUDo}[1][]
+{
+    \ifx\inserttitlegraphic\empty
+    \else
+    \begin{beamercolorbox}[ht=0.66\textheight, wd=\textwidth, center]{title page image}
+        \includegraphics[width=\textwidth, height=0.75\textheight,keepaspectratio]{\inserttitlegraphic} %keepaspectratio
+    \end{beamercolorbox}
+    \vspace{5pt}
+    \fi
+    %\hfill
+    \begin{center}
+        \Huge\textcolor{black}{\usebeamerfont{title}\inserttitle}
+    \end{center}
+    %\begin{beamercolorbox}[wd=\textwidth, rounded=true,backgroundcolor=\color{white}\pgfsetfillopacity{0.5}]{title page title}
+    %    {\usebeamerfont{title}\inserttitle}
+    %\end{beamercolorbox}
+    \hfill
+    \vspace{5pt}
+}
+
+% Frame title
+\defbeamertemplate*{frametitle}{TUDo}[1][0]
+{
+    \begin{beamercolorbox}[wd=\textwidth]{frametitle}
+    \usebeamerfont{frametitle}\insertframetitle
+    \ifx\insertframesubtitle\empty
+    \else
+    \par\hspace{1pt}\usebeamerfont{framesubtitle}\insertframesubtitle
+    \fi
+    \end{beamercolorbox}
+    \vspace{-5pt}
+}
+
+\mode<all>

beamerouterthemeTUDo.sty

@@ -0,0 +1,59 @@
+% Basierend auf dem LaTeX-Beamer-Theme der TU Dortmund
+% Erstellt von Maximilian Nöthe <maximilian.noethe@tu-dortmund.de>
+% Version 1.1 vom 27.5.2014
+% Vielen Dank an Carsten Raas für seine Mithilfe
+
+\mode<presentation>
+
+\setbeamersize{text margin  left=18pt}
+\setbeamersize{text margin right=18pt}
+
+\defbeamertemplate*{headline}{TUDo}[1][0]
+{
+    \leftskip=18pt
+    \vspace{13.5pt}
+    \begin{beamercolorbox}[wd=\paperwidth, ht=0.75cm]{header}
+        \hspace{18pt}
+        \begin{beamercolorbox}[ht=0.75cm, wd=0.4\linewidth]{institute}
+            \includegraphics[height=0.75cm]{illustrations/tud_logo_cmyk}
+            %\hfill
+        \end{beamercolorbox}
+        \hfill
+        \begin{beamercolorbox}[ht=0.75cm, wd=0.4\linewidth, right]{institute}
+            {\usebeamerfont{institute}\insertinstitute}
+        \end{beamercolorbox}
+        \hspace{18pt}
+    \end{beamercolorbox}
+    \vspace{6pt}
+    \ifnum\insertframenumber>0
+        \vspace{-0.4pt}\hspace{18pt}\usebeamercolor[fg]{headsepline}\rule{\linewidth}{0.4pt}
+    \fi
+    \vspace{10pt}
+}
+
+\defbeamertemplate*{footline}{TUDo}[1][0]
+{
+    \hspace{15pt}
+    \begin{beamercolorbox}[wd=\linewidth]{footline}
+        \begin{beamercolorbox}[wd=0.25\linewidth, left]{author}
+            \usebeamerfont{date}\insertdate
+        \end{beamercolorbox}
+        \hfill
+        \begin{beamercolorbox}[wd=0.45\linewidth,center]{section in header}
+            \ifx\insertsubsection\empty
+            \usebeamerfont{section in head/foot}\insertsection
+            \else
+            \usebeamerfont{section in head/foot}\insertsection: \ \usebeamerfont{subsection in head/foot}\insertsubsection
+            \fi
+        \end{beamercolorbox}
+        \hfill
+        \begin{beamercolorbox}[wd=0.15\linewidth, right]{frame number}
+            \ifnum\insertframenumber>0
+            \usebeamerfont{page number in head/foot}\insertframenumber /\inserttotalframenumber
+            \fi
+        \end{beamercolorbox}
+    \end{beamercolorbox}
+    \vspace{12pt}
+}
+
+\mode<all>

beamerthemeTUDo.sty

@@ -0,0 +1,21 @@
+% Basierend auf dem LaTeX-Beamer-Theme der TU Dortmund
+% Erstellt von Maximilian Nöthe <maximilian.noethe@tu-dortmund.de>
+% Version 1.1 vom 27.5.2014
+% Vielen Dank an Carsten Raas für seine Mithilfe
+
+\mode<presentation>
+
+%Requirements
+\RequirePackage{enumerate}
+
+%Settings
+\useinnertheme{TUDo}
+\useoutertheme{TUDo}
+\usecolortheme{TUDo}
+\usefonttheme{TUDo}
+
+%\setlength{\textwidth}{4.54in}
+
+\setbeamertemplate{navigation symbols}{}
+
+\mode<all>

bibliography.bib

@@ -0,0 +1,26 @@
+@article{bib:photoelectric-effect,
+    author       = {Einstein, Albert},
+    title        = {Über einen die Erzeugung und Verwandlung des Lichtes betreffenden heuristischen Gesichtspunkt},
+    journaltitle = {Annalen der Physik},
+    volume       = {322},
+    number       = {6},
+    pages        = {132-148},
+    date         = {1905},
+    doi          = {10.1002/andp.19053220607},
+    publisher    = {Johann Ambrosius Barth},
+    location     = {Leipzig, Deutschland},
+    langid       = {german}
+}
+
+@inproceedings{bib:learnlib,
+    author       = {Raffelt, Harald and Steffen, Bernhard and Berg, Therese},
+    title        = {LearnLib: A Library for Automata Learning and Experimentation},
+    booktitle    = {Proceedings of the 10th International Workshop on Formal Methods for Industrial Critical Systems},
+    pages        = {62-71},
+    date         = {2005-09-05},
+    isbn         = {1-59593-148-1},
+    doi          = {10.1145/1081180.1081189},
+    publisher    = {ACM},
+    address      = {New York, NY, USA},
+    langid       = {english}
+}

clock/main.py

@@ -0,0 +1,136 @@
+from __future__ import division
+#import matplotlib.pyplot as plt
+from plt import *
+import numpy as np
+from numpy import pi
+
+
+    
+def gen(hour=None):    
+    staticmode=False
+    
+    mult=1.0
+    my_dpi=96*mult
+    siz=768
+    fig=plt.figure(figsize=(siz/my_dpi,siz/my_dpi),dpi=my_dpi)
+    fig.patch.set_facecolor("white")
+    
+    angles = 2*pi*np.random.randint(0,864000,100)/86400
+    ax = plt.subplot(111, polar=True)
+    #ax.set_facecolor("white")
+    
+    #ax.figure(figsize=(10,10))
+    #plt.polar()
+    #ax.scatter(angles, np.ones(100)*1)
+    #ax.bar(angles, np.full(100, 0.9), width=0.1, bottom=0.0, color='r', linewidth=0)
+    
+    #ax.bar(angles, np.full(100, 0.9), width=0.05, bottom=0.89, color='r', linewidth=0)
+    
+    ax.grid(b=False)
+    
+    
+    alpha=pi/6
+    
+    def ophase(x,y,c):ax.plot([x*alpha,y*alpha],[8,8],color=c)
+    
+    
+    ophase(0,3,"red")
+    ophase(3,8.5,"blue")
+    ophase(8.5,10.5,"yellow")
+    ophase(10.5,12,"green")
+    
+    ax.text(2.8*alpha,0.4,"Datasets",{"size":18,"color":"red"},rotation=0)
+    ax.text(6.5*alpha,0.5,"Algorithms",{"size":18,"color":"blue"},rotation=8)
+    ax.text(8.6*alpha,0.8,"Analysis",{"size":18,"color":"yellow"},rotation=15)
+    ax.text(10.7*alpha,0.8,"Application",{"size":18,"color":"green"},rotation=20)
+    
+    
+    labels=["Video Data","Text Data","Graph Data","High dim Data","Density OD","Subspace preprocessing","Transformations","Ensembles","Active AD","Explainability","Interpretation","Device Failure"]
+    
+    
+    # suppress the radial labels
+    plt.setp(ax.get_yticklabels(), visible=False)
+    
+    # set the circumference labels
+    if staticmode:
+        ax.set_xticks(np.linspace(0, 2*pi, 12, endpoint=False))
+        ax.set_xticklabels([12,1,2,3,4,5,6,7,8,9,10,11])
+        ax.set_xticklabels(labels)
+    else:
+        ax.set_xticks([])
+    
+    
+        data=[
+                [1.04,0.16],
+                [0.91,0.08],
+                [0.88,-0.05],
+                [1.03,-0.17],
+                [1.05,-0.20],
+                [1.11,-0.30],
+                [1.10,-0.20],
+                [1.20,-0.10],
+                [1.20,0.05],
+                [1.10,0.14],
+                [1.10,0.19],
+                [1.07,0.22],
+                ]
+    
+    
+    
+        radii=[d[0] for d in data]
+        deltap=[d[1] for d in data]
+        for i,(lab,rad,dp) in enumerate(zip(labels,radii,deltap)):
+            theta=alpha*i
+            theta90=theta*180/pi
+            ax.text(theta-dp,rad,lab,{"size":13,"color":"black"},rotation=-theta90)
+    
+    def line(hour):
+        plt.plot([hour*alpha,hour*alpha],[0.0,1.0],color="black")
+    def sline(hour):
+        plt.plot([hour*alpha,hour*alpha],[1.00,1.0],color="black")
+    
+    if not hour is None:
+        line(hour)
+    for i in range(12):
+        sline(i)
+
+
+    try:
+        mplcyberpunk.add_underglow()
+        mplcyberpunk.add_glow_effects()
+    except:pass
+
+
+    plt.plot([7*alpha,8*alpha],[1.0,1.0],color="blue")
+    
+    # make the labels go clockwise
+    ax.set_theta_direction(-1)
+    
+    # place 0 at the top
+    ax.set_theta_offset(pi/2.0)    
+    
+    # plt.grid('off')
+    
+    # put the points on the circumference
+    plt.ylim(0,1)
+    
+    #plt.show()
+    
+    if hour is None:
+        plt.savefig(f"output.png",facecolor="white",format="png")
+        plt.savefig(f"output.pdf",facecolor="white",format="pdf")
+    else:
+        plt.savefig(f"output{hour}.png",facecolor="white",format="png")
+        plt.savefig(f"output{hour}.pdf",facecolor="white",format="pdf")
+    
+    
+    try:
+        plt.how()
+    except:
+        plt.show()
+
+
+gen()
+for i in range(1,13):
+    gen(i)
+

compile.sh

@@ -0,0 +1,5 @@
+#python3 gentopic.py
+lualatex --shell-escape slides
+biber slides
+lualatex --shell-escape slides
+lualatex --shell-escape slides

config.tex

@@ -0,0 +1,27 @@
+% !TEX root = slides.tex
+
+%%%%%%%%%%%%%%%%%%
+% Metadata setup %
+%%%%%%%%%%%%%%%%%%
+
+% Talk's title
+\settalktitle{Proseminar Interpretable Machine Learning}
+
+% Author's name
+\settalkauthor{}
+
+% Multiple authors' names
+% \addtalkauthor{John Doe}
+
+% Talk date (ISO date format)
+\settalkisodate{2022-04-05}
+
+% Header metadata
+\aquaheader
+
+%%%%%%%%%%%%%%%%%%%%%%
+% Language selection %
+%%%%%%%%%%%%%%%%%%%%%%
+
+%\germantalk
+\englishtalk

configsupport.tex

@@ -0,0 +1,83 @@
+% !TEX root = slides.tex
+
+\usepackage{expl3}
+\usepackage{xparse}
+
+%%%%%%%%%%%%
+% Metadata %
+%%%%%%%%%%%%
+
+\ExplSyntaxOn
+
+\tl_new:N   \l__configsupport_title_tl
+\tl_new:N   \l__configsupport_author_tl
+\tl_new:N   \l__configsupport_iso_date_tl
+\tl_new:N   \l__configsupport_faculty_tl
+\tl_new:N   \l__configsupport_chair_tl
+\tl_new:N   \l__configsupport_workgroup_tl
+\bool_new:N \l__configsupport_english_bool
+
+\ProvideExpandableDocumentCommand{\settalktitle}{m}{
+    \tl_set:Nn \l__configsupport_title_tl {#1}
+}
+\ProvideExpandableDocumentCommand{\talktitle}{}{\tl_use:N \l__configsupport_title_tl}
+
+\ProvideExpandableDocumentCommand{\settalkauthor}{m}{
+    \tl_set:Nn \l__configsupport_author_tl {#1}
+}
+\ProvideExpandableDocumentCommand{\addtalkauthor}{m}{
+    \tl_if_empty:NF \l__configsupport_author_tl { \tl_put_right:Nn \l__configsupport_author_tl {,\ } }
+    \tl_put_right:Nn \l__configsupport_author_tl {#1}
+}
+\ProvideExpandableDocumentCommand{\talkauthor}{}{\tl_use:N \l__configsupport_author_tl}
+
+\ProvideExpandableDocumentCommand{\settalkisodate}{m}{
+    \tl_set:Nn \l__configsupport_iso_date_tl {#1}
+}
+\ProvideExpandableDocumentCommand{\talkisodate}{}{\tl_use:N \l__configsupport_iso_date_tl}
+\ProvideExpandableDocumentCommand{\talkdate}{}{\exp_args:Nf \DTMDate \talkisodate}
+
+\ProvideExpandableDocumentCommand{\setfaculty}{m}{
+    \tl_set:Nn \l__configsupport_faculty_tl {#1}
+}
+\ProvideExpandableDocumentCommand{\faculty}{}{\tl_use:N \l__configsupport_faculty_tl}
+
+\ProvideExpandableDocumentCommand{\setchair}{m}{
+    \tl_set:Nn \l__configsupport_chair_tl {#1}
+}
+\ProvideExpandableDocumentCommand{\chair}{}{\tl_use:N \l__configsupport_chair_tl}
+
+\ProvideExpandableDocumentCommand{\setworkgroup}{m}{
+    \tl_set:Nn \l__configsupport_workgroup_tl {#1}
+}
+\ProvideExpandableDocumentCommand{\workgroup}{}{\tl_use:N \l__configsupport_workgroup_tl}
+
+\ProvideExpandableDocumentCommand{\germantalk}{}{
+    \bool_set_false:N \l__configsupport_english_bool
+}
+
+\ProvideExpandableDocumentCommand{\englishtalk}{}{
+    \bool_set_true:N \l__configsupport_english_bool
+}
+
+\ProvideExpandableDocumentCommand{\languagesetup}{}{
+    \bool_if:NTF \l__configsupport_english_bool {
+        \setdefaultlanguage[variant=usmax]{english}
+        \setotherlanguage[variant=german, latesthyphen=true]{german}
+    } {
+        \setdefaultlanguage[variant=german, latesthyphen=true]{german}
+        \setotherlanguage[variant=usmax]{english}
+    }
+}
+
+\ExplSyntaxOff
+
+%%%%%%%%%%%%%%%%%%%%%%
+% Shorthand commands %
+%%%%%%%%%%%%%%%%%%%%%%
+
+\ProvideExpandableDocumentCommand{\aquaheader}{}{
+    \setfaculty{Fakultät für Informatik}
+    \setchair{Chair of Data Science and Data Engineering}
+    \setworkgroup{Prof. Dr. Emmanuel Müller}
+}

dics/benedikt.json

@@ -0,0 +1,13 @@
+{
+    "index":3,
+    "title":"Adversarial Examples",
+    "paper":"Practical Black-Box Attacks against Machine Learning",
+    "chapter":"10.4",
+    "by":   "Papernot, McDaniel, et al.",
+    "when": "2016",
+    "who":  "Benedikt Böing",
+    "mail": "benedikt.böing@cs.uni-dortmund.de",
+    "note1":"Slight changes in a neural network can change its output drastically",
+    "note2":"{null}",
+    "ext":  "png"
+}

dics/bin.json

@@ -0,0 +1,13 @@
+{
+    "index":2,
+    "title":"Prototypes",
+    "paper":"Interpreting Convolutional Sequence Model by Learning Local Prototypes with Adaptation Regularization",
+    "chapter":"8.7",
+    "by":   "Ni, Chen, Cheng, et al.",
+    "when": "2021",
+    "who":  "Bin Li",
+    "mail": "bin.li@cs.uni-dortmund.de",
+    "note1":"Represent some model output by well fitting data instances",
+    "note2":"{null}",
+    "ext":  "png"
+}

dics/chiara.json

@@ -0,0 +1,13 @@
+{
+    "index":1,
+    "title":"Shapley Values",
+    "paper":"Shapley Values for Feature Selection: The Good, the Bad, and the Axioms",
+    "chapter":"9.2,9.5 and 9.6",
+    "by":   "Fryer, Strümke, Nguyen, et al.",
+    "when": "2020",
+    "who":  "Chiara Balestra",
+    "mail": "chiara.balestra@cs.uni-dortmund.de",
+    "note1":"Use game theory to explain the output of a model",
+    "note2":"You could either focus on cs theory or on medical application",
+    "ext":  "png"
+}

dics/simon.json

@@ -0,0 +1,13 @@
+{
+    "index":4,
+    "title":"Pixel Attribution",
+    "paper":"Efficient Saliency Maps for Explainable AI",
+    "chapter":"10.2",
+    "by":   "Mundhenk, Chen, et al.",
+    "when": "2019",
+    "who":  "Simon Klüttermann",
+    "mail": "simon.kluettermann@cs.uni-dortmund.de",
+    "note1":"Different parts of an image have different effect/importance on the classification of an image",
+    "note2":"Programming task: Generate one Saliency Map yourself!",
+    "ext":  "jpeg"
+}

gentopic.py

@@ -0,0 +1,40 @@
+from csvtodic import read
+
+#for dic in read("topics_iml.csv",delimiter=";"):
+#    print(dic)
+
+
+
+
+#print("really?")
+#exit()
+
+import os
+import json
+
+with open("shema.tex","r") as f:
+    shema=f.read()
+
+
+for fn,fno in [[f"dics/{zw}",zw.replace(".json","")] for zw in os.listdir("dics")]:
+    with open(fn,"r") as f:
+        dic=json.loads(f.read())
+
+
+for dic in read("topics_iml.csv",delimiter=";"):
+    dic["ext"]="png"
+
+    #print(dic["paper"]+", "+dic["by"]+"("+dic["when"]+")")
+    #ac=shema.replace("##name##",fno)
+    ac=shema
+    for key,val in dic.items():
+        ac=ac.replace(f"##{key}##",str(val))
+
+    ac=ac.replace("\item {null}","")
+
+   
+    with open(f"topics/{dic['index']}.tex","w") as f:
+        f.write(ac)
+
+
+

header.tex

@@ -0,0 +1,172 @@
+% !TEX root = slides.tex
+
+\documentclass[
+    %draft, % enable for quick rendering
+    9pt,aspectratio=169,usepdftitle=false,
+    %handout, % enable for uncover suppression
+    hyperref={breaklinks},
+    xcolor={svgnames}]{beamer}
+
+% Load used-defined config
+\input{configsupport}
+\input{config}
+
+%%%%%%%%%%%%
+% Packages %
+%%%%%%%%%%%%
+
+% Should go first:
+
+% Font control
+\usepackage{fontspec}
+
+% Subfiles
+\usepackage{subfiles}
+
+% Math support
+\usepackage{amsmath}
+\usepackage{unicode-math}
+
+% Font selection (needs to go before polyglossia)
+\usepackage{libertinus}
+
+% Language control
+\usepackage{polyglossia}
+\languagesetup
+
+% Date formats
+\usepackage[useregional]{datetime2}
+
+% Algorithms
+\usepackage[linesnumbered, vlined]{algorithm2e}
+
+% Author and title reuse
+\usepackage{authoraftertitle}
+
+% Bibliography
+\usepackage[style=alphabetic]{biblatex}
+
+% Print-quality tables
+\usepackage{booktabs}
+
+% Watermarks for draft versions
+%\usepackage{draftwatermark}
+%\SetWatermarkAngle{57.5}
+%\SetWatermarkLightness{.95}
+%\SetWatermarkText{ENTWURF \(\alpha\).1}
+
+% Image inclusion
+\usepackage{graphicx}
+
+% Enable microtypography support
+\usepackage[final]{microtype}
+
+% Listings with syntax highlighting; requires --shell-escape
+\usepackage[newfloat]{minted}
+
+% Fine spacing control for math
+\usepackage{mleftright}
+
+% PDF inclusion
+\usepackage{pdfpages}
+
+% Relative font sizes
+\usepackage{relsize}
+
+% Drawings and Graphs
+\usepackage{tikz}
+\usetikzlibrary{babel}
+\usetikzlibrary{calc}
+\usetikzlibrary{external} % requires --shell-escape
+\usetikzlibrary{positioning}
+\tikzsetexternalprefix{tikz-externals}
+% \tikzexternalize Render TikZ externally, fails for some references
+\usepackage{pgfplots}
+\pgfplotsset{compat=1.17}
+
+% Needs to go last:
+
+% Language-sensitive quotation marks
+\usepackage{csquotes}
+
+% Break URLs at / and -
+\def\UrlBreaks{\do\/\do-}
+
+%%%%%%%%%%%%%%%%%%%%
+% Style and layout %
+%%%%%%%%%%%%%%%%%%%%
+
+% Load Theme
+\usetheme{TUDo}
+\titlegraphic{illustrations/title}
+
+% Neat + for et al
+\renewcommand*{\labelalphaothers}{\raisebox{.3ex}{\relsize{-3}{\bfseries +}}}
+\renewcommand*{\sortalphaothers}{+}
+
+% Remove algorithm captions, see examples
+\renewcommand{\AlCapSty}{}
+
+% Use minted's line numbers for algorithm2e
+\let\vrbstyle\theFancyVerbLine
+\patchcmd{\vrbstyle}{\arabic{FancyVerbLine}}{}{}{}
+\SetNlSty{vrbstyle}{}{}
+
+% Pastel colored listings
+\usemintedstyle{friendly}
+
+% German strings
+\addto\captionsgerman{%
+    \renewcommand{\listlistingname}{Listingverzeichnis}%
+}
+
+%%%%%%%%%%%
+% Content %
+%%%%%%%%%%%
+
+% Load external resources
+\addbibresource{bibliography.bib}
+
+% Internal metadata setup
+\title{\talktitle}
+\author{\talkauthor}
+\date{\talkdate}
+
+\institute{%
+    %\faculty
+
+    \chair
+
+    \workgroup%
+}
+
+\logo{\includegraphics[width=1cm]{ls9}}
+
+
+%\AtBeginSection[]{
+%    \begin{frame}<beamer>
+%        \frametitle{\contentsname}
+%        \tableofcontents[
+%            currentsection,
+%            currentsubsection,
+%            hideothersubsections,
+%            sectionstyle=show/shaded,
+%        ]
+%    \end{frame}
+%}
+
+
+\usepackage[listings,theorems]{tcolorbox}
+
+\usepackage[absolute,overlay]{textpos}
+\usepackage{graphicx}
+
+\usepackage[utf8x]{inputenc}
+
+\newcommand{\source}[1]{\begin{textblock*}{9cm}(0.1cm,8.9cm)
+    \begin{beamercolorbox}[ht=0.5cm,left]{framesource}
+        \usebeamerfont{framesource}\usebeamercolor[fg!66]{framesource} Source: {#1}
+    \end{beamercolorbox}
+\end{textblock*}}
+
+

illustrations/.gitignore

@@ -0,0 +1 @@
+!*.eps