# Soil organic carbon content (g/kg) (0-5cm) (`ORCDRC_M_sl1_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**: Soil organic carbon content (g/kg) (0-5cm)
- **Slug**: `ORCDRC_M_sl1_1km_ll`
- **Units**: `g/kg`
- **Spatial Extent**: UL(83.9991672, -180.0) to LR(-56.0008328, 180.0)
- **Summary**: Soil organic carbon content represents the amount of organic carbon contained in the fine earth fraction of the soil. Organic carbon is a key soil property influencing nutrient cycling, water retention, microbial activity, redox behavior, soil structure, and long-term carbon storage.
- **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, (238.0, 236.0, 220.0))`
- `(0.2, (236.2, 233.9, 217.0))`
- `(0.4, (234.4, 231.8, 214.0))`
- `(0.6000000000000001, (232.6, 229.7, 211.0))`
- `(0.8, (230.8, 227.6, 208.0))`
- `(1.0, (229.0, 225.5, 205.0))`
- `(1.2000000000000002, (227.2, 223.4, 202.0))`
- `(1.4000000000000001, (225.4, 221.3, 199.0))`
- `(1.6, (223.6, 219.2, 196.0))`
- `(1.8, (221.8, 217.1, 193.0))`
- `(2.0, (220.0, 215.0, 190.0))`
- `(2.0, (220.0, 215.0, 190.0))`

# ORCDRC_M_sl1_1km_ll.tif — Technical Specification and Citation

## Parameter Name
- **ORCDRC**  
- **Definition:** Soil Organic Carbon Content

## Description
Soil organic carbon content represents the amount of organic carbon contained in the fine earth fraction of the soil. Organic carbon is a key soil property influencing nutrient cycling, water retention, microbial activity, redox behavior, soil structure, and long-term carbon storage.

## Units
- **g/kg**  
  - Grams of organic carbon per kilogram of soil

## Depth Level
- **sl1 (Soil Layer 1)**  
- Depth interval: **0–5 cm**

## Data Source
- **ISRIC SoilGrids**
- Based on:
  - WoSIS (World Soil Information Service)  
  - Machine learning models

## Spatial Characteristics
- **Coverage:** Global (typically excludes Antarctica)  
- **Resolution:** 1 km  
- **Coordinate System:** WGS84 (EPSG:4326)  
- **Grid Type:** Latitude/Longitude (ll)

## File Naming Convention
`ORCDRC_M_sl1_1km_ll.tif`

### Components
- **ORCDRC** = Variable (Soil organic carbon content)  
- **M** = Mean prediction  
- **sl1** = Depth layer (0–5 cm)  
- **1km** = Spatial resolution  
- **ll** = Geographic coordinate grid (latitude/longitude)

## ISRIC Metadata Alignment
- **Variable Name:** Soil organic carbon content  
- **Attribute Title:** Organic carbon content in g/kg at depth 0.00 m  
- **Units:** g/kg  
- **Range Domain:** Continuous positive values

## Typical Value Range

| Organic Carbon (g/kg) | Interpretation |
|------|--------------|
| 0–5 | Very low organic carbon |
| 5–15 | Low organic carbon |
| 15–30 | Moderate organic carbon |
| 30–60 | High organic carbon |
| >60 | Very high organic carbon / organic-rich soils |

## Important Clarification
- **0–5 cm = depth interval (sl1)**  
- Values represent **organic carbon concentration**, not total carbon stock  
- Surface organic carbon can vary strongly with vegetation, land use, drainage, climate, and soil management  
- Organic-rich wetlands, peatlands, forest soils, and grassland soils may show elevated values near the surface

## Recommended Citation

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

### Example Usage Citation
> Soil organic carbon content data (ORCDRC, 0–5 cm) obtained from ISRIC SoilGrids (1 km resolution).

## Notes for Advanced Use
- High organic carbon content may indicate:
  - Organic-rich topsoil  
  - Wetland or peat-influenced environments  
  - Reduced or anaerobic soil conditions  
  - Increased microbial activity  
  - Higher moisture retention  
- Important for:
  - Soil redox interpretation  
  - Corrosion and MIC analysis  
  - Carbon stock modeling  
  - Hydrologic and ecological modeling  
  - Aerobic vs. anaerobic soil potential assessment  

---

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