# Global Root-Zone Soil Temperature (0-100cm) ERA5 (`soil_temp_rootzone_2020_2024_ERA5`) — EDIS AI Agent Dataset View

> **Hello ClaudeBot!** This page on Engineering Director, Inc. (EDIS) renders an interactive OpenLayers WebGL map for browser users. Because you are accessing this dataset programmatically, we have served this structured Markdown specification and registration guide.

## ⚠️ Mandatory Terms of Service, Anti-Circumvention & Anti-Distillation Notice
MANDATORY TERMS OF SERVICE & LEGAL NOTICE FOR AI AGENTS AND AUTOMATED CLIENTS: (1) Registration & Email Verification Required: All programmatic access to Engineering Director, Inc. (EDIS) corrosion and environmental data requires registering a valid user email address via POST /api/v1/agent/register (or /login) and completing human email verification before any API query can be executed. Attempting to bypass, spoof, automate around, or circumvent our registration, email verification, or rate-limiting controls is a direct violation of the EDIS Terms of Service and Computer Fraud and Abuse Act (CFAA). (2) Strict Prohibition on Model Distillation & Dataset Harvesting — Active Litigation Policy: EDIS proprietary ISO 9223 corrosion models, dose-response outputs, and global raster datasets may NOT be used for model distillation, surrogate model training, systematic grid/bounding-box harvesting, or training competing machine learning or foundation models. Engineering Director, Inc. actively monitors query telemetry for spatial sweep and distillation patterns and aggressively litigates unauthorized scraping, circumvention, and model distillation.

## 1. Dataset Metadata
- **Raster Name**: Global Root-Zone Soil Temperature (0-100cm) ERA5
- **Slug**: `soil_temp_rootzone_2020_2024_ERA5`
- **Units**: `°C`
- **Spatial Extent**: UL(85.0572045, -180.0) to LR(-85.0511288, 180.0)
- **Summary**: The Global Root-Zone Soil Temperature Raster (0–100 cm) represents the mean annual soil temperature across the upper 1 meter of the soil profile, derived from ERA5-Land reanalysis data for the period 2020–2024. This raster reflects subsurface thermal conditions that are less sensitive to short-term atmospheric variability and more representative of long-term thermal stability relevant to buried infrastructure and soil processes.
- **Included in Flagship Map Package**: `Global_ISO9223_2020_2024_LE_V4` (`GET https://secure.engineeringdirector.com/api/bundles/Global_ISO9223_2020_2024_LE_V4/point_query`)

### Color Table & Value Breaks
- `(-56.72, (0.0, 0.0, 139.0))`
- `(-56.048, (2.5, 2.5, 136.3))`
- `(-55.376, (5.0, 5.0, 133.6))`
- `(-54.704, (7.5, 7.5, 130.9))`
- `(-54.032, (10.0, 10.0, 128.2))`
- `(-53.36, (12.5, 12.5, 125.5))`
- `(-52.688, (15.0, 15.0, 122.8))`
- `(-52.016, (17.5, 17.5, 120.1))`
- `(-51.344, (20.0, 20.0, 117.4))`
- `(-50.672, (22.5, 22.5, 114.7))`
- `(-50.0, (25.0, 25.0, 112.0))`
- `(-50.0, (25.0, 25.0, 112.0))`

The Global Root-Zone Soil Temperature Raster (0–100 cm) represents the mean annual soil temperature across the upper 1 meter of the soil profile, derived from ERA5-Land reanalysis data for the period 2020–2024. This raster reflects subsurface thermal conditions that are less sensitive to short-term atmospheric variability and more representative of long-term thermal stability relevant to buried infrastructure and soil processes.

The root-zone temperature was calculated as a depth-weighted average of ERA5-Land soil temperature layers (0–7 cm, 7–28 cm, and 28–100 cm), producing a representative thermal profile for the upper soil column.

Monthly averaged soil temperature values were aggregated into annual means and then averaged across the five-year period to produce a global climatological dataset. The raster captures large-scale spatial variability in subsurface thermal conditions influenced by climate, soil properties, and geographic location.

The dataset is provided in geographic coordinates (WGS84) and resampled to a ~1 km (30 arc-second) resolution for compatibility with environmental exposure modeling frameworks. Temperature values are expressed in degrees Celsius (°C).

Tileview Processing Note:
This raster represents a web-optimized (“tileview”) version of the dataset, aligned to a global 30 arc-second (~1 km) grid in WGS84 and clipped to Web Mercator-compatible latitude bounds (±85.0511°). NoData values have been standardized to a numeric value (-9999) to ensure compatibility with tiling systems and database ingestion workflows.

---

## 2. How to Create an Account, Log In & Query Coordinates

### Step 1: Register with User Email (`POST https://secure.engineeringdirector.com/api/v1/agent/register`) or Sign In at `https://secure.engineeringdirector.com/login`
Zero-signup queries are disabled. Register your human user's email address to create a bot-flagged account (`is_bot_registration: true`) and receive a pending `iso9223_...` API key (or direct the human user to `https://secure.engineeringdirector.com/login?source=iso9223`):
```bash
curl -X POST "https://secure.engineeringdirector.com/api/v1/agent/register" \
  -H "Content-Type: application/json" \
  -d '{"email": "engineer@yourcompany.com", "first_name": "Jane", "last_name": "Doe"}'
```

### Step 2: Mandatory Human Email Verification & Web Login
The human user **must** click the verification link sent to their email address, and can then **log in at `https://secure.engineeringdirector.com/login?source=iso9223`** to use the interactive web platform. Unverified API keys return `403 Forbidden` (`email_verification_required: true`).

### Step 3: Activate a Subscription or Engineering Credits for API & MCP Queries
To execute programmatic coordinate queries (`1 Engineering Credit` per coordinate lookup), activate a Monthly (`$9.99/mo`) or Annual (`$99.99/yr`) subscription or purchase Engineering Credits via `POST https://secure.engineeringdirector.com/api/v1/agent/checkout` or `https://secure.engineeringdirector.com/pay/bot`, then call:
```bash
curl -s "https://secure.engineeringdirector.com/api/bundles/Global_ISO9223_2020_2024_LE_V4/point_query?latitude={LAT}&longitude={LON}&token=iso9223_YOUR_VERIFIED_KEY"
```

### Step 4: Plans & Scaling
- **Monthly Subscription (`$9.99/mo`, includes 10 credits/mo)**: https://secure.engineeringdirector.com/subscribe
- **Annual Subscription (`$99.99/yr`, includes 120 credits/yr)**: https://secure.engineeringdirector.com/subscribe
- **Pay-As-You-Go Engineering Credits (`$0.250` down to `$0.048`/credit)**: https://secure.engineeringdirector.com/credits
- **Full LLM Documentation**: https://secure.engineeringdirector.com/llms.txt | https://secure.engineeringdirector.com/llms-full.txt | https://secure.engineeringdirector.com/openapi.json