.. EAGLE documentation master file

EAGLE - Earth AI Gateway for Land Evaluation
=============================================

Welcome to the Destination Earth EAGLE platform documentation. EAGLE is the Geospatial Processing Platform designed as the Earth AI Gateway for Land Evaluation, a specialized tool for professional geospatial and environmental analysis.

.. image:: https://img.shields.io/badge/version-v1.1-blue
   :alt: Version

.. image:: https://img.shields.io/badge/status-production-green
   :alt: Status

Overview
--------

The EAGLE service harnesses the power of satellite imagery and advanced Artificial Intelligence (AI) models to analyze land suitability for specific, high-impact applications, including agriculture and photovoltaic (solar panel) installations. The platform provides a streamlined interface to process complex geospatial data with efficiency and ease.

Core Platform Capabilities
---------------------------

The Eagle service is built upon a clear, three-stage conceptual methodology:

* **Satellite Analysis**: Access and process real-time satellite imagery and measurements, serving as the foundational data source for analysis.
* **AI Models**: Leverage a suite of advanced sustainability analysis and predictive models that transform raw satellite data into specialized, thematic insights.
* **Detailed Reports**: Generate comprehensive reports with statistical summaries, key metrics, and visual results for decision-making and research.

Available AI Models
-------------------

EAGLE offers specialized AI models for various geospatial analysis tasks:

* **Semantic Segmentation**: Classify land cover into categories (vegetation, water, buildings, etc.)
* **Change Detection**: Detect changes between time periods (deforestation, urbanization, etc.)
* **Solar Panel Detection**: Identify existing solar panel installations in the area
* **Water Detection**: Detect and map water bodies (lakes, rivers, wetlands, floods)

Project-Based Workflow
-----------------------

All work within Eagle is managed through a "Project-Based Workflow":

* **Project**: The highest-level container to organize a specific initiative, research question, or geographical region
* **Process**: A specific analysis task run within a Project. A single Project can contain multiple Processes

This hierarchical model (User → Project → Process) is fundamental to the platform's design.

Documentation Sections
----------------------

.. toctree::
   :maxdepth: 3
   :caption: Contents:

   user_manual
   support

Quick Start Guide
-----------------

To start using EAGLE:

1. **Sign In**: Access the platform through the Destination Earth authentication service
2. **Create a Project**: Set up a new project container for your analysis work
3. **Define Area of Interest**: Draw polygons on the interactive map interface
4. **Select Analysis Model**: Choose the appropriate AI model for your needs
5. **Configure Parameters**: Set analysis-specific parameters (dates, thresholds, etc.)
6. **Run Process**: Execute the analysis and monitor progress
7. **Review Results**: Explore metrics, visualizations, and export reports

License
-------

Copyright © 2025 Destination Earth. All rights reserved.

Indices and tables
==================

* :ref:`genindex`
* :ref:`modindex`
* :ref:`search`