AI_Model_Creator v 0.0.1 (Pre-Alpha)

Diese Software soll einen easy to use (, deutschsprachigen) KI-Model Creator für Bilderkennung darstellen, welche trotz der einfachen Bedienbarkeit eine hohe Variabilität erreicht, um SIE möglichst bei IHREM nächsten Bilderkennungsprojekt zu unterstützen. Die erstellten Models können zumindest zurzeit ausschließlich mit der Realtime_Detect Software ausgeführt werden! Der AI_Model_Creator installiert Realtime_Detect falls sie wollen automatisch.
Wenn aber Fehler bei der Installation auftreten oder sonst etwas mit dieser Software getan werden soll, kann dieses Programm auch manuell installiert werden wie hier beschrieben.

Veröffentlicht unter der GPL v3:
AI_Model_Creator; an easy to use AI cumputer vision model creator.
Copyright (C) 2020 Jonas Mayer

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program. If not, see https://www.gnu.org/licenses/
You can contact me by mail: bysuxaxofficial@gmail.com

Kompatibilität	Sollte Funktionieren	Tut auf frischem System (getestet)
Ubuntu 18.04.4	✔️	✔️
Linux Mint	✔️	✅
Debian basierte Linux Distros	✔️	❌
Andere Linux Distros	❌	❌
Windows	❌	❌
Mac	❌	❌

Um den AI_Model_Creator zu installieren und ein Model zu generieren, musst du folgendes tun:

I. Stellen sie sicher, dass Python 3, wie es eigentlich auf allen Debian basierten Systemen der Fall sein sollte, installiert ist:
python3 --version
Ansonsten installieren sie es durch:
sudo apt-get install python3

II. Falls sie in Betracht ziehen die Realtime_Detect Software zu benutzen, um Bilder ihrer Kamera durch ihr erstelltes Model zu verarbeiten, können sie schon im voraus ROS Melodic, wie hier beschrieben, installieren. Und gehen sie sicher, dass dieser Command in jedem Terminal, das benutzt wird ausgeführt wird:
source /opt/ros/melodic/setup.bash
Dies können sie sich aber auch später entscheiden. Entweder, wenn das Training beendet ist, auf "Mit Realtime_Detect fortfahren" klicken (dann muss ROS Melodic manuell so installiert sein), dann wird nämlich Realtime_Detect automatisch installiert, oder sie können sie jeder Zeit, nach der Modelerstellung, manuell wie hier beschrieben installieren.

1. Als Erstes sollten sie das Git Repository clonen:
   git clone https://github.com/BySuxax/AI_Model_Creator.git
   Es kann sein, dass es nötig ist, erst Git zu installieren: sudo apt install git

2. Als Nächstes können sie, um das Programm zu starten UND AUTOMATISCH GEBRAUCHTE LIBRARIES ZU INSTALLIEREN (Alle automatisch installierten Libraries stehen im File: LicenseInformation.txt), folgenden Command ausführen:
   (Ich übernehme keine Haftung für Systemschäden, Dateiverlust oder ähnlichem. Es werden durch Python Libraries, Programmeigene Ordner gelöscht. Eine Fehlfunktion kann nicht ausgeschlossen werden!)
   python3 AI_Model_Creator/startAPI.py
   !! Achten sie auf die Konsole! Es kann sein, dass sie ihr Root Passwort eingeben müssen, um die Libraries zu installieren !! (Falls sie dies nicht wollen reicht es folgende Programme mithilfe von sudo apt-get install zu installieren: python3 , python3-venv. Die sonstigen Pakete sollten ohne Root installierbar sein.)
   Es sollte sich nach einiger Zeit ein Fenster zur Einstellung von Trainingsparametern öffnen.

3. Stellen sie die Parameter für sich passend ein. Die Angaben dort sind nur ungefähre Angaben und müssen nicht der Wirklichkeit entsprechen. Das Training hat leider zurzeit noch keine Abbrechen-Taste. Daher sollten sie darauf achten die Länge des Trainings nicht zu groß zu machen. (Maximum, was eingestellt werden kann, ist ca. 4 Stunden je nach PC und menge der Daten) (Wird bald bessere Lösungen geben, wenn dieses Projekt weiterentwickelt wird.)

4. Geben sie einen Namen ein unter dem das Model gespeichert wird. Dann drücken sie auf "Save Name"! (Es soll keine Endung wie .pt enthalten sein) Nun können sie auf weiter drücken. Es sollte sich ein Fenster für die Trainings-Bilder Auswahl öffnen.
   

5. Wählen sie einen Bilderordner in welchem die Bilder sind, die sie der KI zu trainieren geben wollen. (Sie können natürlich auch zwischendrin den Ordner wechseln, um andere Bilder zu wählen.) Es sollten nach einer kurzen Lade-Pause alle Bilder in diesem Ordner in dem linken großen Kasten angezeigt werden. Wählen sie die Bilder aus die zu einer Klasse gehören indem sie auf sie links klicken. Wenn sie ausgewählt sind, sind die Bildumrandungen rot markiert.

6. Wenn sie die Bilder ausgewählt haben, die sie einer Klasse hinzufügen wollen, drücken sie auf "Füge ausgewählte Bilder einer Klasse hinzu". Es sollte sich ein kleines Fenster öffnen, in welchem sie neue Klassen hinzufügen, indem sie den Klassennamen in das Textfeld eingeben und auf "Neue Klasse hinzufügen" drücken. Mit der Combobox können sie dann die Klasse auswählen, welcher die Bilder hinzufügen werden sollen. Dann bestätigen sie mit "Mit ausgewählten Klasse fortfahren". Nun können sie wieder neue Bilder auswählen und sie entweder einer neuen oder der gleichen Klasse hinzufügen.

7. Wenn sie mit dem Auswählen fertig sind (am besten für jede Klasse mindestens 10 Bilder), können sie auf "weiter" drücken, um mit dem Training zu beginnen. Jetzt sollte sich ein Fenster öffnen, in welchem dir Infos zum Training gegeben werden (keine sorge, es kann etwas dauern bis das Training beginnt) und wie es weiter geht. Die große Progressbar zeigt an, wie lange noch trainiert wird. Die Beiden oben zeigen an wie gut die KI bereits ist. Desto weniger Fehler sie macht, desto besser ist sie natürlich auch. Der Unterschied ist, dass bei "Fehler Training" die KI mit Bildern getestet wird, die sie schon gesehen hat, währen bei "Fehler Test" die KI die Bilder noch nie gesehen hat.

8. Sie können nun entweder das Programm schließen über den "Beenden" Button oder mit der Realtime_Detect Software fortfahren. Wenn sie mit Realtime_Detect fortfahren, muss ROS Melodic installiert sein oder umgehend installiert werden und der Befehl muss in deinem ".bashrc" Skript in deinem Home-Verzeichniss stehen:
   source /opt/ros/melodic/setup.bash
   Wenn du auf "Weiter mit Realtime_Detect" drückst, wird die Software automatisch installiert. Du kannst das Programm aber auch beenden und Realtime_Detect wie hier beschrieben manuell installieren. In beiden Fällen findest du hier wie du weiter machen musst um das erstellte Model anwenden zu können.

Mir ist deine Rückmeldung sehr wichtig! Schrieb gerne was dich stört aber natürlich auch gefällt oder wenn etwas nicht geklappt hat, hoffentlich finden wir dann eine Lösung. Meine E-Mail: BySuxaxofficial@gmail.com

All automatically installed Libraries are mentioned in "LicenseInformation.txt"