Colorado Climate Center Web Services
Intro
The CoAgMet Web Services consists of four types of calls - meta, monthly, daily and hourly. Each of these calls is documented below. Each call has its own parameters that may be required required and optional parameters that let you further refine your request.Basic calls can be made via http requests from a web browser with the complete call specified in the URL.
Examples
To request metadata for the CoAgMet network, use:
http://coagmet.colostate.edu/cgi-bin/web_services.pl?type=meta
To request metadata for NW Colorado, use:
http://coagmet.colostate.edu/cgi-bin/web_services.pl?type=meta&bbox=39,-105,41,-102
To request 2010 hourly temperature and precipitation data for stations ftc01 and ftc03, use:
http://coagmet.colostate.edu/cgi-bin/web_services.pl?type=hourly&sids=ftc01,ftc03&sdate=2010-01-01&edate=2010-12-31&elems=tmean,pp
To extract 5 minute Summer 2017 temperature and preciptations for ARDEC use:
http://coagmet.colostate.edu/cgi-bin/web_services.pl?type=five_minute&sids=ftc03&sdate=2017-06-01&edate=2017-08-31&elems=tmean,pp
To get daily soil moisture for one station over a few day period:
http://coagmet.colostate.edu/cgi-bin/web_services.pl?type=soilmoisture_daily&sids=bnv01&sdate=2018-04-01&edate=2018-04-15
General
This section describes parameters that common to all requests.Note.
Items in italics are not yet implemented.
- type - Data type [required] Data type specifies the type of data requested. This is a required field.
- src - Data source
Code Description coag CoAgMet coop Cooperative Weather Stations snotel SNOTEL Stations coco CoCoRAHS - Location specifiers
Code Description sids Comma separated station list bbox Lat/Lon bounding box (lat0,lon0,lat1,lon1)
lat0,lon0 - SW corner of box
lat1,lon1 - NE corner of boxdefault All Stations - Options
Code Description sdate Start date in yyyy-mm-dd format. edate End date in yyyy-mm-dd format. elems Elements. A list of one or more of the codes found in table for this type.
Code | Description |
---|---|
meta | Metadata |
monthly | Monthly data |
daily | Daily data |
hourly | Hourly data |
five_minute | Five minute data |
soilmoisture_daily | Daily soil moisture |
soilmoisture_hourly | Hourly soil moisture |
Metadata
CoAgMet
Records are in fixed format (%6s %-30s %-40s %10.4f %10.4f %6d %3s %s ). Mising fields are spaces. Returns:- Station ID
- Station Name
- Station Location
- Latitude
- Longitude
- Elevation (feet)
- Datalogger Format
- Active?
Example
akr02 Akron USDA-ARS-GPRC 40.1548 -103.1420 4537 akr Y
Cooperative Weather Stations and SNOTEL
Records are in fixed format (%6s %-40s %10.4f %10.4f %6d %-50s %-50s ). Mising fields are spaces. Returns:- Station ID
- Station Name
- Latitude (degrees)
- Longitude (degrees)
- Elevation (feet)
- Mean monthly mean temps
- Mean monthly precip
Example
50109 AKRON 4E 40.1500 -103.1500 4540 251 305 378 460 559 664 727 709 619 496 355 271 36 37 106 142 300 228 295 226 98 85 70 36
CoCoRAHS
Monthly Data (CoAgMet, Coop and SNOTEL)
Monthly data is returned as a comma delimited file with one line for each year.Record format:
- Station ID
- Year
- Element (see table below)
- January data
- February data
- March data
- Etc.
Data elements
Element | Description |
---|---|
DP01 | Number of days with >= 0.1 inches precipitation. |
DP05 | Number of days with >= 0.5 inches precipitation. |
DP10 | Number of days with >= 1.0 inches precipitation. |
DSNW | Number of days with snowdepth >= 1 inches. |
DT00 | Number of days with min. temp. <= 0 deg.F. |
DT32 | Number of days with min. temp. <= 32 Deg.F. |
DT90 | Number of days with max. temp. >= 90 Deg.F. |
DX32 | Number of days with max. temp. <= 32 Deg.F. |
EMXP | Extreme max. daily precip. and day of occurence. (Deg.F.) |
EMNT | Extreme min. temp. and day of occurence. (Deg.F.) |
EMXT | Extreme max. temp. and day of occurence. (Deg.F.) |
HTDD | Monthly heating degree days, 65 Deg.F base. |
CLDD | Monthly cooling degree days, 65 deg.F base. |
CGDD | Monthly corn growing degree days, 65 deg.F base. |
MMNT | Monthly mean minimum temperature. (0.1's Deg.F.) |
MMXT | Monthly mean maximum temperature. (0.1's Deg.F.) |
MNTM | Monthly mean temperature. (0.1's Deg.F. |
MXSD | Maximum snowdepth and day of occurence. (inches) |
TPCP | Total monthly precipitation. (0.01's inches) |
TSNW | Total monthly snowfall. (0.1's inches) |
RFET | Total monthly reference evapotranspiration. (0.01's inches) |
Code | Description |
---|---|
A | accumulated amount |
B | Adjusted total |
E | Estimated |
I | Incomplete, 1-9 days missing |
M | Missing |
S | Precipitation is continuing to be accumulated |
T | trace |
+ | multiple occurences |
Daily CoAgMet Data
Index | Type | Units |
---|---|---|
date | Datetime | YYYY-MM-DD |
tave | Mean Temperature | Celsius |
tmax | Maximum Temperature | Celsius |
mxtm | Time of Maximum Temperature | HH:MM:SS |
tmin | Minimum Temperature | Celsius |
mntm | Time of Minimum Temperature | HH:MM:SS |
vp | Vapor Pressure | kPa |
rhmax | Maximum Relative Humidity | Fraction |
rhmxtm | Time of Maximum Relative Humidity | HH:MM:SS |
rhmin | Minimum Relative Humidity | Fraction |
rhmntm | Time of Minimum Relative Humidity | HH:MM:SS |
sr | Solar Radiation | MJ/m^2 |
wrun | Wind_Run | km/day |
pp | Precipitation | millimeters |
st5mx | Maximum Soil Temperature at 5cm | Celsius |
st5mxtm | Time of Maximum Soil Temperature at 5cm | HH:MM:SS |
st5mn | Minimum Soil Temperature at 5cm | Celsius |
st5mntm | Time of Minimum Soil Temperature at 5cm | HH:MM:SS |
st15mx | Maximum Soil Temperature at 15cm | Celsius |
st15mxtm | Time of Maximum Soil Temperature at 15cm | HH:MM:SS |
st15mn | Minimum Soil Temperature at 15cm | Celsius |
st15mntm | Time of Minimum Soil Temperature at 15cm | HH:MM:SS |
volts | Battery Voltage | |
year | Year of data | |
gust | Maximum daily wind gust | m/s |
gusttm | Time of maximum daily wind gust | min into day NOT HH:MM as other max/min |
gustdir | Direction of maximum daily wind gust | deg |
etr | Daily ASCE Reference ET | mm per day |
etr_pk | Penman-Kimberly Reference ET | mm per day |
etr_hly | Summed hourly ASCE Reference ET | mm per day |
eto | Daily ASCE Short Reference ET | mm per day |
Daily Coop Data
Type | Type | Units |
---|---|---|
TMAX | Maximum Temperature | Degrees F. |
TMIN | Minimum Temperature | Degrees F. |
PRCP | Precipitation | 0.01 inches |
SNOW | Snowfall | 0.1 inches |
SNDP | Snow depth on the ground | inches |
Code | Description |
---|---|
m | missing |
t | trace |
a | accumulated period |
h | hail (Ft Collins only) |
Daily SNOTEL Data
Type | Type | Units |
---|---|---|
TMAX | Maximum Temperature | Degrees F. |
TMIN | Minimum Temperature | Degrees F. |
PRCP | Precipitation | 0.01 inches |
SNOW | Snowfall | 0.1 inches |
SNDP | Snow depth on the ground | inches |
CoAgMet Hourly Data Format
Index | Type | Units |
---|---|---|
datetime | Datetime | YYYY-MM-DD HH:MM:SS |
tmean | Mean Temperature | Celsius |
rh | Relative Humidity | Fraction |
vp | Vapor Pressure | kPa |
sr | Solar Radiation | kJ/m^2 * min |
ws | Mean Wind Speed | m/s |
wind_vec | Vector Average Wind Direction | Degrees 0 and 360 are north |
wind_std | Standard Deviation of Wind Direction | Degrees |
pp | Precipitation | millimeters |
st5 | Mean Soil Temp at 5cm | Celsius |
st15 | Mean Soil Temp at 15cm | Celsius |
gust | Wind Gust | m/s |
gusttm | Wind Gust Time | minutes into day |
gustdir | Wind Gust Direction | Degrees |
etr | ASCE Reference ETr | mm/hr |
eto | ASCE Short Reference ETo | mm/hr |
CoAgMet Five Minute Data Format
Index | Type | Units | Type |
---|---|---|---|
volt* | BattVolt_Avg | Volts | Avg |
tmean | AirTemp_Avg | Celcius | Avg |
rh | RH_Avg | fraction | Avg |
vp | Vap_Press_Avg | kPa | Avg |
sr | HrlySolRad_Avg | kJ/m^2/min | Avg |
ws | WindSpeed | m/s | WVc |
wind_vec | WindDir | Deg | WVc |
wind_std | WindDir_STDD | Deg | WVc |
pp | Rain_Tot | mm | Tot |
st5 | SoilTemp_5cm_Avg | Celcius | Avg |
st15 | SoilTemp_15cm_Avg | Celcius | Avg |
gust | HWG_speed | m/s | Max |
gusttm | HWG_time | SMM | |
gustdir | HWG_Dir | degrees | SMM |
* deprecated
CoAgMet Daily Soil Moisture
Index | Type | Units |
---|---|---|
vwc4 | Volumetric water content, 4" depth | m3/m3 |
ec4 | Electrical conductivity, 4" depth | dS/m |
st4 | Soil Temperature, 4" depth | C |
vwc24 | Volumetric water content, 24" depth | m3/m3 |
ec24 | Electrical conductivity, 24" depth | dS/m |
st24 | Soil Temperature, 24" depth | C |
CoAgMet Hourly Soil Moisture
Index | Type | Units |
---|---|---|
vwc4 | Volumetric water content, 4" depth | m3/m3 |
ec4 | Electrical conductivity, 4" depth | dS/m |
st4 | Soil Temperature, 4" depth | C |
vwc24 | Volumetric water content, 24" depth | m3/m3 |
ec24 | Electrical conductivity, 24" depth | dS/m |
st24 | Soil Temperature, 24" depth | C |