Exit to dashboard
Units
User manual

Stochastic Climate Simulator

Part of the Lillywhite water technology platform. Generates multi-year synthetic daily weather (temperature and precipitation) for use in GoldSim and other hydrologic models.

The weather model replicates the methods of CLIGEN, the USDA stochastic climate generator, with calibrated bias correction applied to the historical record.

Historical records are public-domain GHCN-D data provided by NOAA, for use in historical modeling and analysis at your own risk. Station tracking metadata is refreshed weekly, while individual daily time-series records are fetched live directly from NOAA upon request.

Built with

  • Rust compiled to WebAssembly (in-browser simulation engine)
  • Alpine.js (interface)
  • Chart.js (charts)
  • Leaflet with Esri street tiles (maps)
  • Tailwind CSS (styling)
Sign in

Data Source

Weather data connected and ready to analyze
Currently loaded:

Upload your own record

File Format Requirements & Sample

Specifications for uploading custom daily climate time series

Supported File Formats

You can upload .csv, .txt (comma- or tab-delimited), or .xlsx / .xls (Microsoft Excel workbooks).

Column Header Flexibility

The ingestion parser automatically recognizes standard meteorological aliases so you do not need to manually rename columns:

Date Column (Required)
DATE, Date, Day, Time, Timestamp
Precipitation (Optional)
PRCP, Precip, Precipitation, Rain, PPT
Maximum Temp (Optional)
TMAX, Max_Temp, High, Temp_Max
Minimum Temp (Optional)
TMIN, Min_Temp, Low, Temp_Min

Note: The dataset must contain a date column plus precipitation, temperature, or both.

Unit System Selection

The Units dropdown next to the file picker dictates how the numbers are interpreted (US Customary: °F, in vs. Metric: °C, mm). Any unit dimensions indicated inside your column titles (such as PRCP (mm) or TMAX [F]) are overridden by this dropdown setting to ensure reliable conversion.

Sample Data Layout

Date,PRCP,TMAX,TMIN
2020-01-01,0.00,38.5,24.1
2020-01-02,0.15,35.2,22.8
2020-01-03,0.42,32.0,19.4
2020-01-04,0.00,34.8,18.0
2020-01-05,0.00,41.2,25.6

Online stations

Search NOAA Global Historical Climatology Network stations by place name, coordinates, or a click on the map.

1. Search Area

25 miles

2. Data Filters

Calculating...

Fetching records and running statistical distribution fits...

Probability Density Fit (Annual Totals)

Statistical distribution fitting for hydrologic and civil engineering

How This Chart Is Generated

Daily precipitation records from the weather station are aggregated into annual totals (in inches or millimeters per year). To ensure high-quality statistical modeling, only full meteorological years with at least 330 valid observation days are included in the sample.

Fitted Theoretical Distributions

Gamma Distribution (2-Parameter)

A continuous probability distribution bounded on the left at zero. It is standard in meteorology and hydrology for modeling positively skewed, non-negative precipitation depths.

Log-Pearson Type III (LP3)

The benchmark distribution recommended by the U.S. Interagency Advisory Committee on Water Data (USGS Bulletin 17B / 17C). It models log-transformed annual precipitation, rigorously capturing skewness and extreme hydrologic tail behavior (exceptional wet years and severe droughts).

Interpreting the Goodness-of-Fit P-Values

Below the chart, a two-sided Kolmogorov-Smirnov (K-S) goodness-of-fit test evaluates whether the empirical annual data conforms to each distribution:

  • p > 0.05: Statistically consistent. There is no evidence to reject the distribution at the 95% confidence level.
  • p ≤ 0.05: Significant divergence between the observed history and theoretical curve.

Engineering & Modeling Applications

Civil engineers and hydrologists utilize these annual depth distributions to compute return-period depths (e.g., 25-yr dry, 100-yr wet recurrence), assess long-term water balance reliability, and parameterize stochastic weather generators (such as GoldSim and CLIGEN).

Data Analysis

Select a weather station or upload a daily record on the tab to view historical precipitation and temperature analysis.

Data Analysis

Record Length:
Completeness:

Max 1-Day Peak

Max Dry Spell

days

Max Wet Spell

days

Daily precipitation

Visible Window Span
Window Cumulative Precip
Wet Days in Window
Window Max 1-Day Event

Annual totals fit

Log-Pearson III
Gamma

Long-term trend

MK Sen's Slope
MK P-Value

Monthly extremes

Wet vs dry days

Seasonal trends

A trend is marked when the statistical test is at or below 0.05.
Winter (DJF) Slope
Spring (MAM) Slope
Summer (JJA) Slope
Fall (SON) Slope

All Time High

All Time Low

Mean Frost Days/Yr

days

Daily temperature

Visible Window Span
Window Mean TMAX / TMIN
Window Max High (TMAX)
Window Min Low (TMIN)

Daily maximum

TMAX MK:
All-Time Record High
Warmest Month Mean

Daily minimum

TMIN MK:
All-Time Record Low
Coldest Month Mean

Monthly Mean Ranges

Annual Frost vs Hot Days

Mean number of frost days
Mean number of hot days

Analysis period

Inputs changed: The parameters below were fitted to ( to ). Click Update parameters to recalculate for the current site and dates.

Tip: pick a station on the data source tab (or upload a record above) first.

Monthly precipitation

Markov wet-day occurrence and a Pearson Type III distribution for skewed precipitation depth.
Month P(W|W) P(W|D) Mean Std Dev Skewness

Monthly temperature

Month Mean Tmax SD Tmax Mean Tmin SD Tmin

Run a simulation

Builds a synthetic daily or sub-daily weather sequence. Parameters from the previous tab are used when they exist. Otherwise the run uses default parameters.

P10: · P90:

P10: · P90:

P10: · P90:

Ensemble coverage

realizations

Duration:

Realization:
Total: Peak: Temp:

Run · Shaded band: P10–P90

Statistical Distribution across Realizations

Metric Mean Std Dev Min 10th % (P10) 25th % (P25) Median (P50) 75th % (P75) 90th % (P90) Max

Average monthly precipitation depth across all simulated years vs historical

Average consecutive wet days per storm sequence starting in month

Run Wet Days

Average number of dry days per month across all years (< 0.1 mm/day)

Dry Days

Average number of wet days per month across all years (≥ 0.1 mm/day)

Wet Days

Average consecutive dry days per drought spell starting in month

Run Dry Days

Final Result : Ensemble Mean •
Observed
Simulated
Mean daily maximum temperature across all simulated years vs historical

Mean daily minimum temperature across all simulated years vs historical

Average days in each month exceeding high-temperature threshold

Average frost days in each month with minimum temperature below freezing

Mean monthly solar radiation derived from diurnal temperature range

Radiation (MJ/m²)

Realization : Ensemble Mean •
Observed
Simulated
Mean Annual Precip
Observed:
Annual Wet Days
days/yr
Observed:
Mean Annual Temp
Observed:
Annual Frost Days
days/yr
Observed:
Observed historical recorded years vs stochastic simulated realization(s).

Annual Total Precipitation Series

Empirical quantiles plotted against the 1:1 ideal agreement reference line.

Quantile-Quantile (Q-Q) Distribution Fit

Statistical Verification Metrics Table

Hydrologic Metric Observed Historical Simulated Difference % Bias / Error Verification Status

Validating sub-daily rainfall intensity-duration scaling, dimensionless storm mass curves, 24-hour diurnal temperature cycles, and daily Tmax/Tmin recovery.

Time Step
Mass Conservation
Peak Sub-Daily Intensity
Mean Storm Duration
Peak Ratio (Tp / D)
Tmax / Tmin Recovery
Simulated maximum rainfall intensity across rolling aggregation windows (Δt to 24 hr) compared against NOAA / Hershfield empirical scaling anchored to observed 24-hr station storm depths.

Precip Scaling
Ensemble median and P10–P90 cumulative storm depth P(t)/P_storm vs dimensionless storm duration t/D across simulated wet days, overlaid with NRCS SCS Type I/II and Huff 2nd Quartile curves.

Dimensionless Storm Mass Curve

Intra-Storm Profile
Simulated sub-daily temperature composite across the 24-hour solar cycle (Summer Jul & Winter Jan) overlaid with observed historical Tmax (afternoon peak near 15:00) and Tmin (predawn trough near 03:00).

Diurnal Phase
Monthly mean of actual daily maximum max_t T(t) and minimum min_t T(t) extracted from sub-daily steps vs observed historical monthly Tmax and Tmin to verify diurnal amplitude and detect any discrete time-step clipping.

Amplitude Recovery
Sub-Daily Resolution : •
Observed / Reference
Simulated Sub-Daily

GoldSim link

CligenWeather.dll connects to a GoldSim External element and returns daily precipitation, maximum temperature, and minimum temperature.
1

Put the DLL with the model

Put CligenWeather.dll in the same folder as the GoldSim model file. No separate install or Python is required.
✓ Windows 64-bit native C++
2

Paste the parameters

Create 12 monthly values for each of the 9 parameter vectors in GoldSim, indexed by Months, and link them to the External element.
No parameters generated yet.

3

Link the External element

Add an External element that calls CligenWeather.dll, function CligenWeather. Link 5 run settings, 9 monthly vectors, and the precipitation, maximum temperature, and minimum temperature time series.
• Output: Time Series Definition • High speed: ERROR level default

DLL Input Arguments (14 Elements / 113 Values)

GoldSim → DLL

Values GoldSim sends to CligenWeather at realization initialization (5 scalars + 9 monthly 12-item vectors).

Input Argument Type / Unit Description
Start_Time Scalar (datetime) Simulation start time (link to GoldSim ~StartTime)
Sim_Dur Scalar (day) Total simulation duration (link to GoldSim ~SimDuration)
Time_Step Scalar (day) Model time step length (link to GoldSim ~TimestepLength, e.g. 1 day)
Realization Scalar (-) Current Monte Carlo realization (link to GoldSim ~Realization)
Units_Flag Scalar (0 or 1) 0 = Metric (mm, °C), 1 = US Customary (in, °F)
PWW Vector[12] (-) Monthly wet-day probability given yesterday was wet (12 items, Jan–Dec)
PWD Vector[12] (-) Monthly wet-day probability given yesterday was dry (12 items, Jan–Dec)
Mean_P Vector[12] (in or mm) Monthly mean daily precipitation depth on wet days (12 items, Jan–Dec)
SD_P Vector[12] (in or mm) Monthly daily precipitation standard deviation (12 items, Jan–Dec)
Skew_P Vector[12] (-) Monthly daily precipitation skewness coefficient (12 items, Jan–Dec)
Mean_Tmax Vector[12] (°F or °C) Monthly mean daily maximum air temperature (12 items, Jan–Dec)
SD_Tmax Vector[12] (Fdeg or Cdeg) Monthly daily maximum temperature standard deviation (12 items, Jan–Dec)
Mean_Tmin Vector[12] (°F or °C) Monthly mean daily minimum air temperature (12 items, Jan–Dec)
SD_Tmin Vector[12] (Fdeg or Cdeg) Monthly daily minimum temperature standard deviation (12 items, Jan–Dec)

DLL Outputs Returned to GoldSim (3 Time Series Definitions)

DLL → GoldSim

Full realization time series generated at ETime = 0 and passed to linked GoldSim Time Series elements.

Output Parameter Type / Units Description
Precip_Rate Time Series Definition (mm/d or in/d) Stochastic precipitation rate time series (daily rate when Time_Step = 1 day; disaggregated CLIGEN double-exponential storm rate when Time_Step < 1 day; link to Precip_DLL)
Tmax Time Series Definition (°C or °F) Daily maximum temperature when Time_Step = 1 day, or continuous sub-daily diurnal temperature when Time_Step < 1 day (link to Tmax_DLL)
Tmin Time Series Definition (°C or °F) Daily minimum temperature when Time_Step = 1 day, or continuous sub-daily diurnal temperature (matching Tmax) when Time_Step < 1 day (link to Tmin_DLL)
Need step-by-step guidance? View GoldSim Setup Guide