This tutorial shows how to use the pvlib.tmy module to read data from TMY2 and TMY3 files.
This tutorial has been tested against the following package versions:
Authors:
In [1]:
    
# built in python modules
import datetime
import os
import inspect
# python add-ons
import numpy as np
import pandas as pd
# plotting libraries
%matplotlib inline
import matplotlib.pyplot as plt
try:
    import seaborn as sns
except ImportError:
    pass
import pvlib
    
pvlib comes packaged with a TMY2 and a TMY3 data file.
In [2]:
    
# Find the absolute file path to your pvlib installation
pvlib_abspath = os.path.dirname(os.path.abspath(inspect.getfile(pvlib)))
    
Import the TMY data using the functions in the pvlib.tmy module.
In [3]:
    
tmy3_data, tmy3_metadata = pvlib.tmy.readtmy3(os.path.join(pvlib_abspath, 'data', '703165TY.csv'))
tmy2_data, tmy2_metadata = pvlib.tmy.readtmy2(os.path.join(pvlib_abspath, 'data', '12839.tm2'))
    
Print the TMY3 metadata and the first 5 lines of the data.
In [4]:
    
print(tmy3_metadata)
tmy3_data.head(5)
    
    
    Out[4]:
In [5]:
    
tmy3_data['GHI'].plot()
    
    Out[5]:
    
The TMY readers have an optional argument to coerce the year to a single value.
In [6]:
    
tmy3_data, tmy3_metadata = pvlib.tmy.readtmy3(os.path.join(pvlib_abspath, 'data', '703165TY.csv'), coerce_year=1987)
    
In [7]:
    
tmy3_data['GHI'].plot()
    
    Out[7]:
    
Here's the TMY2 data.
In [8]:
    
print(tmy2_metadata)
print(tmy2_data.head())
    
    
Finally, the TMY readers can access TMY files directly from the NREL website.
In [9]:
    
tmy3_data, tmy3_metadata = pvlib.tmy.readtmy3('http://rredc.nrel.gov/solar/old_data/nsrdb/1991-2005/data/tmy3/722740TYA.CSV', coerce_year=2015)
    
In [10]:
    
tmy3_data['GHI'].plot(figsize=(12,6))
plt.title('Tucson TMY GHI')
    
    Out[10]:
    
In [ ]: