CLI : Ukazna vrstica

**Chloros CLI** omogoča zmogljiv dostop prek ukazne vrstice do motorja za obdelavo slik Chloros, kar omogoča avtomatizacijo, pisanje skriptov in brezglavo delovanje za vaše delovne tokove obdelave slik.

Ključne značilnosti

  • 🚀 Avtomatizacija – skriptno obdelovanje več podatkovnih nizov v serijah

  • 🔗 Integracija – vgradnja v obstoječe delovne tokove in poteke

  • 💻 Delovanje brez grafičnega vmesnika – zagon brez grafičnega vmesnika

  • 🌍 Večjezičnost – podpora za 38 jezikov

  • Vzporedna obdelavaDinamična prilagoditev računalniške moči se samodejno optimizira za vašo strojno opremo

Zahteve

Zahteva
Podrobnosti

Operacijski sistem

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

Pomnilnik

Najmanj 8 GB RAM (priporočeno 16 GB)

Internet

Potreben za aktivacijo licence

Prostor na disku

Odvisno od velikosti projekta

circle-exclamation

Hitri začetek

Namestitev

Windows

CLI je samodejno vključen v namestitveni program Chloros:

  1. Prenesite in zaženite Chloros Installer.exe

  2. Izpolnite namestitvenega čarovnika

  3. CLI je nameščen v: C:\Program Files\Chloros\resources\cli\chloros-cli.exe

circle-check

Linux

Namestite paket .deb za vašo arhitekturo:

Za podrobna navodila o nastavitvi Linux glejte Namestitev Linux.

Prva namestitev

Pred uporabo CLI aktivirajte svojo licenco Chloros+:

Windows:

Linux:

Osnovna uporaba

Obdelajte mapo s privzetimi nastavitvami:

Windows:

Linux:


Referenca ukazov

Splošna sintaksa


Ukazi

process - Obdelava slik

Obdelava slik v mapi s kalibracijo.

Sintaksa:

Primeri:

Možnosti ukaza za obdelavo

Možnost
Tip
Privzeto
Opis

<input-folder>

Pot

Obvezno

Mapa, ki vsebuje multispektralne slike RAW/JPG

-o, --output

Pot

Enako kot vhod

Izhodna mapa za obdelane slike

-n, --project-name

Niz

Samodejno ustvarjeno

Ime projekta po meri

--vignette

Oznaka

Omogočeno

Omogoči popravek vinjetiranja

--no-vignette

Oznaka

-

Onemogoči popravek vinjetiranja

--reflectance

Oznaka

Omogočeno

Omogoči kalibracijo odbojnosti

--no-reflectance

Oznaka

-

Onemogoči kalibracijo odbojnosti

--ppk

Oznaka

Onemogočeno

Uporabi PPK popravke iz podatkov svetlobnega senzorja .daq

--format

Izbira

TIFF (16-bit)

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

--min-target-size

Celo število

Samodejno

Najmanjša velikost cilja v pikslatih za zaznavanje kalibracijskega polja

--target-clustering

Celo število

Samodejno

Prag združevanja ciljev (0–100)

--debayer

Izbirno

standard

Metoda debayeringa: standard ali texture-aware (samo Chloros+)

--target, --targets

Oznaka

Onemogočeno

Iskanje kalibracijskih ciljev samo v podmapah »target« ali »targets« (pospeši obdelavo)

--indices

Seznam

Noben

Indeksi vegetacije za izračun (npr. --indices NDVI NDRE GNDVI)

--exposure-pin-1

Niz

Noben

Zakleni osvetlitev za model kamere (Pin 1)

--exposure-pin-2

Niz

Noben

Zaklepanje osvetlitve za model kamere (Pin 2)

--recal-interval

Cel številka

Samodejno

Interval ponovne kalibracije v sekundah

--timezone-offset

Cel številka

0

Časovni zamik v urah


login - Preverjanje pristnosti računa

Prijavite se s svojimi poverilnicami Chloros+, da omogočite obdelavo CLI.

Sintaksa:

Primer:

circle-exclamation

Izhod:

***

logout – Izbriši poverilnice

Izbriši shranjene poverilnice in se odjavi iz svojega računa.

Sintaksa:

Primer:

Izhod:

circle-info

SDK Uporabniki: Python SDK ponuja tudi programsko metodo logout() za izbris poverilnic znotraj skriptov Python. Za podrobnosti glejte dokumentacijo Python SDK.


status – Preverjanje stanja licence

Prikaže trenutno stanje licence in avtentifikacije.

Sintaksa:

Primer:

Izhod:


export-status – Preverjanje napredka izvoza

Spremljajte napredek izvoza niti 4 med ali po obdelavi.

Sintaksa:

Primer:

Primer uporabe: Ta ukaz pokličite med potekom obdelave, da preverite napredek izvoza.***

language – Upravljanje jezika vmesnika

Preglejte ali spremenite jezik vmesnika CLI.

Sintaksa:

Primeri:

Podprti jeziki (skupaj 38)

Koda
Jezik
Izvirno ime

en

angleščina

English

es

španščina

Español

pt

portugalščina

Português

fr

francoščina

Français

de

nemščina

Deutsch

it

italijanščina

Italiano

ja

japonščina

日本語

ko

korejščina

한국어

zh

Kitajščina (poenostavljena)

简体中文

zh-TW

Kitajščina (tradicionalna)

繁體中文

ru

Ruščina

Русский

nl

Nizozemščina

Nederlands

ar

Arabščina

العربية

pl

Poljščina

Polski

tr

Turščina

Türkçe

hi

Hindijščina

हिंदी

id

Indonezijščina

Bahasa Indonesia

vi

Vietnamščina

Tiếng Việt

th

Tajski

ไทย

sv

Švedski

Svenska

da

Danski

Dansk

no

Norveški

Norsk

fi

finščina

Suomi

el

grščina

Ελληνικά

cs

češčina

Čeština

hu

Madžarski

Magyar

ro

Romunski

Română

uk

Ukrajinski

Українська

pt-BR

Brazilski portugalščina

Português Brasileiro

zh-HK

Kantonski

粵語

ms

Malajski

Bahasa Melayu

sk

Slovaški

Slovenčina

bg

Bolgarski

Български

hr

Hrvaški

Hrvatski

lt

Litovski

Lietuvių

lv

Latvijščina

Latviešu

et

Estonščina

Eesti

sl

Slovene

Slovenščina

circle-check

set-project-folder - Nastavitev privzete mape projekta

Spremenite lokacijo privzete mape projekta (skupno z GUI na Windows).

Sintaksa:

Primeri:


get-project-folder - Prikaži mapo projekta

Prikaži trenutno lokacijo privzete mape projekta.

Sintaksa:

Primer:

Izhod:


reset-project-folder – Ponastavi na privzeto

Ponastavi mapo projekta na privzeto lokacijo.

Sintaksa:


selftest – Izvedba sistemskih diagnostičnih pregledov

Izvedite 7 diagnostičnih pregledov za preverjanje konfiguracije sistema.

Sintaksa:

Izvedene diagnostične preveritve:

  1. Preverjanje različice

  2. Razpoložljivost vrat (5000)

  3. Zagon ozadja

  4. Preizkus povezljivosti API

  5. Informacije o sistemu in zaznavanje grafičnega procesorja

  6. Preverjanje modelov za odstranjevanje šuma

  7. Preverjanje razpoložljivosti CUDA

circle-info

Koristno za odpravljanje težav: Po namestitvi zaženite selftest, da preverite, ali je vaš sistem pravilno konfiguriran, zlasti na Linux/Jetson, kjer je morda potrebno preveriti nastavitve grafičnega procesorja in CUDA.


update – Preverjanje posodobitev (samo Linux)

Preverite in namestite posodobitve CLI na sistemih Linux.

Sintaksa:

Možnost
Opis

--check

Samo preveri posodobitve, ne namesti

circle-info

Ta ukaz je na voljo samo v Linux. V Windows se posodobitve dostavijo prek namestitvenega programa.


Splošne možnosti

Te možnosti veljajo za vse ukaze:

Možnost
Vrsta
Privzeto
Opis

--backend-exe

Pot

Samodejno zaznano

Pot do izvedljive datoteke strežnika

--port

Celo število

5000

Številka vrat strežnika API

--restart

Oznaka

-

Prisilni ponovni zagon strežnika (ukine obstoječe procese)

--version

Zastavica

-

Prikaži informacije o različici in zapri

--help

Zastavica

-

Prikaži informacije o pomoči in zapri

circle-info

Samodejno zaznavanje ozadja: Pot --backend-exe se samodejno zazna glede na platformo:

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

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

  • Linux (ročno): /opt/mapir/chloros/backend/chloros-backend

Primer z globalnimi možnostmi:

Windows:

Linux:


Priročnik za nastavitve obdelave

Vzporedna obdelava in dinamična prilagoditev računalniške moči

Chloros 1.1.0 vključuje dinamično prilagoditev računalniške moči — procesni motor samodejno zazna vašo strojno opremo in izbere optimalno strategijo:

Platforma
Strategija
Delavci
Potek
Opombe

Jetson Nano 8 GB

GPU_SINGLE

1

tiled_gpu

Učinkovita raba pomnilnika, serializirana

Jetson Orin NX 16 GB

GPU_PARALLEL

3

fused_gpu

Sočasna obdelava GPU

Namizni računalnik z 8 GB GPU

GPU_SINGLE

3

tiled_gpu

Dobra zmogljivost namiznega računalnika

Namizni računalnik z grafično kartico 12 GB+

GPU_PARALLEL

3–4

fused_gpu

Optimalna zmogljivost namiznega računalnika

Sistem samo s CPU

CPU_PARALLEL

jedra – 1

cpu_fallback

Grafična kartica ni potrebna

circle-check

Metode debayeringa

Metoda
CLI Oznaka
Kakovost
Hitrost
Licenca

Standardna (hitra, srednja kakovost)

--debayer standard

Dobra

Hitra

Brezplačna / Chloros+

Texture Aware (počasno, najvišja kakovost)

--debayer texture-aware

Najvišja

Počasno

Samo Chloros+

Privzeta metoda debayerja je Standardna. MetodaTexture Aware uporablja model za odstranjevanje šuma AI/ML za izhod najvišje kakovosti, vendar zahteva licenco Chloros+ in grafično kartico NVIDIA.

Popravek vinjetiranja

Kaj počne: Popravlja padec svetlobe na robovih slike (temnejši koti, ki so pogosti na fotografijah).

  • Privzeto omogočeno – Večina uporabnikov naj to pusti omogočeno

  • Uporabite --no-vignette za onemogočanje

circle-check

Kalibracija odbojnosti

Pretvori surove vrednosti senzorja v standardizirane odstotke odbojnosti z uporabo kalibracijskih plošč.

  • Privzeto vklopljeno – nujno za analizo vegetacije

  • Zahteva kalibracijske ciljne plošče na slikah

  • Uporabite --no-reflectance za onemogočanje

circle-info

Zahteve: Za natančno pretvorbo odbojnosti poskrbite, da so kalibracijske plošče na slikah pravilno osvetljene in vidne.

PPK-popravki

Kaj počne: Uporablja poprocesne kinematične popravke z uporabo podatkov dnevnika DAQ-A-SD za izboljšano natančnost GPS.

  • Privzeto onemogočeno

  • Uporabite --ppk za vklop

  • Zahteva datoteke .daq v projektni mapi iz MAPIR svetlobnega senzorja DAQ-A-SD.

Izhodni formati

Oblika
Bitna globina
Velikost datoteke
Najbolj primerno za

TIFF (16-bitni)

16-bitno celo število

Velika

GIS analiza, fotogrametrija (priporočeno)

TIFF (32-bitni, odstotek)

32-bitno število s plavajočo vejico

Zelo veliko

Znanstvena analiza, raziskave

PNG (8-bitni)

8-bitno celo število

Srednje

Vizualni pregled, deljenje na spletu

JPG (8-bit)

8-bitno celo število

Majhno

Hiter predogled, stisnjena izhodna datoteka

***

Avtomatizacija in skriptiranje

Obdelava v seriji v PowerShellu (Windows)

Samodejna obdelava več map z nizi podatkov v Windows:

Windows skript za obdelavo v paketih (Windows)

Preprost krog za obdelavo v paketih na Windows:

Obdelava v paketu Bash (Linux)

Obdelava več map z nizi podatkov na Linux:

Skript za avtomatizacijo Python (večplatformski)

Napredna avtomatizacija z obdelavo napak (deluje na Windows in Linux):


Potek obdelave

Standardni potek

  1. Vnos: Mapa, ki vsebuje pare slik RAW/JPG

  2. Odkrivanje: CLI samodejno skenira za podprte slikovne datoteke

  3. Obdelava: Vzporedni način se prilagaja vašim jedrom CPU (Chloros+)

  4. Izhod: Ustvari podmapke po modelih fotoaparatov z obdelanimi slikami

Primer strukture izhodnih datotek

Ocene časa obdelave

Tipični časi obdelave za 100 slik (vsaka 12 MP):

Platforma
Način
Predvideni čas
Opombe

Namizni računalnik z grafično kartico 12 GB+

GPU_PARALLEL

5–10 min

Najhitrejša možnost

Namizni računalnik z 8 GB GPU

GPU_SINGLE

10–15 min

Dobra zmogljivost

Jetson Orin NX 16 GB

GPU_PARALLEL

15–25 min

Obdelava na robu omrežja

Jetson Nano 8 GB

GPU_SINGLE

30–60 min

Omejen pomnilnik

Samo CPU

CPU_PARALLEL

20–40 min

GPU ni potreben

circle-info

Nasvet za izboljšanje zmogljivosti: Čas obdelave se razlikuje glede na število slik, ločljivost, metodo debayeringa in strojno opremo. Debayering z upoštevanjem teksture traja znatno dlje kot standardni. Za podrobnosti glejte Dinamično prilagajanje računalniške zmogljivosti.


Odpravljanje težav

CLI ni bilo mogoče najti

Windows Napaka:

Windows Rešitve:

  1. Preverite mesto namestitve:

  1. Uporabite polno pot, če ni v PATH:

  1. Ročno dodajte v PATH:

    • Odprite Lastnosti sistema → Okoljske spremenljivke

    • Uredite spremenljivko PATH

    • Dodajte: C:\Program Files\Chloros\resources\cli

    • Ponovno zaženite terminal

Linux Napaka:

Linux Rešitve:

  1. Preverite namestitev:

  1. Ponovno naložite lupino:

  1. Preverite dovoljenja:


Backend se ni uspel zagnatiNapaka:

Rešitve:

  1. Preverite, ali backend že teče (ga najprej zaprite)

  2. Preverite, ali ga požarni zid ne blokira (Windows) ali preverite razpoložljivost vrat (Linux: lsof -i :5000)

  3. Poskusite z drugim vratom:

  1. Prisilno ponovno zaženite backend:

  1. Pri napaki Linux preverite, ali izvedljiva datoteka backenda obstaja:


Težave z licenco / avtentifikacijoNapaka:

Rešitve:

  1. Preverite, ali imate aktivno naročnino Chloros+

  2. Prijavite se s svojimi poverilnicami:

  1. Preverite stanje licence:

  1. Obrnite se na podporo: info@mapir.camera


Slike niso bile najdeneNapaka:

Rešitve:

  1. Preverite, ali mapa vsebuje podprte formate (.RAW, .TIF, .JPG)

  2. Preverite, ali je pot do mape pravilna (za poti z vmesnimi presledki uporabite narekovaje)

  3. Preverite, ali imate dovoljenja za branje mape

  4. Preverite, ali so končnice datotek pravilne


Obdelava se ustavi ali zamrzneRešitve:

  1. Preverite razpoložljivi prostor na disku (poskrbite, da je dovolj prostora za izhodne datoteke)

  2. Zaprite druge aplikacije, da sprostite pomnilnik

  3. Zmanjšajte število slik (obdelujte v serijah)


Vrata so že v uporabiNapaka:

Rešitve:

Windows:

Linux:


Pogosta vprašanja

V: Ali potrebujem licenco za CLI?

O:Da! Za CLI je potrebna plačljivalicenca Chloros+.

  • ❌ Standardni (brezplačni) načrt: CLI onemogočen

  • ✅ Chloros+ (plačljivi) načrti: CLI v celoti omogočen

Naročite se na: https://cloud.mapir.camera/pricingarrow-up-right


V: Ali lahko uporabljam CLI na strežniku brez grafičnega vmesnika?O: Da! CLI deluje popolnoma brez grafičnega vmesnika. To je glavni primer uporabe na Linux.Windows strežnik:

  • Windows strežnik 2016 ali novejši

  • Nameščen Visual C++ Redistributable

Linux strežnik:

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

  • Namestitev prek paketa .deb

Obe platformi:

  • Najmanj 8 GB RAM (priporočeno 16 GB)

  • Enkratna aktivacija licence: chloros-cli login user@example.com 'password'


V: Kje se shranijo obdelane slike?O:Privzeto se obdelane slike shranijo visto mapo kot vhodne v podmapah po modelih kamer (npr. Survey3N_RGN/).

Uporabite možnost -o, da določite drugo izhodno mapo:


V: Ali lahko obdelujem več map hkrati?O: Ne neposredno z enim ukazom, vendar lahko uporabite skripte za zaporedno obdelavo map. Glejte poglavje Avtomatizacija in skripti.***

V: Kako shranim izhod CLI v datoteko dnevnika?PowerShell:

Batch:

Linux Bash:


V: Kaj se zgodi, če med obdelavo pritisnem Ctrl+C?O: CLI bo:

  1. Obdelavo ustavil na primeren način

  2. Zaprl backend

  3. Izstopil s kodo 130

Delno obdelane slike lahko ostanejo v izhodni mapi.


V: Ali lahko avtomatiziram obdelavo CLI?O: Seveda! CLI je zasnovan za avtomatizacijo. Glejte Avtomatizacija in skriptiranje za PowerShell (Windows), Batch (Windows), Bash (Linux) in Python (medplatformski).***

V: Kako preverim različico CLI?O:

Izhod:


Pomoč

Pomoč v ukazni vrstici

Oglejte si informacije o pomoči neposredno v CLI:

Kanali podpore

Celotni primeri

Primer 1: Osnovna obdelava

Obdelava s privzetimi nastavitvami (vignette, odbojnost):

Windows:

Linux:


Primer 2: Visokokakovostni znanstveni izhod

32-bitni float TIFF:

Windows:

Linux:


Primer 3: Hitra obdelava predogleda

8-bitni PNG brez kalibracije za hiter pregled:

Windows:

Linux:


Primer 4: Obdelava s PPK-popravki

Uporabite PPK-popravke z odbojnostjo:

Windows:

Linux:


Primer 5: Mesto izpisa po meri

Obdelava v drugo mesto z določenim formatom:

Windows:

Linux:


Primer 6: Potek avtentifikacije

Celoten potek avtentifikacije (enak na vseh platformah):


Primer 7: Uporaba več jezikov

Sprememba jezika vmesnika (enaka na vseh platformah):

Last updated