pvlib.iotools.read_nsrdb_psm4#

pvlib.iotools.read_nsrdb_psm4(filename, map_variables=True)[source]#

Read an NSRDB PSM4 weather file (formatted as SAM CSV).

The NSRDB is described in [1] and the SAM CSV format is described in [2].

Parameters:

filename (str, path-like, or buffer) – Filename or in-memory buffer of a file containing data to read.
map_variables (bool, default True) – When true, renames columns of the Dataframe to pvlib variable names where applicable. See variable VARIABLE_MAP.

Returns:

data (pandas.DataFrame) – timeseries data from NREL PSM4
metadata (dict) – metadata from NREL PSM4 about the record, see notes for fields

Notes

The return is a tuple with two items. The first item is a dataframe with the PSM4 timeseries data.

The second item is a dictionary with metadata from NREL PSM4 about the record containing the following fields:

Examples

>>> # Read a local PSM4 file:
>>> df, metadata = iotools.read_nsrdb_psm4("data.csv")  

>>> # Read a file object or an in-memory buffer:
>>> with open(filename, 'r') as f:  
...     df, metadata = iotools.read_nsrdb_psm4(f)  