CLI: Riga di comando

**Chloros CLI** fornisce un potente accesso da riga di comando al motore di elaborazione delle immagini Chloros, consentendo l'automazione, la creazione di script e il funzionamento senza monitor per i flussi di lavoro di imaging.

Caratteristiche principali

• 🚀 Automazione - Elaborazione batch di script di più set di dati

• 🔗 Integrazione - Integrazione nei flussi di lavoro e nelle pipeline esistenti

• 💻 Funzionamento headless - Esecuzione senza GUI

• 🌍 Multilingue - Supporto per 38 lingue

• ⚡ Elaborazione parallela - Si adatta dinamicamente alla tua CPU (fino a 16 worker paralleli)

Requisiti

Requisito	Dettagli
Sistema operativo	Windows 10/11 (64 bit)
Licenza	Chloros+ (abbonamento a pagamento richiesto)
Memoria	Minimo 8 GB di RAM (consigliati 16 GB)
Internet	Necessario per l'attivazione della licenza
Spazio su disco	Varia in base alle dimensioni del progetto

Requisiti di licenza: CLI richiede un abbonamento a pagamento a Chloros+. I piani standard (gratuiti) non consentono l'accesso a CLI. Visita https://cloud.mapir.camera/pricing per effettuare l'aggiornamento.

Avvio rapido

Installazione

CLI è automaticamente incluso nell'installatore Chloros:

1. Scaricare ed eseguire Chloros Installer.exe

2. Completare la procedura guidata di installazione

3. CLI installato in: C:\Program Files\Chloros\resources\cli\chloros-cli.exe

Il programma di installazione aggiunge automaticamente chloros-cli al PATH del sistema. Riavviare il terminale dopo l'installazione.

Configurazione iniziale

Prima di utilizzare CLI, attiva la licenza Chloros+:

# 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"

Utilizzo di base

Elaborare una cartella con le impostazioni predefinite:

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

---

Riferimento ai comandi

Sintassi generale

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

---

Comandi

process - Elaborare immagini

Elabora le immagini in una cartella con calibrazione.

Sintassi:

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

Esempio:

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

Opzioni del comando di elaborazione

Opzione	Tipo	Impostazione predefinita	Descrizione
<input-folder>	Percorso	Obbligatorio	Cartella contenente immagini multispettrali RAW/JPG
-o, --output	Percorso	Uguale all'input	Cartella di output per le immagini elaborate
-n, --project-name	Stringa	Generato automaticamente	Nome progetto personalizzato
--vignette	Flag	Abilitato	Abilita correzione vignettatura
--no-vignette	Flag	-	Disabilita correzione vignettatura
--reflectance	Flag	Abilitato	Abilita calibrazione riflettanza
--no-reflectance	Flag	-	Disabilita calibrazione riflettanza
--ppk	Flag	Disabilitato	Applica correzioni PPK dai dati del sensore di luce .daq
--format	Scelta	TIFF (16 bit)	Formato di output: TIFF (16-bit), TIFF (32-bit, Percent), PNG (8-bit), JPG (8-bit)
--min-target-size	Intero	Auto	Dimensione minima target in pixel per il rilevamento del pannello di calibrazione
--target-clustering	Intero	Auto	Soglia di raggruppamento target (0-100)
--exposure-pin-1	Stringa	Nessuna	Blocco esposizione per modello di fotocamera (Pin 1)
--exposure-pin-2	Stringa	Nessuna	Blocco esposizione per modello di fotocamera (Pin 2)
--recal-interval	Intero	Auto	Intervallo di ricalibrazione in secondi
--timezone-offset	Intero	0	Offset fuso orario in ore

---

login - Autentica account

Accedi con le tue credenziali Chloros+ per abilitare l'elaborazione CLI.

Sintassi:

chloros-cli login <email> <password>

Esempio:

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

Caratteri speciali: utilizzare virgolette singole attorno alle password contenenti caratteri come $, ! o spazi.

Output:

***

logout - Cancella credenziali

Cancella le credenziali memorizzate ed esci dal tuo account.

Sintassi:

chloros-cli logout

Esempio:

chloros-cli logout

Output:

✓ Logout successful
ℹ Credentials cleared from cache

Utenti SDK: Python SDK fornisce anche un metodo programmatico logout() per cancellare le credenziali all'interno degli script Python. Per ulteriori dettagli, consultare la documentazione Python SDK.

---

status - Controlla lo stato della licenza

Visualizza lo stato attuale della licenza e dell'autenticazione.

Sintassi:

chloros-cli status

Esempio:

chloros-cli status

Output:

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

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

---

export-status - Controlla lo stato di avanzamento dell'esportazione

Monitora lo stato di avanzamento dell'esportazione del thread 4 durante o dopo l'elaborazione.

Sintassi:

chloros-cli export-status

Esempio:

chloros-cli export-status

Caso d'uso: richiamare questo comando durante l'esecuzione dell'elaborazione per controllare lo stato di avanzamento dell'esportazione.***

language - Gestione della lingua dell'interfaccia

Visualizzare o modificare la lingua dell'interfaccia CLI.

Sintassi:

# Show current language
chloros-cli language

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

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

Esempi:

# 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

Lingue supportate (38 in totale)

Codice	Lingua	Nome nativo
en	Inglese	English
es	Spagnolo	Español
pt	Portoghese	Português
fr	Francese	Français
de	Tedesco	Deutsch
it	Italiano	Italiano
ja	Giapponese	日本語
ko	Coreano	한국어
zh	Cinese (semplificato)	简体中文
zh-TW	Cinese (tradizionale)	繁體中文
ru	Russo	Русский
nl	Olandese	Nederlands
ar	Arabo	العربية
pl	Polacco	Polski
tr	Turco	Türkçe
hi	Hindi	हिंदी
id	Indonesiano	Bahasa Indonesia
vi	Vietnamita	Tiếng Việt
th	Thailandese	ไทย
sv	Svedese	Svenska
da	Danese	Dansk
no	Norvegese	Norsk
fi	Finlandese	Suomi
el	Greco	Ελληνικά
cs	Ceco	Čeština
hu	Ungherese	Magyar
ro	Rumeno	Română
uk	Ucraino	Українська
pt-BR	Portoghese brasiliano	Português Brasileiro
zh-HK	Cantonese	粵語
ms	Malese	Bahasa Melayu
sk	Slovacco	Slovenčina
bg	Bulgaro	Български
hr	Croato	Hrvatski
lt	Lituano	Lietuvių
lv	Lettone	Latviešu
et	Estone	Eesti
sl	Sloveno	Slovenščina

Persistenza automatica: la lingua preferita viene salvata in ~/.chloros/cli_language.json e rimane attiva in tutte le sessioni.

---

set-project-folder - Imposta cartella progetto predefinita

Modifica la posizione della cartella progetto predefinita (condivisa con GUI).

Sintassi:

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

Esempio:

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

---

get-project-folder - Mostra cartella del progetto

Visualizza la posizione corrente della cartella predefinita del progetto.

Sintassi:

chloros-cli get-project-folder

Esempio:

chloros-cli get-project-folder

Output:

ℹ Current project folder: C:\Projects\2025

---

reset-project-folder - Ripristina impostazioni predefinite

Ripristina la cartella del progetto nella posizione predefinita.

Sintassi:

chloros-cli reset-project-folder

---

Opzioni globali

Queste opzioni si applicano a tutti i comandi:

Opzione	Tipo	Predefinito	Descrizione
--backend-exe	Percorso	Rilevato automaticamente	Percorso dell'eseguibile backend
--port	Intero	5000	Numero porta backend API
--restart	Flag	-	Forza il riavvio del backend (termina i processi esistenti)
--version	Flag	-	Mostra le informazioni sulla versione e esci
--help	Flag	-	Mostra le informazioni di aiuto ed esci

Esempio con opzioni globali:

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

---

Guida alle impostazioni di elaborazione

Elaborazione parallela

Chloros+ CLI adatta automaticamentel'elaborazione parallela alle capacità del computer:Come funziona:

• Rileva i core della CPU e la RAM

• Assegna i worker: 2× core della CPU (utilizza l'hyperthreading)

• Massimo: 16 worker paralleli (per garantire la stabilità)Livelli di sistema:

Tipo di sistema	CPU	RAM	Worker	Prestazioni
High-End	16+ core	32+ GB	Fino a 16	Velocità massima
Fascia media	8-15 core	16-31 GB	8-16	Velocità eccellente
Fascia bassa	4-7 core	8-15 GB	4-8	Buona velocità

Ottimizzazione automatica: CLI rileva automaticamente le specifiche del sistema e configura l'elaborazione parallela ottimale. Non è necessaria alcuna configurazione manuale!

Metodi Debayer

CLI utilizza Alta qualità (più veloce) come algoritmo debayer predefinito e consigliato:

Metodo	Qualità	Velocità	Descrizione
Alta qualità (più veloce) ⭐	⭐⭐⭐⭐	⚡⚡⚡	Algoritmo sensibile ai bordi (impostazione predefinita, consigliata)

Correzione vignettatura

Cosa fa: corregge la caduta di luce ai bordi dell'immagine (angoli più scuri comuni nelle immagini delle fotocamere).

• Abilitata per impostazione predefinita - La maggior parte degli utenti dovrebbe mantenerla abilitata

• Utilizzare --no-vignette per disabilitarla

Raccomandazione: abilitare sempre la correzione vignetta per garantire una luminosità uniforme in tutto il fotogramma.

Calibrazione riflettanza

Converte i valori grezzi del sensore in percentuali di riflettanza standardizzate utilizzando pannelli di calibrazione.

• Abilitata per impostazione predefinita - Essenziale per l'analisi della vegetazione.

• Richiede pannelli di calibrazione nelle immagini.

• Utilizzare --no-reflectance per disabilitare.

Requisiti: assicurarsi che i pannelli di calibrazione siano correttamente esposti e visibili nelle immagini per una conversione accurata della riflettanza.

Correzioni PPK

Cosa fa: applica correzioni cinematiche post-elaborate utilizzando i dati di registro DAQ-A-SD per una maggiore precisione del GPS.

• Disabilitato per impostazione predefinita

• Utilizzare --ppk per abilitare

• Richiede file .daq nella cartella del progetto dal sensore di luce DAQ-A-SD MAPIR.

Formati di output

Formato	Profondità di bit	Dimensione file	Ideale per
TIFF (16 bit) ⭐	Intero a 16 bit	Grande	Analisi GIS, fotogrammetria (consigliato)
TIFF (32 bit, percentuale)	32 bit in virgola mobile	Molto grande	Analisi scientifica, ricerca
PNG (8 bit)	Intero a 8 bit	Medio	Ispezione visiva, condivisione web
JPG (8 bit)	Intero a 8 bit	Piccolo	Anteprima rapida, output compresso

***

Automazione e scripting

Elaborazione batch PowerShell

Elaborazione automatica di più cartelle di set di dati:

# 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 Script batch

Semplice ciclo per l'elaborazione batch:

@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 Script di automazione

Automazione avanzata con gestione degli errori:

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

---

Flusso di lavoro di elaborazione

Flusso di lavoro standard

1. Input: cartella contenente coppie di immagini RAW/JPG

2. Rilevamento: CLI esegue la scansione automatica dei file immagine supportati

3. Elaborazione: la modalità parallela si adatta ai core della CPU (Chloros+)

4. Output: crea sottocartelle per modello di fotocamera con le immagini elaborate

Esempio di struttura dell'output

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
    └── ...

Stime dei tempi di elaborazione

Tempi di elaborazione tipici per 100 immagini (12 MP ciascuna):

Modalità	Tempo	Hardware
Modalità parallela	5-10 min	i7/Ryzen 7, 16 GB di RAM, SSD (fino a 16 worker)
Modalità parallela	10-15 min	i5/Ryzen 5, 8 GB di RAM, HDD (fino a 8 worker)

Suggerimento sulle prestazioni: il tempo di elaborazione varia in base al numero di immagini, alla risoluzione e alle specifiche del computer.

---

Risoluzione dei problemi

CLI non trovato

Errore:

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

Soluzioni:

1. Verificare la posizione di installazione:

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

1. Utilizzare il percorso completo se non presente in PATH:

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

1. Aggiungere manualmente a PATH:

   • Aprire Proprietà del sistema → Variabili d'ambiente

   • Modificare la variabile PATH

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

   • Riavvia il terminale

---

Impossibile avviare il backendErrore:

Backend failed to start within 30 seconds

Soluzioni:

1. Verifica se il backend è già in esecuzione (chiudilo prima)

2. Verifica che Windows il firewall non lo stia bloccando

3. Prova una porta diversa:

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

1. Forza il riavvio del backend:

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

---

Problemi di licenza/autenticazioneErrore:

Chloros+ license required for CLI access

Soluzioni:

1. Verificare di disporre di un abbonamento Chloros+ attivo

2. Accedere con le proprie credenziali:

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

1. Controllare lo stato della licenza:

chloros-cli status

1. Contattare l'assistenza: [e-mail]

---

Nessuna immagine trovataErrore:

No images found in the specified folder

Soluzioni:

1. Verificare che la cartella contenga formati supportati (.RAW, .TIF, .JPG)

2. Verificare che il percorso della cartella sia corretto (utilizzare le virgolette per i percorsi con spazi)

3. Assicurarsi di disporre dei permessi di lettura per la cartella

4. Verificare che le estensioni dei file siano corrette

---

Elaborazione bloccata o in sospesoSoluzioni:

1. Verificare lo spazio disponibile su disco (assicurarsi che sia sufficiente per l'output)

2. Chiudere le altre applicazioni per liberare memoria

3. Ridurre il numero di immagini (elaborare in batch)

---

Porta già in usoErrore:

Port 5000 is already in use

Soluzione:

Specificare una porta diversa:

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

---

Domande frequenti

D: È necessaria una licenza per CLI?

R:Sì! CLI richiede unalicenza Chloros+ a pagamento.

• ❌ Piano Standard (gratuito): CLI disabilitato

• ✅ Piani Chloros+ (a pagamento): CLI completamente abilitato

Abbonati su: https://cloud.mapir.camera/pricing

---

D: Posso usare CLI su un server senza GUI?R: Sì! CLI funziona completamente senza interfaccia grafica. Requisiti:

• Windows Server 2016 o versioni successive

• Visual C++ Redistributable installato

• RAM sufficiente (minimo 8 GB, consigliati 16 GB)

• Attivazione della licenza GUI una tantum su qualsiasi macchina

---

D: Dove vengono salvate le immagini elaborate?R:Per impostazione predefinita, le immagini elaborate vengono salvate nellastessa cartella dell'input nelle sottocartelle del modello di fotocamera (ad esempio, Survey3N_RGN/).

Utilizzare l'opzione -o per specificare una cartella di output diversa:

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

---

D: Posso elaborare più cartelle contemporaneamente?A: Non direttamente con un unico comando, ma è possibile utilizzare uno script per elaborare le cartelle in sequenza. Vedere la sezione Automazione e scripting.***

D: Come posso salvare l'output di CLI in un file di log?PowerShell:

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

Batch:

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

---

D: Cosa succede se premo Ctrl+C durante l'elaborazione?R: CLI:

1. Interromperà l'elaborazione in modo corretto

2. Chiuderà il backend

3. Uscira con il codice 130

Le immagini parzialmente elaborate potrebbero rimanere nella cartella di output.

---

D: Posso automatizzare l'elaborazione di CLI?R: Certamente! CLI è progettato per l'automazione. Vedere Automazione e scripting per esempi di PowerShell, Batch e Python.***

D: Come posso verificare la versione di CLI?R:

chloros-cli --version

Output:

Chloros CLI 1.0.2

---

Ottenere assistenza

Guida della riga di comando

Visualizza le informazioni di aiuto direttamente in CLI:

# General help
chloros-cli --help

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

Canali di assistenza

• E-mail: [e-mail]

• Sito web: https://www.mapir.camera/community/contact

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

Esempi completi

Esempio 1: elaborazione di base

Elaborazione con impostazioni predefinite (vignettatura, riflettanza):

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

---

Esempio 2: output scientifico di alta qualità

32 bit float TIFF:

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

---

Esempio 3: elaborazione anteprima veloce

8 bit PNG senza calibrazione per una rapida revisione:

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

---

Esempio 4: elaborazione con correzione PPK

Applicare correzioni PPK con riflettanza:

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

---

Esempio 5: posizione di output personalizzata

Elaborare su un'unità diversa con formato specifico:

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

---

Esempio 6: flusso di lavoro di autenticazione

Completa il flusso di autenticazione:

# 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

---

Esempio 7: utilizzo multilingue

Cambia la lingua dell'interfaccia:

# 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