pvlib.iotools.get_nasa_power#

pvlib.iotools.get_nasa_power(latitude, longitude, start, end, parameters=['dni', 'dhi', 'ghi', 'temp_air', 'wind_speed'], *, community='re', elevation=None, wind_height=None, wind_surface=None, map_variables=True, url='https://power.larc.nasa.gov/api/temporal/hourly/point')[source]#

Retrieve irradiance and weather data from NASA POWER.

A general description of NASA POWER is given in [1] and the API is described in [2]. A detailed list of the available parameters can be found in [3].

Parameters:

latitude (float) – In decimal degrees, north is positive (ISO 19115).
longitude (float) – In decimal degrees, east is positive (ISO 19115).
start (datetime like) – First timestamp of the requested period.
end (datetime like) – Last timestamp of the requested period.
parameters (str, list) –
List of parameters. The default parameters are mentioned below; for the full list see [3]. Note that the pvlib naming conventions can also be used.
- Global Horizontal Irradiance (GHI) [Wm⁻²]
- Diffuse Horizontal Irradiance (DHI) [Wm⁻²]
- Direct Normal Irradiance (DNI) [Wm⁻²]
- Air temperature at 2 m [C]
- Wind speed at 10 m [m/s]
community (str, default 're') –
Can be one of the following depending on which parameters are of interest. Note that in many cases this choice might affect the units of the parameter.
- 're': renewable energy
- 'sb': sustainable buildings
- 'ag': agroclimatology
elevation (float, optional) – The custom site elevation in meters to produce the corrected atmospheric pressure adjusted for elevation.
wind_height (float, optional) – The custom wind height in meters to produce the wind speed adjusted for height. Has to be between 10 and 300 m; see [4].
wind_surface (str, optional) – The definable surface type to adjust the wind speed. For a list of the surface types see [4]. If you provide a wind surface alias please include a site elevation with the request.
map_variables (bool, default True) – When true, renames columns of the Dataframe to pvlib variable names where applicable. See variable VARIABLE_MAP.

Raises:

requests.HTTPError – Raises an error when an incorrect request is made.

Returns:

data (pd.DataFrame) – Time series data. The index corresponds to the start (left) of the interval.
meta (dict) – Metadata.

References