# Saturation Potential Index (0-1) (`Saturation_Potential_Index_0_1`) — 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**: Saturation Potential Index (0-1)
- **Slug**: `Saturation_Potential_Index_0_1`
- **Units**: `Unitless (Normalized Index: 0–1)`
- **Spatial Extent**: UL(90.125, -180.0) to LR(-90.1219617, 180.1247159)
- **Summary**: The Saturation Potential Index represents the relative likelihood of soil moisture accumulation based on terrain position, drainage characteristics, and precipitation inputs. Higher values indicate areas where water is more likely to persist, resulting in reduced soil aeration and increased potential for anaerobic conditions.

This raster is directly relevant to external corrosion risk in buried pipelines, particularly in environments prone to long-term wetness.
- **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, (0.0, 100.0, 0.0))`
- `(0.005, (5.0, 105.0, 0.0))`
- `(0.01, (10.0, 110.0, 0.0))`
- `(0.015, (15.0, 115.0, 0.0))`
- `(0.02, (20.0, 120.0, 0.0))`
- `(0.025, (25.0, 125.0, 0.0))`
- `(0.03, (30.0, 130.0, 0.0))`
- `(0.035, (35.0, 135.0, 0.0))`
- `(0.04, (40.0, 140.0, 0.0))`
- `(0.045, (45.0, 145.0, 0.0))`
- `(0.05, (50.0, 150.0, 0.0))`
- `(0.05, (50.0, 150.0, 0.0))`

<h2>Technical Specifications</h2>

<h3>Saturation Potential Index (0–1)</h3>
<p><strong>Global | ~1 km Resolution | 2020–2024</strong></p>

<h4>Raster Name</h4>
<p>Saturation Potential Index – Normalized (0–1)</p>

<h4>File Name</h4>
<p>Saturation_Potential_Index_0_1.tif</p>

<h4>Short Description</h4>
<p>
A normalized global index (0–1) representing the relative likelihood of persistent soil moisture and terrain-driven water accumulation based on drainage connectivity, terrain position, and hydrologic behavior.
</p>
<h4>How to Read This Map</h4>
<ul>
  <li>This layer represents the <strong>likelihood of persistent moisture</strong></li>
  <li>Values vary gradually across the landscape</li>
  <li>Focus on <strong>relative differences and regional patterns</strong></li>
  <li>Subtle changes are meaningful in combination with other layers</li>
</ul>

<p><strong>Key Insight:</strong> This layer reflects where moisture is likely to persist, not just where water is present.</p>
<h4>Units of Measure</h4>
<p>Normalized Index (0–1, dimensionless)</p>

<h4>Technical Specification</h4>
<p>
The Saturation Potential Index represents the combined effect of terrain position, drainage connectivity, and water accumulation processes that influence long-term soil moisture conditions.
</p>

<p>
This index integrates multiple terrain-derived hydrologic factors, including:
</p>

<ul>
  <li>HAND Low-Lying Index</li>
  <li>Drainage Position Index</li>
  <li>Drainage Intensity Index</li>
  <li>River Influence</li>
</ul>

<p>
Each input layer is normalized to a common 0–1 scale and combined to estimate the likelihood of persistent saturation conditions:
</p>

<p><strong>Saturation Potential = Σ (w<sub>i</sub> · S<sub>i</sub>)</strong></p>

<p>
Higher values indicate environments where water is more likely to accumulate, persist, and reduce soil aeration.
</p>

<h4>Key Characteristics</h4>

<ul>
  <li>Normalized index representing relative saturation potential</li>
  <li>Integrates terrain, drainage, and hydrologic connectivity</li>
  <li>Identifies areas prone to long-term wetness and water retention</li>
  <li>Strong indicator of reduced soil aeration conditions</li>
  <li>Critical driver of hydrologic exposure and corrosion-related environments</li>
</ul>

<h4>Spatial Characteristics</h4>

<ul>
  <li><strong>Coordinate System:</strong> GCS_WGS_1984</li>
  <li><strong>Spatial Resolution:</strong> ~1 km</li>
  <li><strong>Coverage:</strong> Global</li>
  <li><strong>Format:</strong> GeoTIFF / web raster</li>
</ul>

<h4>Processing</h4>

<p>
The Saturation Potential Index was derived by combining multiple terrain-based hydrologic indicators into a unified representation of water retention potential.
</p>

<ul>
  <li>Input normalization to 0–1 scale</li>
  <li>Weighted combination of hydrologic indices</li>
  <li>Emphasis on low-lying, drainage-connected terrain</li>
  <li>Integration of flow accumulation and river proximity effects</li>
  <li>Export to normalized raster format</li>
</ul>

<h4>Interpretation</h4>

<table border="1" cellpadding="6" cellspacing="0">
  <tr>
    <th>Index Value</th>
    <th>General Interpretation</th>
  </tr>
  <tr>
    <td>0.0 – 0.2</td>
    <td>Very low saturation potential; well-drained environments</td>
  </tr>
  <tr>
    <td>0.2 – 0.5</td>
    <td>Moderate drainage with limited moisture retention</td>
  </tr>
  <tr>
    <td>0.5 – 0.8</td>
    <td>Increased likelihood of water accumulation and periodic saturation</td>
  </tr>
  <tr>
    <td>0.8 – 1.0</td>
    <td>High saturation potential; persistent wetness and low aeration conditions</td>
  </tr>
</table>

<h4>Role in Pipeline Hydrologic Exposure Model</h4>

<p>
The Saturation Potential Index is a key intermediate layer in the Pipeline Hydrologic Exposure model, translating terrain and drainage characteristics into a direct indicator of moisture persistence.
</p>

<p>
Higher saturation potential contributes significantly to elevated hydrologic exposure scores and indicates environments more susceptible to:
</p>

<ul>
  <li>Persistent soil moisture</li>
  <li>Reduced oxygen availability</li>
  <li>Water accumulation in low-gradient terrain</li>
  <li>Conditions favorable to corrosion mechanisms</li>
</ul>

<p>
This layer directly contributes to:
</p>

<ul>
  <li>Pipeline Hydrologic Exposure Score (1–100)</li>
  <li>Pipeline Hydrologic Exposure Index (1–7)</li>
</ul>

<h4>Scope and Intended Use</h4>

<ul>
  <li>Identification of saturation-prone environments</li>
  <li>Pipeline corrosion exposure screening</li>
  <li>Terrain-driven hydrologic analysis</li>
  <li>Environmental and geospatial risk modeling</li>
</ul>

<p>
This dataset is intended as a relative indicator of saturation potential and should be used in conjunction with other hydrologic and environmental layers.
</p>

<h4>Related Hydrologic Exposure Datasets</h4>

<h5>Primary Hydrologic Exposure Indices</h5>

<ul>
<li><a href="https://secure.engineeringdirector.com/public/map/Pipeline_Hydrologic_Exposure_Score_1_100_v14_final">Pipeline Hydrologic Exposure Score (1–100)</a></li>
<li><a href="https://secure.engineeringdirector.com/public/map/Pipeline_Hydrologic_Exposure_Index_1_7_v14_INT_websafe">Pipeline Hydrologic Exposure Index (1–7)</a></li>
</ul>

<h5>Supporting Hydrologic Input Layers</h5>

<ul>
  <li><a href="https://secure.engineeringdirector.com/public/map/HAND_Height_Above_Nearest_Drainage_m">HAND – Height Above Nearest Drainage</a></li>
  <li><a href="https://secure.engineeringdirector.com/public/map/HAND_Low_Lying_Index_0_1">HAND Low-Lying Index</a></li>
  <li><a href="https://secure.engineeringdirector.com/public/map/Saturation_Potential_Index_0_1">Saturation Potential Index</a></li>
  <li><a href="https://secure.engineeringdirector.com/public/map/Drainage_Position_Index_0_1">Drainage Position Index</a></li>
  <li><a href="https://secure.engineeringdirector.com/public/map/River_Influence_20km">River Influence</a></li>
  <li><a href="https://secure.engineeringdirector.com/public/map/Distance_To_River_20km_Geodesic">Distance to River</a></li>
  <li><a href="https://secure.engineeringdirector.com/public/map/Drainage_Index_Normalized_0_1">Drainage Intensity Index</a></li>
</ul>

<h4>Limitations</h4>

<ul>
  <li>This index does not directly incorporate precipitation or temporal climate variability.</li>
  <li>It represents terrain-driven saturation potential rather than actual measured soil moisture.</li>
  <li>It does not predict flood depth or flood frequency.</li>
  <li>It does not account for engineered drainage systems or infrastructure.</li>
</ul>

<h4>Legal & Licensing</h4>

<p>
© 2026 AtmosphericIQ LLC and Engineering Director, Inc. All rights reserved.
</p>

<p>
This dataset and associated models are proprietary to AtmosphericIQ LLC and distributed by Engineering Director, Inc.
</p>

<h4>Dataset Citation</h4>

<p>
Mazzella, J. (2026).<br>
<strong>Saturation Potential Index (0–1), Global Raster, 2020–2024.</strong><br>
AtmosphericIQ LLC / Engineering Director, Inc.
</p>

<p>
Derived using terrain-based hydrologic modeling, drainage analysis, and multi-parameter normalization of hydrologic indicators.
</p>

---

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