CLI : Opdrachtregel

De **Chloros CLI** biedt krachtige opdrachtregeltoegang tot de Chloros-beeldverwerkingsengine, waardoor automatisering, scripting en headless-werking voor uw beeldverwerkingsworkflows mogelijk worden.

Belangrijkste kenmerken

  • 🚀 Automatisering - Batchverwerking van meerdere datasets via scripts

  • 🔗 Integratie - Integreer in bestaande workflows en pijplijnen

  • 💻 Headless-werking - Draai zonder GUI

  • 🌍 Meertalig - Ondersteuning voor 38 talen

  • Parallelle verwerking - Dynamic Compute Adaptation optimaliseert automatisch voor uw hardware

Vereisten

Vereiste
Details

Besturingssysteem

Windows 10/11 (64-bit), Linux x86_64 (amd64), Linux arm64 (NVIDIA Jetson JetPack 6)

Geheugen

Minimaal 8 GB RAM (16 GB aanbevolen)

Internet

Vereist voor licentieactivering

Schijfruimte

Varieert afhankelijk van de projectgrootte

circle-exclamation

Snel aan de slag

Installatie

Windows

De CLI wordt automatisch meegeleverd met het Chloros-installatieprogramma:

  1. Download en voer Chloros Installer.exe uit

  2. Voltooi de installatiewizard

  3. CLI geïnstalleerd in: C:\Program Files\Chloros\resources\cli\chloros-cli.exe

circle-check

Linux

Installeer het .deb-pakket voor uw architectuur:

Raadpleeg Linux Installatie voor gedetailleerde informatie over de installatie van Linux.

Eerste installatie

Activeer uw Chloros+ licentie voordat u de CLI gebruikt:

Windows:

Linux:

Basisgebruik

Verwerk een map met standaardinstellingen:

Windows:

Linux:


Commando-overzicht

Algemene syntaxis


Commando's

process - Afbeeldingen verwerken

Verwerk afbeeldingen in een map met kalibratie.

Syntaxis:

Voorbeelden:

Opties voor het verwerkingscommando

Optie
Type
Standaard
Beschrijving

<input-folder>

Pad

Vereist

Map met RAW/JPG multispectrale afbeeldingen

-o, --output

Pad

Hetzelfde als invoer

Uitvoermap voor verwerkte afbeeldingen

-n, --project-name

Tekst

Automatisch gegenereerd

Aangepaste projectnaam

--vignette

Vlag

Ingeschakeld

Vignetcorrectie inschakelen

--no-vignette

Vlag

-

Vignetcorrectie uitschakelen

--reflectance

Vlag

Ingeschakeld

Reflectiekalibratie inschakelen

--no-reflectance

Vlag

-

Reflectiekalibratie uitschakelen

--ppk

Vlag

Uitgeschakeld

Pas PPK-correcties toe op basis van .daq-lichtsensorgegevens

--format

Keuze

TIFF (16-bits)

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

--min-target-size

Geheel getal

Auto

Minimale doelgrootte in pixels voor detectie van kalibratiepaneel

--target-clustering

Geheel getal

Auto

Drempelwaarde voor clustering van doelen (0-100)

--debayer

Keuze

standard

Debayer-methode: standard of texture-aware (alleen Chloros+)

--target, --targets

Vlag

Uitgeschakeld

Zoek alleen naar kalibratiedoelen in een submap "target" of "targets" (versnelt de verwerking)

--indices

Lijst

Geen

Te berekenen vegetatie-indexen (bijv. --indices NDVI NDRE GNDVI)

--exposure-pin-1

Tekst

Geen

Belichting vergrendelen voor cameramodel (Pin 1)

--exposure-pin-2

Tekst

Geen

Belichting vergrendelen voor cameramodel (Pin 2)

--recal-interval

Geheel getal

Auto

Herkalibratie-interval in seconden

--timezone-offset

Geheel getal

0

Tijdzone-offset in uren


login - Account verifiëren

Log in met uw Chloros+ inloggegevens om CLI-verwerking in te schakelen.

Syntaxis:

Voorbeeld:

circle-exclamation

Uitvoer:

***

logout - Inloggegevens wissen

Wis opgeslagen inloggegevens en log uit bij uw account.

Syntaxis:

Voorbeeld:

Uitvoer:

circle-info

SDK-gebruikers: De Python SDK biedt ook een programmatische logout()-methode voor het wissen van inloggegevens binnen Python-scripts. Raadpleeg de Python SDK documentatie voor meer informatie.


status - Licentiestatus controleren

Geef de huidige licentie- en authenticatiestatus weer.

Syntaxis:

Voorbeeld:

Uitvoer:


export-status - Exportvoortgang controleren

Controleer de exportvoortgang van Thread 4 tijdens of na de verwerking.

Syntaxis:

Voorbeeld:

Toepassing: Roep deze opdracht aan terwijl de verwerking loopt om de voortgang van de export te controleren.***

language - Beheer van de interfacetaal

Bekijk of wijzig de interfacetaal van CLI.

Syntaxis:

Voorbeelden:

Ondersteunde talen (38 in totaal)

Code
Taal
Oorspronkelijke naam

en

Engels

English

es

Spaans

Español

pt

Portugees

Português

fr

Frans

Français

de

Duits

Deutsch

it

Italiaans

Italiano

ja

Japans

日本語

ko

Koreaans

한국어

zh

Chinees (vereenvoudigd)

简体中文

zh-TW

Chinees (traditioneel)

繁體中文

ru

Russisch

Русский

nl

Nederlands

Nederlands

ar

Arabisch

العربية

pl

Pools

Polski

tr

Turks

Türkçe

hi

Hindi

हिंदी

id

Indonesisch

Bahasa Indonesia

vi

Vietnamees

Tiếng Việt

th

Thais

ไทย

sv

Zweeds

Svenska

da

Deens

Dansk

no

Noors

Norsk

fi

Fins

Suomi

el

Grieks

Ελληνικά

cs

Tsjechisch

Čeština

hu

Hongaars

Magyar

ro

Roemeens

Română

uk

Oekraïens

Українська

pt-BR

Braziliaans Portugees

Português Brasileiro

zh-HK

Kantonees

粵語

ms

Maleis

Bahasa Melayu

sk

Slowaaks

Slovenčina

bg

Bulgaars

Български

hr

Kroatisch

Hrvatski

lt

Litouws

Lietuvių

lv

Lets

Latviešu

et

Ests

Eesti

sl

Sloveens

Slovenščina

circle-check

set-project-folder - Standaardprojectmap instellen

Wijzig de locatie van de standaardprojectmap (gedeeld met GUI op Windows).

Syntaxis:

Voorbeelden:


get-project-folder - Projectmap weergeven

Geef de huidige locatie van de standaardprojectmap weer.

Syntaxis:

Voorbeeld:

Uitvoer:


reset-project-folder - Terugzetten naar standaard

De projectmap terugzetten naar de standaardlocatie.

Syntaxis:


selftest - Systeemdiagnostiek uitvoeren

Voer 7 diagnostische controles uit om uw systeemconfiguratie te verifiëren.

Syntaxis:

Uitgevoerde diagnostiek:

  1. Versiecontrole

  2. Beschikbaarheid van poort (5000)

  3. Opstarten van backend

  4. API-connectiviteitstest

  5. Systeeminformatie en GPU-detectie

  6. Verificatie van denoiser-modellen

  7. Controle op beschikbaarheid van CUDA

circle-info

Handig voor probleemoplossing: Voer selftest uit na de installatie om te controleren of uw systeem correct is geconfigureerd, met name op Linux/Jetson waar de GPU- en CUDA-instellingen mogelijk moeten worden geverifieerd.


update - Controleren op updates (alleen Linux)

Controleer op en installeer CLI-updates op Linux-systemen.

Syntaxis:

Optie
Beschrijving

--check

Alleen controleren op updates, niet installeren

circle-info

Deze opdracht is alleen beschikbaar op Linux. Op Windows worden updates geleverd via het installatieprogramma.


Algemene opties

Deze opties zijn van toepassing op alle commando's:

Optie
Type
Standaard
Beschrijving

--backend-exe

Pad

Automatisch gedetecteerd

Pad naar uitvoerbaar backend-bestand

--port

Geheel getal

5000

Poortnummer van backend API

--restart

Vlag

-

Backend geforceerd opnieuw opstarten (beëindigt bestaande processen)

--version

Vlag

-

Versie-informatie weergeven en afsluiten

--help

Vlag

-

Helpinformatie weergeven en afsluiten

circle-info

Automatische detectie van backend: Het pad --backend-exe wordt automatisch gedetecteerd per platform:

  • Windows: C:\Program Files\MAPIR\Chloros\resources\backend\chloros-backend.exe

  • Linux (.deb): /usr/lib/chloros/chloros-backend

  • Linux (handmatig): /opt/mapir/chloros/backend/chloros-backend

Voorbeeld met algemene opties:

Windows:

Linux:


Handleiding voor verwerkingsinstellingen

Parallelle verwerking en dynamische rekenaanpassing

Chloros 1.1.0 bevat Dynamic Compute Adaptation — de verwerkingsengine detecteert automatisch uw hardware en selecteert de optimale strategie:

Platform
Strategie
Werkers
Pijplijn
Opmerkingen

Jetson Nano 8GB

GPU_SINGLE

1

tiled_gpu

Geheugenefficiënt, geserialiseerd

Jetson Orin NX 16 GB

GPU_PARALLEL

3

fused_gpu

Gelijktijdige GPU-verwerking

Desktop met 8 GB GPU

GPU_SINGLE

3

tiled_gpu

Goede desktopprestaties

Desktop met 12 GB+ GPU

GPU_PARALLEL

3-4

fused_gpu

Optimale desktopprestaties

Systeem met alleen CPU

CPU_PARALLEL

cores - 1

cpu_fallback

Geen GPU vereist

circle-check

Debayer-methoden

Methode
CLI-vlag
Kwaliteit
Snelheid
Licentie

Standaard (Snel, Gemiddelde kwaliteit)

--debayer standard

Goed

Snel

Gratis / Chloros+

Textuurbewust (Langzaam, Hoogste kwaliteit)

--debayer texture-aware

Hoogste

Langzaam

Alleen Chloros+

De standaard debayer-methode is Standaard. DeTextuurbewuste methode maakt gebruik van een AI/ML-ruisonderdrukkingsmodel voor de hoogste uitvoerkwaliteit, maar vereist een Chloros+ licentie en een NVIDIA GPU.

Vignettecorrectie

Wat het doet: Corrigeert lichtverval aan de randen van het beeld (donkere hoeken die vaak voorkomen in camerabeelden).

  • Standaard ingeschakeld - De meeste gebruikers kunnen dit beter ingeschakeld laten

  • Gebruik --no-vignette om uit te schakelen

circle-check

Reflectiekalibratie

Zet ruwe sensorwaarden om in gestandaardiseerde reflectiepercentages met behulp van kalibratiepanelen.

  • Standaard ingeschakeld - Essentieel voor vegetatieanalyse

  • Vereist kalibratiedoelpanelen in beelden

  • Gebruik --no-reflectance om uit te schakelen

circle-info

Vereisten: Zorg ervoor dat kalibratiepanelen goed belicht en zichtbaar zijn in uw beelden voor een nauwkeurige reflectanceconversie.

PPK-correcties

Wat het doet: Past Post-Processed Kinematic-correcties toe met behulp van DAQ-A-SD-loggegevens voor verbeterde GPS-nauwkeurigheid.

  • Standaard uitgeschakeld

  • Gebruik --ppk om in te schakelen

  • Vereist .daq-bestanden in de projectmap van de MAPIR DAQ-A-SD-lichtsensor.

Uitvoerformaten

Formaat
Bitdiepte
Bestandsgrootte
Meest geschikt voor

TIFF (16-bits)

16-bits geheel getal

Groot

GIS-analyse, fotogrammetrie (aanbevolen)

TIFF (32-bit, Percent)

32-bits drijvende komma

Zeer groot

Wetenschappelijke analyse, onderzoek

PNG (8-bit)

8-bits geheel getal

Middel

Visuele inspectie, delen via het web

JPG (8-bit)

8-bits geheel getal

Klein

Snel voorbeeld, gecomprimeerde uitvoer

***

Automatisering & scripting

PowerShell-batchverwerking (Windows)

Verwerk automatisch meerdere datasetsmappen op Windows:

Windows Batchscript (Windows)

Eenvoudige lus voor batchverwerking op Windows:

Bash-batchverwerking (Linux)

Verwerk meerdere datasetsmappen op Linux:

Python-automatiseringsscript (platformonafhankelijk)

Geavanceerde automatisering met foutafhandeling (werkt op Windows en Linux):


Verwerkingsworkflow

Standaardworkflow

  1. Invoer: Map met RAW/JPG-beeldparen

  2. Detectie: CLI scant automatisch naar ondersteunde beeldbestanden

  3. Verwerking: Parallelle modus schaalt mee met uw CPU-kernen (Chloros+)

  4. Uitvoer: Maakt submappen per cameramodel aan met verwerkte afbeeldingen

Voorbeeld van de uitvoerstructuur

Geschatte verwerkingstijden

Typische verwerkingstijden voor 100 afbeeldingen (elk 12 MP):

Platform
Modus
Geschatte tijd
Opmerkingen

Desktop 12 GB+ GPU

GPU_PARALLEL

5-10 min

Snelste optie

Desktop 8 GB GPU

GPU_SINGLE

10-15 min

Goede prestaties

Jetson Orin NX 16 GB

GPU_PARALLEL

15-25 min

Edge computing

Jetson Nano 8 GB

GPU_SINGLE

30-60 min

Beperkt geheugen

Alleen CPU

CPU_PARALLEL

20-40 min

Geen GPU vereist

circle-info

Prestatietip: De verwerkingstijd varieert afhankelijk van het aantal afbeeldingen, de resolutie, de debayer-methode en de hardware. Texture Aware debayer duurt aanzienlijk langer dan Standard. Zie Dynamic Compute Adaptation voor meer informatie.


Probleemoplossing

CLI niet gevonden

Windows-fout:

Windows Oplossingen:

  1. Controleer de installatielocatie:

  1. Gebruik het volledige pad als het niet in PATH staat:

  1. Voeg handmatig toe aan PATH:

    • Open Systeemeigenschappen → Omgevingsvariabelen

    • Bewerk de PATH-variabele

    • Voeg toe: C:\Program Files\Chloros\resources\cli

    • Start de terminal opnieuw op

Linux Fout:

Linux Oplossingen:

  1. Controleer de installatie:

  1. Herlaad uw shell:

  1. Controleer de machtigingen:


Backend kan niet worden gestartFout:

Oplossingen:

  1. Controleer of de backend al actief is (sluit deze eerst)

  2. Controleer of de firewall niet blokkeert (Windows) of controleer de beschikbaarheid van de poort (Linux: lsof -i :5000)

  3. Probeer een andere poort:

  1. Forceer een herstart van de backend:

  1. Controleer op Linux of het uitvoerbare bestand van de backend bestaat:


Licentie-/authenticatieproblemenFout:

Oplossingen:

  1. Controleer of u een actief Chloros+-abonnement hebt

  2. Log in met uw inloggegevens:

  1. Controleer de licentiestatus:

  1. Neem contact op met de ondersteuning: info@mapir.camera


Geen afbeeldingen gevondenFout:

Oplossingen:

  1. Controleer of de map ondersteunde formaten bevat (.RAW, .TIF, .JPG)

  2. Controleer of het pad naar de map correct is (gebruik aanhalingstekens voor paden met spaties)

  3. Zorg ervoor dat u leesrechten voor de map hebt

  4. Controleer of de bestandsextensies correct zijn


Verwerking loopt vast of hangtOplossingen:

  1. Controleer de beschikbare schijfruimte (zorg dat er voldoende is voor de uitvoer)

  2. Sluit andere toepassingen om geheugen vrij te maken

  3. Verminder het aantal afbeeldingen (verwerk in batches)


Poort al in gebruikFout:

Oplossingen:

Windows:

Linux:


Veelgestelde vragen

V: Heb ik een licentie nodig voor de CLI?

A:Ja! Voor de CLI is een betaaldeChloros+ licentie vereist.

  • ❌ Standaard (gratis) abonnement: CLI uitgeschakeld

  • ✅ Chloros+ (betaalde) abonnementen: CLI volledig ingeschakeld

Abonneren via: https://cloud.mapir.camera/pricingarrow-up-right


V: Kan ik de CLI gebruiken op een server zonder GUI?A: Ja! De CLI draait volledig headless. Dit is het belangrijkste gebruiksscenario op Linux.Windows-server:

  • Windows-server 2016 of later

  • Visual C++ Redistributable geïnstalleerd

Linux-server:

  • Ubuntu 20.04+ / Debian 11+ (amd64) of JetPack 6 (arm64)

  • Installeren via het .deb-pakket

Beide platforms:

  • Minimaal 8 GB RAM (16 GB aanbevolen)

  • Eenmalige licentieactivering: chloros-cli login user@example.com 'password'


V: Waar worden bewerkte afbeeldingen opgeslagen?A:Standaard worden bewerkte afbeeldingen opgeslagen indezelfde map als de invoer, in submappen met het cameramodel (bijv. Survey3N_RGN/).

Gebruik de optie -o om een andere uitvoermap op te geven:


V: Kan ik meerdere mappen tegelijk verwerken?A: Niet direct in één opdracht, maar u kunt scripts gebruiken om mappen achtereenvolgens te verwerken. Zie het gedeelte Automatisering en scripting.***

V: Hoe sla ik de uitvoer van CLI op in een logbestand?PowerShell:

Batch:

Linux Bash:


V: Wat gebeurt er als ik tijdens de verwerking op Ctrl+C druk?A: De CLI zal:

  1. De verwerking op een nette manier stoppen

  2. De backend afsluiten

  3. Afsluiten met code 130

Gedeeltelijk verwerkte afbeeldingen kunnen in de uitvoermap achterblijven.


V: Kan ik de verwerking van CLI automatiseren?A: Absoluut! De CLI is ontworpen voor automatisering. Zie Automatisering & scripting voor PowerShell (Windows), Batch (Windows), Bash (Linux) en Python (platformonafhankelijk).***

V: Hoe controleer ik de CLI-versie?A:

Uitvoer:


Hulp krijgen

Help via de opdrachtregel

Bekijk helpinformatie rechtstreeks in de CLI:

Ondersteuningskanalen

Volledige voorbeelden

Voorbeeld 1: Basisverwerking

Verwerking met standaardinstellingen (vignettering, reflectie):

Windows:

Linux:


Voorbeeld 2: Wetenschappelijke uitvoer van hoge kwaliteit

32-bits float TIFF:

Windows:

Linux:


Voorbeeld 3: Snelle verwerking van voorbeelden

8-bits PNG zonder kalibratie voor snelle beoordeling:

Windows:

Linux:


Voorbeeld 4: PPK-gecorrigeerde verwerking

Pas PPK-correcties toe met reflectantie:

Windows:

Linux:


Voorbeeld 5: Aangepaste uitvoerlocatie

Verwerk naar een andere locatie met een specifiek formaat:

Windows:

Linux:


Voorbeeld 6: Authenticatiewerkstroom

Volledige authenticatiestroom (hetzelfde op alle platforms):


Voorbeeld 7: Meertalig gebruik

Interfacetaal wijzigen (hetzelfde op alle platforms):

Laatst bijgewerkt