= Introduction =
[[Image(WeatherUndergroundUI4.png, align=right, 30%)]]
[[Image(WeatherUndergroundUI5.png, align=right, 30%)]]
The Weather plugin is a [http://wiki.micasaverde.com/index.php/Luup_Plugins Luup component] that captures, displays, and periodically updates Temperature and Humidity data based upon Vera's current [http://wiki.micasaverde.com/index.php/Location Location].

= How does it work =
Each user must register with [http://wunderground.com Weather Underground] to obtain a key.  The plugin, when configured with the key, uses the Latitude / Longitude values configured in Vera's [http://wiki.micasaverde.com/index.php/Location Location] settings, and data provided by the Weather Underground (WUI) data feed, to retrieve:

 *  Temperature - The Current temperature
 *  Low Temperature - The ''estimated'' low temperature
 *  High Temperature - The ''estimated'' high temperature
 *  Humidity - The ''estimated'' humidity

Each of these values is presented as a Child Device of the Weather plugin, implementing the respective [http://wiki.micasaverde.com/index.php/Luup_UPNP_Files UPnP Service].  They're all set to be visually ''grouped'' in the UI/Presentation.

Behind the scenes, the plugin uses Vera's ''Latitude'' and ''Longitude'' values, derived from the User-specified [http://wiki.micasaverde.com/index.php/Location Location] settings, to help form a URL to the Weather Underground (WUI) API.  The user also has the option of explicitly specifying a location string within the Plugin itself.

The URL calls to WUI look like:

  https://api.wunderground.com/api/{''key''}/conditions/forecast/q/{''lat''},{''long''}.xml OR;

  https://api.wunderground.com/api/{''key''}/conditions/forecast/q/{''location''}.xml

The plugin selects elements from the XML output, and translates them into values that are set upon the respective Child Devices.

The Weather plugin retrieves the Weather data at startup and, by default, every 30 minutes after that.

= Installation =
 * For UI2/3 Installation, please follow the [wiki:Installation-UI2 UI2/3 Installation procedure]
 * For UI4 Installation, please follow the [wiki:Installation-UI4 UI4 Installation procedure]

= Scene Scripting =
The Weather Plugin exposes a number of Variables, as is illustrated in the Install instructions.  These variables can be accessed in Luup scenes using code illustrated here:
  * http://wiki.micasaverde.com/index.php/Luup_Variables#Weather_Plugin

Further examples can be found in the Discussion area referenced below.

= Discussion =
The Weather plugin is discussed in this forum thread, along with a lot of it's development history:
  http://forum.micasaverde.com/index.php?topic=1435.0

Feel free to ask questions on that thread, as well as make any suggestions & contributions to the future development of the Weather plugin's functionality.