# GLHYMPS Porosity (`GLHYMPS_Porosity_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 Porosity
- **Slug**: `GLHYMPS_Porosity_1km_WGS84_UINT8`
- **Units**: `Relative Porosity Index`
- **Spatial Extent**: UL(89.9835615, -179.9999889) to LR(-89.9991237, 179.9989201)
- **Summary**: The GLHYMPS Porosity raster represents the estimated relative porosity of near-surface geologic materials derived from the GLHYMPS global hydrogeology framework. Porosity describes the proportion of void space within geologic materials and is an important control on groundwater storage potential, aquifer capacity, groundwater persistence, and artesian system development.

Higher values indicate geologic materials with greater groundwater storage potential, while lower values indicate more compact, crystalline, or low-storage hydrogeologic settings.

This raster is used as a supporting hydrogeologic layer 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
- `(0.0, (210.0, 180.0, 140.0))`
- `(0.1, (208.5, 178.0, 138.0))`
- `(0.2, (207.0, 176.0, 136.0))`
- `(0.30000000000000004, (205.5, 174.0, 134.0))`
- `(0.4, (204.0, 172.0, 132.0))`
- `(0.5, (202.5, 170.0, 130.0))`
- `(0.6000000000000001, (201.0, 168.0, 128.0))`
- `(0.7000000000000001, (199.5, 166.0, 126.0))`
- `(0.8, (198.0, 164.0, 124.0))`
- `(0.9, (196.5, 162.0, 122.0))`
- `(1.0, (195.0, 160.0, 120.0))`
- `(1.0, (195.0, 160.0, 120.0))`

# GLHYMPS Porosity

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

---

## Raster Name

GLHYMPS Porosity

---

## File Name

`GLHYMPS_Porosity_1km_WGS84.tif`

---

## S3 Location

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

---

## Short Description

The GLHYMPS Porosity raster represents the estimated relative porosity of near-surface geologic materials derived from the GLHYMPS global hydrogeology framework. Porosity describes the proportion of void space within geologic materials and is an important control on groundwater storage potential, aquifer capacity, groundwater persistence, and artesian system development.

Higher values indicate geologic materials with greater groundwater storage potential, while lower values indicate more compact, crystalline, or low-storage hydrogeologic settings.

This raster is used as a supporting hydrogeologic layer within the Global Artesian Well Likelihood Framework.

---

## Units of Measure

Relative Porosity Index

---

## Technical Specification

This raster was derived from GLHYMPS porosity attributes and processed into a globally consistent ~1 km raster layer. The dataset was reprojected to WGS84 for web map rendering, API query services, and enterprise GIS deployment.

The porosity raster supports the artesian model by helping identify geologic environments capable of storing groundwater and sustaining aquifer systems.

---

## Model Role Within Artesian Framework

The GLHYMPS Porosity raster contributes to the hydrogeologic component of the Artesian Well Likelihood Framework.

The raster helps characterize:

- groundwater storage potential
- aquifer capacity
- pore-space availability
- groundwater persistence
- sedimentary and unconsolidated terrain favorability

Porosity is especially useful when interpreted together with hydraulic conductivity and transmissivity. High porosity alone does not necessarily indicate high groundwater flow, but when combined with favorable permeability and transmissivity, it strengthens the likelihood of productive or persistent groundwater systems.

---

## Interpretation Guidance

| Relative Value | General Interpretation |
|---|---|
| Very Low | Limited groundwater storage potential |
| Low | Low pore-space availability |
| Moderate | Moderate groundwater storage potential |
| High | Favorable aquifer storage conditions |
| Very High | Strong groundwater storage potential |

---

## Hydrogeologic Significance

Higher porosity values commonly correspond with:

- unconsolidated sediments
- alluvial deposits
- sedimentary basins
- carbonate systems
- weathered or porous geologic materials

Lower porosity values commonly correspond with:

- crystalline basement
- metamorphic terrains
- compact igneous rocks
- dense bedrock systems
- low-storage hydrogeologic environments

---

## Spatial Characteristics

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

---

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

Processing included:

- GLHYMPS polygon ingestion
- porosity attribute extraction
- geometry repair and projection
- rasterization to ~1 km global grid
- normalization and harmonization
- reprojection to WGS84
- GeoTIFF export for web rendering and API deployment

---

## Related Hydrogeologic Rasters

- [GLHYMPS Hydraulic Conductivity (logK)](https://secure.engineeringdirector.com/public/map/GLHYMPS_Hydrogeology_Constraint_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)

---

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

---

## Intended Applications

This raster is intended for:

- hydrogeologic screening
- groundwater storage assessment
- artesian likelihood modeling
- aquifer favorability analysis
- infrastructure planning
- pipeline corridor assessment
- enterprise GIS and API workflows

---

## Limitations

This raster represents generalized porosity conditions at approximately 1 km resolution and should not be interpreted as:

- site-specific measured porosity
- aquifer yield prediction
- groundwater depth prediction
- hydraulic head prediction
- direct artesian well occurrence
- engineering-scale hydrogeologic characterization

Local hydrogeologic conditions may vary substantially due to lithologic heterogeneity, fractures, weathering, confinement, and subsurface stratigraphy.

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

---

## Confidence Statement

The GLHYMPS Porosity raster provides a globally consistent hydrogeologic storage indicator that improves interpretation of groundwater-bearing terrain within the Artesian Well Likelihood Framework. It is best used as a supporting layer alongside hydraulic conductivity, transmissivity, lithology, and terrain hydrology.

---

## Data Access & API Services

Available through Engineering Director platforms for:

- interactive mapping
- API integration
- enterprise GIS
- bulk scoring workflows
- hydrogeologic screening

---

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