# Organic Carbon Density (kg/m³) (100-200cm) (`OCDENS_M_sl7_1km_ll`) — 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**: Organic Carbon Density (kg/m³) (100-200cm)
- **Slug**: `OCDENS_M_sl7_1km_ll`
- **Units**: `kg/m³`
- **Spatial Extent**: UL(83.9991672, -180.0) to LR(-56.0008328, 180.0)
- **Summary**: Organic Carbon Density represents the estimated mass of soil organic carbon stored within a given soil volume and depth interval.
- **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, (255.0, 248.0, 220.0))`
- `(2.5, (254.0, 245.4, 215.9))`
- `(5.0, (253.0, 242.8, 211.8))`
- `(7.5, (252.0, 240.2, 207.7))`
- `(10.0, (251.0, 237.6, 203.6))`
- `(12.5, (250.0, 235.0, 199.5))`
- `(15.0, (249.0, 232.4, 195.4))`
- `(17.5, (248.0, 229.8, 191.3))`
- `(20.0, (247.0, 227.2, 187.2))`
- `(22.5, (246.0, 224.6, 183.1))`
- `(25.0, (245.0, 222.0, 179.0))`
- `(25.0, (245.0, 222.0, 179.0))`

# OCDENS_M_sl7_1km_ll.tif — Technical Specification and Citation

## Parameter Name
- **OCDENS**
- **Definition:** Organic Carbon Density

## Description

This dataset represents the modeled organic carbon density of soil within the depth interval corresponding to:
- Soil Layer 7 (100–200 cm).

Organic Carbon Density represents the estimated mass of soil organic carbon stored within a given soil volume and depth interval.

The raster is derived from:
- ISRIC SoilGrids datasets,
- global soil profile observations,
- and machine learning soil property estimation workflows.

Organic carbon density is an important parameter influencing:
- soil fertility,
- microbial activity,
- soil resistivity,
- moisture retention,
- oxygen diffusion,
- and soil corrosion environments.

Higher organic carbon density generally indicates:
- increased biologic activity,
- increased moisture persistence,
- lower soil aeration,
- and potentially more aggressive anaerobic corrosion environments.

Deep organic carbon layers may also indicate:
- historic wetland conditions,
- buried organics,
- peat influence,
- or long-term soil accumulation environments.

## Units
- **kg/m³**
  - kilograms of organic carbon per cubic meter of soil

## Depth Level
- **sl7 (Soil Layer 7)**
- Depth interval:
  - **100–200 cm**

## Data Source
- **ISRIC SoilGrids**
- Based on:
  - WoSIS (World Soil Information Service)
  - Global soil profile observations
  - Machine learning prediction frameworks
  - Environmental covariates
  - Random Forest methodologies

## Modeling Methodology

The raster was generated using:
- global soil profile observations,
- machine learning interpolation,
- environmental predictor variables,
- and digital soil mapping methodologies.

Organic carbon density is estimated from:
- organic carbon concentration,
- bulk density,
- soil depth intervals,
- and modeled soil physical properties.

The dataset represents modeled subsurface organic carbon storage at global scale.

## Spatial Characteristics

| Property | Value |
|---|---|
| Coverage | Global (typically excludes Antarctica) |
| Resolution | 1 km |
| Coordinate System | WGS84 (EPSG:4326) |
| Grid Type | Latitude/Longitude |
| Depth Layer | 100–200 cm |

## File Naming Convention

`OCDENS_M_sl7_1km_ll.tif`

### Components
- **OCDENS** = Organic Carbon Density
- **M** = Mean prediction
- **sl7** = Soil Layer 7 (100–200 cm)
- **1km** = Spatial resolution
- **ll** = Latitude/Longitude geographic grid

## ISRIC Metadata Alignment

| Attribute | Description |
|---|---|
| Variable Name | Organic Carbon Density |
| Units | kg/m³ |
| Depth Interval | 100–200 cm |
| Dataset Source | ISRIC SoilGrids |

## Typical Value Interpretation

| Organic Carbon Density (kg/m³) | Interpretation |
|---|---|
| 0–2 | Very low organic carbon |
| 2–5 | Low organic carbon |
| 5–10 | Moderate organic carbon |
| 10–20 | High organic carbon |
| >20 | Very high organic carbon / organic-rich soils |

## Soil and Corrosion Relevance

Organic carbon density strongly influences:
- microbial activity,
- oxygen depletion,
- sulfate reduction,
- soil moisture persistence,
- and electrochemical soil behavior.

Higher organic carbon soils may:
- support anaerobic microbial environments,
- increase sulfide production,
- lower oxidation potential,
- and promote microbiologically influenced corrosion (MIC).

Deep organic-rich soils are often associated with:
- wetlands,
- peat deposits,
- low-drainage environments,
- and highly reducing soil conditions.

Lower organic carbon soils generally:
- exhibit greater aeration,
- faster drainage,
- and reduced biologic corrosion potential.

## Environmental Relevance

This raster may be used in:
- carbon storage estimation,
- soil ecology analysis,
- wetland characterization,
- corrosion risk modeling,
- hydrologic studies,
- and environmental geochemistry.

## Typical Soil Relationships

| Soil Type | Typical Organic Carbon Density |
|---|---|
| Sandy soils | Low |
| Loamy soils | Moderate |
| Clay-rich soils | Moderate to high |
| Organic soils / peat | Very high |

---

# Important Clarification

This dataset represents:
- modeled organic carbon density,

and not:
- instantaneous biologic activity,
- direct microbial populations,
- or measured carbon chemistry at individual sites.

Localized conditions may vary significantly due to:
- land use,
- drainage,
- agricultural activity,
- climate variability,
- vegetation,
- and groundwater conditions.

The raster is optimized for:
- regional and global environmental interpretation.

Site-specific engineering applications may require:
- direct soil sampling,
- laboratory carbon analysis,
- or field validation.

---


# Recommended Citations

## Primary Project Citation

> Mazzella, J., Hayden, T., & Engineering Director, Inc./AtmosphericIQ LLC (2025).  
> *Global Soil Organic Carbon and Corrosion Environment Modeling Framework.*  
> Engineering Director, Inc.

---

## Supporting Soil Dataset Citation

> Poggio, L., de Sousa, L.M., Batjes, N.H., et al. (2021).  
> *SoilGrids 2.0: producing soil information for the globe with quantified spatial uncertainty.*  
> SOIL, 7, 217–240.  
> https://doi.org/10.5194/soil-7-217-2021

---

## Data Citation

> ISRIC – World Soil Information (2020).  
> *SoilGrids250m: Global gridded soil information.*  
> https://soilgrids.org

---

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