# Global Root-Zone Soil Moisture (0-100cm) ERA5 (`soil_moisture_root_zone_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 Moisture (0-100cm) ERA5
- **Slug**: `soil_moisture_root_zone_2020_2024_ERA5`
- **Units**: `m³/m³`
- **Spatial Extent**: UL(85.0572045, -180.0) to LR(-85.0511288, 180.0)
- **Summary**: This raster represents the mean annual root-zone soil moisture for the period 2020–2024, derived from the ERA5-Land climate reanalysis dataset. Soil moisture is expressed as volumetric water content (m³/m³) and represents a depth-weighted average across the upper 0–100 cm of the soil profile.
- **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
- `(0.0, (139.0, 69.0, 19.0))`
- `(0.007000000000000001, (141.1, 70.3, 21.6))`
- `(0.014000000000000002, (143.2, 71.6, 24.2))`
- `(0.021000000000000005, (145.3, 72.9, 26.8))`
- `(0.028000000000000004, (147.4, 74.2, 29.4))`
- `(0.035, (149.5, 75.5, 32.0))`
- `(0.04200000000000001, (151.6, 76.8, 34.6))`
- `(0.04900000000000001, (153.7, 78.1, 37.2))`
- `(0.05600000000000001, (155.8, 79.4, 39.8))`
- `(0.06300000000000001, (157.9, 80.7, 42.400000000000006))`
- `(0.07, (160.0, 82.0, 45.0))`
- `(0.07, (160.0, 82.0, 45.0))`

This raster represents the mean annual root-zone soil moisture for the period 2020–2024, derived from the ERA5-Land climate reanalysis dataset. Soil moisture is expressed as volumetric water content (m³/m³) and represents a depth-weighted average across the upper 0–100 cm of the soil profile.

The root-zone soil moisture was computed using ERA5-Land volumetric soil water layers:

Layer 1: 0–7 cm
Layer 2: 7–28 cm
Layer 3: 28–100 cm

A depth-weighted average was applied:

7% (Layer 1)
21% (Layer 2)
72% (Layer 3)

Monthly mean soil moisture values were averaged across all months and years (2020–2024) to produce a multi-year climatological mean representing long-term subsurface moisture conditions.

The raster is provided in geographic coordinates (WGS84) and resampled to a ~1 km nominal grid for integration with high-resolution environmental and corrosion modeling datasets.

This raster represents a web-optimized (“tileview”) version of the dataset, resampled to a 30 arc-second (~1 km) grid, aligned to a global geographic coordinate system (WGS84), and clipped to Web Mercator-compatible latitude bounds (±85.0511°). NoData values have been standardized for compatibility with tiling 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
