# Beam Horizontal Irradiance (BHI – Mean Irradiance) (`direct_horizontal_2020_2024_web_1km`) — 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**: Beam Horizontal Irradiance (BHI – Mean Irradiance)
- **Slug**: `direct_horizontal_2020_2024_web_1km`
- **Units**: `W/m²`
- **Spatial Extent**: UL(85.25, -180.0) to LR(-85.0, 180.0)
- **Summary**: Description:
Direct beam solar radiation received on a horizontal surface. This excludes diffuse radiation and represents only the direct component of sunlight.

Important Note:
This is not Direct Normal Irradiance (DNI).
- **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
- `(16.38, (94.0, 132.0, 195.0))`
- `(16.741999999999997, (94.9, 132.8, 195.1))`
- `(17.104, (95.8, 133.6, 195.2))`
- `(17.466, (96.7, 134.4, 195.3))`
- `(17.828, (97.6, 135.2, 195.4))`
- `(18.189999999999998, (98.5, 136.0, 195.5))`
- `(18.552, (99.4, 136.8, 195.6))`
- `(18.914, (100.3, 137.6, 195.7))`
- `(19.276, (101.2, 138.4, 195.8))`
- `(19.637999999999998, (102.1, 139.2, 195.9))`
- `(20.0, (103.0, 140.0, 196.0))`
- `(20.0, (103.0, 140.0, 196.0))`

<section class="ssi-attribute">

  <h2>Beam Horizontal Irradiance (BHI) – Mean Surface Direct Solar Radiation</h2>
  <p><strong>Global | ~1 km Resolution | 2020–2024</strong></p>

  <hr>

  <h3>Short Description</h3>
  <p>
    This dataset represents the spatial distribution of mean direct beam solar
    radiation incident on a horizontal surface. Beam Horizontal Irradiance (BHI)
    quantifies the portion of solar radiation reaching the surface without
    atmospheric scattering.
  </p>

  <hr>

  <h3>Technical Specification</h3>

  <p>
    The dataset is derived from ERA5 surface direct solar radiation fields and
    represents mean beam horizontal irradiance for the period 2020–2024.
  </p>

  <p>
    ERA5 hourly radiation data were aggregated across the 2020–2024 period to
    produce a multi-year climatological mean expressed as radiative flux.
  </p>

  <p>
    This dataset is developed by <strong>AtmosphericIQ LLC</strong> and processed for
    distribution and deployment by <strong>Engineering Director, Inc.</strong>
  </p>

  <p>
    <strong>Note:</strong> This dataset is not equivalent to Direct Normal Irradiance (DNI).
  </p>

  <hr>

  <h3>Key Characteristics</h3>

  <ul>
    <li>Units: watts per square meter (W/m²)</li>
    <li>Represents mean direct beam solar radiation on a horizontal surface</li>
    <li>Derived from ERA5 direct radiation fields</li>
    <li>Represents climatological mean conditions for 2020–2024</li>
  </ul>

  <hr>

  <h3>Spatial Characteristics</h3>

  <ul>
    <li>Coordinate System: <strong>GCS_WGS_1984</strong></li>
    <li>Native Resolution: ~0.25°</li>
    <li>Resampled Resolution: ~1 km (30 arc-second)</li>
    <li>Coverage: <strong>Global (±85.0511° for web compatibility)</strong></li>
  </ul>

  <hr>

  <h3>Role in SSI™ Model</h3>

  <p>
    Beam Horizontal Irradiance (BHI) is one of several radiative variables incorporated
    into the Solar Suitability Index (SSI™) model developed by AtmosphericIQ LLC.
  </p>

  <p>
    As a measure of direct beam solar energy reaching the surface, BHI contributes
    to the radiative component of the SSI™ scoring framework.
  </p>

  <p>
    This dataset is provided as a supporting climatic input layer and does not
    independently represent solar suitability.
  </p>

  <hr>

  <h3>Applications</h3>

  <ul>
    <li>Solar resource assessment</li>
    <li>Climatological and environmental analysis</li>
    <li>Geospatial screening workflows</li>
    <li>Supporting solar suitability modeling</li>
  </ul>

  <hr>

  <h3>Data Source</h3>

  <p>
    Derived from Copernicus Climate Change Service (C3S) ERA5 reanalysis data,
    with processing including temporal aggregation (2020–2024), spatial resampling
    to ~1 km resolution, and web-compatible clipping.
  </p>

  <hr>

  <h3>Related SSI™ Dataset</h3>

  <p>
    This dataset is a supporting climatic input to the Solar Suitability Index (SSI™),
    a global multi-parameter model developed by AtmosphericIQ LLC.
  </p>

  <p>
    For the full solar suitability model and derived classification datasets, see:
    <br>
    <a href="https://secure.engineeringdirector.com/public/map/solar_suitability_index_2020_2024_web_1km" target="_blank">
      Global Solar Suitability Index (SSI™) – Continuous Score (1–100)
    </a>
  </p>

  <hr>

  <h3>Data Access & API Services</h3>

  <p>
    This dataset is available through Engineering Director, Inc. platforms:
    <br>
    <a href="https://www.engineeringdirector.com" target="_blank">
      www.engineeringdirector.com
    </a>
  </p>

  <p>
    Use beyond visualization, including API access, automated queries, or integration,
    is subject to the Engineering Director API Terms of Service.
  </p>

  <hr>

  <h3>Legal & Licensing</h3>

  <p>© 2026 AtmosphericIQ LLC and Engineering Director, Inc. All rights reserved.</p>

  <p>
    This dataset is provided for informational and analytical use only and is supplied
    "as is" without warranty of any kind. Users assume all risk associated with its use.
  </p>

</section>

---

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