# Global Soil Aerobic Index (0-1) (`aerobic_index_1km`) — 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 Soil Aerobic Index (0-1)
- **Slug**: `aerobic_index_1km`
- **Units**: `Dimensionless index (range: 0–1)`
- **Spatial Extent**: UL(83.9991672, -179.9999871) to LR(-56.0008104, 179.9999553)
- **Summary**: This project produces a spatially continuous **Aerobic Index Raster** used to classify global soils based on their relative oxygenation potential. Rather than directly estimating soil oxygen concentration, the model computes a composite environmental proxy derived from soil, climatic, hydrologic, and lithological variables. :contentReference[oaicite:0]{index=0}
- **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.31, (0.0, 56.0, 35.0))`
- `(0.314, (0.0, 56.0, 35.0))`
- `(0.318, (0.0, 56.0, 35.0))`
- `(0.322, (0.0, 56.0, 35.0))`
- `(0.326, (0.0, 56.0, 35.0))`
- `(0.32999999999999996, (0.0, 56.0, 35.0))`
- `(0.33399999999999996, (0.0, 56.0, 35.0))`
- `(0.33799999999999997, (0.0, 56.0, 35.0))`
- `(0.34199999999999997, (0.0, 56.0, 35.0))`
- `(0.346, (0.0, 56.0, 35.0))`
- `(0.35, (0.0, 56.0, 35.0))`
- `(0.35, (0.0, 56.0, 35.0))`

## Technical Specifications

### Aerobic Soil Index – Continuous Index (0–1)

**Global | 250 m Resolution | Version 12_r7i**

---

#### Raster Name

Aerobic Soil Index – Continuous Index (0–1)

---

#### File Name

`aerobic_index_1km.tif`

---

#### Short Description

A continuous global aerobic soil index (0–1) representing the relative likelihood of oxygen presence and mobility within the soil profile based on soil texture, moisture retention, climate wetness, lithologic permeability, and compaction characteristics.

The index is designed for environmental interpretation, corrosion screening, and identification of aerobic versus anaerobic soil environments relevant to buried infrastructure.

---

#### How to Read This Map

- **Higher values** indicate greater aerobic potential and improved oxygen diffusion
- **Lower values** indicate increased likelihood of anaerobic or oxygen-limited conditions
- Focus on **continuous zones and regional patterns**, not isolated pixels
- This index is **calculated at each location** using multiple environmental and soil variables

**Key Insight:**  
This index reflects the combined influence of soil texture, water retention, climate moisture, permeability, and lithology on oxygen mobility within the shallow subsurface environment.

---

#### Units of Measure

Index Score (0–1, dimensionless)

---

#### Technical Specification

Version 12_r7i represents the finalized production model integrating soil texture, soil chemistry, climate moisture, lithologic permeability, and water retention properties into a unified aerobic soil potential framework.

This dataset represents a continuous global aerobic soil index developed using a weighted multi-parameter environmental modeling approach designed to estimate relative oxygen availability and mobility within the soil profile.

The model integrates five primary components:

---

##### 1. Soil Texture Component

- Sand Content
- Clay Content

These variables describe soil pore structure and permeability characteristics controlling oxygen diffusion and drainage behavior.

Higher sand content generally increases oxygen mobility, while higher clay content reduces aeration and permeability.

###### Supporting Soil Texture Layers

- [Clay Content (%) – 0–5 cm](https://secure.engineeringdirector.com/public/map/CLYPPT_M_sl1_1km_ll)
- [Sand Content (%) – 0–5 cm](https://secure.engineeringdirector.com/public/map/SNDPPT_M_sl1_1km_ll)

---

##### 2. Water Retention Component

- Wilting Point (WWP)
- Available Water Holding Capacity (AWCH)

These variables characterize soil moisture retention and pore-water persistence influencing oxygen displacement and anaerobic potential.

Higher retained moisture generally reduces oxygen availability within the soil matrix.

---

##### 3. Soil Compaction & Chemistry Component

- Bulk Density (BLDFIE)
- Cation Exchange Capacity (CEC)

These variables describe soil compaction, fine-textured behavior, and electrochemical properties associated with restricted gas diffusion and persistent moisture retention.

###### Supporting Soil Property Layers

- [Bulk Density (0–5 cm)](https://secure.engineeringdirector.com/public/map/BLDFIE_M_sl1_250m)
- [Clay Content (%) – 0–5 cm](https://secure.engineeringdirector.com/public/map/CLYPPT_M_sl1_1km_ll)

---

##### 4. Climate Moisture Component

- Relative Humidity
- Atmospheric Wetness Indicators

Climate moisture conditions are incorporated to represent persistent environmental wetness capable of reducing soil oxygen diffusion over large spatial scales.

Higher humidity generally promotes lower aerobic potential.

###### Supporting Climate Layers

- [Time of Wetness (TOW)](https://secure.engineeringdirector.com/public/map/tow_global_2020_2024_ERA5)
- [Mean Annual Precipitation](https://secure.engineeringdirector.com/public/map/mean_annual_precip_2020_2024)

---

##### 5. Lithology Permeability Component

- GLiM Lithology Permeability Modifier

Lithologic permeability influences regional drainage efficiency and subsurface oxygen mobility.

Permeable lithologies generally increase aerobic conditions, while low-permeability lithologies increase saturation persistence.

---

#### Model Integration

The Aerobic Soil Index is generated using a weighted environmental integration framework:

```python
aerobic_index = (
    (sand * 0.225) +
    ((1 - clay) * 0.135) +
    ((1 - wwp) * 0.135) +
    ((1 - cec) * 0.09) +
    ((1 - bd) * 0.09) +
    ((1 - humidity) * 0.135) +
    (awch * 0.045) +
    (glim * 0.135)
)

---

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