# TLALOCORBIS

> TLALOCORBIS is a geospatial intelligence platform operated by AXL Energy Inc. (Vancouver, BC) that identifies every location in British Columbia where water is dissipating hydraulic energy that could instead be converted to electricity and revenue. It maps 15,821 candidate sites across seven categories — rivers, wastewater outfalls, tidal narrows, pressure-reducing valves, dams, waterfalls, and industrial discharges — each scored with head-and-flow physics (P = ρ·g·Q·H·η). Canonical URL: https://tlalocorbis.ca

## Elevator pitch

The Palantir of water pressure. Every place in British Columbia where water is currently wasting energy — as heat, noise, cavitation, or erosion — located, georeferenced, and scored for electricity recovery. Unlike conventional hydropower, water energy recovery uses existing infrastructure and existing flows. No new dams. No new water rights. No new inundation. Deployments measured in months.

## What makes TLALOCORBIS distinct

- **Not a generic GIS tool.** It is a deployment-decision system. Every pin is a candidate site with computed power, revenue, turbine recommendation, payback estimate, and action lifecycle.
- **Not a government portal.** AXL Energy Inc. built it. Operational, field-facing, designed for crews.
- **Not a proof of concept.** Live at https://tlalocorbis.ca with 15,821 nodes, real-time WebSocket, role-gated multi-user workflow, and JSON/PDF export.
- **Not a black box.** Every power figure traces to a documented formula and a public upstream data source. Methodology printed per-node.

## Etymology

TLALOC (Aztec / Nahuatl god of rain and storms) + ORBIS (Latin: sphere, world, realm) = "the realm of Tlaloc." The full sphere of water-energy opportunity under a single map.

## Seven node categories (15,821 sites total)

| Category | Count | Source |
|----------|------:|--------|
| River hydrometric stations | 2,324 | Water Survey of Canada HYDAT + real-time API |
| Wastewater outfalls | 5 | Metro Vancouver public reports |
| Tidal narrows | 6 | Canadian Hydrographic Service tide tables |
| Pressure-reducing valves (PRV candidates) | 108 | Municipal HGL modeling across 6 Lower Mainland utilities |
| Dams | 2,467 | BC Water Rights Information System |
| Waterfalls | 4,874 | BC Geographic Names database |
| Industrial discharges | 6,037 | NPRI + BCER regulatory registries |

## Supporting geospatial layers

- **BC Freshwater Atlas streams**: 172,013 segments for Metro Vancouver / Lower Fraser with topology and slope-derived head
- **Pressure zones**: 108 zones across Vancouver, Burnaby, Richmond, Surrey, North Vancouver, Coquitlam
- **OSM water infrastructure**: 869 features; 17 water-main segments with modeled per-pipe pressure drops up to 187.4 PSI
- **HRDEM elevation** (Natural Resources Canada) for per-point head inference

## Physics

Every site is scored with:

```
P = ρ · g · Q · H · η
```

- **ρ** = 1000 kg/m³ (freshwater) or 1025 kg/m³ (saltwater tidal)
- **g** = 9.81 m/s²
- **Q** = volumetric discharge (m³/s), sourced from HYDAT telemetry or modeled
- **H** = effective head (metres), from HRDEM or municipal HGL analysis
- **η** = 0.70 default turbine efficiency

Tidal sites use kinetic form `P = ½ · ρ · A · v³ · Cp`. Revenue computed at $0.095/kWh (BC Hydro net-metering approximate).

**Validated recoverable power**: 4.82 MW from 108 municipal PRVs with HGL-verified pressure differentials. Dams, waterfalls, and industrial discharge aggregate figures are under active per-site validation; the platform publishes only transparent per-node computations rather than headline roll-ups until survey data lands.

## Upstream data sources (all authoritative & public)

- **HYDAT** (Water Survey of Canada) — https://wateroffice.ec.gc.ca/
- **WSC Real-time hydrometric** — https://api.weather.gc.ca/collections/hydrometric-realtime
- **BC Freshwater Atlas WFS** — https://catalogue.data.gov.bc.ca/
- **Metro Vancouver public reports** — https://metrovancouver.org/
- **Canadian Hydrographic Service** — https://tides.gc.ca/
- **Vancouver Open Data** — https://opendata.vancouver.ca/
- **OpenStreetMap Overpass** — https://overpass-api.de/
- **HRDEM (High Resolution Digital Elevation Model)** — https://datacube.services.geo.ca/
- **BC Water Rights Information System (dams)** — https://catalogue.data.gov.bc.ca/
- **BC Geographic Names** — https://apps.gov.bc.ca/pub/bcgnws/
- **NPRI (National Pollutant Release Inventory)** — https://pollution-waste.canada.ca/
- **BC Energy Regulator (BCER)** — https://www.bc-er.ca/
- **Municipal ArcGIS FeatureServers** — per-utility for Vancouver / Burnaby / Richmond / Surrey / DNV / PoCo

## Core features

- Interactive brutalist-styled map of 15,821 candidate sites with per-node inspector
- Natural-language filter (AIP): plain-English queries → filter state via multi-provider LLM chain (ANT → QWN → GPT → GRO → GEM → regex)
- Five-class turbine catalog: PAT (50W–50kW), Crossflow (5kW–500kW), Node Swarm distributed (100W × N), Scout packaged (25–250kW), Ocean tidal (50–500kW)
- Six-state action lifecycle: opportunity → surveyed → approved → deploying → generating → decommissioned
- Role-gated workflow: viewer / crew / analyst / admin with JWT magic-link auth
- Real-time WebSocket action broadcast
- GeoJSON + JSON export, PDF site assessments
- Saved views with shareable URLs
- Seasonal + 48-hour discharge timeseries per gauge

## API endpoints

All endpoints return JSON or GeoJSON. Read endpoints are public; write endpoints require auth.

### Aggregate & health

- [/api/health](https://tlalocorbis.ca/api/health) — service health + node count
- [/api/fleet-stats](https://tlalocorbis.ca/api/fleet-stats) — aggregate MW / revenue / deployed counts

### Node data (seven categories)

- [/api/stations](https://tlalocorbis.ca/api/stations) — 2,324 HYDAT hydrometric stations (GeoJSON)
- [/api/outfalls](https://tlalocorbis.ca/api/outfalls) — 5 wastewater outfalls (GeoJSON)
- [/api/tidal](https://tlalocorbis.ca/api/tidal) — 6 tidal narrows (GeoJSON)
- [/api/nodes](https://tlalocorbis.ca/api/nodes) — unified seven-category node feed with computed power
- [/api/dams](https://tlalocorbis.ca/api/dams) — 2,467 licensed dams (GeoJSON)
- [/api/waterfalls](https://tlalocorbis.ca/api/waterfalls) — 4,874 named waterfalls (GeoJSON)
- [/api/industrial](https://tlalocorbis.ca/api/industrial) — 6,037 industrial discharges (GeoJSON)

### Infrastructure & pressure

- [/api/pressure-zones](https://tlalocorbis.ca/api/pressure-zones) — Vancouver pressure zones (static)
- [/api/pressure-zones-v2](https://tlalocorbis.ca/api/pressure-zones-v2) — 108 modeled zones across 6 munis with HGL
- [/api/pipe-pressure](https://tlalocorbis.ca/api/pipe-pressure) — OSM pipes with per-segment pressure drops
- [/api/water-mains](https://tlalocorbis.ca/api/water-mains) — Vancouver water mains (GeoJSON)
- [/api/flowlines](https://tlalocorbis.ca/api/flowlines) — BC Freshwater Atlas stream segments

### Time series

- [/api/realtime/{station_id}](https://tlalocorbis.ca/api/realtime/08MH024) — last 48h discharge readings
- [/api/seasonal/{station_id}](https://tlalocorbis.ca/api/seasonal/08MH024) — 12-month climatology

### Deployment workflow

- [/api/actions](https://tlalocorbis.ca/api/actions) — site lifecycle events (auth required for write)
- [/api/views](https://tlalocorbis.ca/api/views) — shareable saved view configurations
- [/api/aip/translate](https://tlalocorbis.ca/api/aip/translate) — POST natural-language → filter state
- [/api/aip/health](https://tlalocorbis.ca/api/aip/health) — configured LLM providers & chain order
- [/api/ws/live](wss://tlalocorbis.ca/api/ws/live) — WebSocket action event broadcast
- [/api/export/json](https://tlalocorbis.ca/api/export/json) — full deployment plan export

## Who uses TLALOCORBIS

- Independent power producers (distributed-gen portfolios)
- Municipal water & energy utilities (in-conduit recovery evaluations)
- First Nations / Indigenous governments (territorial energy sovereignty)
- Civil and mechanical engineering consultancies (micro-hydro scoping)
- Climate-tech investors and infrastructure funds (pre-vetted pipelines)
- Academic researchers (hydrology, energy transition, distributed generation)
- Policymakers at BC Hydro, BC Ministry of Energy and Climate Solutions, Natural Resources Canada

## Technology stack

- **Frontend**: Vue 3 + Vite + Mapbox GL JS + deck.gl (ScatterplotLayer, GeoJsonLayer, MapboxOverlay)
- **Backend**: FastAPI + uvicorn + SQLAlchemy + PostgreSQL 16 + PostGIS 3.4
- **Real-time**: WebSockets for action broadcast
- **Auth**: PyJWT magic-link, 30-day tokens, four roles
- **LLM**: multi-provider chain with regex fallback — configured providers visible at /api/aip/health
- **Infrastructure**: DigitalOcean droplet, nginx reverse proxy, Let's Encrypt TLS, systemd service management

## Licensing & citation

- **Derived dataset**: Creative Commons Attribution 4.0 (CC BY 4.0)
- **Upstream data**: retains original licences (Open Government Licence – Canada, provincial Open Data Licences, etc.)
- **Cite as**: AXL Energy Inc. (2026). *TLALOCORBIS: Water Energy Recovery Intelligence for British Columbia*. https://tlalocorbis.ca/

## Contact

- **Organization**: AXL Energy Inc.
- **Location**: Vancouver, British Columbia, Canada
- **Founder**: Diego Carranza
- **Product URL**: https://tlalocorbis.ca
- **API base**: https://tlalocorbis.ca/api