# GLiM Lithology Constraint Favorability Index (0-100) (`GLiM_Lithology_Constraint_1km_WGS84_UINT8`) — 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**: GLiM Lithology Constraint Favorability Index (0-100)
- **Slug**: `GLiM_Lithology_Constraint_1km_WGS84_UINT8`
- **Units**: `dimensionless Index (0-100)`
- **Spatial Extent**: UL(89.9835615, -179.9999889) to LR(-89.9991237, 179.9989201)
- **Summary**: The GLiM Lithology Constraint raster represents a global lithologic favorability layer derived from the GLiM global lithology database. The raster classifies surface lithology into relative hydrogeologic favorability values based on the likelihood that mapped geologic materials support groundwater storage, groundwater transmission, confined aquifer development, or artesian-style hydrogeologic conditions.

Higher values indicate lithologies more favorable for groundwater occurrence and artesian susceptibility, such as unconsolidated sediments, sedimentary rocks, carbonates, and alluvial systems. Lower values indicate lithologies generally less favorable for groundwater storage or confined groundwater development, such as crystalline basement, igneous, volcanic, and metamorphic terrains.
- **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, (210.0, 180.0, 140.0))`
- `(0.5, (208.5, 178.0, 138.0))`
- `(1.0, (207.0, 176.0, 136.0))`
- `(1.5, (205.5, 174.0, 134.0))`
- `(2.0, (204.0, 172.0, 132.0))`
- `(2.5, (202.5, 170.0, 130.0))`
- `(3.0, (201.0, 168.0, 128.0))`
- `(3.5, (199.5, 166.0, 126.0))`
- `(4.0, (198.0, 164.0, 124.0))`
- `(4.5, (196.5, 162.0, 122.0))`
- `(5.0, (195.0, 160.0, 120.0))`
- `(5.0, (195.0, 160.0, 120.0))`

# GLiM Lithology Constraint

**Global | ~1 km Resolution | Version 1**

---

## Raster Name

GLiM Lithology Constraint

---

## File Name

`GLiM_Lithology_Constraint_1km_WGS84.tif`

---

## S3 Location

`s3://aiq-file-storage/Artesian_Wells/GLiM_Lithology_Constraint_1km_WGS84.tif`

---

## Short Description

The GLiM Lithology Constraint raster represents a global lithologic favorability layer derived from the GLiM global lithology database. The raster classifies surface lithology into relative hydrogeologic favorability values based on the likelihood that mapped geologic materials support groundwater storage, groundwater transmission, confined aquifer development, or artesian-style hydrogeologic conditions.

Higher values indicate lithologies more favorable for groundwater occurrence and artesian susceptibility, such as unconsolidated sediments, sedimentary rocks, carbonates, and alluvial systems. Lower values indicate lithologies generally less favorable for groundwater storage or confined groundwater development, such as crystalline basement, igneous, volcanic, and metamorphic terrains.

---

## Units of Measure

Lithologic Favorability Index (0–100, dimensionless)

---

## Technical Specification

This raster was derived from GLiM lithology polygons by assigning hydrogeologic favorability scores to lithology classes and rasterizing the result to a global ~1 km grid.

The layer is used as a geologic constraint and fallback support layer within the Artesian Well Likelihood framework.

---

## General Lithology Scoring Logic

| Lithology Type | Relative Favorability |
|---|---|
| Unconsolidated sediments | Very High |
| Carbonate sedimentary rocks | Very High |
| Siliciclastic sedimentary rocks | High |
| Mixed sedimentary rocks | High |
| Evaporites | Moderate to High |
| Volcanic rocks | Low |
| Plutonic rocks | Very Low |
| Metamorphic rocks | Very Low |
| Ice / non-geologic cover | Very Low or NoData |
| Water bodies | NoData / not modeled |

---

## Model Role Within Artesian Framework

The GLiM Lithology Constraint helps the model:

- reinforce sedimentary and alluvial systems
- suppress crystalline shield regions
- improve geologic continuity
- reduce unrealistic groundwater favorability in igneous and metamorphic terrains
- provide geologic fallback support where hydrogeologic datasets are incomplete

This layer is especially important for differentiating broad geologic terrain classes at global scale.

---

## Interpretation Guidance

| Value Range | Interpretation |
|---|---|
| 0–20 | Very low lithologic favorability |
| 20–40 | Low lithologic favorability |
| 40–60 | Moderate lithologic favorability |
| 60–80 | High lithologic favorability |
| 80–100 | Very high lithologic favorability |

---

## Spatial Characteristics

| Property | Value |
|---|---|
| Coverage | Global |
| Resolution | ~1 km |
| Coordinate System | GCS_WGS_1984 |
| Projection | EPSG:4326 |
| Pixel Type | 32-bit Float / classified numeric index |

---

## Data Source

Derived from:

**GLiM — Global Lithological Map**

GLiM provides global polygon-based lithologic classifications used to characterize surface geology and dominant lithologic units.

---

## Processing Workflow

Processing included:

- GLiM polygon ingestion
- lithology code interpretation
- hydrogeologic favorability scoring
- rasterization to ~1 km global grid
- reprojection to WGS84
- GeoTIFF export for web and API deployment

---

## Related Artesian Framework Layers

- [Artesian Well Likelihood (1–100)](https://secure.engineeringdirector.com/public/map/Artesian_Well_Likelihood_1km_Industry_Filled_webfile)
- [Artesian Well Likelihood Index (1–5)](https://secure.engineeringdirector.com/public/map/Artesian_Well_Likelihood_Class_1km_Industry_Filled_webfile)
- [GLHYMPS Hydraulic Conductivity (logK)](https://secure.engineeringdirector.com/public/map/GLHYMPS_Hydrogeology_Constraint_1km_WGS84_UINT8)
- [GLHYMPS Porosity](https://secure.engineeringdirector.com/public/map/GLHYMPS_Porosity_1km_WGS84_UINT8)
- [GLHYMPS Transmissivity](https://secure.engineeringdirector.com/public/map/GLHYMPS_Transmissivity_1km_WGS84_UINT8_v3)
- [GLHYMPS Hydrogeology Constraint](https://secure.engineeringdirector.com/public/map/GLHYMPS_Hydrogeology_Constraint_1km_WGS84_UINT8)



---

## Intended Applications

This raster is intended for:

- hydrogeologic screening
- artesian groundwater likelihood modeling
- infrastructure planning
- pipeline corridor assessment
- regional groundwater analysis
- geologic constraint mapping
- enterprise GIS and API workflows

---

## Limitations

This raster represents generalized lithologic favorability at global scale and should not be interpreted as:

- site-specific geologic mapping
- aquifer yield prediction
- groundwater depth prediction
- direct artesian well occurrence
- subsurface stratigraphic interpretation

Surface lithology may not fully represent deeper confined aquifer systems, buried sedimentary basins, or local hydrostratigraphy.

Site-specific geologic and hydrogeologic investigation remains necessary for engineering or groundwater development decisions.

---

## Confidence Statement

The GLiM Lithology Constraint provides a globally consistent lithologic screening layer that improves geologic realism in the Artesian Well Likelihood framework. It is best used as a regional-scale geologic favorability indicator and supporting constraint rather than a standalone predictor of artesian groundwater conditions.

---

## Data Access & API Services

Available through Engineering Director platforms for:

- interactive mapping
- API integration
- enterprise GIS
- raster query workflows
- hydrogeologic screening

---

## Legal & Licensing

© 2026 AtmosphericIQ LLC and Engineering Director, Inc. All rights reserved.

GLiM source data copyright remains with original dataset authors and contributors. Derived raster products and processing workflows are proprietary.

---

## Dataset Citation

Mazzella, J. (2026).

**GLiM Lithology Constraint, Global 1 km Hydrogeologic Raster Framework.**

AtmosphericIQ LLC / Engineering Director, Inc.

---

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