Erste Schritte

Im Folgenden wird erläutert, welche Voraussetzungen auf Ihrem PC vorliegen müssen, um den kaMin zu verwenden, wie Sie den kaMin starten und wie Sie ggf. eine ausführbare Datei der k-Means-App erzeugen können.

Die Software kaMin wird in Form von Python-Skripten zur Verfügung gestellt und ist deshalb problemlos unter Windows nutzbar. Eine Nutzung unter MacOS und Linux ist prinzipiell auch möglich. Allerdings wurde die Software noch nicht für diese Systeme getestet und optimiert. Damit Sie die k-Means-App kaMin ausführen können, muss auf Ihrem System lediglich Python mit den Python-Paketen Matplotlib, Scipy, Pillow und Scikit-Learn installiert sein.

Installation von Python

Nutzen Sie für die Installation von Python am besten den auf der Python-Homepage zur Verfügung gestellten Installer. Dieser richtet, neben der Installation, Python auf Ihrem System ein.

  1. Laden Sie sich den Python-Installer für Ihr System von der Python-Hompage herunter.
  2. Wichtig:
    Setzen Sie im ersten Fenster des Installers den Haken bei Add python.exe to PATH
  3. Klicken Sie dann auf „Install Now”. Dadurch wird Python installiert, die notwendigen Tools eingerichtet und Python für die Verwendung vorbereitet.

Installation der Python-Pakete Matplotlib, Scipy, Pillow und Scikit-Learn

Um die Installation der Pakete so komfortabel wie möglich zu gestalten, steht ein Python-Skript zur Verfügung, das die Installation automatisiert durchführt. Voraussetzung ist lediglich eine installierte Python-Umgebung mit installiertem Paket-Installer pip. Haben Sie die Installation von Python wie oben beschrieben mit dem Installer durchgeführt, sind diese Voraussetzungen automatisch erfüllt.
Laden Sie sich zur Installation der Pakete das Python-Skript herunter und führen es mit einem Doppelklick aus.

Alternativ lassen sich die Pakete auch manuell unter Verwendung des Paket-Installer pip installieren. Zur Installation der Pakete sind folgende Schritte notwendig:

  1. Öffnen Sie die Kommandozeile/Eingabeaufforderung (Windows).
  2. Geben Sie dort der Reihe nach die Befehle
    pip install matplotlib
    pip install pillow
    pip install scipy
    pip install scikit-learn
    ein und bestätigen Sie jede Eingabe mit der Eingabetaste. Das jeweilige Paket wird nun automatisch heruntergeladen und installiert.

Im Folgenden werden zwei Möglichkeiten aufgezeigt, wie der kaMin gestartet werden kann.

Laden Sie sich zuerst die k-Means-App kaMin herunter und entpacken Sie die heruntergeladene .zip-Datei.

Start via Doppelklick

Doppelklicken Sie auf die Datei starte_kaMin.py. Es öffnet sich die Oberfläche der k-Means-App.

Hinweis:
Wollen Sie verhindern, dass sich mit der Oberfläche des kaMin eine Eingabeaufforderung öffnet, ändern Sie die Dateiendung .py der Datei starte_kaMin.py zu .pyw

Start über die Eingabeaufforderung

Sie können die Python-Skripte auch über den Aufruf in der Eingabeaufforderung ausführen.

  1. Öffnen Sie den entpackten Ordner.
  2. Öffnen Sie eine Konsole für den geöffneten Ordner. Rechtsklicken Sie hierfür in den Ordner und wählen In Terminal öffnen aus. Es öffnet sich eine Konsole, die bereits den Pfad des Ordners besitzt.
    Hinweis:
    Bei älteren Windows-Versionen ist die Auswahl Im Terminal öffnen nicht verfügbar. In diesem Fall können Sie im Ordner des kaMin in der Explorer-Adressleiste cmd eingeben und mit der Eingabetaste bestätigen.
  3. Geben Sie in der Konsole den Befehl python starte_kaMin.py ein und bestätigten Sie den Befehl mit der Eingabetaste. Es öffnet sich die Oberfläche der k-Means-App kaMin.

Mit Hilfe des Pakets PyInstaller (https://pyinstaller.org/en/stable/) ist es möglich, aus Python-Skripten ausführbare Dateien für Windows zu erstellen. Eine solche ausführbare Datei kann auf einem beliebigen Rechner des jeweiligen Systems ausgeführt werden, ohne dass dafür eine Installation von Python oder zusätzlicher Pakete notwendig ist, da diese in der ausführbaren Datei „gebündelt” werden. Die Lizenzen der ggf. „gebündelten” Dateien sind zu beachten.
Auf dem Rechner, auf dem die ausführbare Datei erstellt wird, muss Python mit den notwendigen Paketen installiert sein.

Erstellung via vorbereitetem Python-Skript

Um die Erstellung der ausführbaren Datei so komfortabel wie möglich zu gestalten, steht ein Python-Skript zur Verfügung, das die Installation des Pakets PyInstaller und die anschließende Erstellung der .exe-Datei automatisiert durchführt.

  1. Laden Sie sich zur Erstellung der ausführbaren Datei das Python-Skript herunter.
  2. Kopieren Sie das Skirpt in den Ordner des kaMin.
  3. Führen Sie das Skript mit einem Doppelklick aus.
    Hinweis:
    Die Ausführung des Skripts kann einige Minuten dauern.

Manuelle Erstellung der ausführbaren Datei

Alternativ kann das Paket PyInstaller auch via pip installiert und die Erstellung der .exe-Datei im Anschluss manuell durchgeführt werden. Dafür sind folgende Schritte notwendig:

Installation des PyInstallers
Öffnen Sie eine Konsole und geben Sie dort den Befehl pip install pyinstaller ein. Bestätigen Sie den Befehl mit der Eingabetaste. Das Paket Pyinstaller wird nun automatisch heruntergeladen und installiert.

Erstellen einer ausführbaren .exe-Datei

  1. Öffnen Sie die Konsole im Ordner der k-Means-App kaMin, d.h. in dem Ordner, in dem sich die Datei starte_kaMin.py befindet.
  2. Geben Sie den Befehl pyinstaller --noconfirm --windowed --onefile --distpath ./kaMin-Die_k-Means-App --add-data Grafiken/*;Grafiken/ --name kaMin-Die_k-Means-App-Alpha_1_2 --icon Grafiken/logo_k_means.png starte_kaMin.py ein und bestätigen Sie den Befehl mit der Eingabetaste.
    Die Erstellung der ausführbaren Datei kann einige Minuten in Anspruch nehmen.
  3. Im Ordner des kaMin wurde automatisch ein Ordner kaMin-Die_k-Means-App erstellt, der die ausführbare Datei enthält.
  4. Doppelklick auf die .exe-Datei startet nun die k-Means-App.
  5. Wenn Sie die ausführbare Datei auf einem anderen Rechner nutzen möchten, kopieren Sie den Ordner kaMin-Die_k-Means-App auf den anderen Rechner. Auf diesem muss kein Python installiert sein.