# Global Ground Movement Susceptibility Raster (GMSR) (0-100) (`GMSR_v1_Global_Ground_Movement_Susceptibility_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**: Global Ground Movement Susceptibility Raster (GMSR) (0-100)
- **Slug**: `GMSR_v1_Global_Ground_Movement_Susceptibility_0_100`
- **Units**: `Index Score (0–100)`
- **Spatial Extent**: UL(90.0026808, -179.9963784) to LR(-90.0026808, 180.0053616)
- **Summary**: The Global Ground Movement Susceptibility Raster (GMSR) is a global geospatial dataset representing relative susceptibility to long-term ground movement hazards.
- **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 Ground Movement Susceptibility Raster (GMSR) v1.0.2

**Raster File**

`GMSR_v1_Global_Ground_Movement_Susceptibility_0_100.tif`

**Public Dataset URL**

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

---

# Product Overview

The Global Ground Movement Susceptibility Raster (GMSR) is a global geospatial dataset representing relative susceptibility to long-term ground movement hazards.

The framework integrates five independently modeled geohazard processes:

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

The resulting raster provides a continuous score ranging from 0–100, where higher values indicate greater susceptibility to geotechnical ground movement processes.

The dataset is intended for:

* Infrastructure planning
* Site screening
* Climate resilience analysis
* Engineering due diligence
* Asset portfolio risk assessment
* Environmental planning
* Geotechnical hazard screening
* Catastrophe risk modeling

---

# Dataset Information

| Attribute         | Value                                                          |
| ----------------- | -------------------------------------------------------------- |
| Product Name      | Global Ground Movement Susceptibility Raster (GMSR)            |
| Version           | 1.0.2                                                          |
| Coverage          | Global                                                         |
| Coordinate System | WGS 84 (EPSG:4326)                                             |
| Resolution        | ~1 km                                                          |
| Raster Format     | GeoTIFF                                                        |
| Cell Type         | Float32                                                        |
| Value Range       | 0–100                                                          |
| Units             | Relative Susceptibility Score                                  |
| NoData Value      | None                                                           |
| Temporal Basis    | 2020–2024 Climate Normals and Contemporary Geological Datasets |
| Update Frequency  | Periodic                                                       |
| Primary Output    | Ground Movement Susceptibility Score                           |

---

# Product Status

| Attribute              | Value                               |
| ---------------------- | ----------------------------------- |
| Status                 | Production Release                  |
| Validation Status      | Independently Validated             |
| Validation Dataset     | NASA Global Landslide Catalog       |
| Validation Sample Size | 11,001 Independent Landslide Events |
| Validation Metric      | AUC (Area Under the Curve)          |
| Validation Result      | 0.893                               |
| Publication Year       | 2026                                |
| Current Version        | 1.0.2                               |

---

# Raster Statistics

| Statistic          | Value |
| ------------------ | ----: |
| Minimum            |  0.60 |
| Maximum            | 97.00 |
| Mean               | 20.56 |
| Standard Deviation | 10.38 |

### Interpretation

The observed maximum value of 97.00 indicates that no location globally achieved the theoretical maximum susceptibility score.

The standardized 0–100 display range is retained to ensure consistency across all GMSR component products and the composite framework.

---

# Score Interpretation

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

Scores represent relative susceptibility and should not be interpreted as probability of failure.

---

# Visualization Standard

The public GMSR v1 0–100 raster is rendered using a continuous susceptibility color ramp designed for global-scale visualization and interpretation.

Color progression follows increasing susceptibility:

* Blue — Very Low Susceptibility
* Blue-Green — Low Susceptibility
* Cream / Tan — Moderate Susceptibility
* Orange — High Susceptibility
* Red — Very High Susceptibility

The visualization standard is intended for interpretation and communication purposes only and does not alter underlying raster values.

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.

---

# GMSR Framework

The GMSR framework combines five independently developed susceptibility surfaces into a single composite index.

## Component Weighting

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

Each component raster was independently developed, normalized, and validated prior to integration within the composite framework. The final GMSR raster combines these component products using a weighted susceptibility methodology to provide a globally consistent screening-level assessment of ground movement susceptibility.

## Composite Equation

```text
GMSR =
0.30 × Landslide Susceptibility
+ 0.20 × Soil Creep Potential
+ 0.15 × Shrink–Swell Potential
+ 0.15 × Subsidence Susceptibility
+ 0.20 × Seismic Amplification
```

## Missing Data Handling

The final composite uses available-data weighted normalization.

Where one or more component datasets contain NoData values, available component weights are automatically normalized to preserve the 0–100 scoring framework.

This methodology minimizes artificial gaps while maintaining global coverage.

---

# Methodology Summary

## Landslide Susceptibility

Evaluates terrain susceptible to gravitational mass movement using:

* Slope Gradient
* Local Relief
* Climate Wetness
* Root Zone Soil Moisture
* Lithologic Susceptibility

## Soil Creep Potential

Evaluates slow long-term downslope soil movement using:

* Slope Gradient
* Local Relief
* Climate Wetness Index
* Root Zone Soil Moisture
* Freeze–Thaw Cycles
* Wet–Dry Cycles
* Lithologic Susceptibility

## Shrink–Swell Potential

Evaluates expansive soil behavior using:

* SoilGrids Clay Content
* WRB Vertisol Occurrence
* Soil Wilting Point
* Wet–Dry Cycles

## Subsidence Susceptibility

Evaluates susceptibility to gradual settlement resulting from:

* Lowland Topographic Position
* Wetland Occurrence
* Soil Saturation Potential
* River Influence
* Drainage Position
* Soft Soil Susceptibility
* Hydrogeologic Conditions

## Seismic Amplification

Evaluates susceptibility to amplified ground shaking using:

* Global Seismic Hazard
* Lithologic Susceptibility
* Slope Gradient
* Local Relief

---

# Validation

The NASA Global Landslide Catalog was not used during model development, calibration, weighting, or raster generation and therefore provides an independent validation dataset.

The GMSR framework was independently evaluated against documented landslide events from the NASA Global Landslide Catalog.

Validation was performed by comparing GMSR susceptibility scores at landslide event locations against randomly distributed global background locations.

## Validation Dataset

| Attribute                        | Value                          |
| -------------------------------- | ------------------------------ |
| Validation Dataset               | NASA Global Landslide Catalog  |
| Original Records                 | 11,059                         |
| Valid Landslide Events Evaluated | 11,001                         |
| Random Background Locations      | 33,883                         |
| Validation Method                | Event-Based Spatial Comparison |
| Validation Metric                | Area Under Curve (AUC)         |

## Validation Results

| Metric                  | Value |
| ----------------------- | ----: |
| Landslide Mean GMSR     | 36.79 |
| Random Mean GMSR        | 20.61 |
| Landslide Median GMSR   | 36.72 |
| Random Median GMSR      | 21.73 |
| Landslide Class 5–7 (%) | 85.41 |
| Random Class 5–7 (%)    | 21.71 |
| Landslide Class 7 (%)   |  1.37 |
| Random Class 7 (%)      |  0.10 |
| AUC                     | 0.893 |

### Understanding AUC

AUC (Area Under the Receiver Operating Characteristic Curve) measures the ability of a model to distinguish between documented hazard locations and randomly distributed background locations.

An AUC value of 0.50 indicates no discriminatory power, while a value of 1.00 indicates perfect separation.

The GMSR validation achieved an AUC of 0.893, indicating strong correspondence between elevated susceptibility scores and observed landslide occurrence.

In practical terms, if a documented landslide location and a random global location are selected at random, there is approximately an 89.3% probability that the landslide location will receive a higher GMSR susceptibility score.

### Validation Interpretation

Documented landslide occurrences were strongly concentrated within elevated GMSR susceptibility classes relative to randomly distributed global locations.

Approximately 85% of evaluated landslide events occurred within GMSR Classes 5–7, while only 22% of random background locations occurred within those same classes.

The resulting AUC value of 0.893 indicates strong agreement between elevated GMSR susceptibility scores and observed landslide occurrence at global scale.

---

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

---

# Source Datasets

* [GEBCO Global Bathymetry and Elevation](https://www.gebco.net)
* [Global Lithological Map (GLiM)](https://doi.org/10.1029/2012GC004370)
* [ISRIC SoilGrids](https://soilgrids.org)
* [NASA FLDAS Root Zone Soil Moisture](https://ldas.gsfc.nasa.gov/fldas)
* [World Reference Base for Soil Resources (WRB)](https://www.fao.org/soils-portal/data-hub/soil-classification/world-reference-base)
* [Global Seismic Hazard Model (GEM Foundation)](https://www.globalquakemodel.org/product/global-seismic-hazard-map)

## Validation Datasets

* [NASA Global Landslide Catalog](https://data.nasa.gov/dataset/global-landslide-catalog-export)

## Derived Internal Datasets

* [Freeze–Thaw Cycles Dataset](https://secure.engineeringdirector.com/public/map/Freeze_Thaw_2020_2024_ERA5)
* [Wet–Dry Cycles Dataset](https://secure.engineeringdirector.com/public/map/wet_dry_cycles_2020_2024_ERA5)

---

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

---

# Limitations

* Intended for screening and planning purposes.
* Not a substitute for site-specific geotechnical investigation.
* Does not predict timing of failures.
* Does not represent actual displacement rates.
* Does not incorporate local engineering controls.
* Does not include real-time monitoring information.
* Validation is based on documented landslide occurrence and does not independently validate all contributing ground movement mechanisms.
* Susceptibility scores represent relative conditions and should not be interpreted as event probability.

---

# Version History

| Version | Date | Description                                                                                                                                                                                                     |
| ------- | ---- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 1.0     | 2026 | Initial public release                                                                                                                                                                                          |
| 1.0.1   | 2026 | Added NASA Global Landslide Catalog validation, validation statistics, AUC documentation, finalized public URLs, official visualization standard, and publication-ready metadata.                               |
| 1.0.2   | 2026 | Updated component methodology documentation following production code audit. Added WRB source dataset and refined framework documentation to reflect validated component model inputs and weighting structures. |

---

# Attribution

Joseph Mazzella

Nicole Mazzella

AtmosphericIQ LLC

Engineering Director, Inc.

---

# Dataset Citation

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

*Global Ground Movement Susceptibility Raster (GMSR) v1.0.2.*

AtmosphericIQ LLC / Engineering Director, Inc.

---
# Version Information

| Property                   | Value                                               |
| -------------------------- | --------------------------------------------------- |
| Dataset Name               | Global Ground Movement Susceptibility Raster (GMSR) |
| Dataset Version            | 1.0.2                                               |
| 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.60–97.00                                          |
| Raster Type                | Continuous                                          |
| Cell Type                  | Float32                                             |
| Primary Output             | Ground Movement Susceptibility Score                |
| Validation Dataset         | NASA Global Landslide Catalog                       |
| Validation Sample Size     | 11,001 Independent Landslide Events                 |
| Validation AUC             | 0.893                                               |
| Processing Framework       | GMSR v1 Composite Geohazard 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
