CLI : Kommandorad

**Chloros CLI** ger kraftfull kommandoradsåtkomst till bildbehandlingsmotorn Chloros, vilket möjliggör automatisering, skriptning och headless-drift för dina bildbehandlingsarbetsflöden.

Viktiga funktioner

  • 🚀 Automatisering – Skriptbaserad batchbearbetning av flera datamängder

  • 🔗 Integration – Integrera i befintliga arbetsflöden och pipelines

  • 💻 Headless-drift – Kör utan GUI

  • 🌍 Flerspråkig – Stöd för 38 språk

  • Parallell bearbetningDynamic Compute Adaptation optimerar automatiskt för din hårdvara

Krav

Krav
Detaljer

Operativsystem

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

Minne

Minst 8 GB RAM (16 GB rekommenderas)

Internet

Krävs för licensaktivering

Diskutrymme

Varierar beroende på projektstorlek

circle-exclamation

Snabbstart

Installation

Windows

CLI ingår automatiskt i installationsprogrammet för Chloros:

  1. Ladda ner och kör Chloros Installer.exe

  2. Följ installationsguiden

  3. CLI installeras i: C:\Program Files\Chloros\resources\cli\chloros-cli.exe

circle-check

Linux

Installera paketet .deb för din arkitektur:

För detaljerad information om Linux-installationen, se Linux Installation.

Första installation

Innan du använder CLI måste du aktivera din Chloros+-licens:

Windows:

Linux:

Grundläggande användning

Bearbeta en mapp med standardinställningar:

Windows:

Linux:


Kommandoreferens

Allmän syntax


Kommandon

process - Bearbeta bilder

Bearbeta bilder i en mapp med kalibrering.

Syntax:

Exempel:

Alternativ för kommandot Process

Alternativ
Typ
Standard
Beskrivning

<input-folder>

Sökväg

Obligatoriskt

Mapp som innehåller RAW/JPG-multispektralbilder

-o, --output

Sökväg

Samma som ingång

Utdatamapp för bearbetade bilder

-n, --project-name

Sträng

Autogenererad

Anpassat projektnamn

--vignette

Flagga

Aktiverad

Aktivera vignettkorrigering

--no-vignette

Flagga

-

Inaktivera vignettkorrigering

--reflectance

Flagga

Aktiverad

Aktivera reflektanskalibrering

--no-reflectance

Flagga

-

Inaktivera reflektanskalibrering

--ppk

Flagga

Inaktiverad

Tillämpa PPK-korrigeringar från .daq-ljussensordata

--format

Val

TIFF (16-bit)

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

--min-target-size

Heltal

Auto

Minsta målstorlek i pixlar för detektering av kalibreringspanelen

--target-clustering

Heltal

Auto

Tröskelvärde för målkluster (0–100)

--debayer

Val

standard

Debayer-metod: standard eller texture-aware (endast Chloros+)

--target, --targets

Flagga

Inaktiverad

Sök endast efter kalibreringsmål i en undermapp med namnet ”target” eller ”targets” (påskyndar bearbetningen)

--indices

Lista

Ingen

Vegetationsindex att beräkna (t.ex. --indices NDVI NDRE GNDVI)

--exposure-pin-1

Sträng

Ingen

Lås exponering för kameramodell (Pin 1)

--exposure-pin-2

Sträng

Ingen

Lås exponering för kameramodell (stift 2)

--recal-interval

Heltal

Auto

Omkalibreringsintervall i sekunder

--timezone-offset

Heltal

0

Tidszonsavvikelse i timmar


login - Autentisera konto

Logga in med dina Chloros+-inloggningsuppgifter för att aktivera CLI-bearbetning.

Syntax:

Exempel:

circle-exclamation

Utdata:

***

logout - Rensa inloggningsuppgifter

Rensa lagrade inloggningsuppgifter och logga ut från ditt konto.

Syntax:

Exempel:

Utdata:

circle-info

SDK-användare: Python SDK tillhandahåller även en programmatisk logout()-metod för att rensa inloggningsuppgifter inom Python-skript. Se Python SDK dokumentationen för mer information.


status – Kontrollera licensstatus

Visar aktuell licens- och autentiseringsstatus.

Syntax:

Exempel:

Utdata:


export-status – Kontrollera exportförloppet

Övervaka exportförloppet för tråd 4 under eller efter bearbetningen.

Syntax:

Exempel:

Användningsfall: Använd detta kommando medan bearbetningen pågår för att kontrollera exportförloppet.***

language – Hantera gränssnittsspråk

Visa eller ändra gränssnittsspråket för CLI.

Syntax:

Exempel:

Språk som stöds (totalt 38)

Kod
Språk
Namn på originalspråket

en

Engelska

English

es

Spanska

Español

pt

Portugisiska

Português

fr

Franska

Français

de

Tyska

Deutsch

it

Italienska

Italiano

ja

Japanska

日本語

ko

Koreanska

한국어

zh

Kinesiska (förenklad)

简体中文

zh-TW

Kinesiska (traditionell)

繁體中文

ru

Ryska

Русский

nl

Nederländska

Nederlands

ar

Arabiska

العربية

pl

Polska

Polski

tr

Turkiska

Türkçe

hi

Hindi

हिंदी

id

Indonesiska

Bahasa Indonesia

vi

Vietnamesiska

Tiếng Việt

th

Thailändska

ไทย

sv

Svenska

Svenska

da

Danska

Dansk

no

Norska

Norsk

fi

Finska

Suomi

el

Grekiska

Ελληνικά

cs

Tjeckiska

Čeština

hu

Ungerska

Magyar

ro

Rumänska

Română

uk

Ukrainska

Українська

pt-BR

Brasiliansk portugisiska

Português Brasileiro

zh-HK

Kantonesiska

粵語

ms

Malajiska

Bahasa Melayu

sk

Slovakiska

Slovenčina

bg

Bulgariska

Български

hr

Kroatiska

Hrvatski

lt

Litauiska

Lietuvių

lv

Lettiska

Latviešu

et

Estniska

Eesti

sl

Slovensk

Slovenščina

circle-check

set-project-folder - Ställ in standardprojektmapp

Ändra platsen för standardprojektmappen (delas med GUI på Windows).

Syntax:

Exempel:


get-project-folder - Visa projektmapp

Visa den aktuella standardprojektmappens plats.

Syntax:

Exempel:

Utdata:


reset-project-folder – Återställ till standard

Återställ projektmappen till standardplatsen.

Syntax:


selftest – Kör systemdiagnostik

Kör 7 diagnostiska kontroller för att verifiera din systemkonfiguration.

Syntax:

Utförda diagnostiska kontroller:

  1. Versionskontroll

  2. Porttillgänglighet (5000)

  3. Start av backend

  4. API-anslutningstest

  5. Systeminformation och GPU-detektering

  6. Verifiering av brusreduceringsmodeller

  7. Kontroll av CUDA-tillgänglighet

circle-info

Användbart för felsökning: Kör selftest efter installationen för att verifiera att ditt system är korrekt konfigurerat, särskilt på Linux/Jetson där GPU- och CUDA-inställningarna kan behöva verifieras.


update – Sök efter uppdateringar (endast Linux)

Sök efter och installera CLI-uppdateringar på Linux-system.

Syntax:

Alternativ
Beskrivning

--check

Sök endast efter uppdateringar, installera inte

circle-info

Detta kommando är endast tillgängligt på Linux. På Windows levereras uppdateringar via installationsprogrammet.


Globala alternativ

Dessa alternativ gäller för alla kommandon:

Alternativ
Typ
Standard
Beskrivning

--backend-exe

Sökväg

Automatiskt detekterad

Sökväg till backend-körbar fil

--port

Heltal

5000

Backend API portnummer

--restart

Flagga

-

Tvinga omstart av backend (avslutar befintliga processer)

--version

Flagga

-

Visa versionsinformation och avsluta

--help

Flagga

-

Visa hjälpinformation och avsluta

circle-info

Automatisk upptäckt av backend: Sökvägen --backend-exe upptäcks automatiskt per plattform:

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

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

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

Exempel med globala alternativ:

Windows:

Linux:


Guide till bearbetningsinställningar

Parallellbearbetning och dynamisk beräkningsanpassning

Chloros 1.1.0 inkluderar Dynamisk beräkningsanpassning — bearbetningsmotorn upptäcker automatiskt din hårdvara och väljer den optimala strategin:

Plattform
Strategi
Arbetare
Pipeline
Anmärkningar

Jetson Nano 8 GB

GPU_SINGLE

1

tiled_gpu

Minneseffektiv, serialiserad

Jetson Orin NX 16 GB

GPU_PARALLEL

3

fused_gpu

Samtidig GPU-bearbetning

Stationär dator med 8 GB GPU

GPU_SINGLE

3

tiled_gpu

Bra prestanda för stationära datorer

Stationär dator med 12 GB+ GPU

GPU_PARALLEL

3–4

fused_gpu

Optimal stationär prestanda

System med endast CPU

CPU_PARALLEL

kärnor – 1

cpu_fallback

Inget grafikkort krävs

circle-check

Debayer-metoder

Metod
CLI-flagga
Kvalitet
Hastighet
Licens

Standard (Snabb, medelhög kvalitet)

--debayer standard

Bra

Snabb

Gratis / Chloros+

Texturmedveten (Långsam, högsta kvalitet)

--debayer texture-aware

Högsta

Långsam

Endast Chloros+

Standardmetoden för debayering är Standard. MetodenTexturmedveten använder en AI/ML-brusreduceringsmodell för utdata av högsta kvalitet, men kräver en Chloros+-licens och ett NVIDIA-grafikkort.

Vignettkorrigering

Vad det gör: Korrigerar ljusavfall vid bildkanterna (mörkare hörn som är vanliga i kamerabilder).

  • Aktiverat som standard – De flesta användare bör ha detta aktiverat

  • Använd --no-vignette för att inaktivera

circle-check

Reflektanskalibrering

Konverterar råa sensorvärden till standardiserade reflektansprocenttal med hjälp av kalibreringspaneler.

  • Aktiverat som standard – Nödvändigt för vegetationsanalys

  • Kräver kalibreringspaneler i bilderna

  • Använd --no-reflectance för att inaktivera

circle-info

Krav: Se till att kalibreringspanelerna är korrekt exponerade och synliga i dina bilder för korrekt reflektanskonvertering.

PPK-korrigeringar

Vad det gör: Tillämpar post-processerade kinematiska korrigeringar med hjälp av DAQ-A-SD-loggdata för förbättrad GPS-noggrannhet.

  • Inaktiverat som standard

  • Använd --ppk för att aktivera

  • Kräver .daq-filer i projektmappen från MAPIR DAQ-A-SD-ljussensor.

Utdataformat

Format
Bittjocklek
Filstorlek
Bäst för

TIFF (16-bit)

16-bitars heltal

Stor

GIS-analys, fotogrammetri (rekommenderas)

TIFF (32-bitars, procent)

32-bitars flyttal

Mycket stor

Vetenskaplig analys, forskning

PNG (8-bit)

8-bitars heltal

Medel

Visuell inspektion, delning på webben

JPG (8-bit)

8-bitars heltal

Liten

Snabb förhandsgranskning, komprimerad utdata

***

Automatisering och skriptning

PowerShell-batchbearbetning (Windows)

Bearbeta flera datasetmappar automatiskt på Windows:

Windows Batchskript (Windows)

Enkel loop för batchbearbetning på Windows:

Bash-batchbearbetning (Linux)

Bearbeta flera datasetmappar på Linux:

Python automatiseringsskript (plattformsoberoende)

Avancerad automatisering med felhantering (fungerar på Windows och Linux):


Bearbetningsflöde

Standardflöde

  1. Indata: Mapp som innehåller RAW/JPG-bildpar

  2. Upptäckt: CLI söker automatiskt efter bildfiler som stöds

  3. Bearbetning: Parallellt läge skalar efter dina CPU-kärnor (Chloros+)

  4. Utdata: Skapar undermappar för kameramodeller med bearbetade bilder

Exempel på utdatastruktur

Uppskattad bearbetningstid

Typisk bearbetningstid för 100 bilder (12 MP vardera):

Plattform
Läge
Uppskattad tid
Anmärkningar

Stationär dator med 12 GB+ GPU

GPU_PARALLEL

5–10 min

Snabbaste alternativet

Stationär dator med 8 GB GPU

GPU_SINGLE

10–15 min

Bra prestanda

Jetson Orin 16 GB

GPU_PARALLEL

15–25 min

Edge-beräkning

Jetson Nano 8 GB

GPU_SINGLE

30–60 min

Begränsat minne

Endast CPU

CPU_PARALLEL

20–40 min

Ingen GPU krävs

circle-info

Prestandatips: Bearbetningstiden varierar beroende på antal bilder, upplösning, debayer-metod och hårdvara. Texture Aware-debayer tar betydligt längre tid än Standard. Se Dynamic Compute Adaptation för mer information.


Felsökning

CLI hittades inte

Windows-fel:

Windows Lösningar:

  1. Kontrollera installationsplatsen:

  1. Använd fullständig sökväg om den inte finns i PATH:

  1. Lägg till i PATH manuellt:

    • Öppna Systemegenskaper → Miljövariabler

    • Redigera variabeln PATH

    • Lägg till: C:\Program Files\Chloros\resources\cli

    • Starta om terminalen

Linux Fel:

Linux Lösningar:

  1. Kontrollera installationen:

  1. Ladda om ditt skal:

  1. Kontrollera behörigheter:


Backend kunde inte startasFel:

Lösningar:

  1. Kontrollera om backend redan körs (stäng den först)

  2. Kontrollera att brandväggen inte blockerar (Windows) eller kontrollera porttillgänglighet (Linux: lsof -i :5000)

  3. Prova en annan port:

  1. Tvinga omstart av backend:

  1. På Linux, kontrollera att backend-programmet finns:


Problem med licens/autentiseringFel:

Lösningar:

  1. Kontrollera att du har en aktiv Chloros+-prenumeration

  2. Logga in med dina inloggningsuppgifter:

  1. Kontrollera licensstatus:

  1. Kontakta supporten: info@mapir.camera


Inga bilder hittadesFel:

Lösningar:

  1. Kontrollera att mappen innehåller format som stöds (.RAW, .TIF, .JPG)

  2. Kontrollera att mappvägen är korrekt (använd citattecken för sökvägar med mellanslag)

  3. Se till att du har läsbehörighet för mappen

  4. Kontrollera att filändelserna är korrekta


Bearbetningen stannar upp eller hänger sigLösningar:

  1. Kontrollera tillgängligt diskutrymme (se till att det finns tillräckligt för utdata)

  2. Stäng andra program för att frigöra minne

  3. Minska antalet bilder (bearbeta i omgångar)


Porten används redanFel:

Lösningar:

Windows:

Linux:


Vanliga frågor

F: Behöver jag en licens för CLI?

S:Ja! CLI kräver en betaldChloros+-licens.

  • ❌ Standardplan (gratis): CLI inaktiverat

  • ✅ Chloros+ (betald) plan: CLI fullt aktiverat

Prenumerera på: https://cloud.mapir.camera/pricingarrow-up-right


F: Kan jag använda CLI på en server utan GUI?S: Ja! CLI körs helt utan grafiskt gränssnitt. Detta är det primära användningsfallet på Linux.Windows-server:

  • Windows Server 2016 eller senare

  • Visual C++ Redistributable installerat

Linux Server:

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

  • Installera via .deb-paketet

Båda plattformarna:

  • Minst 8 GB RAM (16 GB rekommenderas)

  • Engångsaktivering av licens: chloros-cli login user@example.com 'password'


F: Var sparas bearbetade bilder?S:Som standard sparas bearbetade bilder isamma mapp som ingångsfilerna i undermappar för kameramodeller (t.ex. Survey3N_RGN/).

Använd alternativet -o för att ange en annan utmatningsmapp:


F: Kan jag bearbeta flera mappar samtidigt?S: Inte direkt med ett enda kommando, men du kan använda skript för att bearbeta mappar i tur och ordning. Se avsnittet Automatisering och skript.***

F: Hur sparar jag CLI-utdata till en loggfil?PowerShell:

Batch:

Linux Bash:


F: Vad händer om jag trycker på Ctrl+C under bearbetningen?S: CLI kommer att:

  1. Avsluta bearbetningen på ett korrekt sätt

  2. Stänga av backend

  3. Avsluta med kod 130

Delvis bearbetade bilder kan finnas kvar i utdatamappen.


F: Kan jag automatisera CLI-bearbetningen?Svar: Absolut! CLI är utformat för automatisering. Se Automatisering och skriptning för exempel på PowerShell (Windows), Batch (Windows), Bash (Linux) och Python (plattformsoberoende) exempel.***

F: Hur kontrollerar jag versionen av CLI?S:

Utdata:


Få hjälp

Hjälp via kommandoraden

Visa hjälpinformation direkt i CLI:

Supportkanaler

Kompletta exempel

Exempel 1: Grundläggande bearbetning

Bearbetning med standardinställningar (vignett, reflektans):

Windows:

Linux:


Exempel 2: Vetenskaplig utdata av hög kvalitet

32-bitars flyttal TIFF:

Windows:

Linux:


Exempel 3: Snabb förhandsgranskning

8-bitars PNG utan kalibrering för snabb granskning:

Windows:

Linux:


Exempel 4: PPK-korrigerad bearbetning

Tillämpa PPK-korrigeringar med reflektans:

Windows:

Linux:


Exempel 5: Anpassad utmatningsplats

Bearbeta till en annan plats med specifikt format:

Windows:

Linux:


Exempel 6: Autentiseringsflöde

Komplett autentiseringsflöde (samma på alla plattformar):


Exempel 7: Användning av flera språk

Ändra gränssnittsspråk (samma på alla plattformar):

Last updated