# Aurora GIS Documentation

Welcome to the Aurora GIS documentation. Aurora GIS is a comprehensive PHP-based web application for managing, analyzing, and visualizing geospatial data using PostgreSQL and PostGIS.

## Overview

Aurora GIS provides a complete solution for:

- **Data Management**: Upload, import, and manage spatial datasets in multiple formats
- **Spatial Analysis**: Perform advanced geospatial analysis including hotspot detection, outlier analysis, KDE, clustering, and more
- **Data Visualization**: Interactive maps, dashboards, and charts
- **Background Processing**: Asynchronous job processing for long-running operations
- **API Access**: RESTful API for programmatic access to datasets and analysis tools

## Quick Start

1. [Installation Guide](installation.md) - Set up Aurora GIS on your server
2. [Configuration](configuration.md) - Configure database, authentication, and system settings
3. [Architecture Overview](architecture.md) - Understand the system architecture

## Documentation Sections

```{toctree}
:maxdepth: 2
:caption: Getting Started

installation
configuration
architecture
```

```{toctree}
:maxdepth: 2
:caption: Data Import

import/index
```

```{toctree}
:maxdepth: 2
:caption: API Reference

api/index
```

```{toctree}
:maxdepth: 2
:caption: Workers

workers/index
```

```{toctree}
:maxdepth: 2
:caption: Analysis Tools

analysis-tools/index
```

```{toctree}
:maxdepth: 2
:caption: User Interface

ui/index
```

```{toctree}
:maxdepth: 2
:caption: Content & Applications

dashboard
web-apps
accordion
```

```{toctree}
:maxdepth: 1
:caption: Additional Resources

changelog
```

## Key Features

### Data Import & Management
- **Vector Formats**: GeoJSON, Shapefiles, KML, CSV, GeoPackage, DXF, PBF
- **Raster Formats**: GeoTIFF, COG, JPEG2000, NetCDF, HDF
- **URL-based imports** with scheduling
- **PostGIS remote** database connections
- **ESRI/ArcGIS** service imports
- **Overture Maps** integration
- **S3 bucket** imports

### Spatial Analysis
- **Hot Spot Analysis**: Identify statistically significant clusters using Getis-Ord Gi* statistics
- **Outlier Detection**: Find statistical outliers using z-score or MAD methods
- **KDE (Kernel Density Estimation)**: Generate density surfaces from point data
- **Clustering**: Group features based on spatial proximity
- **Zonal Statistics**: Calculate statistics for raster data within polygon zones
- **Proximity Analysis**: Buffer, nearest neighbor, and distance calculations
- **Overlay Operations**: Intersect, union, erase, and join operations

### Background Processing
- Asynchronous job processing for long-running operations
- Worker-based architecture for scalable processing
- Job status tracking and monitoring
- Support for scheduled imports and analysis

### Visualization
- Interactive Leaflet.js maps
- **Dashboard Builder**: Create custom dashboards with multiple widgets
- **Web Apps**: Build multi-page applications with custom layouts
- **Accordion Stories**: Create narrative content with expandable sections
- Chart generation from spatial data
- Layer styling and legend management
- Popup configuration for feature details

## System Requirements

- PHP 7.4 or higher
- PostgreSQL 12+ with PostGIS extension
- Web server (Apache/Nginx)
- PHP extensions: PDO, PDO_PGSQL, JSON, ZIP, GDAL (for raster operations)
- Optional: DuckDB (for Overture Maps), QGIS Server (for QGIS projects)

## Support

For issues, questions, or contributions, please refer to the relevant documentation sections or contact the development team.

