CLI : Kommandolinje

**Chloros CLI** giver kraftfuld kommandolinjeadgang til Chloros-billedbehandlingsmotoren, hvilket muliggør automatisering, scripting og headless-drift til dine billedbehandlingsworkflows.

Nøglefunktioner

  • 🚀 Automatisering - Script-batchbehandling af flere datasæt

  • 🔗 Integration - Integrer i eksisterende arbejdsgange og pipelines

  • 💻 Headless-drift - Kør uden GUI

  • 🌍 Flersproget - Understøttelse af 38 sprog

  • Parallel behandling - Dynamisk beregnings tilpasning optimerer automatisk til din hardware

Krav

Krav
Detaljer

Operativsystem

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

Hukommelse

Minimum 8 GB RAM (16 GB anbefales)

Internet

Kræves til aktivering af licens

Diskplads

Varierer afhængigt af projektstørrelse

circle-exclamation

Hurtig start

Installation

Windows

CLI er automatisk inkluderet i Chloros-installationsprogrammet:

  1. Download og kør Chloros Installer.exe

  2. Gennemfør installationsguiden

  3. CLI installeret til: C:\Program Files\Chloros\resources\cli\chloros-cli.exe

circle-check

Linux

Installer .deb-pakken til din arkitektur:

For detaljeret opsætning af Linux, se Linux Installation.

Første opsætning

Før du bruger CLI, skal du aktivere din Chloros+-licens:

Windows:

Linux:

Grundlæggende brug

Behandl en mappe med standardindstillinger:

Windows:

Linux:


Kommandoreference

Generel syntaks


Kommandoer

process - Behandle billeder

Behandler billeder i en mappe med kalibrering.

Syntaks:

Eksempler:

Indstillinger for kommandoen Process

Indstilling
Type
Standard
Beskrivelse

<input-folder>

Sti

Påkrævet

Mappe indeholdende RAW/JPG-multispektrale billeder

-o, --output

Sti

Samme som input

Outputmappe til behandlede billeder

-n, --project-name

Streng

Autogenereret

Brugerdefineret projektnavn

--vignette

Flag

Aktiveret

Aktiver vignettkorrektion

--no-vignette

Flag

-

Deaktiver vignettkorrektion

--reflectance

Flag

Aktiveret

Aktiver reflektanskalibrering

--no-reflectance

Flag

-

Deaktiver reflektanskalibrering

--ppk

Flag

Deaktiveret

Anvend PPK-korrektioner fra .daq-lyssensordata

--format

Valg

TIFF (16-bit)

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

--min-target-size

Heltal

Auto

Mindste målstørrelse i pixels til detektering af kalibreringspanel

--target-clustering

Heltal

Auto

Tærskel for målgruppering (0-100)

--debayer

Valg

standard

Debayer-metode: standard eller texture-aware (kun Chloros+)

--target, --targets

Flag

Deaktiveret

Søg kun efter kalibreringsmål i en undermappe med navnet "target" eller "targets" (fremskynder behandlingen)

--indices

Liste

Ingen

Vegetationsindekser, der skal beregnes (f.eks. --indices NDVI NDRE GNDVI)

--exposure-pin-1

Streng

Ingen

Lås eksponering for kameramodel (Pin 1)

--exposure-pin-2

Streng

Ingen

Lås eksponering for kameramodel (Pin 2)

--recal-interval

Heltal

Auto

Rekalibreringsinterval i sekunder

--timezone-offset

Heltal

0

Tidszoneforskel i timer


login - Godkend konto

Log ind med dine Chloros+-loginoplysninger for at aktivere CLI-behandling.

Syntaks:

Eksempel:

circle-exclamation

Output:

***

logout - Slet legitimationsoplysninger

Slet gemte legitimationsoplysninger og log ud af din konto.

Syntaks:

Eksempel:

Output:

circle-info

SDK-brugere: Python SDK tilbyder også en programmatisk logout()-metode til at slette legitimationsoplysninger i Python-scripts. Se Python SDK dokumentationen for detaljer.


status - Kontroller licensstatus

Vis aktuel licens- og godkendelsesstatus.

Syntaks:

Eksempel:

Output:


export-status - Kontroller eksportforløb

Overvåg eksportforløbet for tråd 4 under eller efter behandlingen.

Syntaks:

Eksempel:

Anvendelsestilfælde: Kald denne kommando, mens behandlingen kører, for at kontrollere eksportforløbet.***

language - Administrer grænsefladesprog

Vis eller ændr grænsefladesproget for CLI.

Syntaks:

Eksempler:

Understøttede sprog (38 i alt)

Kode
Sprog
Navn på originalsproget

en

Engelsk

English

es

Spansk

Español

pt

Portugisisk

Português

fr

Fransk

Français

de

Tysk

Deutsch

it

Italiensk

Italiano

ja

Japansk

日本語

ko

Koreansk

한국어

zh

Kinesisk (forenklet)

简体中文

zh-TW

Kinesisk (traditionelt)

繁體中文

ru

Russisk

Русский

nl

Hollandsk

Nederlands

ar

Arabisk

العربية

pl

Polsk

Polski

tr

Tyrkisk

Türkçe

hi

Hindi

हिंदी

id

Indonesisk

Bahasa Indonesia

vi

Vietnamesisk

Tiếng Việt

th

Thai

ไทย

sv

Svensk

Svenska

da

Dansk

Dansk

no

Norsk

Norsk

fi

Finsk

Suomi

el

Græsk

Ελληνικά

cs

Tjekkisk

Čeština

hu

Ungarsk

Magyar

ro

Rumænsk

Română

uk

Ukrainsk

Українська

pt-BR

Brasiliansk portugisisk

Português Brasileiro

zh-HK

Kantonesisk

粵語

ms

Malaysisk

Bahasa Melayu

sk

Slovakisk

Slovenčina

bg

Bulgarsk

Български

hr

Kroatisk

Hrvatski

lt

Litauisk

Lietuvių

lv

Lettisk

Latviešu

et

Estisk

Eesti

sl

Slovensk

Slovenščina

circle-check

set-project-folder - Indstil standardprojektmappe

Ændr placeringen af standardprojektmappen (deles med GUI på Windows).

Syntaks:

Eksempler:


get-project-folder - Vis projektmappe

Vis den aktuelle placering af standardprojektmappen.

Syntaks:

Eksempel:

Output:


reset-project-folder - Nulstil til standard

Nulstil projektmappen til standardplaceringen.

Syntaks:


selftest - Kør systemdiagnostik

Kør 7 diagnostiske kontroller for at verificere din systemkonfiguration.

Syntaks:

Udførte diagnostiske tests:

  1. Versionskontrol

  2. Porttilgængelighed (5000)

  3. Opstart af backend

  4. API-forbindelsestest

  5. Systemoplysninger og GPU-detektion

  6. Verifikation af støjfjernelsesmodeller

  7. Kontrol af CUDA-tilgængelighed

circle-info

Nyttigt til fejlfinding: Kør selftest efter installationen for at kontrollere, at dit system er konfigureret korrekt, især på Linux/Jetson, hvor GPU- og CUDA-opsætningen muligvis skal verificeres.


update - Søg efter opdateringer (kun Linux)

Søg efter og installer CLI-opdateringer på Linux-systemer.

Syntaks:

Indstilling
Beskrivelse

--check

Søg kun efter opdateringer, installer ikke

circle-info

Denne kommando er kun tilgængelig på Linux. På Windows leveres opdateringer via installationsprogrammet.


Globale indstillinger

Disse indstillinger gælder for alle kommandoer:

Indstilling
Type
Standard
Beskrivelse

--backend-exe

Sti

Registreres automatisk

Sti til backend-eksekverbar fil

--port

Heltal

5000

Backend API portnummer

--restart

Flag

-

Tving genstart af backend (afslutter eksisterende processer)

--version

Flag

-

Vis versionsoplysninger og afslut

--help

Flag

-

Vis hjælpeoplysninger og afslut

circle-info

Automatisk registrering af backend: Stien --backend-exe registreres automatisk pr. platform:

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

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

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

Eksempel med globale indstillinger:

Windows:

Linux:


Vejledning til behandlingsindstillinger

Parallel behandling og dynamisk beregnings tilpasning

Chloros 1.1.0 inkluderer Dynamisk beregnings tilpasning — behandlingsmotoren registrerer automatisk din hardware og vælger den optimale strategi:

Platform
Strategi
Arbejdere
Pipeline
Bemærkninger

Jetson Nano 8 GB

GPU_SINGLE

1

tiled_gpu

Hukommelseseffektiv, serialiseret

Jetson Orin NX 16 GB

GPU_PARALLEL

3

fused_gpu

Samtidig GPU-behandling

Desktop med 8 GB GPU

GPU_SINGLE

3

tiled_gpu

God desktop-ydeevne

Desktop med 12 GB+ GPU

GPU_PARALLEL

3-4

fused_gpu

Optimal desktop-ydeevne

System kun med CPU

CPU_PARALLEL

kerner - 1

cpu_fallback

Ingen GPU påkrævet

circle-check

Debayer-metoder

Metode
CLI-flag
Kvalitet
Hastighed
Licens

Standard (Hurtig, Medium kvalitet)

--debayer standard

God

Hurtig

Gratis / Chloros+

Teksturbevidst (langsom, højeste kvalitet)

--debayer texture-aware

Højeste

Langsom

Kun Chloros+

Standardmetoden til debayering er Standard. MetodenTeksturbevidst bruger en AI/ML-støjfjernelsesmodel for at opnå den højeste kvalitet, men kræver en Chloros+-licens og en NVIDIA GPU.

Vignettekorrektion

Hvad det gør: Korrigerer lysfald ved billedkanterne (mørkere hjørner, som er almindelige i kamerabilleder).

  • Aktiveret som standard – De fleste brugere bør holde denne funktion aktiveret

  • Brug --no-vignette for at deaktivere

circle-check

Reflektanskalibrering

Konverterer rå sensorværdier til standardiserede reflektansprocenter ved hjælp af kalibreringspaneler.

  • Aktiveret som standard – Afgørende for vegetationsanalyse

  • Kræver kalibreringsmålpaneler i billederne

  • Brug --no-reflectance til at deaktivere

circle-info

Krav: Sørg for, at kalibreringspanelerne er korrekt eksponeret og synlige i dine billeder for nøjagtig reflektanskonvertering.

PPK-korrektioner

Hvad det gør: Anvender post-processerede kinematiske korrektioner ved hjælp af DAQ-A-SD-logdata for forbedret GPS-nøjagtighed.

  • Deaktiveret som standard

  • Brug --ppk for at aktivere

  • Kræver .daq-filer i projektmappen fra MAPIR DAQ-A-SD-lyssensor.

Outputformater

Format
Bitdybde
Filstørrelse
Bedst egnet til

TIFF (16-bit)

16-bit heltal

Stor

GIS-analyse, fotogrammetri (anbefales)

TIFF (32-bit, procent)

32-bit flydende

Meget stor

Videnskabelig analyse, forskning

PNG (8-bit)

8-bit heltal

Mellem

Visuel inspektion, deling på nettet

JPG (8-bit)

8-bit heltal

Lille

Hurtig forhåndsvisning, komprimeret output

***

Automatisering og scripting

PowerShell-batchbehandling (Windows)

Behandl flere datasætmapper automatisk på Windows:

Windows Batch-script (Windows)

Enkel loop til batchbehandling på Windows:

Bash-batchbehandling (Linux)

Behandl flere datasætmapper på Linux:

Python-automatiseringsscript (platformuafhængigt)

Avanceret automatisering med fejlhåndtering (fungerer på Windows og Linux):


Behandlingsworkflow

Standardworkflow

  1. Indgang: Mappe indeholdende RAW/JPG-billedpar

  2. Opdagelse: CLI scanner automatisk efter understøttede billedfiler

  3. Behandling: Parallel tilstand skaleres til dine CPU-kerner (Chloros+)

  4. Output: Opretter undermapper for kameramodeller med behandlede billeder

Eksempel på outputstruktur

Estimater for behandlingstid

Typiske behandlingstider for 100 billeder (12 MP hver):

Platform
Tilstand
Estimeret tid
Bemærkninger

Desktop 12 GB+ GPU

GPU_PARALLEL

5-10 min

Hurtigste mulighed

Desktop 8 GB GPU

GPU_SINGLE

10-15 min

God ydeevne

Jetson Orin NX 16 GB

GPU_PARALLEL

15-25 min

Edge-computing

Jetson Nano 8 GB

GPU_SINGLE

30-60 min

Begrænset hukommelse

Kun CPU

CPU_PARALLEL

20-40 min

Ingen GPU påkrævet

circle-info

Tip til ydeevne: Behandlingstiden varierer afhængigt af antal billeder, opløsning, debayer-metode og hardware. Texture Aware-debayer tager betydeligt længere tid end Standard. Se Dynamisk beregnings tilpasning for detaljer.


Fejlfinding

CLI ikke fundet

Windows-fejl:

Windows Løsninger:

  1. Kontroller installationsplaceringen:

  1. Brug den fulde sti, hvis den ikke er i PATH:

  1. Tilføj manuelt til PATH:

    • Åbn Systemegenskaber → Miljøvariabler

    • Rediger PATH-variablen

    • Tilføj: C:\Program Files\Chloros\resources\cli

    • Genstart terminalen

Linux Fejl:

Linux Løsninger:

  1. Kontroller installationen:

  1. Genindlæs din shell:

  1. Kontroller tilladelser:


Backend kunne ikke startesFejl:

Løsninger:

  1. Kontroller, om backend allerede kører (luk den først)

  2. Kontroller, at firewallen ikke blokerer (Windows), eller kontroller porttilgængeligheden (Linux: lsof -i :5000)

  3. Prøv en anden port:

  1. Tving backend til at genstarte:

  1. På Linux skal du kontrollere, om backend-eksekverbarfilen findes:


Problemer med licens/godkendelseFejl:

Løsninger:

  1. Kontroller, at du har et aktivt Chloros+-abonnement

  2. Log ind med dine loginoplysninger:

  1. Kontroller licensstatus:

  1. Kontakt support: info@mapir.camera


Ingen billeder fundetFejl:

Løsninger:

  1. Kontroller, at mappen indeholder understøttede formater (.RAW, .TIF, .JPG)

  2. Kontroller, at mappestien er korrekt (brug anførselstegn for stier med mellemrum)

  3. Sørg for, at du har læseadgang til mappen

  4. Kontroller, at filtypenavnene er korrekte


Behandlingen går i stå eller hængerLøsninger:

  1. Kontroller ledig diskplads (sørg for, at der er nok til output)

  2. Luk andre programmer for at frigøre hukommelse

  3. Reducer antallet af billeder (behandl i batches)


Porten er allerede i brugFejl:

Løsninger:

Windows:

Linux:


Ofte stillede spørgsmål

Spørgsmål: Har jeg brug for en licens til CLI?

Svar:Ja! CLI kræver en betaltChloros+-licens.

  • ❌ Standard (gratis) abonnement: CLI deaktiveret

  • ✅ Chloros+ (betalt) abonnementer: CLI fuldt aktiveret

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


Spørgsmål: Kan jeg bruge CLI på en server uden GUI?Svar: Ja! CLI kører fuldstændigt headless. Dette er den primære anvendelse på Linux.Windows-server:

  • Windows Server 2016 eller nyere

  • Visual C++ Redistributable installeret

Linux Server:

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

  • Installation via .deb-pakken

Begge platforme:

  • Minimum 8 GB RAM (16 GB anbefales)

  • Engangsaktivering af licens: chloros-cli login user@example.com 'password'


Spørgsmål: Hvor gemmes de behandlede billeder?Svar:Som standard gemmes de behandlede billeder isamme mappe som input i undermapper for kameramodeller (f.eks. Survey3N_RGN/).

Brug -o-indstillingen til at angive en anden outputmappe:


Spørgsmål: Kan jeg behandle flere mapper på én gang?A: Ikke direkte med én kommando, men du kan bruge scripting til at behandle mapper sekventielt. Se afsnittet Automatisering og scripting.***

Spørgsmål: Hvordan gemmer jeg CLI-output i en logfil?PowerShell:

Batch:

Linux Bash:


Spørgsmål: Hvad sker der, hvis jeg trykker på Ctrl+C under behandlingen?Svar: CLI vil:

  1. Afslutte behandlingen på en ordentlig måde

  2. Lukke backend-systemet ned

  3. Afslutte med kode 130

Delvist behandlede billeder kan forblive i output-mappen.


Spørgsmål: Kan jeg automatisere CLI-behandlingen?Svar: Absolut! CLI er designet til automatisering. Se Automatisering og scripting for PowerShell (Windows), Batch (Windows), Bash (Linux) og Python (platformuafhængige) eksempler.***

Spørgsmål: Hvordan tjekker jeg CLI-versionen?Svar:

Output:


Få hjælp

Hjælp til kommandolinjen

Se hjælpeoplysninger direkte i CLI:

Supportkanaler

Komplette eksempler

Eksempel 1: Grundlæggende behandling

Behandling med standardindstillinger (vignette, reflektans):

Windows:

Linux:


Eksempel 2: Videnskabeligt output i høj kvalitet

32-bit float TIFF:

Windows:

Linux:


Eksempel 3: Hurtig forhåndsvisning

8-bit PNG uden kalibrering til hurtig gennemgang:

Windows:

Linux:


Eksempel 4: PPK-korrigeret behandling

Anvend PPK-korrektioner med reflektans:

Windows:

Linux:


Eksempel 5: Brugerdefineret outputplacering

Behandl til en anden placering med specifikt format:

Windows:

Linux:


Eksempel 6: Godkendelsesworkflow

Komplet godkendelsesflow (det samme på alle platforme):


Eksempel 7: Brug af flere sprog

Skift sprog i brugergrænsefladen (det samme på alle platforme):

Last updated