# Artesian Well Likelihood Index (1–5) (`Artesian_Well_Likelihood_Class_1km_Industry_Filled_webfile`) — 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**: Artesian Well Likelihood Index (1–5)
- **Slug**: `Artesian_Well_Likelihood_Class_1km_Industry_Filled_webfile`
- **Units**: `Unitless (Index 1-5)`
- **Spatial Extent**: UL(89.0001537, -180.0) to LR(-89.0005557, 180.0)
- **Summary**: The Artesian Well Likelihood Index (1–5) provides a simplified classified global hydrogeologic screening layer representing the relative likelihood of artesian, confined, pressurized, or groundwater emergence conditions. The index is derived from the continuous Artesian Well Likelihood Score (1–100) and is intended for rapid screening, corridor prioritization, infrastructure planning, and operational GIS workflows.

The framework integrates terrain hydrology, climate wetness, hydrogeology (GLHYMPS), lithology (GLiM), groundwater convergence, saturation persistence, and empirical groundwater validation into a globally consistent hydrogeologic susceptibility classification system.
- **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
- `(1.0, (245.0, 247.0, 238.0))`
- `(1.1, (241.8, 245.1, 233.2))`
- `(1.2, (238.6, 243.2, 228.4))`
- `(1.3, (235.4, 241.3, 223.6))`
- `(1.4, (232.2, 239.4, 218.8))`
- `(1.5, (229.0, 237.5, 214.0))`
- `(1.6, (225.8, 235.6, 209.2))`
- `(1.7000000000000002, (222.6, 233.7, 204.4))`
- `(1.8, (219.4, 231.8, 199.6))`
- `(1.9, (216.2, 229.9, 194.8))`
- `(2.0, (213.0, 228.0, 190.0))`
- `(2.0, (213.0, 228.0, 190.0))`

# Artesian Well Likelihood Index (1–5)

**Global | ~1 km Resolution | Version 1 (Industry Filled)**

---

## Raster Name

Artesian Well Likelihood Index (1–5)

---

## File Name

`Artesian_Well_Likelihood_Class_1km_Industry_Filled_webfile.tif`

---

## Short Description

The Artesian Well Likelihood Index (1–5) provides a simplified classified global hydrogeologic screening layer representing the relative likelihood of artesian, confined, pressurized, or groundwater emergence conditions. The index is derived from the continuous Artesian Well Likelihood Score (1–100) and is intended for rapid screening, corridor prioritization, infrastructure planning, and operational GIS workflows.

The framework integrates terrain hydrology, climate wetness, hydrogeology (GLHYMPS), lithology (GLiM), groundwater convergence, saturation persistence, and empirical groundwater validation into a globally consistent hydrogeologic susceptibility classification system.

---

# How to Read This Map

The index simplifies the continuous artesian likelihood surface into five operational screening classes.

- **Class 1** represents very low likelihood
- **Class 5** represents very high likelihood

The classification system is designed for:
- rapid interpretation
- corridor screening
- infrastructure planning
- map visualization
- operational prioritization

---

# Units of Measure

Classified Hydrogeologic Index (1–5)

---

# Classification System

| Class | Likelihood Level | General Interpretation |
|---|---|---|
| 1 | Very Low | Terrain generally unfavorable for artesian or confined groundwater conditions |
| 2 | Low | Limited groundwater confinement or saturation persistence potential |
| 3 | Moderate | Transitional hydrogeologic favorability with moderate groundwater persistence |
| 4 | High | Strong groundwater accumulation and hydrogeologic favorability |
| 5 | Very High | Highly favorable terrain for artesian, confined, or pressurized groundwater conditions |

---

# Approximate Continuous Score Equivalency

| Index Class | Approximate Score Range |
|---|---|
| 1 | 0–20 |
| 2 | 21–40 |
| 3 | 41–60 |
| 4 | 61–80 |
| 5 | 81–100 |

---

# Technical Specification

The Artesian Well Likelihood Index is derived from the continuous Artesian Well Likelihood Score through classified threshold segmentation.

The underlying framework integrates:
- terrain hydrology
- climate wetness
- hydrogeologic permeability
- lithologic favorability
- groundwater occurrence validation

into a globally consistent hydrogeologic susceptibility model.

The classification system was designed to provide:
- simplified interpretation
- operational usability
- scalable GIS deployment
- rapid infrastructure screening

---

# Model Components

The index is derived from the following major hydrogeologic components.

---

# 1. Terrain Hydrology Component

## Supporting Rasters

- [HAND – Height Above Nearest Drainage](https://secure.engineeringdirector.com/public/map/HAND_Height_Above_Nearest_Drainage_m)
- [HAND Low-Lying Index](https://secure.engineeringdirector.com/public/map/HAND_Low_Lying_Index_0_1)
- [Saturation Potential Index](https://secure.engineeringdirector.com/public/map/Saturation_Potential_Index_0_1)
- [Drainage Position Index](https://secure.engineeringdirector.com/public/map/Drainage_Position_Index_0_1)
- [River Influence](https://secure.engineeringdirector.com/public/map/River_Influence_20km)
- [Drainage Intensity Index](https://secure.engineeringdirector.com/public/map/Drainage_Index_Normalized_0_1)
- [Distance to River](https://secure.engineeringdirector.com/public/map/Distance_To_River_20km_Geodesic)

These variables describe:
- groundwater convergence
- valley confinement
- saturation persistence
- drainage connectivity
- low-lying terrain favorability

Terrain-derived hydrologic indices form the foundational groundwater accumulation framework.

---

# 2. Climate Wetness Component

## Supporting Rasters

- [Mean Annual Precipitation](https://secure.engineeringdirector.com/public/map/mean_annual_precip_2020_2024)
- [Rainy Days](https://secure.engineeringdirector.com/public/map/global_annual_rainfall_2020_2024)
- [Relative Humidity](https://secure.engineeringdirector.com/public/map/RH_Mean_2020_2024_30arcsec_GCS_WGS84_tileview)
- [Time of Wetness (TOW)](https://secure.engineeringdirector.com/public/map/tow_global_2020_2024_ERA5)
- [Total Column Water Vapour](https://secure.engineeringdirector.com/public/map/total_column_water_vapour_2020_2024_web_1km)
- [Soil Moisture Surface](https://secure.engineeringdirector.com/public/map/soil_moisture_surface_2020_2024_ERA5)
- [Soil Moisture Root Zone](https://secure.engineeringdirector.com/public/map/soil_moisture_root_zone_2020_2024_ERA5)
- [Wetness Persistence Metrics](https://secure.engineeringdirector.com/public/map/wet_dry_cycles_2020_2024_ERA5)

These variables characterize:
- long-term moisture persistence
- recharge potential
- climatic wetness regimes
- sustained groundwater replenishment

Climate wetness is incorporated as a nonlinear hydrologic amplification signal.

---

# 3. Hydrogeologic Permeability Component (GLHYMPS)

## Supporting Rasters

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

These variables characterize:
- groundwater storage potential
- permeability
- aquifer transmissivity
- hydraulic connectivity

GLHYMPS integration constrains the model toward terrain capable of supporting sustained groundwater movement and pressure development.

---

# 4. Lithologic Constraint Component (GLiM)

## Supporting Raster

- [GLiM Lithology Constraint](https://secure.engineeringdirector.com/public/map/GLiM_Lithology_Constraint_1km_WGS84_UINT8)

GLiM lithology is used to differentiate:
- sedimentary terrains
- unconsolidated basins
- carbonate systems
- volcanic terrains
- crystalline basement regions

Higher favorability is assigned to:
- unconsolidated sediments
- sedimentary basins
- carbonate lithologies
- alluvial systems

Lower favorability is assigned to:
- igneous terrains
- metamorphic basement
- volcanic uplands
- crystalline shields

This component improves geologic continuity and reduces unrealistic groundwater favorability in low-permeability terrains.

---

# 5. Empirical Groundwater Validation Component

## Supporting Validation Datasets

- Global Groundwater Well Database (vector feature dataset)
- Artesian Validation Wells (validated groundwater occurrence points)

The model was validated against a global groundwater well database containing:

- ~217,000 extracted groundwater well records
- ~88,000 validated georeferenced wells

Validation confirms statistical enrichment of observed groundwater wells within elevated artesian likelihood zones.

These validation datasets are maintained as geospatial feature layers supporting:
- hydrogeologic calibration
- model verification
- artesian occurrence screening
- spatial groundwater validation workflows


---

# Intended Applications

The Artesian Well Likelihood Index is intended for:
- pipeline corridor screening
- groundwater emergence susceptibility analysis
- hydrogeologic intelligence
- infrastructure planning
- environmental screening
- GIS visualization
- operational prioritization
- enterprise geospatial workflows

---

# Key Characteristics

- Simplified operational screening layer
- Derived from continuous 0–100 artesian likelihood score
- Global coverage
- ~1 km spatial resolution
- Physically grounded hydrogeologic framework
- Reduced hydrogeologic void regions
- Designed for rapid interpretation and GIS deployment

---

# Spatial Characteristics

- **Coordinate System:** GCS_WGS_1984
- **Spatial Resolution:** ~1 km
- **Coverage:** Global (±85.0511°)

---

# Validation Summary

Validation observations include:
- strong correspondence with known groundwater basins
- alignment with major alluvial systems
- realistic suppression of crystalline uplands
- hydrogeologic continuity across sedimentary terrains

The framework demonstrates strong spatial enrichment of observed groundwater wells within:
- Class 4 zones
- Class 5 zones

---

# Confidence Statement

This dataset represents a probabilistic hydrogeologic susceptibility classification framework and is not intended as deterministic prediction of:
- artesian wells
- groundwater pressure
- groundwater depth
- hydraulic head
- well yield

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

---

# Related Datasets

## Primary Products

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

---

## Supporting Hydrogeologic Layers

- [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)
- [GLiM Lithology Constraint](https://secure.engineeringdirector.com/public/map/GLiM_Lithology_Constraint_1km_WGS84_UINT8)

---

## Supporting Terrain Hydrology Layers

- [HAND – Height Above Nearest Drainage](https://secure.engineeringdirector.com/public/map/HAND_Height_Above_Nearest_Drainage_m)
- [HAND Low-Lying Index](https://secure.engineeringdirector.com/public/map/HAND_Low_Lying_Index_0_1)
- [Saturation Potential Index](https://secure.engineeringdirector.com/public/map/Saturation_Potential_Index_0_1)
- [Drainage Position Index](https://secure.engineeringdirector.com/public/map/Drainage_Position_Index_0_1)
- [River Influence](https://secure.engineeringdirector.com/public/map/River_Influence_20km)
- [Drainage Intensity Index](https://secure.engineeringdirector.com/public/map/Drainage_Index_Normalized_0_1)
- [Distance to River](https://secure.engineeringdirector.com/public/map/Distance_To_River_20km_Geodesic)


---

# Data Access & API Services

Available through Engineering Director platforms for:
- interactive mapping
- API integration
- enterprise GIS
- corridor screening
- bulk scoring workflows

---

# Legal & Licensing

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

This dataset is proprietary and provided “as is” without warranty.

---

# Dataset Citation

Mazzella, J. (2026).

**Global Artesian Well Likelihood Index (1–5), Version 1.**

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
