CLI : Kommandolinje

**Chloros CLI** gir kraftig kommandolinjetilgang til bildebehandlingsmotoren Chloros, noe som muliggjør automatisering, skripting og headless drift for bildebehandlingsarbeidsflytene dine.

Viktige funksjoner

  • 🚀 Automatisering – Skriptbasert batchbehandling av flere datasett

  • 🔗 Integrasjon – Integrer i eksisterende arbeidsflyter og rørledninger

  • 💻 Headless-drift – Kjør uten GUI

  • 🌍 Flerspråklig – Støtte for 38 språk

  • ParallellbehandlingDynamisk beregnings tilpasning optimaliserer automatisk for maskinvaren din

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 anbefales)

Internett

Kreves for lisensaktivering

Diskplass

Varierer etter prosjektstørrelse

circle-exclamation

Hurtigstart

Installasjon

Windows

CLI er automatisk inkludert i Chloros-installasjonsprogrammet:

  1. Last ned og kjør Chloros Installer.exe

  2. Fullfør installasjonsveiviseren

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

circle-check

Linux

Installer .deb-pakken for din arkitektur:

For detaljert informasjon om oppsett av Linux, se Linux Installasjon.

Første gangs oppsett

Før du bruker CLI, må du aktivere Chloros+-lisensen din:

Windows:

Linux:

Grunnleggende bruk

Behandle en mappe med standardinnstillinger:

Windows:

Linux:


Kommandoreferanse

Generell syntaks


Kommandoer

process - Behandle bilder

Behandle bilder i en mappe med kalibrering.

Syntaks:

Eksempler:

Kommandoalternativer

Alternativ
Type
Standard
Beskrivelse

<input-folder>

Bane

Påkrevd

Mappe som inneholder RAW/JPG-multispektrale bilder

-o, --output

Bane

Samme som inndata

Utdatamappe for behandlede bilder

-n, --project-name

Streng

Autogenerert

Egendefinert prosjektnavn

--vignette

Flagg

Aktivert

Aktiver vignettkorrigering

--no-vignette

Flagg

-

Deaktiver vignettkorrigering

--reflectance

Flagg

Aktivert

Aktiver refleksjonskalibrering

--no-reflectance

Flagg

-

Deaktiver refleksjonskalibrering

--ppk

Flagg

Deaktivert

Bruk PPK-korreksjoner fra .daq-lyssensordata

--format

Valg

TIFF (16-bit)

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

--min-target-size

Heltall

Auto

Minste målstørrelse i piksler for deteksjon av kalibreringspanel

--target-clustering

Heltall

Auto

Terskel for målgruppering (0–100)

--debayer

Valg

standard

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

--target, --targets

Flagg

Deaktivert

Søk kun etter kalibreringsmål i en «target»- eller «targets»-undermappe (fremskynder behandlingen)

--indices

Liste

Ingen

Vegetasjonsindekser som skal beregnes (f.eks. --indices NDVI NDRE GNDVI)

--exposure-pin-1

Streng

Ingen

Lås eksponering for kameramodell (Pin 1)

--exposure-pin-2

Streng

Ingen

Lås eksponering for kameramodell (Pin 2)

--recal-interval

Heltall

Auto

Rekalibreringsintervall i sekunder

--timezone-offset

Heltall

0

Tidssoneforskjell i timer


login - Autentiser konto

Logg inn med dine Chloros+-påloggingsopplysninger for å aktivere CLI-behandling.

Syntaks:

Eksempel:

circle-exclamation

Utdata:

***

logout - Slett påloggingsinformasjon

Slett lagret påloggingsinformasjon og logg ut av kontoen din.

Syntaks:

Eksempel:

Utdata:

circle-info

SDK-brukere: Python SDK tilbyr også en programmatisk logout()-metode for å slette påloggingsinformasjon i Python-skript. Se Python SDK dokumentasjonen for detaljer.


status - Sjekk lisensstatus

Vis gjeldende lisens- og autentiseringsstatus.

Syntaks:

Eksempel:

Utdata:


export-status – Sjekk eksportfremdrift

Overvåk eksportfremdriften for tråd 4 under eller etter behandlingen.

Syntaks:

Eksempel:

Bruksområde: Kall denne kommandoen mens behandlingen pågår for å sjekke eksportfremdriften.***

language – Administrer grensesnittspråk

Vis eller endre grensesnittspråket for CLI.

Syntaks:

Eksempler:

Støttede språk (38 totalt)

Kode
Språk
Navn på originalspråket

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 (tradisjonell)

繁體中文

ru

Russisk

Русский

nl

Nederlandsk

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

Gresk

Ελληνικά

cs

Tsjekkisk

Čeština

hu

Ungarsk

Magyar

ro

Rumensk

Română

uk

Ukrainsk

Українська

pt-BR

Brasiliansk portugisisk

Português Brasileiro

zh-HK

Kantonesisk

粵語

ms

Malay

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 - Angi standard prosjektmappe

Endre plasseringen til standard prosjektmappen (delt med GUI på Windows).

Syntaks:

Eksempler:


get-project-folder - Vis prosjektmappe

Vis gjeldende standardprosjektmappe.

Syntaks:

Eksempel:

Utdata:


reset-project-folder - Tilbakestill til standard

Tilbakestill prosjektmappen til standardplasseringen.

Syntaks:


selftest - Kjør systemdiagnostikk

Kjør 7 diagnostiske kontroller for å verifisere systemkonfigurasjonen.

Syntaks:

Utførte diagnostiske tester:

  1. Versjonssjekk

  2. Porttilgjengelighet (5000)

  3. Oppstart av backend

  4. API tilkoblingstest

  5. Systeminformasjon og GPU-deteksjon

  6. Verifisering av støyreduksjonsmodeller

  7. Sjekk av CUDA-tilgjengelighet

circle-info

Nyttig for feilsøking: Kjør selftest etter installasjon for å verifisere at systemet er konfigurert riktig, spesielt på Linux/Jetson hvor GPU- og CUDA-oppsettet kan trenge verifisering.


update – Sjekk etter oppdateringer (kun Linux)

Sjekk etter og installer CLI-oppdateringer på Linux-systemer.

Syntaks:

Alternativ
Beskrivelse

--check

Bare søk etter oppdateringer, ikke installer

circle-info

Denne kommandoen er kun tilgjengelig på Linux. På Windows leveres oppdateringer via installasjonsprogrammet.


Globale alternativer

Disse alternativene gjelder for alle kommandoer:

Alternativ
Type
Standard
Beskrivelse

--backend-exe

Sti

Oppdages automatisk

Sti til kjørbar backend-fil

--port

Heltall

5000

Portnummer for backend API

--restart

Flagg

-

Tving omstart av backend (avslutter eksisterende prosesser)

--version

Flagg

-

Vis versjonsinformasjon og avslutt

--help

Flagg

-

Vis hjelpeinformasjon og avslutt

circle-info

Automatisk gjenkjenning av backend: Banen --backend-exe gjenkjennes automatisk 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

Eksempel med globale alternativer:

Windows:

Linux:


Veiledning for behandlingsinnstillinger

Parallellbehandling og dynamisk beregnings tilpasning

Chloros 1.1.0 inkluderer Dynamisk beregnings tilpasning — behandlingsmotoren oppdager automatisk maskinvaren din og velger den optimale strategien:

Plattform
Strategi
Arbeidere
Rørledning
Merknader

Jetson Nano 8 GB

GPU_SINGLE

1

tiled_gpu

Minneeffektiv, serialisert

Jetson Orin NX 16 GB

GPU_PARALLEL

3

fused_gpu

Samtidig GPU-behandling

Stasjonær PC med 8 GB GPU

GPU_SINGLE

3

tiled_gpu

God stasjonær ytelse

Stasjonær PC med 12 GB+ GPU

GPU_PARALLEL

3–4

fused_gpu

Optimal stasjonær ytelse

System kun med CPU

CPU_PARALLEL

kjerner - 1

cpu_fallback

Ingen GPU nødvendig

circle-check

Debayer-metoder

Metode
CLI-flagg
Kvalitet
Hastighet
Lisens

Standard (rask, middels kvalitet)

--debayer standard

God

Rask

Gratis / Chloros+

Teksturbevisst (Langsom, høyeste kvalitet)

--debayer texture-aware

Høyeste

Langsom

Kun Chloros+

Standardmetoden for debayering er Standard. MetodenTeksturbevisst bruker en AI/ML-støyreduksjonsmodell for å oppnå utdata av høyeste kvalitet, men krever en Chloros+-lisens og en NVIDIA-GPU.

Vignettkorrigering

Hva det gjør: Korrigerer lysfall ved bildekantene (mørkere hjørner som ofte forekommer i kamerabilder).

  • Aktivert som standard – De fleste brukere bør holde dette aktivert

  • Bruk --no-vignette for å deaktivere

circle-check

Refleksjonskalibrering

Konverterer rå sensorverdier til standardiserte refleksjonsprosentandeler ved hjelp av kalibreringspaneler.

  • Aktivert som standard – Avgjørende for vegetasjonsanalyse

  • Krever kalibreringsmålpaneler i bildene

  • Bruk --no-reflectance for å deaktivere

circle-info

Krav: Sørg for at kalibreringspanelene er riktig eksponert og synlige i bildene dine for nøyaktig reflektanskonvertering.

PPK-korreksjoner

Hva det gjør: Bruker etterbehandlede kinematiske korreksjoner ved hjelp av DAQ-A-SD-loggdata for forbedret GPS-nøyaktighet.

  • Deaktivert som standard

  • Bruk --ppk for å aktivere

  • Krever .daq-filer i prosjektmappen fra MAPIR DAQ-A-SD-lyssensor.

Utdataformater

Format
Bittdybde
Filstørrelse
Best egnet for

TIFF (16-bit)

16-biters heltall

Stor

GIS-analyse, fotogrammetri (anbefalt)

TIFF (32-bit, prosent)

32-biters flytende

Svært stor

Vitenskapelig analyse, forskning

PNG (8-bit)

8-biters heltall

Middels

Visuell inspeksjon, deling på nettet

JPG (8-bit)

8-biters heltall

Liten

Hurtig forhåndsvisning, komprimert utdata

***

Automatisering og skripting

PowerShell-batchbehandling (Windows)

Behandle flere datasettmapper automatisk på Windows:

Windows Batch-skript (Windows)

Enkel sløyfe for batchbehandling på Windows:

Bash-batchbehandling (Linux)

Behandle flere datasettmapper på Linux:

Python automatiseringsskript (plattformuavhengig)

Avansert automatisering med feilhåndtering (fungerer på Windows og Linux):


Behandlingsarbeidsflyt

Standard arbeidsflyt

  1. Inndata: Mappe som inneholder RAW/JPG-bildepar

  2. Oppdagelse: CLI skanner automatisk etter støttede bildefiler

  3. Behandling: Parallellmodus skaleres etter antall CPU-kjerner (Chloros+)

  4. Utdata: Oppretter undermapper for kameramodeller med behandlede bilder

Eksempel på utdatastruktur

Estimert behandlingstid

Typisk behandlingstid for 100 bilder (12 MP hver):

Plattform
Modus
Estimert tid
Merknader

Stasjonær PC med 12 GB+ GPU

GPU_PARALLEL

5–10 min

Raskeste alternativ

Stasjonær PC med 8 GB GPU

GPU_SINGLE

10–15 min

God ytelse

Jetson Orin 16 GB

GPU_PARALLEL

15–25 min

Edge-beregning

Jetson Nano 8 GB

GPU_SINGLE

30–60 min

Begrenset minne

Kun CPU

CPU_PARALLEL

20–40 min

Ingen GPU nødvendig

circle-info

Ytelsestips: Behandlingstiden varierer avhengig av antall bilder, oppløsning, debayer-metode og maskinvare. Texture Aware-debayer tar betydelig lengre tid enn Standard. Se Dynamic Compute Adaptation for detaljer.


Feilsøking

CLI ikke funnet

Windows-feil:

Windows Løsninger:

  1. Kontroller installasjonsstedet:

  1. Bruk full sti hvis ikke i PATH:

  1. Legg til i PATH manuelt:

    • Åpne Systemegenskaper → Miljøvariabler

    • Rediger PATH-variabelen

    • Legg til: C:\Program Files\Chloros\resources\cli

    • Start terminalen på nytt

Linux Feil:

Linux Løsninger:

  1. Kontroller installasjonen:

  1. Last inn skallet på nytt:

  1. Kontroller tillatelser:


Backend kunne ikke startesFeil:

Løsninger:

  1. Sjekk om backend allerede kjører (lukk den først)

  2. Sjekk at brannmuren ikke blokkerer (Windows) eller sjekk porttilgjengelighet (Linux: lsof -i :5000)

  3. Prøv en annen port:

  1. Tving omstart av backend:

  1. På Linux, sjekk om backend-kjørbar fil finnes:


Lisens-/autentiseringsproblemerFeil:

Løsninger:

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

  2. Logg inn med påloggingsinformasjonen din:

  1. Sjekk lisensstatus:

  1. Kontakt support: info@mapir.camera


Ingen bilder funnetFeil:

Løsninger:

  1. Kontroller at mappen inneholder støttede formater (.RAW, .TIF, .JPG)

  2. Kontroller at mappestien er riktig (bruk anførselstegn for stier med mellomrom)

  3. Sørg for at du har lesetillatelse for mappen

  4. Kontroller at filtypene er riktige


Behandlingen stopper opp eller henger seg oppLøsninger:

  1. Sjekk tilgjengelig diskplass (sørg for at det er nok til utdata)

  2. Lukk andre programmer for å frigjøre minne

  3. Reduser antall bilder (behandle i batcher)


Porten er allerede i brukFeil:

Løsninger:

Windows:

Linux:


FAQ

Spørsmål: Trenger jeg en lisens for CLI?

Svar:Ja! CLI krever en betaltChloros+-lisens.

  • ❌ Standard (gratis) abonnement: CLI deaktivert

  • ✅ Chloros+ (betalt) abonnement: CLI fullt aktivert

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


Spørsmål: Kan jeg bruke CLI på en server uten GUI?Svar: Ja! CLI kjører helt uten grafisk grensesnitt. Dette er den primære brukssituasjonen på Linux.Windows-server:

  • Windows Server 2016 eller nyere

  • Visual C++ Redistributable installert

Linux-server:

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

  • Installer via .deb-pakken

Begge plattformene:

  • Minst 8 GB RAM (16 GB anbefalt)

  • Engangsaktivering av lisens: chloros-cli login user@example.com 'password'


Spørsmål: Hvor lagres de behandlede bildene?Svar:Som standard lagres behandlede bilder isamme mappe som inndata i undermapper for kameramodeller (f.eks. Survey3N_RGN/).

Bruk alternativet -o for å angi en annen utdatamappe:


Spørsmål: Kan jeg behandle flere mapper samtidig?A: Ikke direkte med én kommando, men du kan bruke skripting for å behandle mapper sekvensielt. Se avsnittet Automatisering og skripting.***

Spørsmål: Hvordan lagrer jeg CLI-utdata i en loggfil?PowerShell:

Batch:

Linux Bash:


Spørsmål: Hva skjer hvis jeg trykker Ctrl+C under behandlingen?Svar: CLI vil:

  1. Avslutte behandlingen på en ordnet måte

  2. Slå av backend-systemet

  3. Avslutte med kode 130

Delvis behandlede bilder kan forbli i utdatamappen.


Spørsmål: Kan jeg automatisere CLI-behandlingen?Svar: Absolutt! CLI er designet for automatisering. Se Automatisering og skripting for eksempler på PowerShell (Windows), Batch (Windows), Bash (Linux) og Python (plattformuavhengig).***

Spørsmål: Hvordan sjekker jeg CLI-versjonen?Svar:

Utdata:


Hjelp

Hjelp på kommandolinjen

Vis hjelpeinformasjon direkte i CLI:

Supportkanaler

Fullstendige eksempler

Eksempel 1: Grunnleggende behandling

Behandling med standardinnstillinger (vignett, reflektans):

Windows:

Linux:


Eksempel 2: Vitenskapelig utdata av høy kvalitet

32-biters flytende TIFF:

Windows:

Linux:


Eksempel 3: Rask forhåndsvisning

8-bit PNG uten kalibrering for rask gjennomgang:

Windows:

Linux:


Eksempel 4: PPK-korrigert behandling

Bruk PPK-korreksjoner med reflektans:

Windows:

Linux:


Eksempel 5: Tilpasset utdataplassering

Behandle til en annen plassering med spesifikt format:

Windows:

Linux:


Eksempel 6: Autentiseringsflyt

Fullført autentiseringsflyt (samme på alle plattformer):


Eksempel 7: Bruk av flere språk

Endre grensesnittspråk (samme på alle plattformer):

Sist oppdatert