pvlib.iotools.read_pvgis_hourly#

pvlib.iotools.read_pvgis_hourly(filename, pvgis_format=None, map_variables=True)[source]#

Read a PVGIS hourly file.

Changed in version 0.13.0: The function now returns two items (data,meta). Previous versions of this function returned three elements (data,inputs,meta). The inputs dictionary is now included in meta, which has changed structure to accommodate it.

Parameters:

filename (str, pathlib.Path, or file-like buffer) – Name, path, or buffer of hourly data file downloaded from PVGIS.
pvgis_format (str, optional) – Format of PVGIS file or buffer. Equivalent to the outputformat parameter in the PVGIS API. If filename is a file and pvgis_format is not specified then the file extension will be used to determine the PVGIS format to parse. If filename is a buffer, then pvgis_format is required and must be in ['csv', 'json'].
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) – the time series data
metadata (dict) – metadata

Warning

The azimuth orientation specified in the output metadata does not correspond to the pvlib convention, but is offset 180 degrees.

Raises:

ValueError – if pvgis_format is not specified and the file extension is neither .csv nor .json or if pvgis_format is provided as input but isn’t in ['csv', 'json']
TypeError – if pvgis_format is not specified and filename is a buffer