How to run an Atlas 14 ensemble in XPSWMM

Mel Meng
4 min readNov 10, 2021

In my previous posts we discussed why do you need ensemble Analysis and what are the NOAA Atlas 14 Precipitation Depth and Temporal Distribution. In this article we’ll go over an example of setting up an ensemble model in XPSWMM in San Marcos, TX, USA.

Getting the data

You can find all the data from the NOAA Atlas 14 website, enter the address or coordinates to go to the project area.

PF Estimates

The rainfall totals for different durations and frequency are listed in the PF Tabular tab.

It can be downloaded as a csv file.

Temporal Distribution

For this location, there are 4 temporal distributions (6, 12, 24, 96hr) downloads. They can be also be downloaded as csv files.

To learn more about the correct temporal distribution, visit the temporal distribution page. As shown below, the rainfall profiles for Texas is provided in Volume 11, and the state is divided into 3 regions, and the temporal distribution are specific to each region.

XPSWMM Resources

For commonly used rainfall profiles, you can find the temporal distributions converted to XPSWMM xpx format from the XPSWMM online help.

From the NOAA website, we know we’ll need the temporal distribution for Atlas 14 volume 11, region 2.

Download the zip file, and unzip it. For each quantile, and duration there is an XPX file.

For each xpx file, it contains the percent of occurrence from 10% to 90% probability.

An example for the percent of occurrence is shown below. The x-axis is the duration, and the y-axis is the cumulative precipitation. For example, when x=20%, for the 10% curve, it almost has 100% of the precipitation accumulated, and for the 90%, it only rained about 5%. These curves were developed based on real-storm events so that as shown in the graph on the right, for the 10% curve, 10% of the events are in the red area, and 90% of the events are in the green area. Roughly speaking, the lower the percentage, the more intense the storm at the beginning of the event.

The profile name is organized as,

AT14-V11–1Q-10P-6Hr

  • AT14: Atlas 14
  • V11: volume 11
  • 1Q: first quantile, the majority of the rainfall is in 1st quantile
  • 10P: the 10% of the occurrence temporal distribution
  • 6hr: the duration of the storm

To import the temporal distribution into XPSWMM

  • Import XPX file
  • Review the rainfall profile in global data

Global Storm and Ensemble

With global storm, we can run the same model with different rainfall profiles. By assigning an ensemble name, we can calculate ensemble statistics within XPSWMM for each ensemble.

To create global storm,

  • switch to runoff mode
  • go to job control
  • go to global storms
  • create ensemble names
  • build a list of global storm
  • (6) is the temporal distribution imported from xpx file
  • (7)(8) we get the PF frequency rainfall from the NOAA website and apply that to the temporal distribution
  • (9) for each ensemble, XPSWMM will calculate the statistics

Use the solve manager to run the simulation in parallel.

Once it is completed, to show the ensemble statistics,

--

--