#Wunderground Python API wrapper WunderPython is an API wrapper for the Wunderground API.

##Installation

$ pip install WunderPython --pre

The '--pre' option is requierd because there is currently no version marked as stable.

##Requirements Python 2

##Usage Import the library

>>> from wunderpython import wunderground

Create an instance of the API wrapper

>>> wg = wunderground.Wunderground('your secret api key')

Find a location

>>> wg.search(’Munich, G’)
[’Munich, Germany’, ’Munich, Grenada’]

Get a info about a location

>>> location = wg['Munich, Germany']
>>> location.name
'Munich, Germany'
>>>
>>> # getting the latitude and longitude
>>> location.ll
48.130001 11.700000

Get a data feature

>>> conditions = location.conditions
>>> conditions[’temperature_string’]
64 F (18 C)

Supported features are: ['alerts', 'almanac', 'astronomy', 'conditions', 'forecast', 'forecast10day', 'hourly', 'hourly10day', 'rawtide', 'satellite', 'tide', 'webcams']

Access historical data

>>> pastDay = location.history[’2009.06.23’]
>>> pastDay[’observations’][0][’tempi’]
53.6

##Examples Some examples that can be used in IPython Notebook.

###Compare the mean temperature of several cities

from wunderpython import wunderground
wg = wunderground.Wunderground('your secret api key')
from pandas import *
x = []
ds = {}

for city in wg['Munich, Germany', 'New York City, New York', 'Changde, China']:
    ds[city.name] = []
    for day in city.history['2014.06.01':'2014.07.01']:
        dailysummary = day['dailysummary'][0]        
        if dailysummary['date']['year']+'.'+dailysummary['date']['mon']+'.'+dailysummary['date']['mday'] not in x:
            x.append(dailysummary['date']['year']+'.'+dailysummary['date']['mon']+'.'+dailysummary['date']['mday'])
        ds[city.name].append(float(dailysummary['meantempm']))

df = DataFrame(ds, x)
print df.plot(rot = 90)

###Compare wind and pressure

from wunderpython import wunderground
wg = wunderground.Wunderground('your secret api key')
from pandas import *
x = []
ds = {
    'pressurem':[],
    'wspdm':[],
}


for day in wg['Munich, Germany'].history['2014.05.02':'2014.05.05']:
    for observation in day['observations']:
        x.append(observation['date']['pretty'])
        ds['pressurem'].append(float(observation['pressurem']))
        ds['wspdm'].append(float(observation['wspdm']))

df = DataFrame(ds, x)
df.pressurem.plot(secondary_y=True)
df.wspdm.plot(rot = 90)

##Tests Before running the tests you have to replace no_valid_key with your API Key in tests/test_wunderpython.py

Then you can run the tests with:

python tests/test_wunderpython.py

##Note

• Terms of Service
• Developed with Wunderground API Version 0.1, Python 2.7 and IPython Notebook 3.0.

Features not yet supported:

• currenthurricane
• geolookup
• planner
• yesterday

Also WunderMap Layers are not yet supported.