# GMSR Subsidence Susceptibility Raster (`GMSR_Subsidence_Susceptibility_v2_0_100`) — 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**: GMSR Subsidence Susceptibility Raster
- **Slug**: `GMSR_Subsidence_Susceptibility_v2_0_100`
- **Units**: `Score (1-100)`
- **Spatial Extent**: UL(90.0026808, -179.9963784) to LR(-90.0026808, 180.0053616)
- **Summary**: The Global Subsidence Susceptibility Raster (GMSR-SUB) is a global geospatial dataset representing relative susceptibility to long-term ground subsidence resulting from consolidation, compaction, settlement, and deformation of soils and sediments.
- **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.6, (92.0, 128.0, 184.0))`
- `(0.9099999999999999, (93.8, 129.4, 185.0))`
- `(1.22, (95.6, 130.8, 186.0))`
- `(1.5299999999999998, (97.4, 132.2, 187.0))`
- `(1.8399999999999999, (99.2, 133.6, 188.0))`
- `(2.15, (101.0, 135.0, 189.0))`
- `(2.46, (102.8, 136.4, 190.0))`
- `(2.77, (104.6, 137.8, 191.0))`
- `(3.08, (106.4, 139.2, 192.0))`
- `(3.39, (108.2, 140.6, 193.0))`
- `(3.7, (110.0, 142.0, 194.0))`
- `(3.7, (110.0, 142.0, 194.0))`

# Global Subsidence Susceptibility Raster (GMSR-SUB) v2.0

**Raster File**

`GMSR_Subsidence_Susceptibility_v2_0_100.tif`

**Public Dataset URL**

https://secure.engineeringdirector.com/public/map/GMSR_Subsidence_Susceptibility_v2_0_100

---

# Product Overview

The Global Subsidence Susceptibility Raster (GMSR-SUB) is a global geospatial dataset representing relative susceptibility to long-term ground subsidence resulting from consolidation, compaction, settlement, and deformation of soils and sediments.

Subsidence is commonly associated with lowland environments, wetlands, floodplains, organic-rich soils, soft unconsolidated sediments, and hydrogeologic conditions favorable for long-term settlement and compression.

The dataset identifies landscapes exhibiting environmental, hydrologic, soil, and geological conditions favorable for subsidence processes and provides a continuous susceptibility score ranging from 0–100.

The product serves as a major component within the Global Ground Movement Susceptibility Raster (GMSR) framework.

Applications include:

* Infrastructure planning
* Transportation corridor assessment
* Utility route planning
* Pipeline risk assessment
* Asset management
* Engineering screening
* Geotechnical investigations
* Floodplain management
* Climate adaptation planning
* Long-term ground deformation assessment

---

# Product Family

The Global Subsidence Susceptibility Raster (GMSR-SUB) is one of five component products comprising the Global Ground Movement Susceptibility Raster (GMSR) framework.

Component products include:

* Landslide Susceptibility
* Soil Creep Potential
* Shrink-Swell Potential
* Subsidence Susceptibility
* Seismic Amplification

These component rasters may be used independently or within the integrated GMSR framework.

---

# Product Status

| Attribute         | Value         |
| ----------------- | ------------- |
| Product Status    | Released      |
| Validation Status | Expert Review |
| Version           | 2.0           |
| Release Date      | 2026          |

---

# Dataset Information

| Attribute                  | Value                                                                              |
| -------------------------- | ---------------------------------------------------------------------------------- |
| Product Name               | Global Subsidence Susceptibility Raster                                            |
| Short Name                 | GMSR-SUB                                                                           |
| Version                    | 2.0                                                                                |
| Coverage                   | Global                                                                             |
| Coordinate System          | WGS 84 (EPSG:4326)                                                                 |
| Resolution                 | ~1 km                                                                              |
| Raster Format              | GeoTIFF                                                                            |
| Cell Type                  | Float32                                                                            |
| Standardized Display Range | 0–100                                                                              |
| Observed Raster Range      | 0.12–88.47                                                                         |
| Units                      | Relative Susceptibility Score                                                      |
| NoData Value               | None                                                                               |
| Temporal Basis             | Contemporary Global Terrain, Hydrologic, Soil, Wetland, and Hydrogeologic Datasets |
| Update Frequency           | Periodic                                                                           |
| Primary Output             | Subsidence Susceptibility Score                                                    |

---

# Raster Statistics

| Statistic          | Value |
| ------------------ | ----: |
| Minimum            |  0.12 |
| Maximum            | 88.47 |
| Mean               | 14.49 |
| Standard Deviation | 14.72 |

---
# Spatial Distribution Characteristics

The Global Subsidence Susceptibility Raster exhibits a spatially concentrated distribution pattern compared to some other GMSR component products.

Unlike hazards that may occur across broad regional landscapes, subsidence susceptibility is primarily associated with specific environmental settings including:

- Wetlands
- Floodplains
- Delta systems
- Coastal lowlands
- Organic-rich soils
- Saturated landscapes
- Soft sedimentary basins

As a result, extensive areas of the global land surface may display very low susceptibility values while elevated susceptibility is concentrated within geographically distinct zones.

This pattern reflects the underlying environmental controls governing subsidence processes and should not be interpreted as incomplete spatial coverage, missing data, or deficiencies in the modeling framework. Areas exhibiting low susceptibility scores represent locations where the environmental conditions associated with long-term settlement and consolidation are comparatively limited.

The spatial concentration of elevated susceptibility values is consistent with the known geographic distribution of wetlands, floodplains, deltaic environments, peatlands, and other subsidence-prone landscapes documented in the scientific literature.

---

# Score Interpretation

| Score Range | Interpretation                      |
| ----------- | ----------------------------------- |
| 0–20        | Very Low Subsidence Susceptibility  |
| 20–40       | Low Subsidence Susceptibility       |
| 40–60       | Moderate Subsidence Susceptibility  |
| 60–80       | High Subsidence Susceptibility      |
| 80–100      | Very High Subsidence Susceptibility |

Scores represent relative susceptibility and should not be interpreted as measured subsidence rates.

---

# Visualization Standard

The official GMSR product family visualization standard is used.

| Color Theme | Interpretation          |
| ----------- | ----------------------- |
| Blue        | Low Susceptibility      |
| Cream / Tan | Moderate Susceptibility |
| Orange      | Elevated Susceptibility |
| Red         | High Susceptibility     |

The GMSR product family utilizes a standardized 0–100 visualization scale to ensure consistent interpretation across all component and composite products.

Individual raster datasets may not occupy the full 0–100 range; however, the visualization standard remains fixed to support cross-product comparison and portfolio-level analysis.

Display legends are standardized across the GMSR product family and may extend beyond the observed minimum and maximum raster values. Actual raster statistics are reported within the Dataset Information and Raster Statistics sections.

---

# Methodology Summary

The Global Subsidence Susceptibility Raster evaluates long-term susceptibility to gradual land-surface lowering using hydrologic, geomorphic, soil, wetland, and hydrogeologic controls known to influence settlement and consolidation processes.

Primary factors include:

* Lowland Terrain Position (HAND)
* Wetlands
* Soft Soil Distribution
* Saturation Potential
* River Influence
* Drainage Position
* Hydrogeologic Susceptibility

Areas exhibiting persistent saturation, soft or organic-rich soils, low-relief terrain, floodplain environments, and favorable hydrogeologic conditions receive higher subsidence susceptibility scores.

---

# Input Variables

## HAND (Height Above Nearest Drainage)

Represents terrain position relative to drainage networks.

Low HAND values identify:

* Floodplains
* River valleys
* Deltaic environments
* Coastal lowlands

These settings are commonly associated with long-term settlement and subsidence processes.

## Wetlands

Derived from the Global Lakes and Wetlands Database (GLWD).

Wetland environments often contain:

* Organic soils
* Peat deposits
* Saturated sediments
* Compressible materials

These characteristics contribute to elevated subsidence susceptibility.

## Soft Soil Distribution

Derived from global soil classification datasets including WRB and SoilGrids.

Highly compressible soils receive elevated susceptibility scores.

Representative soil groups include:

* Histosols
* Gleysols
* Fluvisols

## Saturation Potential

Represents persistent wetness conditions and long-term soil saturation.

Prolonged saturation promotes consolidation and settlement of susceptible materials.

## River Influence

Represents proximity to river systems and active depositional environments.

River corridors commonly contain unconsolidated sediments susceptible to settlement and compaction.

## Drainage Position

Represents relative landscape position within drainage systems.

Lower drainage positions generally exhibit greater susceptibility to saturation and sediment accumulation.

## Hydrogeologic Susceptibility

Derived from the GLHYMPS hydrogeology framework.

Hydrogeologic properties including porosity, hydraulic conductivity, and transmissivity contribute to overall subsidence susceptibility.

---

# Relationship to GMSR

The Subsidence Susceptibility Raster serves as a major component of the Global Ground Movement Susceptibility Raster (GMSR).

## Product Lineage

This dataset is a component product within the Global Ground Movement Susceptibility Raster (GMSR) framework and contributes 15% of the final composite GMSR score.

## GMSR Weighting

| Component                 | Weight |
| ------------------------- | -----: |
| Landslide Susceptibility  |    30% |
| Soil Creep Potential      |    20% |
| Shrink-Swell Potential    |    15% |
| Subsidence Susceptibility |    15% |
| Seismic Amplification     |    20% |

---

# Validation

## Validation Approach

Validation was performed through expert review of known wetland systems, peatland regions, floodplains, deltaic environments, coastal lowlands, and sedimentary basins commonly associated with long-term settlement and subsidence processes.

High-scoring regions were compared against known geographic settings where subsidence-prone conditions are well documented.

## Validation Summary

The raster demonstrates strong agreement with known environments susceptible to long-term settlement and consolidation including:

* Scandinavia
* Western Siberia
* Eastern China
* Northern India
* Major River Deltas
* Coastal Lowlands
* North American Wetland Complexes

These regions exhibit environmental conditions commonly associated with elevated subsidence susceptibility.

---

# Source Datasets

* [GEBCO Global Bathymetry and Elevation](https://www.gebco.net)

* [Global Lakes and Wetlands Database (GLWD)](https://www.worldwildlife.org/pages/global-lakes-and-wetlands-database)

* [GLHYMPS Global Hydrogeology Dataset](https://www.hydrosheds.org/page/glhymps)

* [ISRIC SoilGrids](https://soilgrids.org)

* [World Reference Base for Soil Resources (WRB)](https://www.fao.org/soils-portal/data-hub/soil-classification/world-reference-base)

---

# Related Products

## Primary GMSR Products

* [GMSR v1 Ground Movement Susceptibility (0–100)](https://secure.engineeringdirector.com/public/map/GMSR_v1_Global_Ground_Movement_Susceptibility_0_100)

* [GMSR v1 Ground Movement Susceptibility Class 1–7](https://secure.engineeringdirector.com/public/map/GMSR_v1_Global_Ground_Movement_Susceptibility_Class_7)

## GMSR Component Products

* [Landslide Susceptibility](https://secure.engineeringdirector.com/public/map/GMSR_Landslide_Susceptibility_0_100)

* [Soil Creep Potential](https://secure.engineeringdirector.com/public/map/GMSR_Soil_Creep_Potential_0_100)

* [Shrink-Swell Potential](https://secure.engineeringdirector.com/public/map/GMSR_Shrink_Swell_v2_0_100)

* [Subsidence Susceptibility](https://secure.engineeringdirector.com/public/map/GMSR_Subsidence_Susceptibility_v2_0_100)

* [Seismic Amplification](https://secure.engineeringdirector.com/public/map/GMSR_Seismic_Amplification_0_100)

---

# Limitations

* Intended for screening and planning purposes.
* Not a substitute for site-specific geotechnical investigation.
* Does not predict subsidence rates.
* Does not estimate future ground lowering magnitude.
* Does not account for local groundwater extraction.
* Does not incorporate mining-related subsidence.
* Does not incorporate local monitoring data.
* Does not represent real-time conditions.

---

# Revision History

| Version | Date | Description                                                                      |
| ------- | ---- | -------------------------------------------------------------------------------- |
| 2.0     | 2026 | Initial public release of the Global Subsidence Susceptibility Raster framework. |

---

# Source Citations

## GEBCO

GEBCO Compilation Group.

The General Bathymetric Chart of the Oceans (GEBCO).

International Hydrographic Organization (IHO) and Intergovernmental Oceanographic Commission (IOC).

## GLWD

Lehner, B., & Döll, P. (2004).

Development and validation of a global database of lakes, reservoirs, and wetlands.

Journal of Hydrology.

## GLHYMPS

Gleeson, T., Moosdorf, N., Hartmann, J., & van Beek, L.

A global hydrogeological data set for groundwater and Earth system modeling.

Geophysical Research Letters.

## SoilGrids

Poggio, L., de Sousa, L., Batjes, N., et al.

SoilGrids 2.0: Producing soil information for the globe.

SOIL.

## WRB

IUSS Working Group WRB.

World Reference Base for Soil Resources.

Food and Agriculture Organization of the United Nations.

---

# Attribution

Joseph Mazzella

Nicole Mazzella

AtmosphericIQ LLC

Engineering Director, Inc.

---

# Dataset Citation

Mazzella, J., Mazzella, N. (2026).

*Global Subsidence Susceptibility Raster (GMSR-SUB) v2.0.*

AtmosphericIQ LLC / Engineering Director, Inc.

---

# Version Information

| Property                   | Value                                          |
| -------------------------- | ---------------------------------------------- |
| Dataset Name               | Global Subsidence Susceptibility Raster        |
| Dataset Version            | 2.0                                            |
| Publication Year           | 2026                                           |
| Authors                    | Joseph Mazzella, Nicole Mazzella               |
| Organization               | AtmosphericIQ LLC / Engineering Director, Inc. |
| Resolution                 | ~1 km                                          |
| Coordinate System          | WGS 84 (EPSG:4326)                             |
| Coverage                   | Global                                         |
| Standardized Display Range | 0–100                                          |
| Observed Raster Range      | 0.12–88.47                                     |
| Raster Type                | Continuous                                     |
| Cell Type                  | Float32                                        |
| Primary Output             | Subsidence Susceptibility Score                |
| Processing Framework       | GMSR Subsidence Susceptibility Framework       |


---

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