Site-level NWP Forecast (Single-point Interpolation)
Grid-point interpolated NWP forecast data for a single site (wind farm / PV plant / monitoring station): 15 days, 15-minute resolution, 19 weather elements — purpose-built for wind and solar power forecasting and weather service alerting.
Data Specifications
| Item | Specification |
|---|---|
| Forecast horizon | +0h to +360h (15 days); first row is the issue time itself |
| Temporal resolution | 15 minutes, strictly regular (96 points/day × 15 days = 1441 points) |
| Spatial form | Single-site grid interpolation (provide coordinates, get a point series) |
| Number of fields | 19 (4 site identifiers + 4 wind + 3 surface + 4 cloud + 4 radiation) |
| Run frequency | Full delivery per model run; new runs fully replace old ones |
| Delivery | CSV files (available now); HTTP API (spec v1.0, rolling out) |
Field Overview
| Group | Fields | Description |
|---|---|---|
| Site | farm_id date_time lat lon | Site ID, Beijing time, site coordinates |
| Wind | spd10 dir10 spd100 dir100 | 10 m and 100 m (near hub height) wind speed / direction |
| Surface | sp t2m rh2 | Surface pressure (Pa), 2 m temperature (K), 2 m relative humidity (%) |
| Cloud | lcc mcc hcc tcc | Low / mid / high / total cloud fraction (0-1) |
| Radiation | dr sr rr tr | Direct / diffuse / reflected / global radiation (J/m², accumulated from issue time) |
Full types, units and value ranges: see the Field Dictionary.
Delivery Options
CSV File Delivery (available now)
- One file per model run, named
weatherforecast_{lon}_{lat}_{yyyyMMddHH}.csv; - UTF-8 (no BOM), comma-separated, LF line endings, fixed 19-column header;
- Full replacement per run — idempotent for database ingestion.
HTTP Query API (spec v1.0)
The API surface is finalized (/api/v1/farms, /api/v1/forecast/issues, /api/v1/forecast) with field names, units and accumulation conventions identical to CSV, enabling a seamless later switch. See the API Reference.
Data Quality Commitments
- Strictly regular 15-minute intervals — no gaps, no duplicates;
- Sample verified: 1441 time points × 19 columns with zero missing values;
- Radiation components satisfy internal observational relations (rr ≈ 0.216 × tr, dr + sr ≈ 1.21 × tr) — machine-checkable;
- New run files fully replace previous runs — no mixing of issue times.
FAQ
Why is temperature in Kelvin (K)?
t2m uses the Kelvin scale; Celsius = K − 273.15.
Why are pressure values so large?
sp is in pascals (Pa); divide by 100 for hPa.
Why do radiation fields keep increasing?
The four radiation fields are energy density accumulated from the issue time (J/m²), monotonically increasing. Per-interval irradiance requires differencing: W/m² = (accumulated end − accumulated start) ÷ interval seconds (÷ 900 for 15 minutes).
Is rr rainfall?
No. rr is reflected shortwave radiation at the surface — not precipitation. Do not ingest it as a rain field.
More unit conversions and time zone rules: Usage Notes.
Start with One Site
Real sample data, technical support throughout integration
