Region screen - HxGN EAM - Version 11.07.01 - Feature Briefs - Hexagon

HxGN EAM Regions and Degree Days
Language
English
Product
HxGN EAM
Search by Category
Feature Briefs
HxGN EAM Version
11.7.1

The Regions screen defines a region for which temperature data will be maintained. In this screen, the Degree Day Reference Point is established, Fahrenheit/Celsius is selected, and the preferred source for actual temperature data is specified.

Currently the source supported in HxGN EAM is:

  • The National Climatic Data Center (the climate data steward of the National Oceanic and Atmospheric Administration (NOAA))

(see EAM-13801) The interface between HxGN EAM and National Climatic Data Center (NCDC) was developed in 2011 using XML messaging interface. Since that time, NCDC has transitioned to JSON interface (NCDC API V2) and no longer supports XML.

This causes the Get Actual Temperatures link in Actual Temperatures tab of the Regions screen to throw an error. In addition, a URL specified in the Actual Temperatures URL in the header needs to be re-formatted to current NCDC requirements.

To request weather data from the National Climatic Data Center (NCDC):

  1. First, determine the 11 character Station ID.

    • To get a list of all stations:

      ftp://ftp.ncdc.noaa.gov/pub/data/noaa/isd-history.txt

      This may be the best source for international stations

    • To get an XML list of stations by Zip Code:

      http://www.ncdc.noaa.gov/cdo-services/services/gsodstationservice/zipcode/29605/stations.xml

      This may be the best source for USA stations

    • To get an XML list of stations by Latitude/Longitude:

      http://www.ncdc.noaa.gov/cdo-services/services/gsodstationservice/latlon/35.432:-82.538/stations.xml

      To get an XML list of stations by City Name:

      http://www.ncdc.noaa.gov/cdo-services/services/gsodstationservice/city/Knoxville/stations.xml

  2. Scan the response for date applicability:

    - <gsodStation>

      <id>99999913822</id>

      <name>GREENVILLE DONALDSON AFB</name>

      <beginDate>19490101</beginDate>

      <endDate>19630430</endDate>

      <latitude>34.767</latitude>

      <longitude>-82.383</longitude>

    </gsodStation>

    - <gsodStation>

      <id>72312263889</id>

      <name>GREENVILLE</name>

      <beginDate>20081124</beginDate>

    ++++++

      <latitude>34.758</latitude>

      <longitude>-82.376</longitude>

    </gsodStation>

    - <gsodStation>

      <id>72312299999</id>

      <name>GREENVILLE</name>

      <beginDate>20050614</beginDate>

      <endDate>20081123</endDate>

      <latitude>34.75</latitude>

      <longitude>-82.367</longitude>

    </gsodStation>

  3. Then copy the appropriate 11 character <id> into the following URL:

    https://www.ncdc.noaa.gov/cdo-web/api/v2/data?stationid=GHCND:USW00013886

Location type

Format

Examples

City or town name

City Name

City Name, State (US only)

City Name, State, Country

City Name, Country

q=New+York

q=New+york,ny

q=London,united+kingdom

IP address

XXX.XXX.XXX.XXX

q=101.25.32.325

UK or Canada Postal Code or US Zip Code

Postal Code or zip code format

q=SW1

q=90201

Latitude and longitude

XX.XXX,XX.XXX in decimal degrees

q=48.834,2.394

Historical Temperatures tab

  • Store Historical Averages for highs, lows, averages, and degree days.

  • One record for each of the 366 days of the year.

  • The system pre-populates 366 Historical records with nulls for all temperature data.

Actual Temperatures tab

  • Store Actual highs, lows, averages and degree days in List/Detail format.

  • Request that weather data be imported from the source specified on the Regions screen.

  • One record for each day.