# Drainage Position Index (0-1) (`Drainage_Position_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**: Drainage Position Index (0-1)
- **Slug**: `Drainage_Position_Index_0_1`
- **Units**: `Unitless (Normalized Index: 0–1)`
- **Spatial Extent**: UL(90.125, -180.0) to LR(-90.1219617, 180.1247159)
- **Summary**: The Drainage Position Index characterizes the relative position of each location within the landscape drainage hierarchy. Lower values correspond to ridge tops and well-drained uplands, while higher values represent valley bottoms and convergent flow zones.

This index is useful for identifying areas where water accumulates due to terrain convergence and limited drainage.
- **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>Drainage Position Index (0–1)</h3>
<p><strong>Global | ~1 km Resolution</strong></p>

<h4>Raster Name</h4>
<p>Drainage Position Index – Normalized (0–1)</p>

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

<h4>Short Description</h4>
<p>
A normalized global index (0–1) representing the relative position of terrain within the drainage system, identifying whether a location is situated on ridges, slopes, or valley-bottom accumulation zones.
</p>
<h4>How to Read This Map</h4>
<ul>
  <li>This map shows <strong>relative position within the terrain</strong> (valley, slope, ridge)</li>
  <li><strong>Lower values</strong> correspond to drainage pathways</li>
  <li><strong>Higher values</strong> correspond to upland or divide areas</li>
  <li>Focus on <strong>patterns and gradients</strong>, not isolated values</li>
</ul>

<p><strong>Key Insight:</strong> Terrain position controls how water moves, accumulates, or drains across the landscape.</p>
<h4>Units of Measure</h4>
<p>Normalized Index (0–1, dimensionless)</p>

<h4>Technical Specification</h4>
<p>
The Drainage Position Index characterizes landscape position within the hydrologic system by identifying areas of divergence (ridge tops), transition (slopes), and convergence (valleys).
</p>

<p>
This index is derived from terrain slope, flow routing, and drainage accumulation patterns to quantify whether water is more likely to:
</p>

<ul>
  <li>Drain away from a location (ridge or slope)</li>
  <li>Accumulate and converge (valley or basin)</li>
</ul>

<p>
The index is normalized to a 0–1 scale:
</p>

<p><strong>Drainage Position Index = f (terrain convergence and drainage structure)</strong></p>

<p>
Lower values represent well-drained or shedding terrain, while higher values represent convergent zones where water accumulates.
</p>

<h4>Key Characteristics</h4>

<ul>
  <li>Identifies relative terrain position within drainage systems</li>
  <li>Distinguishes ridge tops, slopes, and valley-bottom environments</li>
  <li>Normalized to a consistent 0–1 scale</li>
  <li>Captures terrain-driven water convergence and accumulation patterns</li>
  <li>Supports hydrologic exposure and saturation modeling</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 Drainage Position Index was derived using terrain and hydrologic flow analysis to quantify relative landscape position.
</p>

<ul>
  <li>DEM-based slope and curvature analysis</li>
  <li>Flow direction and flow accumulation modeling</li>
  <li>Identification of convergent and divergent terrain</li>
  <li>Normalization to 0–1 scale</li>
  <li>Export to global 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>Ridge tops or strongly drained terrain with minimal water accumulation</td>
  </tr>
  <tr>
    <td>0.2 – 0.5</td>
    <td>Sloped terrain with moderate drainage and limited convergence</td>
  </tr>
  <tr>
    <td>0.5 – 0.8</td>
    <td>Transitional terrain with increasing water convergence</td>
  </tr>
  <tr>
    <td>0.8 – 1.0</td>
    <td>Valley bottoms and convergent zones with strong water accumulation</td>
  </tr>
</table>

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

<p>
The Drainage Position Index is a key supporting variable in the Pipeline Hydrologic Exposure model, providing insight into how terrain influences water movement and accumulation.
</p>

<p>
Higher values contribute to increased hydrologic exposure by identifying:
</p>

<ul>
  <li>Valley-bottom accumulation zones</li>
  <li>Flow convergence areas</li>
  <li>Low-gradient terrain prone to saturation</li>
</ul>

<p>
Lower values indicate terrain where water is more likely to drain away, reducing exposure potential.
</p>

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

<ul>
  <li>Saturation Potential Index</li>
  <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>Terrain-driven hydrologic analysis</li>
  <li>Identification of water convergence zones</li>
  <li>Pipeline corrosion exposure screening</li>
  <li>Environmental and geospatial modeling</li>
</ul>

<p>
This dataset is intended as a terrain-based hydrologic indicator and should be used in conjunction with other supporting 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 represents relative terrain position and does not directly measure water volume or flow.</li>
  <li>It does not incorporate precipitation or climate variability.</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>Drainage Position Index (0–1), Global Raster.</strong><br>
AtmosphericIQ LLC / Engineering Director, Inc.
</p>

<p>
Derived using terrain-based hydrologic analysis, flow routing, and landscape position classification techniques.
</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