Skip to content

Latest commit

 

History

History
87 lines (50 loc) · 5.11 KB

User_Manual.md

File metadata and controls

87 lines (50 loc) · 5.11 KB
Raw

Spatial Analysis Agent User Manual

Installation Guide

  • Download the master repository of the plugin from github
  • Launch QGIS software and navigate to Plugin > Manage and install Plugins.. > Install from ZIP
  • Click on ... to select the directory of the downloaded zip file and Install plugin

Installation_page.png

  • If successful, a success message will be displayed, then you can close the Plugins dialog.

Plugin install successful.png

  • Navigate to Plugins > Manage and install plugins. Ensure the plugin is checked.

CheckBox.png

Opening the Plugin

  • Load the Spatial Analysis Agent on Pluginson menubar, or via its icon on the plugins toolbar.

Plugin Icon oon toolbar.png

  • Once the plugin is loaded, a dialog indicating any missing dependencies will appear. Ensure you install all the dependencies by clicking the Yes button.

Missing dependencies.png

  • After the installation of the missing dependencies, restart the QGIS software.

How to Use the Plugin

Plugin interface

Plugin Interface.png

  • The plugin interface consists of five tabs - Request Page, Reports, Solution Graph, Settings, and Help
  • Data Request Page: is the main tab where user can make a request. This consists of the Code panel which displays the AI-generated codes, Information Panel which displays the agent running information, Message panel which enables the users to enter the task they want to perform, and the Data directories which contain the data path of all the data loaded into QGIS.
  • Report: allows users to access and visualize various forms of generated reports such as charts, plots, statistical reports, etc., in different format like html and image.
  • Solution Graph: This tab displays the steps/breakdown of performing the task requested by user is displayed in as a graph.
  • Settings: This tab enable users to set the OpenAI API keys (Find more details about OpenAI API key), select the model (e.g, gpt-4). Users can check the "Chat Mode" box to switch to chat with AI. Also, the Settings tab allow users to set the workspace directory, i.e where results will be saved on their computer. A default directory is set by default after the installation of the plugin. Additionally, users can add tool documentation file to either their local machine or to the Plugin's GitHub repository (find out more). Note: API keys input here will only be stored locally on the user's computer ('plugin_dir/SpatialAnalysisAgent/config.ini').

Settings.png

  • Help: This contains guide on how to use the Co-Pilot

Adding a new tool documentation

This plugin includes comprehensive documentation for QGIS native tools. To enhance the functionality and performance of the plugin, users have the option to create and integrate customized tools. For more information on how to add custom tool documentation, click here.

Case studies

The case studies demonstrate the capabilities of the Spatial Analysis Agent across three categories:

  1. Tool Selection Capability: Showcases the agent's ability to identify and recommend the appropriate tool(s) for specific operations.
  2. Code Generation Accuracy: Demonstrates the agent's proficiency in generating executable code to perform various spatial analysis tasks.
  3. End-to-End Problem Solving: Evaluates the agent's ability to select the appropriate tool, generate the correct code, and successfully execute the complete operation. Explore the detailed case studies on the Case Study page.