Download MxVision WeatherSentry® Web Services Content

MxVision WeatherSentry®
Web Services
Content Guide
May 2014
Schneider Electric
11400 Rupp Drive
Minneapolis, MN 55337
00.1.952.890.0609
© Copyright 2014 Schneider Electric. All rights reserved.
This document and the software it describes are copyrighted with all rights reserved. Neither this
document nor the software may be copied in whole or in part without the prior written consent of
the copyright owner. Printed in the United States of America.
Schneider Electric is a registered trademark and the property of Schneider Electric. All rights reserved.
All other trademarks are the properties of their respective owners.
2
Copyright 2014 Schneider Electric. All rights reserved.
1
Table of Contents
MxVision WeatherSentry® Web Services ........................................................................... 4
2
2.1
Observed........................................................................................................................... 4
2.2
Forecast............................................................................................................................. 4
3
Content – Hourly Parameters ............................................................................................. 5
4
Content – Daily Parameters ................................................................................................ 6
5
Glossary ................................................................................................................................ 9
3
Copyright 2014 Schneider Electric. All rights reserved.
2 MxVision WeatherSentry® Web Services
This content guide is intended for users of MxVision WeatherSentry Web Services.
Included in this guide are the various parameters available to users of MxVision
WeatherSentry Web Services. For additional details, please see the MxVision
WeatherSentry Web Services Programming Guide
MxVision WeatherSentry Web Services provides your organization with global
weather observations and forecasts. All content is global unless otherwise stated.
Several categories of data are available. These are hourly and daily observed and
forecast, as well as daily observed normals. The same content is available for both
SOAP and REST.
2.1
Observed
Observed data is the record of atmospheric conditions. The observed value is
measured at a point in time, or instantaneous, for most parameters – with the
exception of precipitation. Precipitation is typically reported as a measurement over a
period of time, or accumulated.
Observed weather values are reported hourly. Traditionally, the hourly report refers
to the instantaneous value from top-of-the-hour readings. Precipitation values have
duration and therefore are allowed to accumulate until reported at the end-of-thehour. Observed data is available for a specified location for the past 60 days.
The normals provided are a 10 year average of high temperatures and/or low
temperatures. Daily departures from normal are also available.
Quality control occurs within the hour and again within the day. To ensure the most
accurate possible observation data, allow at least 8 hours past midnight for
completion of quality control.
2.2
Forecast
A forecast is the prediction of the weather using the principles of physics and
meteorology. Forecasts of temperature and other similar data are instantaneous –
meaning they are forecast for a specific time. Precipitation values have duration and
are therefore represented as an accumulation expected by the end-of-the-hour.
The forecast process supports up to 15 days of hourly and daily data. Forecast data is
provided for a specified location and is updated every hour.
4
Copyright 2014 Schneider Electric. All rights reserved.
3 Content – Hourly Parameters
Multiple units of measure are available. For example; temperature is typically
measured in degrees Fahrenheit or degrees Celsius. Refer to the XSD at
(http://weather.dtn.com/rest-3.0/doc/TDTNWeatherDataService.xsd) for valid values.
Most hourly parameters are available for both forecast (Fcst) and observed (Obs);
with exceptions noted in the table below.
Parameter
Description
Fcst
Obs
Temperature
√
√
√
√
√
√
√
√
√
√
Feels Like
The air temperature.
The absolute temperature at which air can no
longer hold all of its water vapor.
The amount of water vapor in the air.
The combination of air temperature and relative
humidity determining a perceived air
temperature.
The combination of air temperature and wind
speed determining a perceived air temperature.
The feels like temperature.
√
√
Wind Direction
The direction the wind is coming from.
√
√
Wind Speed
The speed of the wind.
√
√
Wind Gusts
The speed of wind gusts.
The lowest temperature that can be reached by
the evaporation of water only.
√
√
√
√
The number of minutes of sunshine to occur.
√
√
The percentage of sky covered by clouds.
√
√
The measure of solar radiation.
√
√
The likelihood of precipitation to occur.
√
Dew Point
Relative Humidity
Heat Index
Wind Chill
Wet Bulb Temp
Minutes of
Sunshine
Cloud Cover
Percentage
Solar Radiation
Probability of
Precipitation
Precipitation
amount
Snowfall
Total of rain or ice, or liquid equivalent of
snowfall.
The amount of snowfall.
√
√
√
√
Precipitation Type
Weather
Description
Sea Level Pressure
The type of precipitation; rain, ice or snow.
√
√
The general weather condition.
√
√
The atmospheric pressure at sea level.
√
√
Barometric
The pressure caused by the weight of
√
√
5
Copyright 2014 Schneider Electric. All rights reserved.
Pressure
atmosphere.
Visibility
Distance visible without instrumental assistance.
√
√
4 Content – Daily Parameters
Multiple units of measure are available. Refer to the XSD at
(http://weather.dtn.com/rest-3.0/doc/TDTNWeatherDataService.xsd) for valid values.
Daily parameters are valid for a given location and a specified local calendar day; that
is midnight to 11:59pm local time. Most daily parameters are available for both
forecast (Fcst) and observed (Obs); with exceptions noted in the table below.
Daily Parameter
Sunrise
Sunset
Max Temperature
Min Temperature
Avg Temperature
10yr Normal Max
Temperature
10yr Normal Min
Temperature
10yr Normal Avg
Temperature
Avg Temperature
Departure From
10yr Normal
Avg Dew Point
Avg Relative
Humidity
Avg Wet Bulb
Temperature
Heating Degree
Day (HDD)
10yr Normal
Heating Degree
Description (by calendar day)
The time at which the first part of the sun
becomes visible in the morning.
The time at which the last part of the sun
disappears below the horizon in the evening.
The highest temperature to occur.
Obs
Fcst
√
√
√
√
√
√
The lowest temperature to occur.
An average of the Max Temperature and the
Min Temperature.
An average of the high temperatures recorded
for a calendar day over a 10 year period.
An average of the low temperatures recorded
for a calendar day over a 10 year period.
An average of the Normal Max Temperature
and Normal Min Temperature over a 10 year
period.
The difference between the Avg Temperature
and the 10yr Normal Avg Temperature for the
same calendar day.
An average of the hourly dew point values.
An average of the hourly relative humidity
values.
An average of the hourly wet bulb temperature
values.
The sum of heating degrees required to
maintain an average temperature of 65°F
(18°C) within a home or business.
An average of the number of heating degrees
recorded for the same calendar day over a 10
√
√
√
√
√
√
√
√
√
√
√
√
√
√
6
Copyright 2014 Schneider Electric. All rights reserved.
Day
year period.
Heating Degree
Day Departure
From 10yr Normal
The difference between the number of heating
degrees and the 10yr Normal Heating Degree
Day for the same calendar day.
The sum of cooling degrees required to
maintain an average temperature of 65°F
(18°C) within a home or business.
An average of the number of cooling degrees
recorded for the same calendar day over a 10
year period.
The difference between the number of cooling
degrees and the 10yr Normal Cooling Degree
Day for the same calendar day.
Effective Degree Day is a proprietary, enhanced
version of Heating Degree Day that adds the
effect of wind speed.
An average of the number of effective degrees
recorded for the same calendar day over a 10
year period.
The difference between the number of effective
degrees and the 10yr Normal Effective Degree
Day for the same calendar day.
An average of the hourly heat index
temperature.
The lowest hourly heat index temperature
Cooling Degree
Day (CDD)
10yr Normal
Cooling Degree
Day
Cooling Degree
Day Departure
From 10yr Normal
Effective Degree
Day
10yr Normal
Effective Degree
Day
Effective Degree
Day Departure
From 10yr Normal
Avg Heat Index
Min Heat Index
Max Heat Index
√
√
√
√
√
√
√
√
√
√
√
√
√
√
√
√
√
Min Wind Chill
The highest hourly heat index temperature
An average of the hourly wind chill
temperature.
The lowest wind chill value
√
√
Max Wind Chill
The highest wind chill value
√
√
Avg Feels Like
An average of the hourly feels like temperature.
√
Maximum Feels Like
The highest feels like temperature to occur.
√
√
Minimum Feels Like
Average Wind
Speed
Max Wind Speed
Minutes of
Sunshine
Solar Radiation
The lowest feels like temperature to occur.
√
√
An average of the hourly wind speed values.
√
The highest wind speed or gust value.
√
√
The number of minutes of sunshine to occur.
√
√
The measure of solar radiation
√
√
Avg Wind Chill
7
Copyright 2014 Schneider Electric. All rights reserved.
Cloud Cover
Percentage
Evapotranspiration
Growing Degree
Day
Probability of
Precipitation
Precipitation
amount
Snowfall
Precipitation Type
Weather
Description
Crop Heating Unit
Average Barometric
Pressure
Average Soil
Moisture
Min Soil Moisture
Max Soil Moisture
Average Soil
Temperature
Min Soil
Temperature
Max Soil
Temperature
Average Wet Bulb
Globe Temperature
Min Wet Bulb
Globe Temperature
Max Wet Bulb
Globe Temperature
The percentage of sky covered by clouds.
The sum of evaporation and plant transpiration
from the earth's land surface to atmosphere.
The number of degrees that the average
temperature is above a baseline value.
√
√
√
√
√
√
The likelihood of precipitation to occur.
Total of rain or ice, or liquid equivalent of
snowfall.
The amount of snowfall.
√
√
√
√
√
Type of precipitation; rain, ice or snow.
√
√
The general weather condition.
√
√
Crop Heat Units is an energy term calculated
daily using the daily maximum and minimum
temperature
√
√
An average of the hourly barometric pressure.
√
An average of soil moisture content.
√
The lowest measured soil moisture content.
√
The highest measured soil moisture content.
√
An average of soil temperature.
√
The lowest soil temperature measured.
√
The highest soil temperature measured.
√
The average Wet Bulb Globe temperature to
occur.
The lowest Wet Bulb Globe temperature
measured.
The highest Wet Bulb Globe temperature
measured
√
√
√
√
√
√
8
Copyright 2014 Schneider Electric. All rights reserved.
5 Glossary
Accumulated
A value reported over a period of time which is typical for precipitation reporting.
Avg
Average (avg) is the number that is found by dividing the sum of data by the number of
items in the data set. It is also called the mean. For example; the average daily temperature is
calculated by dividing the sum of the 24 hourly temperatures by 24.
Calendar Day
A calendar day refers to the time period of midnight to 11:59pm local time.
Crop Heating Unit
Crop Heating Unit is the equivalent of the Canadian Corn Heat Unit which is a function of
the maximum temperature and minimum temperature reported in degrees Centigrade.
= (. − .4) + 3.3 ∗ (
− 10.0) − 0.084 ∗ (
− 10.0)
2
Maximum temperatures less than 10 degrees Centigrade are set to 10. Minimum
temperatures less than 4.4 degrees Centigrade are set to 4.4. A negative CHU is not valid
and any value less than zero are reported as 0.
Daily
Data is updated each day at a specific time. The time of day may vary by data type or
provider or in reference to a data value represented for a 24 hour period, typically a calendar
day.
Dew Point
The absolute temperature at which air can no longer hold all of its water vapor, causing
condensation into liquid water.
Evapotranspiration
Evapotranspiration (ET) is a quantity that measures the amount of water transferred from
vegetation to the atmosphere. The calculation takes into account the local sun angle and
other location-specific quantities, and the local daily weather conditions to estimate the likely
amount of water that a corn plant would use on a daily basis.
Fcst
Forecast (Fcst) is a prediction of the weather through application of the principles of physics
and meteorology.
Feels Like
The current heat index if over 70°F (21°C) or wind chill if below 50°F (10°C).
9
Copyright 2014 Schneider Electric. All rights reserved.
Global
Global, as used when referring to weather data, is data which is gathered from and available
to the entire globe or world; worldwide.
Hourly
Traditionally, weather observations have been reported on or near the top-of-the-hour. The
end-of-the-hour is the typical reporting method for precipitation amounts.
Instantaneous
A value reported for a specific time, the typical reporting method for temperatures.
Max
Maximum (Max) is the largest or highest value of a data set. For example; the maximum daily
temperature refers to the highest temperature value recorded within a calendar day.
Min
Minimum (Min) is the smallest or lowest value of a data set. For example; the minimum daily
temperature refers to the lowest temperature value recorded within a calendar day.
MADIS
The Meteorological Assimilation Data Ingest System (MADIS) ingests data files from NOAA
data sources and non-NOAA data providers, decodes the data and then encodes all of the
observational data into a common format with uniform observation units and time stamps.
Quality control checks are conducted and the integrated data sets are stored in the MADIS
database with a series of flags indicating the quality of the observation from a variety of
perspectives.
NOAA
The National Oceanic and Atmospheric Administration (NOAA) is a United States federal
agency focused on the condition of the oceans and the atmosphere.
Normals
Normals are the average value of a specific data type over a given timeframe. In this
document normals refer to a 10 year period.
NWS
The National Weather Service (NWS) of the United States is a division of NOAA.
Obs
Observation (Obs) is an evaluation of one or more meteorological elements that describe the
state of the atmosphere either at the earth's surface or aloft.
REST
REST web service (also called a RESTful web API) is a simple web service implemented using
HTTP and the principles of REST.
10
Copyright 2014 Schneider Electric. All rights reserved.
SOAP
Simple Object Access Protocol (SOAP) is a protocol specification for exchanging structured
information in the implementation of Web Services in computer networks.
Web Service
A Web service is a method of communication between two electronic devices over a
network.
yr
A year (yr) is a period of 365 days (or 366 days during leap years).
11
Copyright 2014 Schneider Electric. All rights reserved.