# Total Annual Precipitation DAYMET (`Precip_2020_2024_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**: Total Annual Precipitation DAYMET
- **Slug**: `Precip_2020_2024_1km`
- **Units**: `mm/yr`
- **Spatial Extent**: UL(83.7962118, -180.0) to LR(6.0712118, 180.0)
- **Summary**: North American Annual cumulative precipitation derived from Daymet v4 daily precipitation data, representing the total millimeters of precipitation received per grid cell per year.
- **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
- `(28.0, (139.0, 69.0, 19.0))`
- `(45.2, (145.6, 75.4, 23.4))`
- `(62.4, (152.2, 81.8, 27.8))`
- `(79.6, (158.8, 88.2, 32.2))`
- `(96.8, (165.4, 94.6, 36.6))`
- `(114.0, (172.0, 101.0, 41.0))`
- `(131.2, (178.6, 107.4, 45.400000000000006))`
- `(148.39999999999998, (185.2, 113.80000000000001, 49.800000000000004))`
- `(165.6, (191.8, 120.2, 54.2))`
- `(182.79999999999998, (198.4, 126.6, 58.6))`
- `(200.0, (205.0, 133.0, 63.0))`
- `(200.0, (205.0, 133.0, 63.0))`

Technical Specification
Total Annual Precipitation Raster
North America – 2020–2024 (Daymet v4)
1. Overview

The Total Annual Precipitation raster represents the cumulative amount of precipitation received at each grid cell over a calendar year, derived from Daymet Version 4 daily precipitation data and summarized as annual totals.

2. Geographic Coverage

Spatial Domain: North America (Daymet v4 coverage)

Projection (Web Delivery): EPSG:4326 (WGS 84)

Native Projection: Daymet Lambert Conformal Conic (meters)

Spatial Resolution: 30 arc-seconds (~1 km)

Temporal Coverage: 2020–2024

Products Provided:

Annual Total Precipitation (per year)

5-Year Mean Total Precipitation (2020–2024 average)

3. Data Source

Primary Dataset: NASA ORNL DAAC – Daymet Version 4

Dataset Website: https://daymet.ornl.gov

Input Variable:

prcp — Daily precipitation (mm/day)

Daymet provides gridded daily meteorological fields derived from station observations using interpolation methods that incorporate terrain and other geographic factors.

4. Metric Definition

Total Annual Precipitation is defined as:

𝑃
𝑎
𝑛
𝑛
𝑢
𝑎
𝑙
=
∑
𝑑
=
1
𝑁
𝑝
𝑟
𝑐
𝑝
𝑑
P
annual
	​

=
d=1
∑
N
	​

prcp
d
	​


Where:

𝑝
𝑟
𝑐
𝑝
𝑑
prcp
d
	​

 = Daymet daily precipitation (mm/day)

𝑁
N = number of valid days in the year (365 or 366)

Units: millimeters per year (mm/year)

Interpretation: higher values indicate wetter climates and stronger precipitation exposure.

5. Processing Methodology
5.1 Computational Framework

Python (ArcGIS Pro Notebook environment)

NumPy for array-based daily accumulation

netCDF4 for Daymet ingestion

ArcPy for raster creation and reprojection

5.2 Processing Steps

Daily Daymet prcp values are read from NetCDF for each year.

NetCDF _FillValue pixels are masked to exclude missing data from calculations.

Daily precipitation is accumulated for each grid cell across the year.

Annual rasters are produced for each year (2020–2024).

A 5-year mean raster is computed as the pixel-wise mean of annual totals.

Outputs are generated in native Daymet projection and reprojected to EPSG:4326 at 30 arc-second resolution.

5.3 NoData Handling

Missing values in the NetCDF input are excluded during accumulation.

Output float rasters use NoData = -9999.

6. Output Specifications
6.1 Annual Raster

Filename format:
TotalPrcp_Daymet_<YEAR>_mm_EPSG4326_30as.tif

Data Type: Float32

Units: mm/year

6.2 Five-Year Mean Raster

Filename:
TotalPrcp_Daymet_5yrMean_2020_2024_mm_EPSG4326_30as.tif

Data Type: Float32

Units: mm/year

NoData: -9999

7. Raster Characteristics (Web Delivery)

Format: GeoTIFF (web-ready / tile-server compatible)

Compression: LZW

Internal Tiling: Enabled

Pyramids: Built

Statistics: Calculated

8. Typical Value Ranges (North America)

Dry interior / desert regions: ~0–250 mm/year

Temperate continental regions: ~500–1500 mm/year

Coastal and mountain orographic regions: ~1500–5000+ mm/year

Extreme precipitation zones (limited areas): may exceed 7000 mm/year

(Actual values vary by location, elevation, and coastal exposure.)

9. Intended Applications

Corrosion and exposure screening

Climate-driven degradation risk assessment

Hydrological and infrastructure planning

Regional wetness classification and mapping

Environmental baseline modeling

10. Limitations

Daymet precipitation is a gridded product derived from observations and interpolation; localized microclimates may not be fully captured.

Metric represents total precipitation amount and does not distinguish between rain vs. snow without additional analysis.

Does not directly represent rainfall intensity or storm frequency; it summarizes annual accumulation.

---

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