CLI: naredbeni redak

Chloros CLI pruža moćan pristup s naredbenog retka mehanizmu za obradu slike Chloros, omogućujući automatizaciju, skriptiranje i rad bez glave za vaše tijekove rada sa slikama.

Ključne značajke

• 🚀 Automatizacija - Skupna obrada skripte više skupova podataka

• 🔗 Integracija - Ugradite u postojeće tijekove rada i cjevovode

• 💻 Operacija bez glave - Pokrenite bez GUI-ja

• 🌍 Multi-Language - Podrška za 38 jezika

• ⚡ Paralelna obrada - Dinamički se prilagođava vašem CPU-u (do 16 paralelnih radnika)

Zahtjevi

Zahtjev	Detalji
Operativni sustav	Windows 10/11 (64-bit)
Licenca	Chloros+ (potreban plan uz plaćanje)
Sjećanje	Minimalno 8 GB RAM-a (preporučuje se 16 GB)
Internet	Potrebno za aktivaciju licence
Prostor na disku	Razlikuje se prema veličini projekta

Zahtjevi licence: CLI zahtijeva plaćenu pretplatu Chloros+. Standardni (besplatni) planovi nemaju CLI pristup. Posjetite https://cloud.mapir.camera/pricing za nadogradnju.

Brzi početak

Instalacija

CLI je automatski uključen u instalacijski program Chloros:

1. Preuzmite i pokrenite Chloros Installer.exe

2. Dovršite čarobnjaka za instalaciju

3. CLI instaliran na: C:\Program Files\Chloros\resources\cli\chloros-cli.exe

Instalacijski program automatski dodaje chloros-cli vašem sistemu PATH. Ponovno pokrenite terminal nakon instalacije.

Prvo postavljanje

Prije korištenja CLI, aktivirajte svoju Chloros+ licencu:

# Login with your Chloros+ account
chloros-cli login [e-mail] 'your_password'

# Check license status
chloros-cli status

# Process your first project
chloros-cli process "C:\Images\Dataset001"

Osnovna upotreba

Obradi mapu sa zadanim postavkama:

chloros-cli process "C:\Images\Dataset001"

---

Referenca naredbi

Opća sintaksa

chloros-cli [global-options] <command> [command-options]

---

Naredbe

process - Obrada slika

Obradite slike u mapi s kalibracijom.

Sintaksa:

chloros-cli process <input-folder> [options]

Primjer:

chloros-cli process "C:\Datasets\Survey_001" --vignette --reflectance

Mogućnosti naredbe procesa

Opcija	Upišite	Zadano	Opis
<input-folder>	Put	Obavezno	Mapa koja sadrži RAW/JPG multispektralne slike
-o, --output	Put	Isto kao unos	Izlazna mapa za obrađene slike
-n, --project-name	Niz	Automatski generirano	Prilagođeni naziv projekta
--vignette	Zastava	Omogućeno	Omogući ispravak vinjete
--no-vignette	Zastava	-	Onemogući korekciju vinjete
--reflectance	Zastava	Omogućeno	Omogući kalibraciju refleksije
--no-reflectance	Zastava	-	Onemogući kalibraciju refleksije
--ppk	Zastava	Onemogućeno	Primijeni PPK ispravke iz .daq podataka svjetlosnog senzora
--format	Izbor	TIFF (16-bitni)	Izlazni format: TIFF (16-bit), TIFF (32-bit, Percent), PNG (8-bit), JPG (8-bit)
--min-target-size	Cijeli broj	Auto	Minimalna veličina cilja u pikselima za otkrivanje kalibracijske ploče
--target-clustering	Cijeli broj	Auto	Ciljni prag grupiranja (0-100)
--exposure-pin-1	Niz	Ništa	Zaključaj ekspoziciju za model kamere (Pin 1)
--exposure-pin-2	Niz	Ništa	Zaključaj ekspoziciju za model kamere (Pin 2)
--recal-interval	Cijeli broj	Auto	Interval rekalibracije u sekundama
--timezone-offset	Cijeli broj	0	Pomak vremenske zone u satima

---

login - Autentifikacija računa

Prijavite se svojim vjerodajnicama Chloros+ kako biste omogućili obradu CLI.

Sintaksa:

chloros-cli login <email> <password>

Primjer:

chloros-cli login [e-mail] 'MyP@ssw0rd123'

Posebni znakovi: Koristite jednostruke navodnike oko zaporki koje sadrže znakove kao što su $, ! ili razmake.

Izlaz:

***

logout - Obriši vjerodajnice

Obrišite pohranjene vjerodajnice i odjavite se sa svog računa.

Sintaksa:

chloros-cli logout

Primjer:

chloros-cli logout

Izlaz:

✓ Logout successful
ℹ Credentials cleared from cache

SDK korisnici: Python SDK također pruža programsku logout() metodu za brisanje vjerodajnica unutar Python skripti. Pogledajte [dokumentaciju Python SDK] (api-python-sdk.md#logout) za detalje.

---

status - Provjerite status licence

Prikaz trenutne licence i statusa provjere autentičnosti.

Sintaksa:

chloros-cli status

Primjer:

chloros-cli status

Izlaz:

╔══════════════════════════════════════╗
║     LICENSE & ACCOUNT INFORMATION    ║
╚══════════════════════════════════════╝

📧 Email: [e-mail]
📋 Plan: Chloros+ Professional
🔓 API/CLI Access: Enabled
✓ Status: Active

---

export-status - Provjerite napredak izvoza

Pratite napredak izvoza niti 4 tijekom ili nakon obrade.

Sintaksa:

chloros-cli export-status

Primjer:

chloros-cli export-status

Upotreba: Pozovite ovu naredbu dok je obrada u tijeku da provjerite napredak izvoza.***

language - Upravljanje jezikom sučelja

Pogledajte ili promijenite jezik sučelja CLI.

Sintaksa:

# Show current language
chloros-cli language

# List all available languages
chloros-cli language --list

# Set a specific language
chloros-cli language <language-code>

Primjeri:

# View current language
chloros-cli language

# List all 38 supported languages
chloros-cli language --list

# Change to Spanish
chloros-cli language es

# Change to Japanese
chloros-cli language ja

Podržani jezici (ukupno 38)

Kod	Jezik	Domaće ime
en	engleski	engleski
es	španjolski	španjolski
pt	portugalski	português
fr	francuski	Français
de	njemački	njemački
it	talijanski	talijanski
ja	japanski	日本語
ko	korejski	한국어
zh	kineski (pojednostavljeni)	简体中文
zh-TW	kineski (tradicionalni)	繁體中文
ru	ruski	Russkij
nl	nizozemski	Nizozemski
ar	arapski	العربية
pl	poljski	Poljski
tr	turski	turski
hi	hindski	हिंदी
id	indonezijski	Bahasa Indonezija
vi	vijetnamski	Tiếng Việt
th	tajlandski	ไทย
sv	švedski	Svenska
da	danski	Dansk
no	norveški	Norsk
fi	finski	Suomi
el	grčki	Ελληνικά
cs	češki	Čeština
hu	mađarski	mađarski
ro	rumunjski	Română
uk	ukrajinski	Ukrajinska
pt-BR	brazilski portugalski	português brasileiro
zh-HK	kantonski	粵語
ms	malajski	Bahasa Melayu
sk	slovački	Slovenčina
bg	bugarski	Bʺlgarski
hr	hrvatski	Hrvatski
lt	litvanski	Lietuvių
lv	latvijski	Latviešu
et	estonski	Eesti
sl	slovenski	Slovenščina

Automatska postojanost: Vaše postavke jezika spremaju se u ~/.chloros/cli_language.json i traju tijekom svih sesija.

---

set-project-folder - Postavite zadanu mapu projekta

Promijenite zadanu lokaciju mape projekta (dijeli se s GUI-jem).

Sintaksa:

chloros-cli set-project-folder <folder-path>

Primjer:

chloros-cli set-project-folder "C:\Projects\2025"

---

get-project-folder - Prikaži mapu projekta

Prikaži trenutnu zadanu lokaciju mape projekta.

Sintaksa:

chloros-cli get-project-folder

Primjer:

chloros-cli get-project-folder

Izlaz:

ℹ Current project folder: C:\Projects\2025

---

reset-project-folder - Vrati na zadano

Ponovno postavite mapu projekta na zadanu lokaciju.

Sintaksa:

chloros-cli reset-project-folder

---

Globalne opcije

Ove se opcije odnose na sve naredbe:

Opcija	Upišite	Zadano	Opis
--backend-exe	Put	Automatski otkriveno	Put do pozadinske izvršne
--port	Cijeli broj	5000	Pozadinski API broj porta
--restart	Zastava	-	Prisilno ponovno pokretanje pozadine (ubija postojeće procese)
--version	Zastava	-	Prikaži informacije o verziji i izađi
--help	Zastava	-	Prikaži informacije za pomoć i izađi

Primjer s globalnim opcijama:

chloros-cli --port 5001 process "C:\Datasets\Survey_001"

---

Vodič za postavke obrade

Paralelna obrada

Chloros+ CLI automatski skaliraparalelnu obradu kako bi odgovarala mogućnostima vašeg računala:Kako radi:

• Otkriva vaše CPU jezgre i RAM

• Dodjeljuje radnike: 2× CPU jezgre (koristi hipernitnost)

• Maksimalno: 16 paralelnih radnika (radi stabilnosti)Razine sustava:

Vrsta sustava	CPU	RAM	Radnici	Izvedba
High-End	16+ jezgri	32+ GB	Do 16	Najveća brzina
Srednje klase	8-15 jezgri	16-31 GB	8-16	Izvrsna brzina
Low-End	4-7 jezgri	8-15 GB	4-8	Dobra brzina

Automatska optimizacija: CLI automatski otkriva specifikacije vašeg sustava i konfigurira optimalnu paralelnu obradu. Nije potrebna ručna konfiguracija!

Debayerove metode

CLI koristi High Quality (Faster) kao zadani i preporučeni debayer algoritam:

Metoda	Kvaliteta	Brzina	Opis
Visoka kvaliteta (brže) ⭐	⭐⭐⭐⭐	⚡⚡⚡	Algoritam svjestan rubova (zadano, preporučeno)

Ispravak vinjete

Što radi: ispravlja pad svjetla na rubovima slike (tamniji kutovi uobičajeni na slikama fotoaparata).

• Omogućeno prema zadanim postavkama - većina korisnika bi ovo trebala držati uključenim

• Koristite --no-vignette za onemogućavanje

Preporuka: Uvijek omogućite korekciju vinjete kako biste osigurali jednoliku svjetlinu u okviru.

Kalibracija refleksije

Pretvara neobrađene vrijednosti senzora u standardizirane postotke refleksije pomoću kalibracijskih ploča.

• Omogućeno prema zadanim postavkama - Neophodno za analizu vegetacije

• Zahtijeva kalibracijske ciljne ploče na slikama

• Koristite --no-reflectance za onemogućavanje

Zahtjevi: Provjerite jesu li kalibracijske ploče pravilno eksponirane i vidljive na vašim slikama radi točne konverzije refleksije.

PPK ispravci

Što radi: Primjenjuje naknadno obrađene kinematičke ispravke pomoću podataka zapisnika DAQ-A-SD za poboljšanu GPS točnost.

• Onemogućeno prema zadanim postavkama

• Koristite --ppk za omogućavanje

• Zahtijeva .daq datoteke u mapi projekta iz MAPIR DAQ-A-SD svjetlosnog senzora.

Izlazni formati

Format	Bit dubina	Veličina datoteke	Najbolja Za
TIFF (16-bitni) ⭐	16-bitni cijeli broj	Velika	GIS analiza, fotogrametrija (preporučeno)
TIFF (32-bit, postotak)	32-bitni float	Vrlo velik	Znanstvena analiza, istraživanje
PNG (8-bit)	8-bitni cijeli broj	Srednje	Vizualno pregled, web dijeljenje
JPG (8-bit)	8-bitni cijeli broj	Small	Brzi pregled, komprimirani izlaz

---

Automatizacija i skriptiranje

PowerShell skupna obrada

Automatski obradi više mapa skupa podataka:

# process_all_datasets.ps1

$datasets = Get-ChildItem "C:\Datasets\2025" -Directory

foreach ($dataset in $datasets) {
    Write-Host "Processing $($dataset.Name)..." -ForegroundColor Cyan
    
    chloros-cli process $dataset.FullName `
        --vignette `
        --reflectance
    
    if ($LASTEXITCODE -eq 0) {
        Write-Host "✓ $($dataset.Name) complete" -ForegroundColor Green
    } else {
        Write-Host "✗ $($dataset.Name) failed" -ForegroundColor Red
    }
}

Write-Host "All datasets processed!" -ForegroundColor Green

Windows Skupna skripta

Jednostavna petlja za skupnu obradu:

@echo off
echo Starting batch processing...

for /d %%i in (C:\Datasets\2025\*) do (
    echo.
    echo ========================================
    echo Processing: %%i
    echo ========================================
    chloros-cli process "%%i"
    
    if %ERRORLEVEL% EQU 0 (
        echo SUCCESS: %%i processed
    ) else (
        echo ERROR: %%i failed
    )
)

echo.
echo All datasets processed!
pause

Python skripta za automatizaciju

Napredna automatizacija s obradom grešaka:

import subprocess
import os
import sys
from pathlib import Path
from datetime import datetime

def process_dataset(input_folder):
    """Process a folder using Chloros CLI"""
    cmd = ['chloros-cli', 'process', str(input_folder)]
    
    # Execute command
    result = subprocess.run(
        cmd, 
        capture_output=True, 
        text=True,
        encoding='utf-8'
    )
    
    return result.returncode == 0, result.stdout, result.stderr

def main():
    """Process all datasets in a directory"""
    datasets_dir = Path('C:/Datasets/2025')
    log_file = Path('processing_log.txt')
    
    successful = []
    failed = []
    
    # Start processing
    print(f"Starting batch processing: {datetime.now()}")
    print(f"Scanning: {datasets_dir}")
    print("=" * 60)
    
    for dataset_folder in sorted(datasets_dir.iterdir()):
        if not dataset_folder.is_dir():
            continue
        
        print(f"\nProcessing: {dataset_folder.name}")
        
        success, stdout, stderr = process_dataset(dataset_folder)
        
        if success:
            print(f"✓ {dataset_folder.name} - SUCCESS")
            successful.append(dataset_folder.name)
        else:
            print(f"✗ {dataset_folder.name} - FAILED")
            failed.append(dataset_folder.name)
            
            # Log error details
            with open(log_file, 'a', encoding='utf-8') as f:
                f.write(f"\n=== {dataset_folder.name} - {datetime.now()} ===\n")
                f.write(f"STDOUT:\n{stdout}\n")
                f.write(f"STDERR:\n{stderr}\n")
    
    # Print summary
    print("\n" + "=" * 60)
    print(f"SUMMARY - Completed: {datetime.now()}")
    print(f"  Successful: {len(successful)}")
    print(f"  Failed: {len(failed)}")
    
    if failed:
        print(f"\nFailed folders:")
        for folder in failed:
            print(f"  - {folder}")
        print(f"\nCheck {log_file} for error details")
        sys.exit(1)
    else:
        print("\nAll datasets processed successfully!")
        sys.exit(0)

if __name__ == '__main__':
    main()

---

Tijek obrade

Standardni tijek rada

1. Ulaz: Mapa koja sadrži parove RAW/JPG slika

2. Otkriće: CLI automatski skenira podržane slikovne datoteke

3. Procesiranje: Paralelni način rada skalira na vaše CPU jezgre (Chloros+)

4. Izlaz: Stvara podmape modela fotoaparata s obrađenim slikama

Primjer izlazne strukture

MyProject/
├── project.json                             # Project metadata
├── 2025_0203_193056_008.JPG                # Original JPG
├── 2025_0203_193055_007.RAW                # Original RAW
└── Survey3N_RGN/                           # Processed outputs ✓
    ├── 2025_0203_193056_008_Reflectance.tif   # Calibrated reflectance
    ├── 2025_0203_193056_008_Target.tif        # Target detection
    └── ...

Procjene vremena obrade

Uobičajena vremena obrade za 100 slika (12 MP svaka):

Način	Vrijeme	Hardver
Paralelni način	5-10 min	i7/Ryzen 7, 16GB RAM, SSD (do 16 radnika)
Paralelni način	10-15 min	i5/Ryzen 5, 8GB RAM, HDD (do 8 radnika)

Savjet za performanse: Vrijeme obrade ovisi o broju slika, razlučivosti i specifikacijama računala.

---

Rješavanje problema

CLI Nije pronađen

Pogreška:

'chloros-cli' is not recognized as an internal or external command

Rješenja:

1. Provjerite mjesto instalacije:

dir "C:\Program Files\Chloros\resources\cli\chloros-cli.exe"

1. Koristite puni put ako nije u PATH:

"C:\Program Files\Chloros\resources\cli\chloros-cli.exe" process "C:\Datasets\Field_A"

1. Ručno dodajte u PATH:

   • Otvorite Svojstva sustava → Varijable okoline

   • Uredite PATH varijablu

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

   • Ponovno pokrenite terminal

---

Nije uspjelo pokretanje pozadinePogreška:

Backend failed to start within 30 seconds

Rješenja:

1. Provjerite je li pozadina već pokrenuta (prvo je zatvorite)

2. Provjerite Windows Vatrozid ne blokira

3. Pokušajte s drugim priključkom:

chloros-cli --port 5001 process "C:\Datasets\Field_A"

1. Prisilno ponovno pokretanje pozadine:

chloros-cli --restart process "C:\Datasets\Field_A"

---

Problemi s licencom/provjerom autentičnostiPogreška:

Chloros+ license required for CLI access

Rješenja:

1. Provjerite imate li aktivnu Chloros+ pretplatu

2. Prijavite se svojim vjerodajnicama:

chloros-cli login [e-mail] 'password'

1. Provjerite status licence:

chloros-cli status

1. Kontaktirajte podršku: [e-mail]

---

Slike nisu pronađenePogreška:

No images found in the specified folder

Rješenja:

1. Provjerite sadrži li mapa podržane formate (.RAW, .TIF, .JPG)

2. Provjerite je li putanja mape točna (upotrijebite navodnike za staze s razmacima)

3. Provjerite imate li dopuštenje za čitanje mape

4. Provjerite jesu li ekstenzije datoteka ispravne

---

Obrada se zaustavlja ili prekidaRješenja:

1. Provjerite raspoloživi prostor na disku (osigurajte dovoljno za ispis)

2. Zatvorite ostale aplikacije kako biste oslobodili memoriju

3. Smanjite broj slika (obradite u serijama)

---

Port se već koristiPogreška:

Port 5000 is already in use

Otopina:

Navedite drugi priključak:

chloros-cli --port 5001 process "C:\Datasets\Field_A"

---

FAQ

P: Trebam li licencu za CLI?

O:Da! CLI zahtijeva plaćenu licencuChloros+.

• ❌ Standardni (besplatni) plan: CLI onemogućen

• ✅ Chloros+ (plaćeni) planovi: CLI potpuno omogućen

Pretplatite se na: https://cloud.mapir.camera/pricing

---

P: Mogu li koristiti CLI na poslužitelju bez GUI-ja?O: Da! CLI radi potpuno bez glave. Zahtjevi:

• Windows poslužitelj 2016 ili noviji

• Visual C++ Redistributable instaliran

• Dovoljno RAM-a (minimalno 8 GB, preporučuje se 16 GB)

• Jednokratna aktivacija GUI licence na bilo kojem računalu

---

P: Gdje se spremaju obrađene slike?O:Prema zadanim postavkama, obrađene slike spremaju se uistu mapu kao ulaz u podmapama modela fotoaparata (npr. Survey3N_RGN/).

Upotrijebite opciju -o da odredite drugu izlaznu mapu:

chloros-cli process "C:\Input" -o "D:\Output"

---

P: Mogu li obraditi više mapa odjednom?O: Ne izravno u jednoj naredbi, ali možete koristiti skriptiranje za uzastopnu obradu mapa. Pogledajte odjeljak Automatizacija i skriptiranje.***

P: Kako mogu spremiti CLI izlaz u datoteku dnevnika?PowerShell:

chloros-cli process "C:\Datasets\Field_A" | Tee-Object -FilePath "processing.log"

Serija:

chloros-cli process "C:\Datasets\Field_A" > processing.log 2>&1

---

P: Što se događa ako pritisnem Ctrl+C tijekom obrade?A: CLI će:

1. Prestanite graciozno obrađivati

2. Isključite pozadinu

3. Izlaz sa kodom 130

Djelomično obrađene slike mogu ostati u izlaznoj mapi.

---

P: Mogu li automatizirati obradu CLI?O: Apsolutno! CLI je dizajniran za automatizaciju. Pogledajte Automatizacija i skriptiranje za PowerShell, Batch i Python primjere.***

P: Kako mogu provjeriti verziju CLI?A:

chloros-cli --version

Izlaz:

Chloros CLI 1.0.2

---

Dobivanje pomoći

Pomoć za naredbeni redak

Pogledajte informacije o pomoći izravno u CLI:

# General help
chloros-cli --help

# Command-specific help
chloros-cli process --help
chloros-cli login --help
chloros-cli language --help

Kanali podrške

• E-mail: [e-mail]

• Web stranica: https://www.mapir.camera/community/contact

• Cijena: https://cloud.mapir.camera/pricing***

Potpuni primjeri

Primjer 1: Osnovna obrada

Proces sa zadanim postavkama (vinjeta, refleksija):

chloros-cli process "C:\Datasets\Field_A_2025_01_15"

---

Primjer 2: Visokokvalitetni znanstveni rezultati

32-bitni float TIFF:

chloros-cli process "C:\Datasets\Field_A" ^
  --format "TIFF (32-bit, Percent)" ^
  --vignette ^
  --reflectance

---

Primjer 3: Brza obrada pregleda

8-bitni PNG bez kalibracije za brzi pregled:

chloros-cli process "C:\Datasets\Field_A" ^
  --format "PNG (8-bit)" ^
  --no-vignette ^
  --no-reflectance

---

Primjer 4: PPK-ispravljena obrada

Primijenite PPK korekcije s refleksijom:

chloros-cli process "C:\Datasets\Field_A" ^
  --ppk ^
  --reflectance

---

Primjer 5: Lokacija prilagođenog izlaza

Prebaci na drugi pogon s određenim formatom:

chloros-cli process "C:\Input\Raw_Images" ^
  -o "D:\Output\Processed" ^
  --format "TIFF (16-bit)"

---

Primjer 6: Tijek rada provjere autentičnosti

Potpuni tijek provjere autentičnosti:

# Step 1: Login
chloros-cli login [e-mail] 'MyP@ssw0rd'

# Step 2: Verify status
chloros-cli status

# Step 3: Process images
chloros-cli process "C:\Datasets\Field_A"

# Step 4: Logout (optional, when switching accounts)
chloros-cli logout

---

Primjer 7: Upotreba više jezika

Promjena jezika sučelja:

# List available languages
chloros-cli language --list

# Change to Spanish
chloros-cli language es

# Process with Spanish interface
chloros-cli process "C:\Vuelos\Campo_A"

# Change back to English
chloros-cli language en