# GLHYMPS Hydraulic Conductivity (logK) (`GLHYMPS_Hydrogeology_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**: GLHYMPS Hydraulic Conductivity (logK)
- **Slug**: `GLHYMPS_Hydrogeology_Constraint_1km_WGS84_UINT8`
- **Units**: `Hydraulic Conductivity (logK)`
- **Spatial Extent**: UL(89.9835615, -179.9999889) to LR(-89.9991237, 179.9989201)
- **Summary**: The GLHYMPS Hydraulic Conductivity (logK) raster represents the estimated relative hydraulic conductivity of near-surface geologic materials derived from the GLHYMPS (Global Hydrogeology MaPS) framework. Hydraulic conductivity describes the ability of geologic materials to transmit groundwater and is one of the primary controls governing aquifer permeability, groundwater movement, recharge connectivity, and artesian groundwater favorability.

Higher values indicate terrain more likely to support sustained groundwater movement and hydraulic connectivity, while lower values indicate relatively impermeable or hydraulically restrictive materials.

This raster is incorporated as a foundational hydrogeologic permeability component within the Global Artesian Well Likelihood Framework.
- **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
- `(-99999.0, (255.0, 255.0, 229.0))`
- `(-89999.0999, (255.0, 255.0, 229.0))`
- `(-79999.1998, (255.0, 255.0, 229.0))`
- `(-69999.2997, (255.0, 255.0, 229.0))`
- `(-59999.3996, (255.0, 255.0, 229.0))`
- `(-49999.4995, (255.0, 255.0, 229.0))`
- `(-39999.59939999999, (255.0, 255.0, 229.0))`
- `(-29999.699299999993, (255.0, 255.0, 229.0))`
- `(-19999.799199999994, (255.0, 255.0, 229.0))`
- `(-9999.899099999995, (255.0, 255.0, 229.0))`
- `(0.0010000000038417056, (255.0, 255.0, 229.0))`
- `(0.001, (255.0, 255.0, 229.0))`

# GLHYMPS Hydraulic Conductivity (logK)

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

---

# Raster Name

GLHYMPS Hydraulic Conductivity (logK)

---

# File Name

`GLHYMPS_logK_1km_WGS84.tif`

---

# Short Description

The GLHYMPS Hydraulic Conductivity (logK) raster represents the estimated relative hydraulic conductivity of near-surface geologic materials derived from the GLHYMPS (Global Hydrogeology MaPS) framework. Hydraulic conductivity describes the ability of geologic materials to transmit groundwater and is one of the primary controls governing aquifer permeability, groundwater movement, recharge connectivity, and artesian groundwater favorability.

Higher values indicate terrain more likely to support sustained groundwater movement and hydraulic connectivity, while lower values indicate relatively impermeable or hydraulically restrictive materials.

This raster is incorporated as a foundational hydrogeologic permeability component within the Global Artesian Well Likelihood Framework.

---

# Units of Measure

Relative Hydraulic Conductivity Index (logK)

Normalized Hydrogeologic Favorability Scale

---

# Scientific Background

Hydraulic conductivity (K) represents the ease with which groundwater can move through pore spaces, fractures, or unconsolidated sediments within geologic materials.

Hydraulic conductivity strongly influences:
- groundwater recharge
- aquifer transmissivity
- groundwater flow persistence
- pressure propagation
- artesian confinement behavior
- subsurface saturation dynamics

The GLHYMPS framework provides globally standardized hydrogeologic permeability estimates derived from:
- lithologic interpretation
- hydrogeologic characterization
- global geologic mapping
- hydrostratigraphic generalization

---

# Model Role Within Artesian Framework

The GLHYMPS Hydraulic Conductivity raster serves as a primary hydrogeologic permeability constraint within the artesian susceptibility framework.

The raster influences:
- groundwater mobility
- aquifer continuity
- groundwater persistence
- hydraulic pressure propagation
- groundwater confinement favorability

Hydraulic conductivity integration helps suppress unrealistic groundwater favorability in:
- crystalline terrains
- igneous uplands
- impermeable basement complexes

while enhancing:
- sedimentary basins
- unconsolidated systems
- transmissive aquifers
- alluvial environments

---

# Interpretation Guidance

| Relative Value | General Interpretation |
|---|---|
| Very Low | Highly impermeable or restrictive terrain |
| Low | Limited groundwater movement potential |
| Moderate | Transitional permeability |
| High | Strong groundwater transmissivity potential |
| Very High | Highly transmissive hydrogeologic systems |

---

# Hydrogeologic Significance

Higher hydraulic conductivity values commonly correspond with:
- alluvial sediments
- unconsolidated deposits
- sandstone aquifers
- carbonate systems
- sedimentary basin environments

Lower values commonly correspond with:
- crystalline shields
- metamorphic basement
- igneous terrains
- volcanic uplands
- low-permeability bedrock systems

---

# Spatial Characteristics

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

---

# Data Source

Derived from:

## GLHYMPS — Global Hydrogeology MaPS

Primary reference:
> Gleeson, T., Moosdorf, N., Hartmann, J., & van Beek, L. P. H. (2014). A glimpse beneath Earth's surface: GLobal HYdrogeology MaPS (GLHYMPS) of permeability and porosity. *Geophysical Research Letters.*

---

# Processing Workflow

The raster was processed through:
- global reprojection
- normalization
- hydrogeologic scaling
- raster harmonization
- hydrogeologic constraint integration

Processing included:
- coordinate standardization
- null-value correction
- hydrogeologic scaling calibration
- spatial alignment with global terrain datasets

---

# Related Hydrogeologic Rasters

## Supporting Layers

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

---

# Related Artesian Framework Layers

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

---

# Intended Applications

This raster is intended for:
- hydrogeologic screening
- groundwater intelligence
- aquifer characterization
- infrastructure planning
- pipeline corridor analysis
- hydrogeologic susceptibility modeling
- groundwater favorability analysis
- enterprise GIS workflows

---

# Limitations

The raster represents generalized hydrogeologic permeability conditions at approximately 1 km resolution and should not be interpreted as:
- site-specific aquifer testing
- measured hydraulic conductivity
- groundwater yield prediction
- engineering-scale hydrogeologic characterization

Local hydrogeologic conditions may vary substantially.

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

---

# Data Access & API Services

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

---

# Legal & Licensing

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

GLHYMPS source data copyright remains with original dataset authors and contributors.

Derived raster products and processing workflows are proprietary.

---

# Dataset Citation

Mazzella, J. (2026).

**GLHYMPS Hydraulic Conductivity (logK), 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