Konfiguration des LayoutWizzards
Die zentrale Konfiguration des LayoutWizzards findet in einer eigenständigen Konfigurationsdatei statt. Diese kann an einem beliebigen Ort im Dateisystem liegen, da ihr Pfad in jedem Programmbestandteil des LayoutWizzards angegeben werden kann. Üblicherweise lautet der Pfad zu dieser zentralen Konfigurationsdatei folgendermaßen:
Der Inhalt einer solchen Konfiguration sieht beispielhaft wie folgt aus:
Die Konfiguration besteht aus einigen allgemeinen Einstellungen und mehreren <analysis>
Blöcken. Die <analysis>
Blöcke regeln im Wesentlichen die Einstellungen für die automatische Analyse. Verschiedene Projekte oder Vorgänge können dabei unterschiedliche Einstellungen verwenden, indem Sie der automatischen Analyse die id
des <analysis>
Blocks übergeben.
Allgemeine Einstellungen betreffen immer alle Vorgänge und werden auch nicht durch vorgangsspezifische Einstellungen überschrieben.
Allgemeine Einstellungen
Die folgende Liste an allgemeinen Konfigurationspfaden ist nicht vollständig. Sie enthält jedoch alle Konfigurationen die individuell für eine Installation angepasst werden müssen.
previews/previewsPerPage
Anzahl an Bildern pro Seite der Vorschauansicht im Goobi-LayoutWizzard-Plugin
previews/previewHeight
Höhe der Thumbnail-Datei in Pixeln, die in der Vorschauansicht angezeigt werden. Kleinere Bilder ermöglichen eine schnellere Anzeige, haben aber eine geringere Auflösung.
previews/largePreviewWidth
Breite der Thumbnail-Datei in Pixeln, die für die Einzelseiten-Ansicht des Goobi-LayoutWizzard-Plugins angezeigt wird. Kleinere Bilder ermöglichen eine schnellere Anzeige, haben aber eine geringere Auflösung.
processingThreads
Die maximale Anzahl gleichzeitig laufender Analyse- oder Speichervorgänge. Dies gilt für Goobi und TaskManager separat. Pro Vorgang werden die Bilder sequenziell bearbeitet. Eine gleichzeitige Bearbeitung kann jedoch vorkommen, wenn mehrere LayoutWizzard-Jobs im TaskManager parallel laufen.
analsisTimeout/duration
Dieser Wert gibt die maximale Dauer für die Analyse oder das Speichern eines Bildes an, nach der die Ausführung für das Bild abgebrochen werden soll. Eine wegen Timeouts abgebrochene Analyse wird vermerkt, die Analyse der folgenden Bilder jedoch fortgesetzt. Die fehlenden Analysedaten können in der manuellen Kontrolle nachgetragen werden. Ein abgebrochenes Speichern beendet jedoch immer den TaskManager-Job mit einem Fehler.
Sinnvolle Werte für den Timeout liegen zwischen 4 Sekunden und etwa einer Minute, je nach Leistung und Zuverlässigkeit des Systems, und der Größe und Komplexität der zu analysierenden Bilder.
analysisTimeout/unit
Dieser Wert definiert die Zeiteinheit, in der analysisTimeout/duration
angegeben wird. Mögliche Werte sind MICROSECONDS
, MILLISECONDS
, SECONDS
und MINUTES
.
saving/defaultCompression
Mit diesem Wert wird die Kompressionsstufe festgelegt, die standardmäßig für das Speichern der Derivate verwendet wird. Gültige Werte sind hierbei NONE
oder JPEG
. Das Attribut quality
gibt die Kompressionsqualität bei JPEG-Kompression an. Sie muss zwischen 0
und 100
liegen.
saving/overwriteExistingImages
Mit diesem Wert kann festgelegt werden, ob bereits existierende Bildderivate während des Speicherns überschrieben werden sollen.
saving/ignoreImageMetadataErrors
Hier wird angegeben, ob die Derivate auch gespeichert werden sollen, wenn nicht alle Bildmetadaten übernommen werden können. Dies kann beispielsweise vorkommen, wenn für die Java-Bildbibliothek unbekannte Metadaten vorhanden sind. Es ist daher ratsam diesen Wert immer auf false
zu lassen, solange diese Einstellung nicht explizit benötigt wird.
Analysis-Konfiguration
Jeder <analysis>
Block hat ein Attribut id
, das regelt, welcher Block für eine bestimmte Analyse verwendet wird. Der letzte Block muss die id="default"
haben. Einstellungen aus diesem Block werden immer verwendet, wenn einem Analyseaufruf keinen Analyse-Id übergeben wird, oder wenn eine Einstellung nicht im eigentlich verwendeten Block konfiguriert ist. Alle anderen Blöcke bestehen entsprechend aus der Teilmenge an Konfigurationen, die von der default
-Konfiguration abweichen.
Folgende Einstellungen können in jedem <analysis>
Block existieren:
info/label
Hierbei handelt es sich um die Bezeichnung der Analyse-Einstellung in der Plugin-Oberfläche.
pageMode
Dieser Wert definiert den standardmäßig zu verwendenden Seitenmodus. Die hierfür gültigen Angaben sind innerhalb der
Ordner- und Dateioptionen beschrieben.
externalCommands/@use
An dieser Stelle wird festgelegt, ob die Erzeugung von Bildern für die Analyse und das Speichern der Derivate durch ein externes Programm erfolgen soll. Dies kann die Bilderzeugung unter Umständen erheblich beschleunigen, aber auch fehleranfälliger sein, da die Erzeugung dann außerhalb von Java stattfindet.
externalCommands/convert
Mit dieser Wert wird der Konsolenbefehl definiert, mit dem das externe Programm zum Erzeugen von Bildern aufgerufen werden soll. An diesen Befehl werden die Spezifika der Ausführung angehängt, die dem Format von ImageMagick
folgen. Das aufgerufene Programm muss also mit Parametern aufgerufen werden können, die kompatibel zu ImageMagick
sind.
analysisStep
Dieser Wert enthält alle internen Parameter den jeweiligen automatischen Analyseschritt.
analysisStep/@name
Hiermit wird der interne Name des <analysisStep>
Blocks festgelegt. Er muss einem der folgenden Werte entsprechen:
PAGESKEW
: Seite ausrichtenCONTENTAREA
: Seite zuschneidenBOOKSPINE
: Falz erkennen
analysisStep/@use
Mit diesem Wert kann festgelegt werden, ob ein Analyseschritt verwendet werden soll. Der Wert false
deaktiviert den Analyseschritt.
analysisStep/@order
An dieser Stelle wird die Reihenfolge des Analyseschrittes innerhalb der gesamten Analyse festgelegt.
Die Einstellungen in den <analysisStep>
Blöcken betreffen spezifische Parameter der Analyse-Algorithmen. Sie werden hier nicht weiter beschrieben. Benutzer können jedoch in der Oberfläche potentiell jeden Parameter anpassen. Sollten sich so vorgenommene Einstellungen genug bewähren, um in die Konfiguration übernommen zu werden, kann der entsprechende Block in der Konfigurationsdatei auf den neuen Wert gesetzt werden. Der passende Parameter-Block kann hierbei ermittelt werden, indem der <analysisStep>
zum jeweiligen Analyse-Schritt in der Konfigurationsdatei herausgefunden und dort der Block mit dem internen Parameternamen geändert wird. Der interne Parametername wird in der Oberfläche als Tooltip angezeigt, wenn der Mauszeiger über das Label des veränderten Parameters gehalten wird.
Zusätzlich können alle Analyse-Parameter-Blöcke das Attribut visibility
besitzen, das die Sichtbarkeit des Parameters in der Oberfläche regelt. Fehlt dieses Attribut wird der default-Wert HIDDEN
verwendet.
VISIBLE
Der Parameter ist in der Oberfläche immer sichtbar, wenn der zugehörige Schritt ausgewählt ist.
HIDDEN
Der Parameter ist in der Oberfläche nur sichtbar, wenn der Analyseschritt-Block in der Oberfläche im erweiterten Modus ist.
INVISIBLE
Der Parameter wird in der Oberfläche gar nicht angezeigt.
Last updated