GitHub

Getting Started with GeoRetina AI

This guide will walk you through the basic workflow of using GeoRetina AI (GRAI) for your first geospatial analysis.

The GRAI Interface

When you first access GRAI, you'll be presented with the chat interface where you can interact with the AI assistant.

GRAI Chat Page

The interface includes several key components:

  • Add Resources: Contains tools for attaching files, connecting databases, and adding regions of interest (ROI)
  • Chat Area: Where you communicate with the AI
  • Map View: Displays geographic data and results
Add Resources

Basic Workflow

1. Select a Region of Interest (ROI)

Before performing analysis, you need to define the geographic area you want to analyze:

  1. Click the "Add Resources" button and select "Add ROI" from the menu

    Select ROI Button
  2. When you click the button, the map is opened where you can select an area to run analyses within it

    Map after clicking Select ROI
  3. Use the drawing tools to define your area

    ROI Drawing Buttons
  4. Draw your region of interest on the map

    Starting ROI Drawing Example
  5. Complete your drawing by double left-clicking on the last vertex. The dashed sides of the polygon will turn into solid yellow lines, indicating that the ROI is ready for finalizing.

    Finalizing ROI Drawing Example
  6. Finalize your selection

    Finalize ROI

2. Ask Your Question

Once your ROI is defined, you can ask the AI to perform an analysis:

  1. Type your question or request in the chat box

    Starting Prompt
  2. The AI will process your request and may ask for clarification

    Finalizing Prompt

3. View Results

After processing, GRAI will display results directly on the map:

  1. Results appear in the map view

    Getting LCLU Results
  2. You can view additional insights by clicking the insights viewer button on the right side of the chat page

    Insights Viewer Button
  3. The insights viewer provides detailed information about your analysis

    Insights Viewer with analysis results

4. Interactive Raster Querying

After completing a raster analysis, you can extract detailed information from specific locations or areas by interactively querying the results directly on the map.

Query Tools

GRAI provides intuitive querying tools accessible through the task bar:

Raster querying tools showing point and polygon query buttons in the task bar
  • Point Querying: Click any location on the raster map to extract pixel values at that specific coordinate
  • Polygon Querying: Draw custom areas to analyze statistics and patterns within defined regions

Query Results and Visualization

When you perform a point query, GRAI automatically generates detailed charts and analytics:

Charts and analytics generated from a point query on raster analysis results

The query results provide:

  • Exact pixel values at the queried location or area
  • Statistical summaries for polygon queries (mean, min, max, standard deviation)
  • Time series charts for temporal analysis
  • Interactive visualizations to explore data patterns
  • Downloadable data for further analysis

This interactive querying capability makes it easy to extract actionable insights from complex raster analyses without requiring specialized GIS knowledge.

5. Session Assets

GRAI saves your analysis results for future reference:

  1. Access previous analyses and results in the Session Assets panel
    Session Assets

Next Steps

Now that you understand the basic workflow, you can explore specific types of geospatial analysis:

Raster-Based Analysis

Vector-Based Analysis