History

RLogik 18ece75b67 master > master: code - minor		2021-11-08 13:21:03 +01:00
..
assets	master > master: assets - VERSION	2021-11-06 18:15:10 +01:00
src	master > master: code - minor	2021-11-08 13:21:03 +01:00
.gitignore	master > master: .gitignore aufgeteilt	2021-11-06 10:53:08 +01:00
Makefile	master > master: Makefiles - defaults für Windows leicht angepasst	2021-11-06 20:48:28 +01:00
README.md	master > master: README - makefiles	2021-11-06 10:55:53 +01:00
requirements	master > master: code - python code umgezogen	2021-10-30 10:18:53 +02:00

README.md

ADS - Python-Projekt

Python ist eine sehr verbreitete Sprache, die eine Riesencommunity hat. Sie ist sehr populär unter Wissenschaftlern und Ingenieuren. Ein Vorteil mit Python ist, dass man sehr leicht und schnell Prototypen entwickeln kann.

Dieses Projekt ist erneut kein nötiger Bestandteil des Kurses, sondern nur für Wissbegierige gedacht. Zunächst bietet sich an, sich die Algorithmen im Unterordner src/algorithms anzuschauen, z. B. src/algorithms/search/binary.py für den Binärsuchalgorithmus, ohne irgendetwas installieren zu müssen.

HINWEIS 1: Bei meiner Implementierung kann es zu leichten Abweichungen kommen. Bitte stets an dem Material im VL-Skript sich orientieren. Der Hauptzweck der Code-Projekte besteht darin, dass Wissbegierige die Algorithmen konkret ausprobieren können. Alle theoretischen Aspekte werden jedoch im Skript und in den Übungen ausführlicher erklärt.

Den Code kann man auch durch die u. s. Anweisungen selber austesten.

HINWEIS 2: Während hier die Anweisungen ausführlich sind und klappen sollten, bitte nur auf eigener Gewähr diesen Code benutzen.

Systemvoraussetzungen

Python version 3.x.x (idealerweise zumindest 3.9.5)

Einrichten mittels Makefile

Führe jeweils

make setup
make run
# oder für interaktiven Modus
make run-it

aus, um Packages zu installieren bzw. den Code auszuführen. Siehe Makefile für Details zu den Vorgängen.

Wer Makefile benutzt kann die u. s. Anweisungen ignorieren.

Setup

Requirements (Packages) einmalig mittels

python3 -m pip install -r requirements; # linux, osx
py -3   -m pip install -r requirements; # Windows

installieren lassen.

Ausführung

Zum Anzeigen der Hilfsanleitung in einer Konsole folgenden Befehl ausführen

python3 src/main.py help; # linux, OSX
py -3   src/main.py help; # Windows

Zur Ausführung der Algorithmen auf Fälle in der Config-Datei in einer Konsole folgenden Befehl ausführen

python3 src/main.py run; # linux, OSX
py -3   src/main.py run; # Windows

Mit dem --debug Flag werden Infos über Schritte mit angezeigt.
Mit dem --colour true/false Argument wird der Farbenmodus ein-/ausgeschaltet.
Mit dem --config path/to/config Argument kann man andere Config-Dateien verwenden.

Entwicklung

Gerne kann man den Code benutzen, in einem eigenen Repository weiter entwickeln, und mit den im Kurs präsentierten Algorithmen und Fällen herumexperimentieren.