Projekte

Ein Projekt ist ein unabhängiger Annotationsauftrag: ein Datenordner (oder ein Präfix in einem S3-Bucket), seine Einstellungen, seine Mitglieder mit ihren Rollen, sein Verlauf und seine Überarbeitungshinweise. Benutzer sehen nur die Projekte, an denen sie beteiligt sind.

Server-Admins verwalten alle Projekte unter ihrem Namen → Projects. Projekt-Admins verwalten Mitglieder und Einstellungen ihres eigenen Projekts.

Dialog Projects: Schaltflächen New project und Import project, eine Tabelle der Projekte mit Name, Beschreibung, Ordner, Anzahl der Bilder, Zugriff, Erstelldatum und den Schaltflächen Members and access, Export und Delete

Ein Projekt anlegen

New project, dann:

Name, Description

Erscheinen in der Projektliste und der oberen Leiste

Existing folder on the server

Ein Ordner mit Bildern, z. B. D:\Images\Line2 oder eine auf dem Server eingebundene Freigabe. Die Annotationsdateien werden neben die Bilder geschrieben. Leer: Der Server legt einen leeren Ordner unter projects_root an.

Store the files in

Nur mit konfigurierten S3-Buckets: ein Ordner auf dem Server oder S3 bucket … mit einem Präfix, siehe Projekte in S3-Buckets

Open to all signed-in users

Alle arbeiten mit ihren serverweiten Rollen im Projekt, ohne Mitglied zu sein

Welche Ordner Admins verwenden dürfen, lässt sich mit project_folders in der Konfiguration begrenzen. Zwei Projekte dürfen sich keinen Ordner teilen.

Aufbau eines Projektordners

Die Bilder liegen direkt im Ordner oder in einer Ebene von Unterordnern, meist einem je Tag:

Line2\
    2026-10-28\
        part_001.png         das Bild
        part_001.csv         seine Rahmen
        part_001.json        sein Speicherverlauf
        .annotations\        Versionen der Annotatoren (mehrere Annotatoren je Bild)
    2026-10-29\ ...
    .lumiscan-annotation\
        settings.json        die gemeinsamen Einstellungen des Projekts (Labels, ROI, ...)

Das ist der Aufbau des Desktop-Werkzeugs; Ordner, die es verwendet hat, werden übernommen, wie sie sind. Siehe Annotationsdateien.

Mitglieder und Zugriff

Members & access neben einem Projekt:

Members and access: Name, Beschreibung, offen für alle und die Mitgliedertabelle mit Benutzer oder Gruppe, Name und den Rollen Annotator, Reviewer, Project admin

  • User: ein Serverkonto über seinen Benutzernamen. Group: eine Gruppe des Verzeichnisses oder Single Sign-on, erkannt über den Namen, den vollständigen DN oder den letzten Teil eines Keycloak-Gruppenpfads.

  • Rollen je Mitglied: Annotator, Reviewer, Project admin. Wer in mehreren Einträgen steht, erhält alle ihre Rollen.

  • Über eine Gruppe eingetragene Verzeichnis- und Single-Sign-on-Benutzer erhalten Zugriff bei ihrer ersten Anmeldung.

  • Ihre eigene Rolle als Projekt-Admin können Sie nicht entfernen; so behält ein Projekt immer einen Admin.

Exportieren und importieren

Export lädt das Projekt als eine Datei <Name>.lumiscan-project.tar herunter, ein einfaches tar-Archiv (lesbar mit tar.exe von Windows, 7-Zip oder jedem Linux-System):

project.json

Name, Beschreibung, Mitglieder (ohne Passwörter), Zeit und Benutzer des Exports

settings.json

die Einstellungen des Projekts

data/…

Bilder, CSV- und JSON-Dateien byte-gleich sowie die Versionen der Annotatoren

notes.jsonl

Überarbeitungshinweise

history.jsonl

jede gespeicherte Version (optional)

Import project lädt eine solche Datei in Stücken von 8 MB mit Fortschrittsanzeige hoch, sodass auch Projekte von mehreren Gigabyte funktionieren. Er legt ein unabhängiges Projekt in einem neuen Ordner unter projects_root an (oder in einem Bucket). Die Mitglieder bleiben erhalten und gelten, wenn sich diese Benutzer an diesem Server anmelden. Die Pfade im Archiv werden geprüft: Nichts kann außerhalb des neuen Projektordners geschrieben werden.

Dialog Import a project: Projektdatei, optionaler Name, Schaltflächen Cancel und Import

Typischer Einsatz: Ein Kunde exportiert ein Projekt und schickt es HD Vision Systems zur Annotation durch Fachleute; das annotierte Projekt kommt auf demselben Weg zurück.

Ein Projekt löschen

Delete entfernt das Projekt vom Server: seine Einstellungen, Mitglieder, seinen Verlauf und seine Hinweise. Bild- und Annotationsdateien werden nur bei Ordnern gelöscht, die der Server selbst angelegt hat (auf Wunsch); vorhandene Ordner und Buckets werden nie gelöscht.

Das Projekt default

Der in der Konfiguration als data_root angegebene Bildordner wird zum Projekt default, offen für alle Benutzer. So laufen Installationen aus der Zeit vor den Projekten unverändert weiter.