Workflow - Precip data extraction
This page contains detailed information for the precipitation data extraction component.
On this page:
Description
This workflow automatically extracts precipitation data from four national sources and compiles data into a consistent format. The workflow requires the user to select an NCEI station. Data from the user selected NCEI Station along with data from three gridded data sources (NLDAS, GLDAS, and TRMM) at the same location and time frame are downloaded and reformatted. It should be noted that dates in time-series refer to local time-zone. The algorithm converts time-series from GMT to local time-zone for NLDAS, GLDAS, and TRMM. A uniform distribution of values is assumed within a time step for gridded data sources when converting to local time zone. A temporal resolution of daily or monthly can be chosen for data requests. Summary statistics are provided for each of the four data sources. The time series of data downloaded for the time period and location can be downloaded as a CSV or JSON.
Input Parameters
Attributes of the HMS Precipitation Data Extraction input object
| Parameter | DataType | Description | Comments |
|---|---|---|---|
| NCEI Station ID | String | NOAA NCEI station identification number e.g. GHCND:USW00013874 | Station identifiers can be obtained from NOAA’s tool at https://www.ncdc.noaa.gov/cdo-web/datatools/findstation |
| Start Date | String | Start date for the output timeseries. e.g., 01/01/2010 | Data Availability nldas: hourly 1/1/1979 – Present (~4-day lag); North America @ 0.125 deg resolution. gldas: 3-hourly 1/1/2000-Present (~1-month lag); Global @ 0.250 deg resolution. ncei: depends upon selected station trmm: daily 12/31/1997-11/30/2019; Global 50 deg South and 50 deg North latitudes @.250 deg resolution. |
| End Date | String | End date for the output timeseries. e.g., 01/01/2010 | |
| Temporal Resolution | Drop-down list | Temporal resolution/timestep of the output time-series. | Valid options: daily, monthly. |
Output Parameters
Attributes of the HMS Precipitation Data Extraction output object
| Column | DataType | Description |
|---|---|---|
| dataset | String | Primary dataset of the requested timeseries. Some API calls return more than one dataset, either for a workflow API or other relevent dataset. |
| dataSource | String | Primary source of the requested timeseries. |
| metaData | Dictionary | Metadata for the output timeseries, includes metadata from the source as well as HMS metadata. |
| data | Dictionary | Output timeseries data is returned as a dictionary, where the key is the datetime stamp and value is a list of values for the source/dataset. |
Web Service Details
Swagger UI
HTTP API
| Method | URL |
|---|---|
| POST | https://qed.epa.gov/hms/rest/api/v3/workflow/precip_data_extraction/ |
Change Log
Version: 0.1 Beta : May 29, 2019
- Production UI and documentation initial setup.