Getting Started

Quickstart: Your First Weather Simulation

[!TIP] You can use any of the preloaded meteorological stations on the map to test the workflow before uploading custom site data.

This walkthrough covers selecting a station, generating CLIGEN parameters, running a 10-year simulation, and comparing the output against the historical record.


Step 1: Open the Application & Select a Station

  1. Navigate to the Stochastic Climate Simulator dashboard in your web browser.
  2. In the top navigation bar, locate the Data Source card.
  3. Click the interactive map or use the search bar to locate a station near your area of interest (for example, search for Denver International Airport, CO or Salt Lake City, UT).
  4. Click on the station pin. A summary pop-up displays the station's elevation, latitude, longitude, and available years of record (e.g., 1980–2023).
  5. Click Use This Station to load the daily precipitation and temperature history.

Data Source Map and Custom File Upload Figure 1: The Data Source tab showing the station map and custom gauge record uploader.


Step 2: Review the Historical Climate Profile

Once the station data loads, the Historical Data Analysis panel populates:

  • Precipitation Distribution Chart: Displays average monthly rainfall totals, wet-day frequencies, and peak daily storm events recorded over the historical period.
  • Temperature Envelope Chart: Displays the seasonal cycle of daily maximum, minimum, and average temperatures throughout the year.
  • Key Summary Cards: Shows annual average precipitation, maximum and minimum recorded temperatures, and record completeness percentage.

Historical Climate Data Analysis Dashboard Figure 2: Historical record screening for Salt Lake Triad Ctr, showing record completeness (98.4%), probability density fits, and long-term rainfall trends.

Confirm that the historical record completeness and date range are suitable for parameter calculation.


Step 3: Generate the CLIGEN Parameters

  1. Open the CLIGEN parameters tab.
  2. Click the Generate parameters button.
  3. The application calculates the monthly CLIGEN statistics from the historical record:
  4. Precipitation Occurrence ($P(W|W)$ and $P(W|D)$): Monthly transition probabilities governing wet and dry day sequences.
  5. Precipitation Depth ($\text{Mean}$, $\text{StdDev}$, $\text{Skew}$): Monthly distribution parameters for wet-day rainfall depth.
  6. Temperature Parameters ($\mu_{T,\max}$, $\sigma_{T,\max}$, $\mu_{T,\min}$, $\sigma_{T,\min}$): Monthly means and standard deviations of daily maximum and minimum temperatures.
  7. The calculated 12-month parameter values appear in two tables: Monthly Precipitation Parameters and Monthly Temperature Parameters.

CLIGEN Parameter Tables Figure 3: Monthly CLIGEN parameter tables with copy buttons for GoldSim.


Step 4: Run a 10-Year Stochastic Simulation

To generate synthetic weather from the calculated parameters:

  1. Scroll to the Stochastic Simulation panel.
  2. Under Simulation Duration, select 10 Years.
  3. Under Time Step, leave the default setting as Daily (24h).
  4. Set the Number of Realizations to 10 to inspect the ensemble spread.
  5. Click the Run Simulation button.

The simulator generates synthetic daily precipitation, maximum temperature, and minimum temperature sequences.

Simulation Run Controls and Statistical Distributions Figure 4: Simulation panel displaying Monte Carlo run settings and statistical percentiles across realizations.


Step 5: Compare Synthetic Results vs. Historical Baseline

When the simulation completes, review the Simulation Analysis tabs:

  1. Monthly Comparison: Switch to the Statistical Parity tab to compare synthetic monthly rainfall averages against the historical averages.
  2. Extreme Value Check: Compare the maximum daily storm depths in the simulation against the historical observations.
  3. Daily Hyetograph & Thermograph: Zoom in on an individual year to inspect daily precipitation and temperature series.

Probabilistic Cumulative Precipitation and Temperature Envelopes Figure 5: Synthetic simulation results showing cumulative precipitation (P10, P50, P90 percentiles) and daily temperature envelopes.


Step 6: Export Your Results

You can export the results in three formats:

  • Export Time Series (CSV / Excel): Download the daily synthetic date, precipitation, $T_{\max}$, and $T_{\min}$ series for use in spreadsheets or hydrological models.
  • Copy Parameters to Clipboard: Copy the 12-month CLIGEN parameter tables formatted for pasting into GoldSim Data elements.
  • Download GoldSim DLL: Download the 64-bit Windows dynamic link library (CligenWeather.dll) to run simulations inside GoldSim.