API : Python SDK

Το Chloros Python SDK παρέχει προγραμματιστική πρόσβαση στον μηχανισμό επεξεργασίας εικόνων Chloros, επιτρέποντας αυτοματοποίηση, προσαρμοσμένες ροές εργασίας και απρόσκοπτη ενσωμάτωση με τις εφαρμογές Python και τις ερευνητικές σας διαδικασίες.

Βασικά χαρακτηριστικά

• 🐍 Εγγενές Python - Καθαρό, Pythonic API για επεξεργασία εικόνων

• 🔧 Πλήρης πρόσβαση στο API - Πλήρης έλεγχος της επεξεργασίας Chloros

• 🚀 Αυτοματοποίηση - Δημιουργήστε προσαρμοσμένες ροές εργασίας μαζικής επεξεργασίας

• 🔗 Ενσωμάτωση - Ενσωματώστε το Chloros σε υπάρχουσες εφαρμογές Python

• 📊 Έτοιμο για έρευνα - Ιδανικό για ροές επιστημονικής ανάλυσης

• ⚡ Παράλληλη επεξεργασία - Κλιμακώνεται ανάλογα με τους πυρήνες της CPU σας (Chloros+)

Απαιτήσεις

Απαίτηση	Λεπτομέρειες
Chloros Εγκατεστημένο	Windows: Πρόγραμμα εγκατάστασης για επιτραπέζιους υπολογιστές; Linux: Πακέτο .deb
Άδεια χρήσης	Chloros+ (απαιτείται πρόγραμμα επί πληρωμή)
Λειτουργικό σύστημα	Windows 10/11 (64-bit), Linux x86_64 (amd64), Linux arm64 (NVIDIA Jetson JetPack 6)
Python	Python 3.7 ή νεότερη έκδοση
Μνήμη	Ελάχιστη μνήμη RAM 8 GB (συνιστάται 16 GB)
Διαδίκτυο	Απαιτείται για την ενεργοποίηση της άδειας χρήσης

Απαιτήσεις άδειας χρήσης: Το Python SDK απαιτεί συνδρομή Chloros+ επί πληρωμή για πρόσβαση στο API. Τα βασικά (δωρεάν) πακέτα δεν έχουν πρόσβαση στο API/SDK. Επισκεφθείτε το https://cloud.mapir.camera/pricing για αναβάθμιση.

Γρήγορη εκκίνηση

Εγκατάσταση

Εγκαταστήστε μέσω pip:

pip install chloros-sdk

Αρχική ρύθμιση: Πριν χρησιμοποιήσετε το SDK, ενεργοποιήστε την άδεια χρήσης Chloros+ ανοίγοντας το Chloros, Chloros (Πρόγραμμα περιήγησης) ή το Chloros CLI και συνδεθείτε με τα διαπιστευτήριά σας. Αυτό χρειάζεται να γίνει μόνο μία φορά. Στο Linux (χωρίς GUI), χρησιμοποιήστε: chloros-cli login [e-mail] 'password'

Βασική χρήση

Επεξεργαστείτε έναν φάκελο με λίγες μόνο γραμμές:

from chloros_sdk import process_folder

# One-line processing (Windows)
results = process_folder("C:\\DroneImages\\Flight001")

# One-line processing (Linux)
results = process_folder("/home/user/drone_images/flight001")

Διαπλατφορμικές διαδρομές: Τα παραδείγματα κώδικα σε αυτή τη σελίδα χρησιμοποιούν διαδρομές τύπου Windows (π.χ., C:\\DroneImages\\Flight001). Στο Linux, χρησιμοποιήστε διαδρομές τύπου Linux (π.χ., /home/user/drone_images/flight001 ή ~/drone_images/flight001). Το SDK λειτουργεί με τον ίδιο τρόπο και στις δύο πλατφόρμες.

Πλήρης έλεγχος

Για προηγμένες ροές εργασίας:

from chloros_sdk import ChlorosLocal

# Initialize SDK
chloros = ChlorosLocal()

# Create project
chloros.create_project("MyProject", camera="Survey3N_RGN")

# Import images
chloros.import_images("C:\\DroneImages\\Flight001")  # Windows
# chloros.import_images("/home/user/drone_images/flight001")  # Linux

# Configure settings
chloros.configure(
    vignette_correction=True,
    reflectance_calibration=True,
    indices=["NDVI", "NDRE", "GNDVI"]
)

# Process images
chloros.process(mode="parallel", wait=True)

---

Οδηγός εγκατάστασης

Προαπαιτούμενα

Πριν εγκαταστήσετε το SDK, βεβαιωθείτε ότι διαθέτετε:

1. Εγκατεστημένο το Chloros — Windows: Πρόγραμμα εγκατάστασης για επιτραπέζιους υπολογιστές (λήψη); Linux: Πακέτο .deb (Εγκατάσταση Linux)

2. Python 3.7+ εγκατεστημένο (python.org)

3. Ενεργή άδεια Chloros+ (αναβάθμιση)

Εγκατάσταση μέσω pip

Τυπική εγκατάσταση:

pip install chloros-sdk

Με υποστήριξη παρακολούθησης προόδου:

pip install chloros-sdk[progress]

Εγκατάσταση ανάπτυξης:

pip install chloros-sdk[dev]

Επαλήθευση εγκατάστασης

Ελέγξτε ότι το SDK έχει εγκατασταθεί σωστά:

import chloros_sdk
print(f"Chloros SDK version: {chloros_sdk.__version__}")

---

Αρχική ρύθμιση

Ενεργοποίηση άδειας χρήσης

Το SDK χρησιμοποιεί την ίδια άδεια χρήσης με τα Chloros, Chloros (Browser) και Chloros CLI. Ενεργοποιήστε μία φορά μέσω του GUI ή του CLI:Windows:Ανοίξτε τοChloros ή το Chloros (Browser) και συνδεθείτε στην καρτέλα ή χρησιμοποιήστε το CLI.Linux: Χρησιμοποιήστε το CLI (δεν διατίθεται GUI):

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

Η άδεια αποθηκεύεται τοπικά και παραμένει ενεργή μετά από επανεκκινήσεις.

Εφάπαξ ρύθμιση: Μετά τη σύνδεση μέσω του GUI ή του CLI, το SDK χρησιμοποιεί αυτόματα την αποθηκευμένη άδεια χρήσης. Δεν απαιτείται επιπλέον έλεγχος ταυτότητας!

Αποσύνδεση: Οι χρήστες του SDK μπορούν να διαγράψουν προγραμματικά τα αποθηκευμένα διαπιστευτήρια χρησιμοποιώντας τη μέθοδο logout(). Δείτε τη μέθοδο logout() στην Αναφορά API.

Δοκιμή σύνδεσης

Επαληθεύστε ότι το SDK μπορεί να συνδεθεί με το Chloros:

from chloros_sdk import ChlorosLocal

# Initialize SDK (auto-starts backend if needed)
chloros = ChlorosLocal()

# Check status
status = chloros.get_status()
print(f"Backend running: {status['running']}")

---

Αναφορά API

Κλάση ChlorosLocal

Κύρια κλάση για τοπική επεξεργασία εικόνων Chloros.

Κατασκευαστής

ChlorosLocal(
    api_url="http://localhost:5000",     # Backend URL
    auto_start_backend=True,             # Auto-start backend if not running
    backend_exe=None,                    # Backend path (auto-detected)
    timeout=30,                          # Request timeout (seconds)
    backend_startup_timeout=60           # Backend startup timeout
)

Παράμετροι:

Παράμετρος	Τύπος	Προεπιλογή	Περιγραφή
api_url	str	"http://localhost:5000"	URL του τοπικού Chloros backend
auto_start_backend	bool	True	Αυτόματη εκκίνηση του backend αν χρειαστεί
backend_exe	str	None (αυτόματη ανίχνευση)	Διαδρομή προς το εκτελέσιμο του backend
timeout	int	30	Χρονικό όριο αιτήματος σε δευτερόλεπτα
backend_startup_timeout	int	60	Χρονικό όριο εκκίνησης backend (δευτερόλεπτα)

Παραδείγματα:

# Default (auto-start backend, auto-detect path on Windows and Linux)
chloros = ChlorosLocal()

# Connect to running backend
chloros = ChlorosLocal(auto_start_backend=False)

# Custom backend path (Windows)
chloros = ChlorosLocal(backend_exe="C:/Custom/chloros-backend.exe")

# Custom backend path (Linux)
chloros = ChlorosLocal(backend_exe="/opt/mapir/chloros/backend/chloros-backend")

# Custom timeout with longer startup (e.g., for Jetson)
chloros = ChlorosLocal(timeout=60, backend_startup_timeout=120)

Αυτόματη ανίχνευση πολλαπλών πλατφορμών: Το SDK δοκιμάζει αυτόματα τη σωστή διαδρομή backend για την πλατφόρμα σας:

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

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

• Linux (χειροκίνητη εγκατάσταση): /opt/mapir/chloros/backend/chloros-backend

---

Μέθοδοι

create_project(project_name, camera=None)

Δημιουργία νέου έργου Chloros.

Παράμετροι:

Παράμετρος	Τύπος	Απαιτείται	Περιγραφή
project_name	str	Ναι	Όνομα για το έργο
camera	str	Όχι	Πρότυπο κάμερας (π.χ., "Survey3N_RGN", "Survey3W_OCN")

Επιστρέφει: dict - Απόκριση δημιουργίας έργουΠαράδειγμα:

# Basic project
chloros.create_project("DroneField_A")

# With camera template
chloros.create_project("DroneField_A", camera="Survey3N_RGN")

---

import_images(folder_path, recursive=False)

Εισαγωγή εικόνων από φάκελο.

Παράμετροι:

Παράμετρος	Τύπος	Απαιτείται	Περιγραφή
folder_path	str/Path	Ναι	Διαδρομή προς φάκελο με εικόνες
recursive	bool	Όχι	Αναζήτηση υποφακέλων (προεπιλογή: False)

Επιστρέφει: dict - Αποτελέσματα εισαγωγής με αριθμό αρχείωνΠαράδειγμα:

# Import from folder
chloros.import_images("C:\\DroneImages\\Flight001")

# Import recursively
chloros.import_images("C:\\DroneImages", recursive=True)

---

configure(**settings)

Διαμόρφωση ρυθμίσεων επεξεργασίας.

Παράμετροι:

Παράμετρος	Τύπος	Προεπιλογή	Περιγραφή
debayer	str	"Standard (Fast, Medium Quality)"	Μέθοδος Debayer
vignette_correction	bool	True	Ενεργοποίηση διόρθωσης βινιέτας
reflectance_calibration	bool	True	Ενεργοποίηση βαθμονόμησης ανακλαστικότητας
indices	list	None	Δείκτες βλάστησης προς υπολογισμό
export_format	str	"TIFF (16-bit)"	Μορφή εξόδου
ppk	bool	False	Ενεργοποίηση διορθώσεων PPK
custom_settings	dict	None	Προηγμένες προσαρμοσμένες ρυθμίσεις

Μορφές εξαγωγής:

• "TIFF (16-bit)" - Συνιστάται για GIS/φωτογραμμετρία

• "TIFF (32-bit, Percent)" - Επιστημονική ανάλυση

• "PNG (8-bit)" - Οπτική επιθεώρηση

• "JPG (8-bit)" - Συμπιεσμένη έξοδος

**Διαθέσιμοι δείκτες:**NDVI, NDRE, GNDVI, OSAVI, CIG, EVI, SAVI, MSAVI, MTVI2, και άλλα.Παράδειγμα:

# Basic configuration
chloros.configure(
    vignette_correction=True,
    reflectance_calibration=True,
    indices=["NDVI", "NDRE"]
)

# Advanced configuration
chloros.configure(
    debayer="Standard (Fast, Medium Quality)",
    vignette_correction=True,
    reflectance_calibration=True,
    ppk=True,
    export_format="TIFF (32-bit, Percent)",
    indices=["NDVI", "NDRE", "GNDVI", "OSAVI", "CIG"]
)

---

process(mode="parallel", wait=True, progress_callback=None)

Επεξεργασία των εικόνων του έργου.

Παράμετροι:

Παράμετρος	Τύπος	Προεπιλογή	Περιγραφή
mode	str	"parallel"	Λειτουργία επεξεργασίας: "parallel" ή "serial"
wait	bool	True	Αναμονή για ολοκλήρωση
progress_callback	callable	None	Συνάρτηση επιστροφής κλήσης προόδου (progress, msg)
poll_interval	float	2.0	Διάστημα ελέγχου για την πρόοδο (δευτερόλεπτα)

Επιστρέφει: dict - Αποτελέσματα επεξεργασίας

Παράλληλη λειτουργία: Απαιτεί άδεια Chloros+. Κλιμακώνεται αυτόματα στους πυρήνες της CPU σας (έως 16 εργαζόμενους).

Παράδειγμα:

# Simple processing
results = chloros.process()

# With progress monitoring
def show_progress(progress, message):
    print(f"[{progress}%] {message}")

chloros.process(
    mode="parallel",
    progress_callback=show_progress,
    wait=True
)

# Fire-and-forget (non-blocking)
chloros.process(wait=False)

---

get_config()

Λήψη της τρέχουσας διαμόρφωσης του έργου.

Επιστρέφει: dict - Τρέχουσα διαμόρφωση έργουΠαράδειγμα:

config = chloros.get_config()
print(config['Project Settings'])

---

get_status()

Λήψη πληροφοριών κατάστασης του backend, συμπεριλαμβανομένης της προόδου επεξεργασίας ανά νήμα.

Επιστρέφει: dict - Κατάσταση του backend με την ακόλουθη δομή:

{
    "running": True,
    "url": "http://localhost:5000",
    "processing": {
        "percent": 75.0,
        "phase": "processing"
    },
    "export": {
        "percent": 50.0,
        "phase": "exporting",
        "active": True
    }
}

Παράδειγμα:

status = chloros.get_status()
print(f"Running: {status['running']}")
print(f"URL: {status['url']}")
print(f"Processing: {status['processing']['percent']}%")
print(f"Export: {status['export']['percent']}% - Active: {status['export']['active']}")

---

shutdown_backend()

Τερματισμός του backend (εάν ξεκίνησε από το SDK).

Παράδειγμα:

chloros.shutdown_backend()

---

logout()

Εκκαθάριση των αποθηκευμένων διαπιστευτηρίων από το τοπικό σύστημα.

Περιγραφή:

Αποσυνδέεται προγραμματικά αφαιρώντας τα αποθηκευμένα διαπιστευτήρια πιστοποίησης. Αυτό είναι χρήσιμο για:

• Εναλλαγή μεταξύ διαφορετικών λογαριασμών Chloros+

• Εκκαθάριση διαπιστευτηρίων σε αυτοματοποιημένα περιβάλλοντα

• Λόγους ασφαλείας (π.χ. αφαίρεση διαπιστευτηρίων πριν από την απεγκατάσταση)

Επιστρέφει: dict - Αποτέλεσμα της λειτουργίας αποσύνδεσηςΠαράδειγμα:

from chloros_sdk import ChlorosLocal

# Initialize SDK
chloros = ChlorosLocal()

# Clear cached credentials
result = chloros.logout()
print(f"Logout successful: {result}")

# After logout, login required via GUI/CLI/Browser before next SDK use

Απαιτείται εκ νέου έλεγχος ταυτότητας: Μετά την κλήση της logout(), πρέπει να συνδεθείτε ξανά μέσω της Chloros, της Chloros (Πρόγραμμα περιήγησης) ή της Chloros CLI πριν χρησιμοποιήσετε την SDK.

---

Λειτουργίες ευκολίας

process_folder(folder_path, **options)

Λειτουργία ευκολίας μίας γραμμής για την επεξεργασία ενός φακέλου.

Παράμετροι:

Παράμετρος	Τύπος	Προεπιλογή	Περιγραφή
folder_path	str/Path	Απαιτείται	Διαδρομή προς φάκελο με εικόνες
project_name	str	Αυτόματη δημιουργία	Όνομα έργου
camera	str	None	Πρότυπο κάμερας
indices	λίστα	["NDVI"]	Δείκτες προς υπολογισμό
vignette_correction	bool	True	Ενεργοποίηση διόρθωσης βινιέτας
reflectance_calibration	bool	True	Ενεργοποίηση βαθμονόμησης ανακλαστικότητας
export_format	str	"TIFF (16-bit)"	Μορφή εξόδου
mode	str	"parallel"	Λειτουργία επεξεργασίας
progress_callback	callable	None	Επιστροφή κλήσης προόδου

Επιστρέφει: dict - Αποτελέσματα επεξεργασίαςΠαράδειγμα:

from chloros_sdk import process_folder

# Simple one-liner
results = process_folder("C:\\DroneImages\\Flight001")

# With custom settings
results = process_folder(
    "C:\\DroneImages\\Flight001",
    project_name="Field_A_Survey",
    camera="Survey3N_RGN",
    indices=["NDVI", "NDRE", "GNDVI"],
    mode="parallel"
)

# With progress monitoring
def show_progress(progress, message):
    print(f"[{progress}%] {message}")

results = process_folder(
    "C:\\DroneImages\\Flight001",
    progress_callback=show_progress
)

---

Υποστήριξη διαχειριστή περιβάλλοντος

Το SDK υποστηρίζει διαχειριστές περιβάλλοντος για αυτόματο καθαρισμό:

from chloros_sdk import ChlorosLocal

# Auto-cleanup when done
with ChlorosLocal() as chloros:
    chloros.create_project("MyProject")
    chloros.import_images("C:\\Images")
    chloros.configure(indices=["NDVI"])
    chloros.process()
# Backend automatically shut down here

---

Πλήρη παραδείγματα

Χρήστες Linux: Όλα τα παρακάτω παραδείγματα χρησιμοποιούν διαδρομές Windows. Αντικαταστήστε τις διαδρομές C:\\... με τις δικές σας διαδρομές Linux (π.χ., /home/user/... ή ~/...). Όλες οι λειτουργίες του SDK είναι πανομοιότυπες σε όλες τις πλατφόρμες.

Παράδειγμα 1: Βασική επεξεργασία

Επεξεργασία φακέλου με τις προεπιλεγμένες ρυθμίσεις:

from chloros_sdk import process_folder

# Process with default settings
results = process_folder("C:\\Datasets\\Field_A_2025_01_15")

print(f"Processing complete: {results}")

---

Παράδειγμα 2: Προσαρμοσμένη ροή εργασίας

Πλήρης έλεγχος της διαδικασίας επεξεργασίας:

from chloros_sdk import ChlorosLocal

# Initialize SDK
chloros = ChlorosLocal()

# Create project with camera template
chloros.create_project("Research_Plot_A", camera="Survey3N_RGN")

# Import images
import_results = chloros.import_images("C:\\Research\\PlotA")
print(f"Imported {len(import_results.get('files', []))} images")

# Configure advanced settings
chloros.configure(
    debayer="Standard (Fast, Medium Quality)",
    vignette_correction=True,
    reflectance_calibration=True,
    ppk=False,
    export_format="TIFF (16-bit)",
    indices=["NDVI", "NDRE", "GNDVI", "OSAVI"]
)

# Process with progress monitoring
def show_progress(progress, message):
    print(f"Progress: {progress}% - {message}")

chloros.process(
    mode="parallel",
    progress_callback=show_progress,
    wait=True
)

print("Processing complete!")

---

Παράδειγμα 3: Μαζική επεξεργασία πολλαπλών φακέλων

Επεξεργασία πολλαπλών συνόλων δεδομένων πτήσεων:

from chloros_sdk import ChlorosLocal
from pathlib import Path

# Initialize SDK once
chloros = ChlorosLocal()

# List of flight folders
flights = [
    "C:\\Datasets\\Flight_001",
    "C:\\Datasets\\Flight_002",
    "C:\\Datasets\\Flight_003"
]

for flight_path in flights:
    flight_name = Path(flight_path).name
    print(f"\n{'='*60}")
    print(f"Processing: {flight_name}")
    print('='*60)
    
    try:
        # Create project
        chloros.create_project(flight_name, camera="Survey3N_RGN")
        
        # Import images
        chloros.import_images(flight_path)
        
        # Configure
        chloros.configure(
            vignette_correction=True,
            reflectance_calibration=True,
            indices=["NDVI", "NDRE", "GNDVI"]
        )
        
        # Process
        chloros.process(mode="parallel", wait=True)
        
        print(f"✓ {flight_name} completed successfully")
    
    except Exception as e:
        print(f"✗ {flight_name} failed: {e}")

print("\n" + "="*60)
print("All flights processed!")

---

Παράδειγμα 4: Ενσωμάτωση στη ροή εργασίας έρευνας

Ενσωμάτωση του Chloros στην ανάλυση δεδομένων:

from chloros_sdk import ChlorosLocal
import pandas as pd
import matplotlib.pyplot as plt

# Initialize Chloros
chloros = ChlorosLocal()

# Field survey data
surveys = [
    {"name": "Plot_A", "folder": "C:\\Research\\PlotA", "biomass": 4500},
    {"name": "Plot_B", "folder": "C:\\Research\\PlotB", "biomass": 3800},
    {"name": "Plot_C", "folder": "C:\\Research\\PlotC", "biomass": 5200}
]

results = []

for survey in surveys:
    # Process with Chloros
    chloros.create_project(survey['name'])
    chloros.import_images(survey['folder'])
    chloros.configure(indices=["NDVI", "NDRE"])
    chloros.process(mode="parallel", wait=True)
    
    # Get results
    config = chloros.get_config()
    
    # Extract NDVI values (example - adjust based on your needs)
    # In real implementation, you would read the processed TIFF files
    
    results.append({
        'plot': survey['name'],
        'biomass': survey['biomass'],
        # Add your NDVI extraction here
    })

# Statistical analysis
df = pd.DataFrame(results)
print("\nResults:")
print(df)

# Create correlation plot
# plt.scatter(df['ndvi'], df['biomass'])
# plt.xlabel('NDVI')
# plt.ylabel('Biomass (kg/ha)')
# plt.title('NDVI vs Biomass Correlation')
# plt.show()

---

Παράδειγμα 5: Προσαρμοσμένη παρακολούθηση προόδου

Προηγμένη παρακολούθηση προόδου με καταγραφή:

from chloros_sdk import ChlorosLocal
from datetime import datetime
import logging

# Setup logging
logging.basicConfig(
    filename=f'processing_{datetime.now():%Y%m%d_%H%M%S}.log',
    level=logging.INFO,
    format='%(asctime)s - %(message)s'
)

# Progress callback with logging
def log_progress(progress, message):
    log_msg = f"[{progress}%] {message}"
    logging.info(log_msg)
    print(log_msg)

# Process with logging
chloros = ChlorosLocal()
chloros.create_project("LoggedProcess")
chloros.import_images("C:\\DroneImages")
chloros.configure(indices=["NDVI", "NDRE"])

logging.info("Starting processing...")
chloros.process(
    mode="parallel",
    progress_callback=log_progress,
    wait=True
)
logging.info("Processing complete!")

---

Παράδειγμα 6: Διαχείριση σφαλμάτων

Αξιόπιστη διαχείριση σφαλμάτων για χρήση σε περιβάλλον παραγωγής:

from chloros_sdk import ChlorosLocal
from chloros_sdk.exceptions import (
    ChlorosError,
    ChlorosBackendError,
    ChlorosLicenseError,
    ChlorosProcessingError
)

def process_safely(folder_path):
    """Process with comprehensive error handling"""
    try:
        with ChlorosLocal() as chloros:
            chloros.create_project("SafeProcess")
            chloros.import_images(folder_path)
            chloros.configure(indices=["NDVI"])
            chloros.process()
            
        return True, "Success"
    
    except ChlorosLicenseError as e:
        return False, f"License error: {e}. Upgrade to Chloros+ at cloud.mapir.camera/pricing"
    
    except ChlorosBackendError as e:
        return False, f"Backend error: {e}. Ensure Chloros is installed (Windows installer or Linux .deb package)."
    
    except ChlorosProcessingError as e:
        return False, f"Processing error: {e}"
    
    except FileNotFoundError as e:
        return False, f"Folder not found: {e}"
    
    except ChlorosError as e:
        return False, f"Chloros error: {e}"
    
    except Exception as e:
        return False, f"Unexpected error: {e}"

# Use the safe function
success, message = process_safely("C:\\DroneImages\\Flight001")
if success:
    print(f"✓ {message}")
else:
    print(f"✗ {message}")

---

Παράδειγμα 7: Διαχείριση λογαριασμού και αποσύνδεση

Διαχείριση διαπιστευτηρίων μέσω προγραμματισμού:

from chloros_sdk import ChlorosLocal

def switch_account():
    """Clear credentials to switch to a different account"""
    try:
        chloros = ChlorosLocal()
        
        # Clear current credentials
        result = chloros.logout()
        print("✓ Credentials cleared successfully")
        print("Please log in with new account via Chloros, Chloros (Browser), or CLI")
        
        return True
    
    except Exception as e:
        print(f"✗ Logout failed: {e}")
        return False

def secure_cleanup():
    """Remove credentials for security purposes"""
    try:
        chloros = ChlorosLocal()
        chloros.logout()
        print("✓ Credentials removed for security")
        
    except Exception as e:
        print(f"Warning: Cleanup error: {e}")

# Switch accounts
if switch_account():
    print("\nRe-authenticate via Chloros GUI/CLI/Browser before next SDK use")

# Or perform secure cleanup
# secure_cleanup()

---

Παράδειγμα 8: Εργαλείο γραμμής εντολών

Δημιουργία προσαρμοσμένου εργαλείου CLI με το SDK:

#!/usr/bin/env python
"""
Custom Chloros CLI Tool
Process multiple folders from command line
"""

import sys
import argparse
from pathlib import Path
from chloros_sdk import process_folder

def main():
    parser = argparse.ArgumentParser(description='Custom Chloros Processor')
    parser.add_argument('folders', nargs='+', help='Folders to process')
    parser.add_argument('--indices', nargs='+', default=['NDVI'],
                       help='Indices to calculate (default: NDVI)')
    parser.add_argument('--camera', default=None,
                       help='Camera template')
    parser.add_argument('--format', default='TIFF (16-bit)',
                       help='Export format')
    parser.add_argument('--logout', action='store_true',
                       help='Clear cached credentials before processing')
    
    args = parser.parse_args()
    
    # Handle logout if requested
    if args.logout:
        from chloros_sdk import ChlorosLocal
        chloros = ChlorosLocal()
        chloros.logout()
        print("Credentials cleared. Please re-login via Chloros GUI/CLI/Browser.")
        return 0
    
    successful = []
    failed = []
    
    for folder in args.folders:
        folder_path = Path(folder)
        
        if not folder_path.exists():
            print(f"✗ Skipping {folder}: not found")
            failed.append(folder)
            continue
        
        print(f"\nProcessing: {folder_path.name}...")
        
        try:
            process_folder(
                folder_path,
                camera=args.camera,
                indices=args.indices,
                export_format=args.format
            )
            print(f"✓ {folder_path.name} complete")
            successful.append(folder)
        
        except Exception as e:
            print(f"✗ {folder_path.name} failed: {e}")
            failed.append(folder)
    
    # Summary
    print(f"\n{'='*60}")
    print(f"Summary: {len(successful)} successful, {len(failed)} failed")
    
    return 0 if not failed else 1

if __name__ == '__main__':
    sys.exit(main())

Χρήση:

# Process multiple folders
python my_processor.py "C:\Flight001" "C:\Flight002" --indices NDVI NDRE GNDVI

# Clear cached credentials
python my_processor.py --logout

---

Χειρισμός εξαιρέσεων

Το SDK παρέχει συγκεκριμένες κλάσεις εξαιρέσεων για διαφορετικούς τύπους σφαλμάτων:

Ιεραρχία εξαιρέσεων

ChlorosError                    # Base exception
├── ChlorosBackendError        # Backend startup/connection issues
├── ChlorosLicenseError        # License validation issues
├── ChlorosConnectionError     # Network/connection failures
├── ChlorosProcessingError     # Image processing failures
├── ChlorosAuthenticationError # Authentication failures
└── ChlorosConfigurationError  # Configuration errors

Παραδείγματα εξαιρέσεων

from chloros_sdk import ChlorosLocal
from chloros_sdk.exceptions import *

try:
    chloros = ChlorosLocal()
    chloros.process()

except ChlorosLicenseError:
    print("Chloros+ license required. Upgrade at cloud.mapir.camera/pricing")

except ChlorosBackendError:
    print("Backend failed to start. Ensure Chloros is installed (Windows installer or Linux .deb package).")

except ChlorosProcessingError as e:
    print(f"Processing failed: {e}")

except ChlorosError as e:
    print(f"General Chloros error: {e}")

---

Προχωρημένα θέματα

Προσαρμοσμένη διαμόρφωση backend

Χρησιμοποιήστε μια προσαρμοσμένη θέση ή διαμόρφωση backend:

chloros = ChlorosLocal(
    backend_exe="C:\\Custom\\chloros-backend.exe",
    api_url="http://localhost:5001",  # Custom port
    timeout=60,                        # Longer timeout
    backend_startup_timeout=120        # 2 minutes startup
)

Επεξεργασία χωρίς μπλοκάρισμα

Ξεκινήστε την επεξεργασία και συνεχίστε με άλλες εργασίες:

# Start processing (non-blocking)
chloros.process(wait=False)

# Do other work here...
print("Processing started in background...")

# Check status later
import time
while True:
    status = chloros.get_config()
    if status.get('processing_complete'):
        break
    time.sleep(5)

print("Processing complete!")

Διαχείριση μνήμης

Για μεγάλα σύνολα δεδομένων, επεξεργαστείτε τα κατά παρτίδες:

from pathlib import Path

base_folder = Path("C:\\LargeDataset")
batch_size = 100

# Get all image files
images = list(base_folder.glob("*.RAW"))

# Process in batches
for i in range(0, len(images), batch_size):
    batch = images[i:i+batch_size]
    batch_folder = base_folder / f"batch_{i//batch_size}"
    
    # Create batch folder and move images
    # ... (implementation details)
    
    # Process batch
    process_folder(batch_folder)

---

Αντιμετώπιση προβλημάτων

Το backend δεν ξεκινά

Πρόβλημα: Το SDK δεν ξεκινά το backendΛύσεις:

1. Βεβαιωθείτε ότι το Chloros είναι εγκατεστημένο:

import os
import platform

# Auto-detect backend path
if platform.system() == "Windows":
    backend_path = r"C:\Program Files\MAPIR\Chloros\resources\backend\chloros-backend.exe"
else:
    backend_path = "/usr/lib/chloros/chloros-backend"

print(f"Backend exists: {os.path.exists(backend_path)}")

1. Ελέγξτε το τείχος προστασίας (Windows) ή τη διαθεσιμότητα της θύρας (Linux: lsof -i :5000)

2. Δοκιμάστε τη διαδρομή του backend χειροκίνητα:

# Windows
chloros = ChlorosLocal(backend_exe="C:\\Path\\To\\chloros-backend.exe")

# Linux
chloros = ChlorosLocal(backend_exe="/opt/mapir/chloros/backend/chloros-backend")

---

Δεν εντοπίστηκε άδεια χρήσηςΠρόβλημα: Το SDK προειδοποιεί για έλλειψη άδειας χρήσηςΛύσεις:

1. Ανοίξτε το Chloros, το Chloros (Πρόγραμμα περιήγησης) ή Chloros CLI και συνδεθείτε.

2. Βεβαιωθείτε ότι η άδεια χρήσης έχει αποθηκευτεί στην προσωρινή μνήμη:

from pathlib import Path
import os
import platform

# Check cache location
if platform.system() == "Windows":
    cache_path = Path(os.getenv('APPDATA')) / 'Chloros' / 'cache'
else:
    cache_path = Path.home() / '.cache' / 'chloros'

print(f"Cache exists: {cache_path.exists()}")

1. Εάν αντιμετωπίζετε προβλήματα με τα διαπιστευτήρια, διαγράψτε τα αποθηκευμένα διαπιστευτήρια και συνδεθείτε ξανά:

from chloros_sdk import ChlorosLocal

# Clear cached credentials
chloros = ChlorosLocal()
chloros.logout()

# Then login again via Chloros, Chloros (Browser), or Chloros CLI

1. Επικοινωνήστε με την υποστήριξη: [e-mail]

---

Σφάλματα εισαγωγήςΠρόβλημα: ModuleNotFoundError: No module named 'chloros_sdk'Λύσεις:

# Verify installation
pip show chloros-sdk

# Reinstall if needed
pip uninstall chloros-sdk
pip install chloros-sdk

# Check Python environment
python -c "import sys; print(sys.path)"

---

Χρονικό όριο επεξεργασίαςΠρόβλημα: Χρονικό όριο επεξεργασίαςΛύσεις:

1. Αυξήστε το χρονικό όριο:

chloros = ChlorosLocal(timeout=120)  # 2 minutes

1. Επεξεργαστείτε μικρότερες παρτίδες

2. Ελέγξτε τον διαθέσιμο χώρο στο δίσκο

3. Παρακολουθήστε τους πόρους του συστήματος

---

Η θύρα χρησιμοποιείται ήδηΠρόβλημα: Η θύρα 5000 του backend είναι κατειλημμένηΛύσεις:

# Use different port
chloros = ChlorosLocal(api_url="http://localhost:5001")

Ή εντοπίστε και κλείστε τη διεργασία που προκαλεί τη σύγκρουση:

# Windows PowerShell
Get-NetTCPConnection -LocalPort 5000

# Linux
lsof -i :5000
kill $(lsof -t -i :5000)

---

Συμβουλές απόδοσης

Βελτιστοποίηση ταχύτητας επεξεργασίας

1. Χρησιμοποιήστε παράλληλη λειτουργία (απαιτείται Chloros+)

chloros.process(mode="parallel")  # Up to 16 workers

1. Μειώστε την ανάλυση εξόδου (εάν είναι αποδεκτό)

chloros.configure(export_format="PNG (8-bit)")  # Faster than TIFF

1. Απενεργοποιήστε περιττούς δείκτες

# Only calculate needed indices
chloros.configure(indices=["NDVI"])  # Not all indices

1. Επεξεργασία σε SSD (όχι σε HDD)***

Βελτιστοποίηση μνήμης

Για μεγάλα σύνολα δεδομένων:

# Process in batches instead of all at once
# See "Memory Management" in Advanced Topics

---

Επεξεργασία στο παρασκήνιο

Απελευθερώστε Python για άλλες εργασίες:

chloros.process(wait=False)  # Non-blocking

# Continue with other work
# ...

---

Παραδείγματα ενσωμάτωσης

Ενσωμάτωση Django

# views.py
from django.http import JsonResponse
from chloros_sdk import process_folder

def process_images_view(request):
    if request.method == 'POST':
        folder_path = request.POST.get('folder_path')
        
        try:
            results = process_folder(folder_path)
            return JsonResponse({'success': True, 'results': results})
        except Exception as e:
            return JsonResponse({'success': False, 'error': str(e)})

Flask API

# app.py
from flask import Flask, request, jsonify
from chloros_sdk import process_folder

app = Flask(__name__)

@app.route('/api/process', methods=['POST'])
def process():
    data = request.get_json()
    folder_path = data.get('folder_path')
    
    try:
        results = process_folder(folder_path)
        return jsonify({'success': True, 'results': results})
    except Exception as e:
        return jsonify({'success': False, 'error': str(e)}), 500

if __name__ == '__main__':
    app.run()

Jupyter Notebook

# notebook.ipynb
from chloros_sdk import ChlorosLocal
import matplotlib.pyplot as plt

# Initialize
chloros = ChlorosLocal()

# Process
chloros.create_project("JupyterTest")
chloros.import_images("C:\\Data")
chloros.configure(indices=["NDVI"])

# Progress in notebook
from IPython.display import clear_output

def notebook_progress(progress, message):
    clear_output(wait=True)
    print(f"Progress: {progress}%")
    print(message)

chloros.process(progress_callback=notebook_progress)

# Visualize results
# ... (your visualization code)

---

Συχνές ερωτήσεις

Ε: Το SDK απαιτεί σύνδεση στο διαδίκτυο;

Α: Μόνο για την αρχική ενεργοποίηση της άδειας χρήσης. Αφού συνδεθείτε μέσω του Chloros, του Chloros (Browser) ή του Chloros CLI, η άδεια αποθηκεύεται τοπικά και λειτουργεί εκτός σύνδεσης για 30 ημέρες.***

Ε: Μπορώ να χρησιμοποιήσω το SDK σε διακομιστή χωρίς GUI;Α: Ναι! Το SDK λειτουργεί χωρίς οθόνη τόσο σε διακομιστές Windows όσο και Linux.Linux (συνιστάται για χρήση χωρίς οθόνη):

• Εγκατάσταση μέσω του πακέτου .deb

• Ενεργοποίηση άδειας χρήσης: chloros-cli login [e-mail] 'password'

Διακομιστής Windows:

• Διακομιστής Windows 2016 ή νεότερη έκδοση

• Εγκατεστημένο το Chloros (μία φορά)

• Άδεια ενεργοποιημένη μέσω CLI ή σε οποιονδήποτε υπολογιστή

---

Ε: Ποια είναι η διαφορά μεταξύ Desktop, CLI και SDK;

Λειτουργία	Desktop GUI	CLI Γραμμή εντολών	Python SDK
Διεπαφή	Σημείο-κλικ	Εντολή	Python API
Κατάλληλο για	Οπτική εργασία	Σενάρια	Ενσωμάτωση
Αυτοματοποίηση	Περιορισμένη	Καλή	Εξαιρετική
Ευελιξία	Βασική	Καλή	Μέγιστη
Άδεια χρήσης	Chloros+	Chloros+	Chloros+

Ε: Μπορώ να διανέμω εφαρμογές που έχουν δημιουργηθεί με το SDK;Α: Ο κώδικας SDK μπορεί να ενσωματωθεί στις εφαρμογές σας, αλλά:

• Οι τελικοί χρήστες πρέπει να έχουν εγκατεστημένο το Chloros

• Οι τελικοί χρήστες πρέπει να διαθέτουν ενεργές άδειες Chloros+

• Η εμπορική διανομή απαιτεί άδεια OEM

Επικοινωνήστε με το [e-mail] για ερωτήσεις σχετικά με το OEM.

---

Ε: Πώς μπορώ να ενημερώσω το SDK;

pip install --upgrade chloros-sdk

---

Ε: Πού αποθηκεύονται οι επεξεργασμένες εικόνες;

Από προεπιλογή, στη Διαδρομή Έργου :

Project_Path/
└── MyProject/
    └── Survey3N_RGN/          # Processed outputs

---

Ε: Μπορώ να επεξεργαστώ εικόνες από σενάρια Python που εκτελούνται σύμφωνα με χρονοδιάγραμμα;Α: Ναι! Χρησιμοποιήστε τον προγραμματιστή του λειτουργικού σας συστήματος με σενάρια Python:

# scheduled_processing.py
from chloros_sdk import process_folder

# Process today's flights
results = process_folder("/data/flights/today")  # Linux
# results = process_folder("C:\\Flights\\Today")  # Windows

Windows: Προγραμματίστε μέσω του Task Scheduler για καθημερινή εκτέλεση.Linux: Προγραμματίστε μέσω cron:

# Run at 2 AM daily
0 2 * ** /usr/bin/python3 /home/user/scheduled_processing.py >> /var/log/chloros.log 2>&1

---

Ε: Υποστηρίζει το SDK async/await;Α: Η τρέχουσα έκδοση είναι σύγχρονη. Για ασύγχρονη συμπεριφορά, χρησιμοποιήστε το wait=False ή εκτελέστε το σε ξεχωριστό νήμα:

import threading

def process_thread():
    chloros.process()

thread = threading.Thread(target=process_thread)
thread.start()

# Continue with other work...

---

Ε: Πώς μπορώ να εναλλάσσω διαφορετικούς λογαριασμούς Chloros+;Α: Χρησιμοποιήστε τη μέθοδο logout() για να διαγράψετε τα αποθηκευμένα διαπιστευτήρια και, στη συνέχεια, συνδεθείτε ξανά με τον νέο λογαριασμό:

from chloros_sdk import ChlorosLocal

# Clear current credentials
chloros = ChlorosLocal()
chloros.logout()

# Re-login via Chloros, Chloros (Browser), or Chloros CLI with new account

Μετά την αποσύνδεση, πιστοποιηθείτε με τον νέο λογαριασμό μέσω του GUI, του προγράμματος περιήγησης ή του CLI πριν χρησιμοποιήσετε ξανά το SDK.

---

Λήψη βοήθειας

Τεκμηρίωση

• Αναφορά API: Αυτή η σελίδα

Κανάλια υποστήριξης

• Email: [e-mail]

• Ιστότοπος: https://www.mapir.camera/community/contact

• Τιμές: https://cloud.mapir.camera/pricing

Δείγματα κώδικα

Όλα τα παραδείγματα που αναφέρονται εδώ έχουν δοκιμαστεί και είναι έτοιμα για παραγωγή. Αντιγράψτε τα και προσαρμόστε τα για τη δική σας περίπτωση χρήσης.

---

Άδεια χρήσηςΙδιόκτητο λογισμικό - Πνευματικά δικαιώματα (c) 2025 MAPIR Inc.

Το SDK απαιτεί ενεργή συνδρομή Chloros+. Απαγορεύεται η μη εξουσιοδοτημένη χρήση, διανομή ή τροποποίηση.