API : Python SDK

Chloros Python SDK ให้การเข้าถึงโปรแกรมประมวลผลภาพ Chloros ซึ่งช่วยให้ทำงานอัตโนมัติ เวิร์กโฟลว์แบบกำหนดเอง และการผสานรวมที่ราบรื่นกับแอปพลิเคชัน Python และไปป์ไลน์การวิจัยของคุณ

คุณสมบัติที่สำคัญ

• 🐍 Native Python - สะอาด, Pythonic API สำหรับการประมวลผลภาพ

• ???? การเข้าถึง API แบบเต็ม - ควบคุมการประมวลผล Chloros ได้อย่างสมบูรณ์

• 🚀 ระบบอัตโนมัติ - สร้างเวิร์กโฟลว์การประมวลผลแบบแบตช์แบบกำหนดเอง

• 🔗 บูรณาการ - ฝัง Chloros ในแอปพลิเคชัน Python ที่มีอยู่

• 📊 พร้อมการวิจัย - เหมาะสำหรับไปป์ไลน์การวิเคราะห์ทางวิทยาศาสตร์

• ⚡ การประมวลผลแบบขนาน - ปรับขนาดตามคอร์ CPU ของคุณ (Chloros+)

ความต้องการ

• ข้อกำหนด - รายละเอียด -

---

• Chloros เดสก์ท็อป - จะต้องติดตั้งในเครื่อง -

• ใบอนุญาต - Chloros+ (ต้องใช้แผนการชำระเงิน) -

• ระบบปฏิบัติการ - Windows 10/11 (64 บิต) -

• Python - Python 3.7 หรือสูงกว่า -

• ความทรงจำ - RAM ขั้นต่ำ 8GB (แนะนำ 16GB) -

• อินเตอร์เน็ต - จำเป็นสำหรับการเปิดใช้งานใบอนุญาต -

{% คำใบ้สไตล์ = "คำเตือน" %}

ข้อกำหนดสิทธิ์การใช้งาน: Python SDK ต้องการการสมัครสมาชิก Chloros+ แบบชำระเงินสำหรับการเข้าถึง API แผนมาตรฐาน (ฟรี) ไม่มีการเข้าถึง API/SDK ไปที่ https://cloud.mapir.camera/pricing เพื่ออัปเกรด

เริ่มต้นอย่างรวดเร็ว

การติดตั้ง

ติดตั้งผ่าน pip:

pip install chloros-sdk

การตั้งค่าครั้งแรก: ก่อนใช้ SDK ให้เปิดใช้งานใบอนุญาต Chloros+ ของคุณโดยเปิด Chloros, Chloros (เบราว์เซอร์) หรือ Chloros CLI และเข้าสู่ระบบด้วยข้อมูลประจำตัวของคุณ ต้องทำเพียงครั้งเดียวเท่านั้น

การใช้งานพื้นฐาน

ประมวลผลโฟลเดอร์ที่มีเพียงไม่กี่บรรทัด:

from chloros_sdk import process_folder

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

ควบคุมเต็มรูปแบบ

สำหรับขั้นตอนการทำงานขั้นสูง:

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

# 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 Desktop ติดตั้งแล้ว (ดาวน์โหลด)

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 (เบราว์เซอร์) และ Chloros CLI เปิดใช้งานครั้งเดียวผ่าน GUI หรือ CLI:

1. เปิด Chloros หรือ Chloros (เบราว์เซอร์)และเข้าสู่ระบบในแท็บผู้ใช้ หรือเปิดCLI

2. ป้อนข้อมูลประจำตัว Chloros+ ของคุณแล้วเข้าสู่ระบบ

3. ใบอนุญาตถูกแคชไว้ในเครื่อง (ยังคงมีอยู่ตลอดการรีบูต)

การตั้งค่าครั้งเดียว: หลังจากเข้าสู่ระบบผ่าน GUI หรือ CLI แล้ว SDK จะใช้สิทธิ์การใช้งานที่แคชไว้โดยอัตโนมัติ ไม่จำเป็นต้องมีการรับรองความถูกต้องเพิ่มเติม!

ออกจากระบบ: ผู้ใช้ SDK สามารถล้างข้อมูลรับรองแคชโดยทางโปรแกรมโดยใช้วิธี 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 อ้างอิง

คลอรอสคลาสท้องถิ่น

คลาสหลักสำหรับการประมวลผลภาพ 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 ในเครื่อง

• auto_start_backend - บูล - True - เริ่มแบ็กเอนด์โดยอัตโนมัติหากจำเป็น -

• backend_exe - STR - None (ตรวจจับอัตโนมัติ) - เส้นทางไปยังไฟล์ปฏิบัติการแบ็กเอนด์ -

• timeout - อินท์ - 30 - ขอหมดเวลาเป็นวินาที -

• backend_startup_timeout - อินท์ - 60 - หมดเวลาสำหรับการเริ่มต้นแบ็กเอนด์ (วินาที) -

ตัวอย่าง:

# Default (auto-start backend)
chloros = ChlorosLocal()

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

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

# Custom timeout
chloros = ChlorosLocal(timeout=60)

วิธีการ

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/เส้นทาง - ใช่ - เส้นทางไปยังโฟลเดอร์ที่มีรูปภาพ -

• recursive - บูล - ไม่ - ค้นหาโฟลเดอร์ย่อย (ค่าเริ่มต้น: False) -

การส่งคืน: dict - นำเข้าผลลัพธ์พร้อมจำนวนไฟล์ตัวอย่าง:

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

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

configure(**settings)

กำหนดการตั้งค่าการประมวลผล

พารามิเตอร์:

• พารามิเตอร์ - พิมพ์ - ค่าเริ่มต้น - คำอธิบาย -

---

• debayer - STR - "คุณภาพสูง (เร็วขึ้น)" - วิธีการ Debayer -

• vignette_correction - บูล - True - เปิดใช้งานการแก้ไขบทความสั้น -

• reflectance_calibration - บูล - True - เปิดใช้งานการปรับเทียบการสะท้อนแสง -

• indices - รายการ - None - ดัชนีพืชพรรณที่จะคำนวณ -

• export_format - STR - "TIFF (16 บิต)" - รูปแบบเอาต์พุต -

• ppk - บูล - False - เปิดใช้งานการแก้ไข PPK -

• custom_settings - คำสั่ง - 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="High Quality (Faster)",
    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" - โหมดการประมวลผล: "ขนาน" หรือ "อนุกรม" -

• wait - บูล - True - รอให้เสร็จสิ้น -

• progress_callback - โทรได้ - None - ฟังก์ชั่นการเรียกกลับความคืบหน้า (ความคืบหน้า, msg) -

• poll_interval - ลอย - 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()

รับข้อมูลสถานะแบ็กเอนด์

การส่งคืน: dict - สถานะแบ็กเอนด์ตัวอย่าง:

status = chloros.get_status()
print(f"Running: {status['running']}")
print(f"URL: {status['url']}")

shutdown_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/เส้นทาง - จำเป็น - เส้นทางไปยังโฟลเดอร์ที่มีรูปภาพ -

• project_name - STR - สร้างอัตโนมัติ - ชื่อโครงการ -

• camera - STR - None - แม่แบบกล้อง -

• indices - รายการ - ["NDVI"] - ดัชนีที่จะคำนวณ -

• vignette_correction - บูล - True - เปิดใช้งานการแก้ไขบทความสั้น -

• reflectance_calibration - บูล - True - เปิดใช้งานการปรับเทียบการสะท้อนแสง -

• export_format - STR - "TIFF (16 บิต)" - รูปแบบเอาต์พุต -

• mode - STR - "parallel" - โหมดการประมวลผล -

• progress_callback - โทรได้ - 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

ตัวอย่างที่สมบูรณ์

ตัวอย่างที่ 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="High Quality (Faster)",
    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 Desktop is installed."
    
    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 Desktop is installed.")

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

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

หัวข้อขั้นสูง

การกำหนดค่าแบ็กเอนด์ที่กำหนดเอง

ใช้ตำแหน่งหรือการกำหนดค่าแบ็กเอนด์ที่กำหนดเอง:

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)

การแก้ไขปัญหา

แบ็กเอนด์ไม่เริ่มต้น

ปัญหา: SDK ไม่สามารถเริ่มแบ็กเอนด์ได้แนวทางแก้ไข:

1. ตรวจสอบว่าติดตั้ง Chloros Desktop แล้ว:

import os
backend_path = r"C:\Program Files\MAPIR\Chloros\resources\backend\chloros-backend.exe"
print(f"Backend exists: {os.path.exists(backend_path)}")

1. ตรวจสอบว่าไฟร์วอลล์ Windows ไม่ได้บล็อกอยู่

2. ลองใช้เส้นทางแบ็กเอนด์ด้วยตนเอง:

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

ตรวจไม่พบใบอนุญาต

ปัญหา: SDK เตือนเกี่ยวกับใบอนุญาตที่ขาดหายไปแนวทางแก้ไข:

1. เปิด Chloros, Chloros (เบราว์เซอร์) หรือ Chloros CLI และเข้าสู่ระบบ

2. ตรวจสอบว่าใบอนุญาตถูกแคชไว้:

from pathlib import Path
import os

# Check cache location (Windows)
cache_path = Path(os.getenv('APPDATA')) / 'Chloros' / 'cache'
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 ถูกครอบครองแนวทางแก้ไข:

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

หรือค้นหาและปิดกระบวนการที่ขัดแย้งกัน:

# PowerShell
Get-NetTCPConnection -LocalPort 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)})

กระติกน้ำ 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()

สมุดบันทึกจูปีเตอร์

# 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 จำเป็นต้องเชื่อมต่ออินเทอร์เน็ตหรือไม่

A: สำหรับการเปิดใช้งานใบอนุญาตครั้งแรกเท่านั้น หลังจากเข้าสู่ระบบผ่าน Chloros, Chloros (เบราว์เซอร์) หรือ Chloros CLI ใบอนุญาตจะถูกแคชในเครื่องและทำงานแบบออฟไลน์เป็นเวลา 30 วัน

ถาม: ฉันสามารถใช้ SDK บนเซิร์ฟเวอร์ที่ไม่มี GUI ได้หรือไม่

**ก. ใช่! ความต้องการ:

• Windows เซิร์ฟเวอร์ 2016 หรือใหม่กว่า

• Chloros ติดตั้งแล้ว (ครั้งเดียว)

• ใบอนุญาตเปิดใช้งานบนเครื่องใด ๆ (ใบอนุญาตแคชคัดลอกไปยังเซิร์ฟเวอร์)

ถาม: เดสก์ท็อป, CLI และ SDK แตกต่างกันอย่างไร

• คุณสมบัติ - 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 ที่ทำงานตามกำหนดเวลาได้หรือไม่

**ก. ใช่! ใช้ Windows Task Scheduler กับสคริปต์ Python:

# scheduled_processing.py
from chloros_sdk import process_folder

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

กำหนดเวลาผ่าน Task Scheduler เพื่อให้ทำงานทุกวัน

ถาม: SDK รองรับ async/await หรือไม่

A: เวอร์ชันปัจจุบันเป็นแบบซิงโครนัส สำหรับการทำงานแบบอะซิงก์ ให้ใช้ wait=False หรือรันในเธรดแยกกัน:

import threading

def process_thread():
    chloros.process()

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

# Continue with other work...

ถาม: ฉันจะสลับระหว่างบัญชี Chloros+ ที่แตกต่างกันได้อย่างไร

A: ใช้วิธี 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 อ้างอิง: หน้านี้

ช่องทางการสนับสนุน

• อีเมล์: [e-mail]

• เว็บไซต์: https://www.mapir.camera/community/contact

• ราคา: https://cloud.mapir.camera/pricing

โค้ดตัวอย่าง

ตัวอย่างทั้งหมดที่แสดงไว้ที่นี่ได้รับการทดสอบและพร้อมสำหรับการผลิต คัดลอกและปรับใช้ให้เหมาะกับกรณีการใช้งานของคุณ

ใบอนุญาต

ซอฟต์แวร์ที่เป็นกรรมสิทธิ์ - ลิขสิทธิ์ (c) 2025 MAPIR Inc.

SDK จำเป็นต้องมีการสมัครสมาชิก Chloros+ ที่ใช้งานอยู่ ห้ามใช้ แจกจ่าย หรือดัดแปลงโดยไม่ได้รับอนุญาต