Skip to main content
Glama
joshdels

free-transmission-wildlife

by joshdels
README.md
# AI-Assisted Transmission Line & Wildlife Analysis

An AI-assisted GIS application for analyzing the relationship between **electrical transmission infrastructure** and **wildlife / public-access lands** in California's San Joaquin Valley.

The project combines **GIS spatial analysis, DuckDB Spatial, MCP, LLMs, and custom web interfaces** to make spatial questions easier to ask and analyze.

## Use Case

Wildlife and environmental organizations may need to answer questions such as:

* Which transmission lines intersect wildlife lands?
* Which public-access lands are within 1 km of transmission infrastructure?
* How many transmission segments affect a particular area?
* Which areas may require further environmental review?
* What transmission infrastructure is closest to a protected or public-access area?

Instead of manually loading multiple datasets into a GIS application and constructing spatial queries, the system allows these questions to be expressed in natural language and translated into spatial analysis workflows.

## Screenshots

### Claude + MCP

![Claude MCP](public/claude.png)

### ArcGIS

![ArcGIS](public/arcgis.png)

### MapLibre

![MapLibre](public/maplibre.png)

### Web Dashboard

![Dashboard](public/dashboard.png)

## Why This Exists

Traditional GIS workflows are powerful, but spatial analysis often requires users to:

1. Find the appropriate datasets.
2. Load and inspect the data.
3. Understand coordinate systems.
4. Construct spatial queries.
5. Run geoprocessing operations.
6. Interpret the results.

This project explores a different interaction model:

> **Ask a spatial question → perform GIS analysis → receive an interpretable result.**

The goal is not to replace GIS software.

It is to explore how **AI can become an interface for spatial analysis**, while the underlying spatial operations remain deterministic and are executed by GIS-aware tools and databases.

## The Bigger Idea

This project explores the intersection of:

**GIS + Spatial Databases + AI + MCP + Custom Interfaces**

with the goal of building more accessible and automatable spatial-analysis workflows.

---

For installation instructions, see [`docs/installation`](docs/installation.md).

For the system architecture, see [`docs/architecture`](docs/architecture.md).

TDQS

A3.5/5.0

Scored across 7 tools

Disambiguation4/5

The data tools are largely distinct, but the two intersection tools (get_list_of_hit_wildlife_from_transmission_lines and calculate_transmission_lines_intersection_with_wildlife) overlap in subject and could be misselected without careful reading. The two map instruction tools are clearly disambiguated by their explicit platform constraints.

Naming Consistency4/5

Most tools follow a get_<description> snake_case convention, and the map tools use a clear platform suffix. The calculate_ prefix in calculate_transmission_lines_intersection_with_wildlife is a minor deviation, and get_list_of_hit_wildlife_from_transmission_lines is verbose, but overall the naming pattern is predictable.

Tool Count5/5

Seven tools is a well-scoped, focused set for a specialized transmission/wildlife analysis dashboard. Each tool serves a distinct output need: summaries, intersection results, overlap metrics, chart guidance, and map guidance.

Completeness4/5

The set covers the core query needs (summaries, intersection list, overlap metric) and presentation needs (chart and map instructions). Minor gaps exist, such as no detailed feature-level retrieval for individual transmission lines or wildlife lands, but the surface is likely sufficient for a dashboard use case.

Maintenance

ActivityMaintained
ResponsivenessNo issues