# CLI : Command Line
The **Chloros CLI** provides powerful command-line access to the Chloros image processing engine, enabling automation, scripting, and headless operation for your imaging workflows. ### Key Features * 🚀 **Automation** - Script batch processing of multiple datasets * 🔗 **Integration** - Embed in existing workflows and pipelines * 💻 **Headless Operation** - Run without GUI * 🌍 **Multi-Language** - Support for 38 languages * ⚡ **Parallel Processing** - [Dynamic Compute Adaptation](/chloros/processing-architecture/dynamic-compute-adaptation.md) automatically optimizes for your hardware ### Requirements | Requirement | Details | | -------------------- | ------------------------------------------------------------------------------------ | | **Operating System** | Windows 10/11 (64-bit), Linux x86\_64 (amd64), Linux arm64 (NVIDIA Jetson JetPack 6) | | **License** | Chloros+ ([paid plan required](https://cloud.mapir.camera/pricing)) | | **Memory** | 8GB RAM minimum (16GB recommended) | | **Internet** | Required for license activation | | **Disk Space** | Varies by project size | {% hint style="warning" %} **License Requirement**: The CLI requires a paid Chloros+ subscription. Standard (free) plans do not have CLI access. Visit to upgrade. {% endhint %} ## Quick Start ### Installation #### Windows The CLI is automatically included with the Chloros installer: 1. Download and run **Chloros Installer.exe** 2. Complete the installation wizard 3. CLI installed to: `C:\Program Files\Chloros\resources\cli\chloros-cli.exe` {% hint style="success" %} The installer automatically adds `chloros-cli` to your system PATH. Restart your terminal after installation. {% endhint %} #### Linux Install the `.deb` package for your architecture: ```bash # Linux amd64 sudo dpkg -i chloros-amd64.deb # Linux arm64 (NVIDIA Jetson, JetPack 6) sudo dpkg -i chloros-arm64-jp6.deb ``` For detailed Linux setup, see [Linux Installation](/chloros/linux-and-edge-computing/linux-installation.md). ### First-Time Setup Before using the CLI, activate your Chloros+ license: **Windows:** ```powershell # Login with your Chloros+ account chloros-cli login user@example.com 'your_password' # Check license status chloros-cli status # Process your first project chloros-cli process "C:\Images\Dataset001" ``` **Linux:** ```bash # Login with your Chloros+ account chloros-cli login user@example.com 'your_password' # Check license status chloros-cli status # Process your first project chloros-cli process ~/images/dataset001 ``` ### Basic Usage Process a folder with default settings: **Windows:** ```powershell chloros-cli process "C:\Images\Dataset001" ``` **Linux:** ```bash chloros-cli process ~/images/dataset001 ``` *** ## Command Reference ### General Syntax ``` chloros-cli [global-options] [command-options] ``` *** ## Commands ### `process` - Process Images Process images in a folder with calibration. **Syntax:** ```bash chloros-cli process [options] ``` **Examples:** ```bash # Windows chloros-cli process "C:\Datasets\Survey_001" --vignette --reflectance # Linux chloros-cli process ~/datasets/survey_001 --vignette --reflectance ``` #### Process Command Options | Option | Type | Default | Description | | ----------------------- | ------- | -------------- | ----------------------------------------------------------------------------------------------- | | `` | Path | *Required* | Folder containing RAW/JPG multispectral images | | `-o, --output` | Path | Same as input | Output folder for processed images | | `-n, --project-name` | String | Auto-generated | Custom project name | | `--vignette` | Flag | Enabled | Enable vignette correction | | `--no-vignette` | Flag | - | Disable vignette correction | | `--reflectance` | Flag | Enabled | Enable reflectance calibration | | `--no-reflectance` | Flag | - | Disable reflectance calibration | | `--ppk` | Flag | Disabled | Apply PPK corrections from .daq light sensor data | | `--format` | Choice | TIFF (16-bit) | Output format: `TIFF (16-bit)`, `TIFF (32-bit, Percent)`, `PNG (8-bit)`, `JPG (8-bit)` | | `--min-target-size` | Integer | Auto | Minimum target size in pixels for calibration panel detection | | `--target-clustering` | Integer | Auto | Target clustering threshold (0-100) | | `--debayer` | Choice | `standard` | Debayer method: `standard` or `texture-aware` (Chloros+ only) | | `--target`, `--targets` | Flag | Disabled | Only search for calibration targets in a "target" or "targets" subfolder (speeds up processing) | | `--indices` | List | None | Vegetation indices to calculate (e.g., `--indices NDVI NDRE GNDVI`) | | `--exposure-pin-1` | String | None | Lock exposure for camera model (Pin 1) | | `--exposure-pin-2` | String | None | Lock exposure for camera model (Pin 2) | | `--recal-interval` | Integer | Auto | Recalibration interval in seconds | | `--timezone-offset` | Integer | 0 | Timezone offset in hours | *** ### `login` - Authenticate Account Login with your Chloros+ credentials to enable CLI processing. **Syntax:** ```bash chloros-cli login ``` **Example:** ```bash chloros-cli login user@example.com 'MyP@ssw0rd123' ``` {% hint style="warning" %} **Special Characters**: Use single quotes around passwords containing characters like `$`, `!`, or spaces. {% endhint %} **Output:**
*** ### `logout` - Clear Credentials Clear stored credentials and logout from your account. **Syntax:** ```bash chloros-cli logout ``` **Example:** ```bash chloros-cli logout ``` **Output:** ``` ✓ Logout successful ℹ Credentials cleared from cache ``` {% hint style="info" %} **SDK Users**: The Python SDK also provides a programmatic `logout()` method for clearing credentials within Python scripts. See the [Python SDK documentation](/chloros/api-python-sdk.md#logout) for details. {% endhint %} *** ### `status` - Check License Status Display current license and authentication status. **Syntax:** ```bash chloros-cli status ``` **Example:** ```bash chloros-cli status ``` **Output:** ``` ╔══════════════════════════════════════╗ ║ LICENSE & ACCOUNT INFORMATION ║ ╚══════════════════════════════════════╝ 📧 Email: user@example.com 📋 Plan: Chloros+ Professional 🔓 API/CLI Access: Enabled ✓ Status: Active ``` *** ### `export-status` - Check Export Progress Monitor Thread 4 export progress during or after processing. **Syntax:** ```bash chloros-cli export-status ``` **Example:** ```bash chloros-cli export-status ``` **Use Case:** Call this command while processing is running to check export progress. *** ### `language` - Manage Interface Language View or change the CLI interface language. **Syntax:** ```bash # Show current language chloros-cli language # List all available languages chloros-cli language --list # Set a specific language chloros-cli language ``` **Examples:** ```bash # 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 ``` #### Supported Languages (38 Total) | Code | Language | Native Name | | ------- | --------------------- | -------------------- | | `en` | English | English | | `es` | Spanish | Español | | `pt` | Portuguese | Português | | `fr` | French | Français | | `de` | German | Deutsch | | `it` | Italian | Italiano | | `ja` | Japanese | 日本語 | | `ko` | Korean | 한국어 | | `zh` | Chinese (Simplified) | 简体中文 | | `zh-TW` | Chinese (Traditional) | 繁體中文 | | `ru` | Russian | Русский | | `nl` | Dutch | Nederlands | | `ar` | Arabic | العربية | | `pl` | Polish | Polski | | `tr` | Turkish | Türkçe | | `hi` | Hindi | हिंदी | | `id` | Indonesian | Bahasa Indonesia | | `vi` | Vietnamese | Tiếng Việt | | `th` | Thai | ไทย | | `sv` | Swedish | Svenska | | `da` | Danish | Dansk | | `no` | Norwegian | Norsk | | `fi` | Finnish | Suomi | | `el` | Greek | Ελληνικά | | `cs` | Czech | Čeština | | `hu` | Hungarian | Magyar | | `ro` | Romanian | Română | | `uk` | Ukrainian | Українська | | `pt-BR` | Brazilian Portuguese | Português Brasileiro | | `zh-HK` | Cantonese | 粵語 | | `ms` | Malay | Bahasa Melayu | | `sk` | Slovak | Slovenčina | | `bg` | Bulgarian | Български | | `hr` | Croatian | Hrvatski | | `lt` | Lithuanian | Lietuvių | | `lv` | Latvian | Latviešu | | `et` | Estonian | Eesti | | `sl` | Slovenian | Slovenščina | {% hint style="success" %} **Automatic Persistence**: Your language preference is saved to `~/.chloros/cli_language.json` and persists across all sessions. {% endhint %} *** ### `set-project-folder` - Set Default Project Folder Change the default project folder location (shared with GUI on Windows). **Syntax:** ```bash chloros-cli set-project-folder ``` **Examples:** ```bash # Windows chloros-cli set-project-folder "C:\Projects\2025" # Linux chloros-cli set-project-folder ~/projects/2025 ``` *** ### `get-project-folder` - Show Project Folder Display the current default project folder location. **Syntax:** ```bash chloros-cli get-project-folder ``` **Example:** ```bash chloros-cli get-project-folder ``` **Output:** ``` # Windows ℹ Current project folder: C:\Projects\2025 # Linux ℹ Current project folder: /home/user/.local/share/chloros/projects ``` *** ### `reset-project-folder` - Reset to Default Reset the project folder to the default location. **Syntax:** ```bash chloros-cli reset-project-folder ``` *** ### `selftest` - Run System Diagnostics Run 7 diagnostic checks to verify your system configuration. **Syntax:** ```bash chloros-cli selftest ``` **Diagnostics performed:** 1. Version check 2. Port availability (5000) 3. Backend startup 4. API connectivity test 5. System info and GPU detection 6. Denoiser models verification 7. CUDA availability check {% hint style="info" %} **Useful for troubleshooting**: Run `selftest` after installation to verify your system is configured correctly, especially on Linux/Jetson where GPU and CUDA setup may need verification. {% endhint %} *** ### `update` - Check for Updates (Linux Only) Check for and install CLI updates on Linux systems. **Syntax:** ```bash # Check for updates without installing chloros-cli update --check # Check for and install updates chloros-cli update ``` | Option | Description | | --------- | ------------------------------------- | | `--check` | Only check for updates, don't install | {% hint style="info" %} This command is available on Linux only. On Windows, updates are delivered through the installer. {% endhint %} *** ## Global Options These options apply to all commands: | Option | Type | Default | Description | | --------------- | ------- | ------------- | ------------------------------------------------ | | `--backend-exe` | Path | Auto-detected | Path to backend executable | | `--port` | Integer | 5000 | Backend API port number | | `--restart` | Flag | - | Force restart backend (kills existing processes) | | `--version` | Flag | - | Show version information and exit | | `--help` | Flag | - | Show help information and exit | {% hint style="info" %} **Backend auto-detection**: The `--backend-exe` path is auto-detected per platform: * **Windows**: `C:\Program Files\MAPIR\Chloros\resources\backend\chloros-backend.exe` * **Linux (.deb)**: `/usr/lib/chloros/chloros-backend` * **Linux (manual)**: `/opt/mapir/chloros/backend/chloros-backend` {% endhint %} **Example with Global Options:** **Windows:** ```powershell chloros-cli --port 5001 process "C:\Datasets\Survey_001" ``` **Linux:** ```bash chloros-cli --port 5001 process ~/datasets/survey_001 ``` *** ## Processing Settings Guide ### Parallel Processing & Dynamic Compute Adaptation Chloros 1.1.0 includes [Dynamic Compute Adaptation](/chloros/processing-architecture/dynamic-compute-adaptation.md) — the processing engine **automatically detects your hardware** and selects the optimal strategy: | Platform | Strategy | Workers | Pipeline | Notes | | -------------------------- | -------------- | --------- | -------------- | ---------------------------- | | **Jetson Nano 8GB** | `GPU_SINGLE` | 1 | `tiled_gpu` | Memory-efficient, serialized | | **Jetson Orin NX 16GB** | `GPU_PARALLEL` | 3 | `fused_gpu` | Concurrent GPU processing | | **Desktop with 8GB GPU** | `GPU_SINGLE` | 3 | `tiled_gpu` | Good desktop performance | | **Desktop with 12GB+ GPU** | `GPU_PARALLEL` | 3-4 | `fused_gpu` | Optimal desktop performance | | **CPU-only system** | `CPU_PARALLEL` | cores - 1 | `cpu_fallback` | No GPU required | {% hint style="success" %} **No manual configuration needed!** Chloros auto-detects your CPU, GPU, RAM, and (on Jetson) thermal sensors, then configures the optimal processing pipeline automatically. {% endhint %} ### Debayer Methods | Method | CLI Flag | Quality | Speed | License | | ----------------------------------------- | ------------------------- | ------- | ----- | --------------- | | **Standard (Fast, Medium Quality)** | `--debayer standard` | Good | Fast | Free / Chloros+ | | **Texture Aware (Slow, Highest Quality)** | `--debayer texture-aware` | Highest | Slow | Chloros+ only | The default debayer method is **Standard**. The **Texture Aware** method uses an AI/ML denoising model for the highest quality output but requires a Chloros+ license and an NVIDIA GPU. ```bash # Use Texture Aware debayer (Chloros+ only) chloros-cli process ~/datasets/field_a --debayer texture-aware ``` ### Vignette Correction **What it does:** Corrects light falloff at image edges (darker corners common in camera imagery). * **Enabled by default** - Most users should keep this enabled * Use `--no-vignette` to disable {% hint style="success" %} **Recommendation**: Always enable vignette correction to ensure uniform brightness across the frame. {% endhint %} ### Reflectance Calibration Converts raw sensor values to standardized reflectance percentages using calibration panels. * **Enabled by default** - Essential for vegetation analysis * Requires calibration target panels in images * Use `--no-reflectance` to disable {% hint style="info" %} **Requirements**: Ensure calibration panels are properly exposed and visible in your images for accurate reflectance conversion. {% endhint %} ### PPK Corrections **What it does:** Applies Post-Processed Kinematic corrections using DAQ-A-SD log data for improved GPS accuracy. * **Disabled by default** * Use `--ppk` to enable * Requires .daq files in project folder from MAPIR DAQ-A-SD light sensor. ### Output Formats
FormatBit DepthFile SizeBest For
TIFF (16-bit) ⭐16-bit integerLargeGIS analysis, photogrammetry (recommended)
TIFF (32-bit, Percent)32-bit floatVery LargeScientific analysis, research
PNG (8-bit)8-bit integerMediumVisual inspection, web sharing
JPG (8-bit)8-bit integerSmallQuick preview, compressed output
*** ## Automation & Scripting ### PowerShell Batch Processing (Windows) Process multiple dataset folders automatically on Windows: ```powershell # 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 Batch Script (Windows) Simple loop for batch processing on Windows: ```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 ``` ### Bash Batch Processing (Linux) Process multiple dataset folders on Linux: ```bash #!/bin/bash # process_all_datasets.sh for dataset in ~/datasets/2026/*/; do name=$(basename "$dataset") echo "Processing $name..." chloros-cli process "$dataset" \ --vignette \ --reflectance if [ $? -eq 0 ]; then echo "✓ $name complete" else echo "✗ $name failed" fi done echo "All datasets processed!" ``` ### Python Automation Script (Cross-Platform) Advanced automation with error handling (works on Windows and Linux): ```python 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""" # Adjust path for your platform # Windows: Path('C:/Datasets/2025') # Linux: Path.home() / 'datasets' / '2025' 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() ``` *** ## Processing Workflow ### Standard Workflow 1. **Input**: Folder containing RAW/JPG image pairs 2. **Discovery**: CLI auto-scans for supported image files 3. **Processing**: Parallel mode scales to your CPU cores (Chloros+) 4. **Output**: Creates camera-model subfolders with processed images ### Example Output Structure ``` 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 └── ... ``` ### Processing Time Estimates Typical processing times for 100 images (12MP each): | Platform | Mode | Estimated Time | Notes | | ----------------------- | -------------- | -------------- | ------------------ | | **Desktop 12GB+ GPU** | `GPU_PARALLEL` | 5-10 min | Fastest option | | **Desktop 8GB GPU** | `GPU_SINGLE` | 10-15 min | Good performance | | **Jetson Orin NX 16GB** | `GPU_PARALLEL` | 15-25 min | Edge compute | | **Jetson Nano 8GB** | `GPU_SINGLE` | 30-60 min | Memory-constrained | | **CPU-only** | `CPU_PARALLEL` | 20-40 min | No GPU required | {% hint style="info" %} **Performance Tip**: Processing time varies based on image count, resolution, debayer method, and hardware. Texture Aware debayer takes significantly longer than Standard. See [Dynamic Compute Adaptation](/chloros/processing-architecture/dynamic-compute-adaptation.md) for details. {% endhint %} *** ## Troubleshooting ### CLI Not Found **Windows Error:** ``` 'chloros-cli' is not recognized as an internal or external command ``` **Windows Solutions:** 1. Verify installation location: ```powershell dir "C:\Program Files\Chloros\resources\cli\chloros-cli.exe" ``` 2. Use full path if not in PATH: ```powershell "C:\Program Files\Chloros\resources\cli\chloros-cli.exe" process "C:\Datasets\Field_A" ``` 3. Add to PATH manually: * Open System Properties → Environment Variables * Edit PATH variable * Add: `C:\Program Files\Chloros\resources\cli` * Restart terminal **Linux Error:** ``` chloros-cli: command not found ``` **Linux Solutions:** 1. Verify installation: ```bash which chloros-cli dpkg -L chloros-amd64 # or chloros-arm64-jp6 ``` 2. Reload your shell: ```bash source ~/.bashrc ``` 3. Check permissions: ```bash sudo chmod +x /usr/bin/chloros-cli ``` *** ### Backend Failed to Start **Error:** ``` Backend failed to start within 30 seconds ``` **Solutions:** 1. Check if backend already running (close it first) 2. Check firewall is not blocking (Windows) or check port availability (Linux: `lsof -i :5000`) 3. Try different port: ```bash # Windows chloros-cli --port 5001 process "C:\Datasets\Field_A" # Linux chloros-cli --port 5001 process ~/datasets/field_a ``` 4. Force restart backend: ```bash # Windows chloros-cli --restart process "C:\Datasets\Field_A" # Linux chloros-cli --restart process ~/datasets/field_a ``` 5. On Linux, check backend executable exists: ```bash ls -la /usr/lib/chloros/chloros-backend ``` *** ### License / Authentication Issues **Error:** ``` Chloros+ license required for CLI access ``` **Solutions:** 1. Verify you have an active Chloros+ subscription 2. Login with your credentials: ```bash chloros-cli login user@example.com 'password' ``` 3. Check license status: ```bash chloros-cli status ``` 4. Contact support: *** ### No Images Found **Error:** ``` No images found in the specified folder ``` **Solutions:** 1. Verify folder contains supported formats (.RAW, .TIF, .JPG) 2. Check folder path is correct (use quotes for paths with spaces) 3. Ensure you have read permissions for the folder 4. Check file extensions are correct *** ### Processing Stalls or Hangs **Solutions:** 1. Check available disk space (ensure enough for output) 2. Close other applications to free memory 3. Reduce image count (process in batches) *** ### Port Already in Use **Error:** ``` Port 5000 is already in use ``` **Solutions:** **Windows:** ```powershell chloros-cli --port 5001 process "C:\Datasets\Field_A" ``` **Linux:** ```bash # Find what's using port 5000 lsof -i :5000 # Use a different port chloros-cli --port 5001 process ~/datasets/field_a ``` *** ## FAQ ### Q: Do I need a license for the CLI? **A:** Yes! The CLI requires a paid **Chloros+ license**. * ❌ Standard (free) plan: CLI disabled * ✅ Chloros+ (paid) plans: CLI fully enabled Subscribe at: *** ### Q: Can I use the CLI on a server without GUI? **A:** Yes! The CLI runs completely headless. This is the primary use case on Linux. **Windows Server:** * Windows Server 2016 or later * Visual C++ Redistributable installed **Linux Server:** * Ubuntu 20.04+ / Debian 11+ (amd64) or JetPack 6 (arm64) * Install via `.deb` package **Both platforms:** * 8GB RAM minimum (16GB recommended) * One-time license activation: `chloros-cli login user@example.com 'password'` *** ### Q: Where are processed images saved? **A:** By default, processed images are saved in the **same folder as input** in camera-model subfolders (e.g., `Survey3N_RGN/`). Use `-o` option to specify a different output folder: ```bash # Windows chloros-cli process "C:\Input" -o "D:\Output" # Linux chloros-cli process ~/input -o ~/output ``` *** ### Q: Can I process multiple folders at once? **A:** Not directly in one command, but you can use scripting to process folders sequentially. See [Automation & Scripting](#automation--scripting) section. *** ### Q: How do I save CLI output to a log file? **PowerShell:** ```powershell chloros-cli process "C:\Datasets\Field_A" | Tee-Object -FilePath "processing.log" ``` **Batch:** ```batch chloros-cli process "C:\Datasets\Field_A" > processing.log 2>&1 ``` **Linux Bash:** ```bash chloros-cli process ~/datasets/field_a 2>&1 | tee processing.log ``` *** ### Q: What happens if I press Ctrl+C during processing? **A:** The CLI will: 1. Stop processing gracefully 2. Shut down the backend 3. Exit with code 130 Partially processed images may remain in the output folder. *** ### Q: Can I automate CLI processing? **A:** Absolutely! The CLI is designed for automation. See [Automation & Scripting](#automation--scripting) for PowerShell (Windows), Batch (Windows), Bash (Linux), and Python (cross-platform) examples. *** ### Q: How do I check the CLI version? **A:** ```bash chloros-cli --version ``` **Output:** ``` Chloros CLI 1.1.0 ``` *** ## Getting Help ### Command-Line Help View help information directly in the CLI: ```bash # General help chloros-cli --help # Command-specific help chloros-cli process --help chloros-cli login --help chloros-cli language --help ``` ### Support Channels * **Email**: * **Website**: * **Pricing**: *** ## Complete Examples ### Example 1: Basic Processing Process with default settings (vignette, reflectance): **Windows:** ```powershell chloros-cli process "C:\Datasets\Field_A_2025_01_15" ``` **Linux:** ```bash chloros-cli process ~/datasets/field_a_2025_01_15 ``` *** ### Example 2: High-Quality Scientific Output 32-bit float TIFF: **Windows:** ```powershell chloros-cli process "C:\Datasets\Field_A" ^ --format "TIFF (32-bit, Percent)" ^ --vignette ^ --reflectance ``` **Linux:** ```bash chloros-cli process ~/datasets/field_a \ --format "TIFF (32-bit, Percent)" \ --vignette \ --reflectance ``` *** ### Example 3: Fast Preview Processing 8-bit PNG without calibration for quick review: **Windows:** ```powershell chloros-cli process "C:\Datasets\Field_A" ^ --format "PNG (8-bit)" ^ --no-vignette ^ --no-reflectance ``` **Linux:** ```bash chloros-cli process ~/datasets/field_a \ --format "PNG (8-bit)" \ --no-vignette \ --no-reflectance ``` *** ### Example 4: PPK-Corrected Processing Apply PPK corrections with reflectance: **Windows:** ```powershell chloros-cli process "C:\Datasets\Field_A" ^ --ppk ^ --reflectance ``` **Linux:** ```bash chloros-cli process ~/datasets/field_a \ --ppk \ --reflectance ``` *** ### Example 5: Custom Output Location Process to a different location with specific format: **Windows:** ```powershell chloros-cli process "C:\Input\Raw_Images" ^ -o "D:\Output\Processed" ^ --format "TIFF (16-bit)" ``` **Linux:** ```bash chloros-cli process ~/input/raw_images \ -o ~/output/processed \ --format "TIFF (16-bit)" ``` *** ### Example 6: Authentication Workflow Complete authentication flow (same on all platforms): ```bash # Step 1: Login chloros-cli login user@example.com 'MyP@ssw0rd' # Step 2: Verify status chloros-cli status # Step 3: Process images # Windows: chloros-cli process "C:\Datasets\Field_A" # Linux: chloros-cli process ~/datasets/field_a chloros-cli process ~/datasets/field_a # Step 4: Logout (optional, when switching accounts) chloros-cli logout ``` *** ### Example 7: Multi-Language Usage Change interface language (same on all platforms): ```bash # List available languages chloros-cli language --list # Change to Spanish chloros-cli language es # Process with Spanish interface # Windows: chloros-cli process "C:\Vuelos\Campo_A" # Linux: chloros-cli process ~/vuelos/campo_a chloros-cli process ~/vuelos/campo_a # Change back to English chloros-cli language en ``` --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://mapir.gitbook.io/chloros/cli.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.