CLI: Befehlszeile

Die **Chloros CLI** bietet leistungsstarken Befehlszeilenzugriff auf die Bildverarbeitungs-Engine Chloros und ermöglicht so die Automatisierung, Skripterstellung und den Headless-Betrieb für Ihre Bildverarbeitungs-Workflows.

Hauptmerkmale

  • 🚀 Automatisierung – Skriptbasierte Stapelverarbeitung mehrerer Datensätze

  • 🔗 Integration – Einbettung in bestehende Workflows und Pipelines

  • 💻 Headless-Betrieb – Ausführung ohne GUI

  • 🌍 Mehrsprachigkeit – Unterstützung für 38 Sprachen

  • Parallelverarbeitung – Dynamische Skalierung an Ihre CPU (bis zu 16 parallele Worker)

Anforderungen

Anforderung
Details

Betriebssystem

Windows 10/11 (64-Bit)

Arbeitsspeicher

Mindestens 8 GB RAM (16 GB empfohlen)

Internet

Für die Lizenzaktivierung erforderlich

Festplattenspeicher

Variiert je nach Projektgröße

Lizenzanforderungen: Für CLI ist ein kostenpflichtiges Abonnement für Chloros+ erforderlich. Standard-Tarife (kostenlos) haben keinen Zugriff auf CLI. Besuchen Sie https://cloud.mapir.camera/pricingarrow-up-right, um ein Upgrade durchzuführen.

Schnellstart

Installation

Das CLI ist automatisch im Chloros-Installationsprogramm enthalten:

  1. Laden Sie das Chloros-Installationsprogramm.exe herunter und führen Sie es aus.

  2. Führen Sie den Installationsassistenten aus.

  3. CLI installiert unter: C:\Program Files\Chloros\resources\cli\chloros-cli.exe

circle-info

Das Installationsprogramm fügt chloros-cli automatisch zu Ihrem System-PATH hinzu. Starten Sie Ihr Terminal nach der Installation neu.

Erstmalige Einrichtung

Bevor Sie CLI verwenden, aktivieren Sie Ihre Chloros+-Lizenz:

Grundlegende Verwendung

Verarbeiten Sie einen Ordner mit den Standardeinstellungen:


Befehlsreferenz

Allgemeine Syntax


Befehle

process – Bilder verarbeiten

Bilder in einem Ordner mit Kalibrierung verarbeiten.

Syntax:

Beispiel:

Optionen für Verarbeitungsbefehle

Option
Typ
Standard
Beschreibung

<input-folder>

Pfad

Erforderlich

Ordner mit RAW/JPG-Multispektralbildern

-o, --output

Pfad

Wie Eingabe

Ausgabeordner für verarbeitete Bilder

-n, --project-name

Zeichenfolge

Automatisch generiert

Benutzerdefinierter Projektname

--vignette

Flag

Aktiviert

Vignettenkorrektur aktivieren

--no-vignette

Flag

-

Vignettenkorrektur deaktivieren

--reflectance

Flag

Aktiviert

Reflektionskalibrierung aktivieren

--no-reflectance

Flag

-

Reflektionskalibrierung deaktivieren

--ppk

Flag

Deaktiviert

PPK-Korrekturen aus .daq-Lichtsensordaten anwenden

--format

Auswahl

TIFF (16-Bit)

Ausgabeformat: TIFF (16-bit), TIFF (32-bit, Percent), PNG (8-bit), JPG (8-bit)

--min-target-size

Ganzzahl

Auto

Mindestzielgröße in Pixeln für die Erkennung des Kalibrierungsfeldes

--target-clustering

Ganzzahl

Auto

Schwellenwert für die Zielclusterung (0-100)

--exposure-pin-1

Zeichenfolge

Keine

Belichtung für Kameramodell sperren (Pin 1)

--exposure-pin-2

Zeichenfolge

Keine

Belichtung für Kameramodell sperren (Pin 2)

--recal-interval

Ganzzahl

Auto

Neukalibrierungsintervall in Sekunden

--timezone-offset

Ganzzahl

0

Zeitzonenverschiebung in Stunden


login – Konto authentifizieren

Melden Sie sich mit Ihren Chloros+-Anmeldedaten an, um die CLI-Verarbeitung zu aktivieren.

Syntax:

Beispiel:

circle-info

Sonderzeichen: Verwenden Sie einfache Anführungszeichen um Passwörter, die Zeichen wie $, ! oder Leerzeichen enthalten.

Ausgabe:

***

logout – Anmeldedaten löschen

Löschen Sie gespeicherte Anmeldedaten und melden Sie sich von Ihrem Konto ab.

Syntax:

Beispiel:

Ausgabe:

circle-info

SDK Benutzer: Das Python SDK bietet auch eine programmatische logout()-Methode zum Löschen von Anmeldedaten innerhalb von Python-Skripten. Weitere Informationen finden Sie in der Python SDK-Dokumentation.


status – Lizenzstatus überprüfen

Zeigt den aktuellen Lizenz- und Authentifizierungsstatus an.

Syntax:

Beispiel:

Ausgabe:


export-status – Exportfortschritt überprüfen

Überwachen Sie den Exportfortschritt von Thread 4 während oder nach der Verarbeitung.

Syntax:

Beispiel:

Anwendungsfall: Rufen Sie diesen Befehl während der Verarbeitung auf, um den Exportfortschritt zu überprüfen.***

language – Verwaltung der Sprache der Benutzeroberfläche

Anzeigen oder Ändern der Sprache der Benutzeroberfläche von CLI.

Syntax:

Beispiele:

Unterstützte Sprachen (insgesamt 38)

Code
Sprache
Name in Originalsprache

en

Englisch

Englisch

es

Spanisch

Español

pt

Portugiesisch

Português

fr

Französisch

Français

de

Deutsch

Deutsch

it

Italienisch

Italiano

ja

Japanisch

日本語

ko

Koreanisch

한국어

zh

Chinesisch (vereinfacht)

简体中文

zh-TW

Chinesisch (traditionell)

繁體中文

ru

Russisch

Русский

nl

Niederländisch

Nederlands

ar

Arabisch

العربية

pl

Polnisch

Polski

tr

Türkisch

Türkçe

hi

Hindi

हिंदी

id

Indonesisch

Bahasa Indonesia

vi

Vietnamesisch

Tiếng Việt

th

Thailändisch

ไทย

sv

Schwedisch

Svenska

da

Dänisch

Dansk

no

Norwegisch

Norsk

fi

Finnisch

Suomi

el

Griechisch

Ελληνικά

cs

Tschechisch

Čeština

hu

Ungarisch

Magyar

ro

Rumänisch

Română

uk

Ukrainisch

Українська

pt-BR

Brasilianisches Portugiesisch

Português Brasileiro

zh-HK

Kantonesisch

粵語

ms

Malaiisch

Bahasa Melayu

sk

Slowakisch

Slovenčina

bg

Bulgarisch

Български

hr

Kroatisch

Hrvatski

lt

Litauisch

Lietuvių

lv

Lettisch

Latviešu

et

Estnisch

Eesti

sl

Slowenisch

Slovenščina

circle-info

Automatische Speicherung: Ihre Spracheinstellung wird in ~/.chloros/cli_language.json gespeichert und bleibt über alle Sitzungen hinweg erhalten.


set-project-folder – Standardprojektordner festlegen

Ändern Sie den Speicherort des Standardprojektordners (gemeinsam mit der GUI).

Syntax:

Beispiel:


get-project-folder – Projektordner anzeigen

Zeigt den aktuellen Standard-Projektordner an.

Syntax:

Beispiel:

Ausgabe:


reset-project-folder – Auf Standard zurücksetzen

Setzt den Projektordner auf den Standardpfad zurück.

Syntax:


Globale Optionen

Diese Optionen gelten für alle Befehle:

Option
Typ
Standard
Beschreibung

--backend-exe

Pfad

Automatisch erkannt

Pfad zur ausführbaren Backend-Datei

--port

Ganzzahl

5000

Backend-Portnummer API

--restart

Flag

-

Neustart des Backends erzwingen (beendet vorhandene Prozesse)

--version

Flag

-

Versionsinformationen anzeigen und beenden

--help

Flag

-

Hilfeinformationen anzeigen und beenden

Beispiel mit globalen Optionen:


Anleitung zu den Verarbeitungseinstellungen

Parallele Verarbeitung

Chloros+ CLI skaliert automatischdie parallele Verarbeitung entsprechend den Fähigkeiten Ihres Computers:So funktioniert es:

  • Erkennt Ihre CPU-Kerne und Ihren Arbeitsspeicher

  • Weist Worker zu: 2× CPU-Kerne (verwendet Hyperthreading)

  • Maximal: 16 parallele Worker (für Stabilität)Systemstufen:

Systemtyp
CPU
RAM
Worker
Leistung

High-End

16+ Kerne

32+ GB

Bis zu 16

Maximale Geschwindigkeit

Mittelklasse

8–15 Kerne

16–31 GB

8–16

Ausgezeichnete Geschwindigkeit

Einstiegsklasse

4–7 Kerne

8–15 GB

4–8

Gute Geschwindigkeit

circle-info

Automatische Optimierung: Der CLI erkennt automatisch Ihre Systemspezifikationen und konfiguriert die optimale Parallelverarbeitung. Keine manuelle Konfiguration erforderlich!

Debayer-Methoden

Der CLI verwendet High Quality (Faster) als standardmäßigen und empfohlenen Debayer-Algorithmus:

Methode
Qualität
Geschwindigkeit
Beschreibung

Hohe Qualität (schneller)

⭐⭐⭐⭐

⚡⚡⚡

Kantensensitiver Algorithmus (Standard, empfohlen)

Vignettierungskorrektur

Funktion: Korrigiert den Lichtabfall an den Bildrändern (dunklere Ecken, die häufig bei Kameraaufnahmen auftreten).

  • Standardmäßig aktiviert – Die meisten Benutzer sollten diese Option aktiviert lassen.

  • Verwenden Sie --no-vignette, um sie zu deaktivieren.

circle-info

Empfehlung: Aktivieren Sie immer die Vignettenkorrektur, um eine gleichmäßige Helligkeit im gesamten Bild zu gewährleisten.

Reflektionskalibrierung

Konvertiert die Rohwerte des Sensors mithilfe von Kalibrierungsfeldern in standardisierte Reflektionsprozentsätze.

  • Standardmäßig aktiviert – Unverzichtbar für die Vegetationsanalyse.

  • Erfordert Kalibrierungszielfelder in Bildern.

  • Verwenden Sie --no-reflectance, um diese Funktion zu deaktivieren.

circle-info

Anforderungen: Stellen Sie sicher, dass die Kalibrierungsfelder in Ihren Bildern richtig belichtet und sichtbar sind, um eine genaue Reflektionsumwandlung zu gewährleisten.

PPK-Korrekturen

Funktion: Wendet nachbearbeitete kinematische Korrekturen unter Verwendung von DAQ-A-SD-Protokolldaten an, um die GPS-Genauigkeit zu verbessern.

  • Standardmäßig deaktiviert

  • Verwenden Sie --ppk, um die Funktion zu aktivieren.

  • Erfordert .daq-Dateien im Projektordner von MAPIR DAQ-A-SD-Lichtsensor.

Ausgabeformate

Format
Bittiefe
Dateigröße
Am besten geeignet für

TIFF (16 Bit)

16-Bit-Ganzzahl

Groß

GIS-Analyse, Photogrammetrie (empfohlen)

TIFF (32-Bit, Prozent)

32-Bit-Gleitkomma

Sehr groß

Wissenschaftliche Analyse, Forschung

PNG (8 Bit)

8-Bit-Ganzzahl

Mittel

Visuelle Inspektion, Web-Sharing

JPG (8-Bit)

8-Bit-Ganzzahl

Klein

Schnellvorschau, komprimierte Ausgabe

***

Automatisierung und Skripting

PowerShell-Stapelverarbeitung

Automatische Verarbeitung mehrerer Datensatzordner:

Windows-Stapelscript

Einfache Schleife für die Stapelverarbeitung:

Python Automatisierungsskript

Erweiterte Automatisierung mit Fehlerbehandlung:


Verarbeitungsworkflow

Standard-Workflow

  1. Eingabe: Ordner mit RAW/JPG-Bildpaaren

  2. Erkennung: CLI sucht automatisch nach unterstützten Bilddateien

  3. Verarbeitung: Der Parallelmodus skaliert entsprechend Ihrer CPU-Kerne (Chloros+)

  4. Ausgabe: Erstellt Unterordner für Kameramodelle mit verarbeiteten Bildern

Beispiel für die Ausgabestruktur

Geschätzte Verarbeitungszeit

Typische Verarbeitungszeiten für 100 Bilder (jeweils 12 MP):

Modus
Zeit
Hardware

Parallelmodus

5–10 min

i7/Ryzen 7, 16 GB RAM, SSD (bis zu 16 Worker)

Parallelmodus

10–15 Min.

i5/Ryzen 5, 8 GB RAM, HDD (bis zu 8 Worker)

circle-info

Leistungstipp: Die Bearbeitungszeit hängt von der Anzahl der Bilder, der Auflösung und den Computerspezifikationen ab.


Fehlerbehebung

CLI nicht gefunden

Fehler:

Lösungen:

  1. Überprüfen Sie den Installationsort:

  1. Verwenden Sie den vollständigen Pfad, wenn er nicht in PATH enthalten ist:

  1. Fügen Sie ihn manuell zu PATH hinzu:

    • Öffnen Sie Systemeinstellungen → Umgebungsvariablen.

    • Bearbeiten Sie die Variable PATH.

    • Fügen Sie Folgendes hinzu: C:\Program Files\Chloros\resources\cli

    • Terminal neu starten


Backend konnte nicht gestartet werdenFehler:

Lösungen:

  1. Überprüfen Sie, ob das Backend bereits ausgeführt wird (schließen Sie es zuerst)

  2. Überprüfen Sie, ob die Firewall Windows nicht blockiert

  3. Versuchen Sie es mit einem anderen Port:

  1. Erzwingen Sie einen Neustart des Backends:


Probleme mit der Lizenz/AuthentifizierungFehler:

Lösungen:

  1. Vergewissern Sie sich, dass Sie über ein aktives Chloros+-Abonnement verfügen.

  2. Melden Sie sich mit Ihren Anmeldedaten an:

  1. Überprüfen Sie den Lizenzstatus:

  1. Wenden Sie sich an den Support: info@mapir.camera


Keine Bilder gefundenFehler:

Lösungen:

  1. Überprüfen Sie, ob der Ordner unterstützte Formate enthält (.RAW, .TIF, .JPG).

  2. Überprüfen Sie, ob der Ordnerpfad korrekt ist (verwenden Sie Anführungszeichen für Pfade mit Leerzeichen).

  3. Stellen Sie sicher, dass Sie Leserechte für den Ordner haben.

  4. Überprüfen Sie, ob die Dateierweiterungen korrekt sind.


Verarbeitung stockt oder hängtLösungen:

  1. Überprüfen Sie den verfügbaren Speicherplatz (stellen Sie sicher, dass genügend Speicherplatz für die Ausgabe vorhanden ist).

  2. Schließen Sie andere Anwendungen, um Speicherplatz freizugeben.

  3. Reduzieren Sie die Anzahl der Bilder (verarbeiten Sie sie in Stapeln).


Port bereits in VerwendungFehler:

Lösung:

Geben Sie einen anderen Port an:


FAQ

F: Benötige ich eine Lizenz für CLI?

A:Ja! Für CLI ist eine kostenpflichtigeChloros+-Lizenz erforderlich.

  • ❌ Standard-Tarif (kostenlos): CLI deaktiviert

  • ✅ Chloros+ (kostenpflichtige) Tarife: CLI vollständig aktiviert

Abonnieren Sie unter: https://cloud.mapir.camera/pricingarrow-up-right


F: Kann ich CLI auf einem Server ohne GUI verwenden?A: Ja! CLI läuft vollständig headless. Anforderungen:

  • Windows Server 2016 oder höher

  • Visual C++ Redistributable installiert

  • Ausreichend RAM (mindestens 8 GB, 16 GB empfohlen)

  • Einmalige Aktivierung der GUI-Lizenz auf einem beliebigen Rechner


F: Wo werden die verarbeiteten Bilder gespeichert?A:Standardmäßig werden die verarbeiteten Bilder imgleichen Ordner wie die Eingabe in Unterordnern des Kameramodells (z. B. Survey3N_RGN/) gespeichert.

Verwenden Sie die Option -o, um einen anderen Ausgabeordner anzugeben:


F: Kann ich mehrere Ordner gleichzeitig verarbeiten?A: Nicht direkt mit einem Befehl, aber Sie können Skripte verwenden, um Ordner nacheinander zu verarbeiten. Siehe Abschnitt Automatisierung und Skripterstellung.***

F: Wie speichere ich die Ausgabe von CLI in einer Protokolldatei?PowerShell:

Batch:


F: Was passiert, wenn ich während der Verarbeitung Strg+C drücke?A: CLI wird:

  1. Die Verarbeitung ordnungsgemäß beenden

  2. Das Backend herunterfahren

  3. Mit dem Code 130 beenden

Teilweise verarbeitete Bilder können im Ausgabeordner verbleiben.


F: Kann ich die Verarbeitung von CLI automatisieren?A: Auf jeden Fall! CLI ist für die Automatisierung ausgelegt. Beispiele für PowerShell, Batch und Python finden Sie unter Automatisierung und Skripting.***

F: Wie kann ich die Version von CLI überprüfen?A:

Ausgabe:


Hilfe erhalten

Befehlszeilenhilfe

Zeigen Sie die Hilfeinformationen direkt in CLI an:

Support-Kanäle

Vollständige Beispiele

Beispiel 1: Grundlegende Verarbeitung

Verarbeitung mit Standardeinstellungen (Vignette, Reflexion):


Beispiel 2: Hochwertige wissenschaftliche Ausgabe

32-Bit-Float TIFF:


Beispiel 3: Schnelle Vorschauverarbeitung

8-Bit PNG ohne Kalibrierung für schnelle Überprüfung:


Beispiel 4: PPK-korrigierte Verarbeitung

Anwendung von PPK-Korrekturen mit Reflexion:


Beispiel 5: Benutzerdefinierter Ausgabeort

Verarbeitung auf einem anderen Laufwerk mit spezifischem Format:


Beispiel 6: Authentifizierungs-Workflow

Authentifizierungsablauf abschließen:


Beispiel 7: Mehrsprachige Nutzung

Sprache der Benutzeroberfläche ändern:

Zuletzt aktualisiert