# Global Apparent Soil Resistivity – Environmental Model (P10101) (`apparent_soil_resistivity_P10101`) — 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 Apparent Soil Resistivity – Environmental Model (P10101)
- **Slug**: `apparent_soil_resistivity_P10101`
- **Units**: `ohm-cm`
- **Spatial Extent**: UL(84.0, -180.0) to LR(-55.9999776, 179.9999424)
- **Summary**: This raster represents predicted average soil resistivity (ohm·cm) within the 0–2 meter depth interval, corresponding to typical pipeline burial depths. Values are generated using a Random Forest model trained on field measurements collected with the Wenner four-pin method, incorporating soil properties (sand, silt, clay, water capacity) and climatic variables (temperature, humidity, and time-of-wetness). The raster provides a spatially continuous estimate of subsurface resistivity for regional corrosion risk screening and engineering analysis.
- **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
- `(171.358, (0.0, 77.0, 0.0))`
- `(261.27340000000004, (2.1, 82.1, 0.0))`
- `(351.1888, (4.2, 87.2, 0.0))`
- `(441.10420000000005, (6.300000000000001, 92.3, 0.0))`
- `(531.0196000000001, (8.4, 97.4, 0.0))`
- `(620.935, (10.5, 102.5, 0.0))`
- `(710.8504, (12.600000000000001, 107.6, 0.0))`
- `(800.7658000000001, (14.700000000000001, 112.69999999999999, 0.0))`
- `(890.6812, (16.8, 117.8, 0.0))`
- `(980.5966000000001, (18.900000000000002, 122.9, 0.0))`
- `(1070.512, (21.0, 128.0, 0.0))`
- `(1070.512, (21.0, 128.0, 0.0))`

Soil Resistivity 
-------
AMPP/NACE define soil corrosivity using the table below:

| Soil Resistivity (ohm-cm) | Degree of Corrosivity     |
|---------------------------|---------------------------|
| 0 – 500                   | Very Corrosive            |
| 501 – 1,000               | Corrosive                 |
| 1,001 – 2,000             | Moderately Corrosive      |
| 2,001 – 10,000            | Mildly Corrosive          |
| > 10,000                  | Negligible Corrosion Risk |


This is a somewhat simplistic projection -- soil corrosivity depends on many factors, not just resistivity, such as the influence of cathodic protection systems and the role that resistivity plays in ground bed performance.

With that said, we can build a model to estimate average resistivity between 0-2 meters (typical pipeline depth). 

- **Model Type:** Random Forest Model
- **Dependent Variable:** Field Resistivity Measurements collected with Wenner 4-pin
- **Independent Variables:** Soil Features (Clay, Silt, Sand, Wilting Point) and Climate Features (Temperature, Humidity, Time-of-Wetness)

The model was trained on N=3500 resistivity field samples from across North America, with the log-transformed resistivity used as the target variable:

Model Validation
-------------------
The model was validated using an 80/20 training/holdout split to evaluate generalization performance.

| Dataset        | R²    | RMSE (ohm·cm) | MAE (ohm·cm) |
|----------------|-------|----------------|----------------|
| Training (80%) | 0.915 | 6,086          | 1,742        |
| Holdout (20%)  | 0.846 | 8,668         | 2,598       |

For informational purposes, the top predictors are displayed below

Top 8 Predictors
--------------------

| Variable | Description                         |
|----------|-------------------------------------|
| SNDPPT   | Sand content (%)                    |
| PHIHOX   | Soil pH in water                    |
| SLTPPT   | Silt content (%)                    |
| TOW      | Time of Wetness (hours/year)        |
| DEM      | Elevation (m)                       |
| AWCtS    | Available Water Capacity (%)        |
| TEMP     | Mean Annual Temperature (°C)        |
| CLYPPT   | Clay content (%)                    |



---

## 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
