# Saturated water content (volumetric fraction) AWCTS (100-200cm) (`AWCtS_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**: Saturated water content (volumetric fraction) AWCTS (100-200cm)
- **Slug**: `AWCtS_M_sl7_1km_ll`
- **Units**: `mm/m`
- **Spatial Extent**: UL(83.9991672, -180.0) to LR(-56.0008328, 180.0)
- **Summary**: Saturated water content of the soil, expressed as a volumetric fraction (m³/m³ or %), representing the maximum amount of water the fine earth fraction can retain when all pore spaces are fully filled. This parameter characterizes the soil’s total pore volume and is a key factor influencing water storage capacity, hydraulic behavior, and subsurface transport processes within the integrated 100–200 cm soil profile.
- **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
- `(25.0, (245.0, 222.0, 179.0))`
- `(25.3, (244.0, 220.8, 177.6))`
- `(25.6, (243.0, 219.6, 176.2))`
- `(25.9, (242.0, 218.4, 174.8))`
- `(26.2, (241.0, 217.2, 173.4))`
- `(26.5, (240.0, 216.0, 172.0))`
- `(26.8, (239.0, 214.8, 170.6))`
- `(27.1, (238.0, 213.6, 169.2))`
- `(27.4, (237.0, 212.4, 167.8))`
- `(27.7, (236.0, 211.2, 166.4))`
- `(28.0, (235.0, 210.0, 165.0))`
- `(28.0, (235.0, 210.0, 165.0))`

# AWCtS_M_sl7_1km_ll.tif — Technical Specification and Citation

## Parameter Name
- **AWCtS**
- **Definition:** Available Water Capacity of Soil

## Description
This dataset represents the modeled available water capacity (AWC) of soil within the depth interval corresponding to:
- Soil Layer 7 (100–200 cm).

Available Water Capacity represents the amount of water that soil can store and make available for plant uptake between:
- field capacity,
- and permanent wilting point.

The raster is derived from ISRIC SoilGrids datasets and machine learning soil property estimation workflows.

Available water capacity is an important parameter influencing:
- soil moisture persistence,
- hydrologic behavior,
- vegetation productivity,
- infiltration,
- evapotranspiration,
- and soil corrosion environments.

Higher available water capacity generally indicates:
- increased moisture retention,
- longer wetness persistence,
- and greater potential electrolyte availability within soils.

## Units
- **mm/m**
  - millimeters of plant-available water per 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.

Available Water Capacity is estimated from:
- soil texture,
- organic matter,
- bulk density,
- and hydraulic soil characteristics.

The dataset represents modeled soil hydraulic behavior 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

`AWCtS_M_sl7_1km_ll.tif`

### Components
- **AWCtS** = Available Water Capacity
- **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 | Available Water Capacity |
| Units | mm/m |
| Depth Interval | 100–200 cm |
| Dataset Source | ISRIC SoilGrids |

## Typical Value Interpretation

| AWC (mm/m) | Interpretation |
|---|---|
| 0–50 | Very low water retention |
| 50–100 | Low water retention |
| 100–150 | Moderate water retention |
| 150–250 | High water retention |
| >250 | Very high water retention |

## Soil and Corrosion Relevance

Available Water Capacity strongly influences:
- soil moisture persistence,
- electrolyte retention,
- oxygen diffusion,
- microbial activity,
- and subsurface corrosion environments.

Higher AWC soils may:
- remain wet longer,
- support increased ionic transport,
- and increase corrosion persistence under favorable electrochemical conditions.

Lower AWC soils generally:
- drain more rapidly,
- dry faster,
- and may exhibit lower sustained soil moisture availability.

## Hydrologic Relevance

This raster may be used in:
- hydrologic modeling,
- vegetation analysis,
- drought assessment,
- infiltration modeling,
- evapotranspiration studies,
- and soil moisture persistence estimation.

## Typical Soil Relationships

| Soil Type | Typical AWC Behavior |
|---|---|
| Sandy soils | Low AWC |
| Loamy soils | Moderate to high AWC |
| Clay-rich soils | High AWC but slower drainage |
| Organic soils | Very high AWC |

---

# Important Clarification

This dataset represents:
- modeled plant-available water capacity,

and not:
- instantaneous soil moisture,
- groundwater elevation,
- or seasonal water saturation.

Localized conditions may vary significantly due to:
- irrigation,
- drainage systems,
- shallow groundwater,
- land management,
- vegetation,
- and climate variability.

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

Site-specific engineering applications may require:
- direct soil testing,
- hydraulic conductivity measurements,
- or field calibration.

---

# Related Soil and Environmental Datasets

## Supporting Soil Layers

- [Clay Content](https://secure.engineeringdirector.com/public/map/CLYPPT_M_sl7_1km_ll)
- [Silt Content](https://secure.engineeringdirector.com/public/map/SLTPPT_M_sl7_1km_ll)
- [Organic Carbon Density](https://secure.engineeringdirector.com/public/map/ORCDRC_M_sl7_1km_ll)
- [CEC Soil](https://secure.engineeringdirector.com/public/map/CECSOL_M_sl7_1km_ll)
- [Soil pH](https://secure.engineeringdirector.com/public/map/PHIHOX_M_sl7_1km_ll)

---

## Related Corrosion Layers

- [Aerobic Soil Index](https://secure.engineeringdirector.com/public/map/aerobic_index_1km)
- [Global Soil Resistivity](https://secure.engineeringdirector.com/public/map/soil_resistivity_barnes_ohm-cm_P10108)

---

# Recommended Citations

## Primary Project Citation

> Mazzella, J., Hayden, T., & Engineering Director, Inc./AtmosphericIQ LLC (2025).  
> *Global Soil Moisture and Available Water Capacity 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