National Solar Radiation Database (NSRDB)¶
The National Solar Radiation Database (NSRDB) is a serially complete collection of meteorological and solar irradiance data sets for the United States and a growing list of international locations. The data are publicly available at no cost to the user and maintained by NREL.
Let’s set our NREL API key.
[1]:
import os
from nrel_dev_api import set_nrel_api_key
from nrel_dev_api.solar import NSRDB_DataQuery, get_nsrdb_download_links, download_nsrdb_data
# get and set NREL developer API key
NREL_API_KEY = os.environ["NREL_API_KEY"]
set_nrel_api_key(NREL_API_KEY)
Data Query¶
Find NSRDB datasets for a location
Get information for a single location point using latitude and longitude.
[2]:
nsrdb_data_query = NSRDB_DataQuery(lat=21.204, lon=72.839)
# check the outputs
nsrdb_data_query.outputs
[2]:
[{'apiDocs': 'https://developer.nrel.gov/docs/solar/nsrdb/msg-iodc/',
'availableIntervals': [15, 30, 60],
'enabled': True,
'displayName': 'MSG IODC: PSM v3',
'metadataLink': 'https://nsrdb.nrel.gov/current-version',
'name': 'msg-iodc',
'ranking': 20,
'availableYears': [2017, 2018, 2019],
'apiUrl': 'https://developer.nrel.gov/api/nsrdb/v2/solar/msg-iodc-download',
'links': [{'year': 2017,
'interval': 15,
'link': 'https://developer.nrel.gov/api/nsrdb/v2/solar/msg-iodc-download.csv?names=2017&wkt=POINT%2872.839+21.204%29&interval=15&api_key=yourapikey&email=youremail'},
{'year': 2018,
'interval': 15,
'link': 'https://developer.nrel.gov/api/nsrdb/v2/solar/msg-iodc-download.csv?names=2018&wkt=POINT%2872.839+21.204%29&interval=15&api_key=yourapikey&email=youremail'},
{'year': 2019,
'interval': 15,
'link': 'https://developer.nrel.gov/api/nsrdb/v2/solar/msg-iodc-download.csv?names=2019&wkt=POINT%2872.839+21.204%29&interval=15&api_key=yourapikey&email=youremail'},
{'year': 2017,
'interval': 30,
'link': 'https://developer.nrel.gov/api/nsrdb/v2/solar/msg-iodc-download.csv?names=2017&wkt=POINT%2872.839+21.204%29&interval=30&api_key=yourapikey&email=youremail'},
{'year': 2018,
'interval': 30,
'link': 'https://developer.nrel.gov/api/nsrdb/v2/solar/msg-iodc-download.csv?names=2018&wkt=POINT%2872.839+21.204%29&interval=30&api_key=yourapikey&email=youremail'},
{'year': 2019,
'interval': 30,
'link': 'https://developer.nrel.gov/api/nsrdb/v2/solar/msg-iodc-download.csv?names=2019&wkt=POINT%2872.839+21.204%29&interval=30&api_key=yourapikey&email=youremail'},
{'year': 2017,
'interval': 60,
'link': 'https://developer.nrel.gov/api/nsrdb/v2/solar/msg-iodc-download.csv?names=2017&wkt=POINT%2872.839+21.204%29&interval=60&api_key=yourapikey&email=youremail'},
{'year': 2018,
'interval': 60,
'link': 'https://developer.nrel.gov/api/nsrdb/v2/solar/msg-iodc-download.csv?names=2018&wkt=POINT%2872.839+21.204%29&interval=60&api_key=yourapikey&email=youremail'},
{'year': 2019,
'interval': 60,
'link': 'https://developer.nrel.gov/api/nsrdb/v2/solar/msg-iodc-download.csv?names=2019&wkt=POINT%2872.839+21.204%29&interval=60&api_key=yourapikey&email=youremail'}]},
{'apiDocs': 'https://developer.nrel.gov/docs/solar/nsrdb/suny-india-data-download/',
'availableIntervals': [60],
'enabled': True,
'displayName': 'SUNY International',
'metadataLink': 'https://nsrdb.nrel.gov',
'name': 'suny-india',
'ranking': 20,
'availableYears': [2000,
2001,
2002,
2003,
2004,
2005,
2006,
2007,
2008,
2009,
2010,
2011,
2012,
2013,
2014],
'apiUrl': 'https://developer.nrel.gov/api/nsrdb/v2/solar/suny-india-download',
'links': [{'year': 2000,
'interval': 60,
'link': 'https://developer.nrel.gov/api/nsrdb/v2/solar/suny-india-download.csv?names=2000&wkt=POINT%2872.839+21.204%29&interval=60&api_key=yourapikey&email=youremail'},
{'year': 2001,
'interval': 60,
'link': 'https://developer.nrel.gov/api/nsrdb/v2/solar/suny-india-download.csv?names=2001&wkt=POINT%2872.839+21.204%29&interval=60&api_key=yourapikey&email=youremail'},
{'year': 2002,
'interval': 60,
'link': 'https://developer.nrel.gov/api/nsrdb/v2/solar/suny-india-download.csv?names=2002&wkt=POINT%2872.839+21.204%29&interval=60&api_key=yourapikey&email=youremail'},
{'year': 2003,
'interval': 60,
'link': 'https://developer.nrel.gov/api/nsrdb/v2/solar/suny-india-download.csv?names=2003&wkt=POINT%2872.839+21.204%29&interval=60&api_key=yourapikey&email=youremail'},
{'year': 2004,
'interval': 60,
'link': 'https://developer.nrel.gov/api/nsrdb/v2/solar/suny-india-download.csv?names=2004&wkt=POINT%2872.839+21.204%29&interval=60&api_key=yourapikey&email=youremail'},
{'year': 2005,
'interval': 60,
'link': 'https://developer.nrel.gov/api/nsrdb/v2/solar/suny-india-download.csv?names=2005&wkt=POINT%2872.839+21.204%29&interval=60&api_key=yourapikey&email=youremail'},
{'year': 2006,
'interval': 60,
'link': 'https://developer.nrel.gov/api/nsrdb/v2/solar/suny-india-download.csv?names=2006&wkt=POINT%2872.839+21.204%29&interval=60&api_key=yourapikey&email=youremail'},
{'year': 2007,
'interval': 60,
'link': 'https://developer.nrel.gov/api/nsrdb/v2/solar/suny-india-download.csv?names=2007&wkt=POINT%2872.839+21.204%29&interval=60&api_key=yourapikey&email=youremail'},
{'year': 2008,
'interval': 60,
'link': 'https://developer.nrel.gov/api/nsrdb/v2/solar/suny-india-download.csv?names=2008&wkt=POINT%2872.839+21.204%29&interval=60&api_key=yourapikey&email=youremail'},
{'year': 2009,
'interval': 60,
'link': 'https://developer.nrel.gov/api/nsrdb/v2/solar/suny-india-download.csv?names=2009&wkt=POINT%2872.839+21.204%29&interval=60&api_key=yourapikey&email=youremail'},
{'year': 2010,
'interval': 60,
'link': 'https://developer.nrel.gov/api/nsrdb/v2/solar/suny-india-download.csv?names=2010&wkt=POINT%2872.839+21.204%29&interval=60&api_key=yourapikey&email=youremail'},
{'year': 2011,
'interval': 60,
'link': 'https://developer.nrel.gov/api/nsrdb/v2/solar/suny-india-download.csv?names=2011&wkt=POINT%2872.839+21.204%29&interval=60&api_key=yourapikey&email=youremail'},
{'year': 2012,
'interval': 60,
'link': 'https://developer.nrel.gov/api/nsrdb/v2/solar/suny-india-download.csv?names=2012&wkt=POINT%2872.839+21.204%29&interval=60&api_key=yourapikey&email=youremail'},
{'year': 2013,
'interval': 60,
'link': 'https://developer.nrel.gov/api/nsrdb/v2/solar/suny-india-download.csv?names=2013&wkt=POINT%2872.839+21.204%29&interval=60&api_key=yourapikey&email=youremail'},
{'year': 2014,
'interval': 60,
'link': 'https://developer.nrel.gov/api/nsrdb/v2/solar/suny-india-download.csv?names=2014&wkt=POINT%2872.839+21.204%29&interval=60&api_key=yourapikey&email=youremail'}]},
{'apiDocs': 'https://developer.nrel.gov/docs/solar/nsrdb/suny-india-tmy-data-download/',
'availableIntervals': [60],
'enabled': True,
'displayName': 'SUNY International TMY',
'metadataLink': 'https://nsrdb.nrel.gov',
'name': 'suny-india-tmy',
'ranking': 20,
'availableYears': ['tmy'],
'apiUrl': 'https://developer.nrel.gov/api/nsrdb/v2/solar/suny-india-tmy-download',
'links': [{'year': 'tmy',
'interval': 60,
'link': 'https://developer.nrel.gov/api/nsrdb/v2/solar/suny-india-tmy-download.csv?names=tmy&wkt=POINT%2872.839+21.204%29&interval=60&api_key=yourapikey&email=youremail'}]}]
Using a well-known text (WKT) representation of the geometry for which to extract data
[3]:
nsrdb_data_query = NSRDB_DataQuery(wkt="POINT(91.287 23.832)")
# check the outputs
nsrdb_data_query.outputs
[3]:
[{'apiDocs': 'https://developer.nrel.gov/docs/solar/nsrdb/himawari-download/',
'availableIntervals': [10, 30, 60],
'enabled': True,
'displayName': 'Himawari',
'metadataLink': 'https://nsrdb.nrel.gov',
'name': 'himawari',
'ranking': 20,
'availableYears': [2016, 2017, 2018, 2019, 2020],
'apiUrl': 'https://developer.nrel.gov/api/nsrdb/v2/solar/himawari-download',
'links': [{'year': 2016,
'interval': 10,
'link': 'https://developer.nrel.gov/api/nsrdb/v2/solar/himawari-download.csv?names=2016&wkt=POINT%2891.287+23.832%29&interval=10&api_key=yourapikey&email=youremail'},
{'year': 2017,
'interval': 10,
'link': 'https://developer.nrel.gov/api/nsrdb/v2/solar/himawari-download.csv?names=2017&wkt=POINT%2891.287+23.832%29&interval=10&api_key=yourapikey&email=youremail'},
{'year': 2018,
'interval': 10,
'link': 'https://developer.nrel.gov/api/nsrdb/v2/solar/himawari-download.csv?names=2018&wkt=POINT%2891.287+23.832%29&interval=10&api_key=yourapikey&email=youremail'},
{'year': 2019,
'interval': 10,
'link': 'https://developer.nrel.gov/api/nsrdb/v2/solar/himawari-download.csv?names=2019&wkt=POINT%2891.287+23.832%29&interval=10&api_key=yourapikey&email=youremail'},
{'year': 2020,
'interval': 10,
'link': 'https://developer.nrel.gov/api/nsrdb/v2/solar/himawari-download.csv?names=2020&wkt=POINT%2891.287+23.832%29&interval=10&api_key=yourapikey&email=youremail'},
{'year': 2016,
'interval': 30,
'link': 'https://developer.nrel.gov/api/nsrdb/v2/solar/himawari-download.csv?names=2016&wkt=POINT%2891.287+23.832%29&interval=30&api_key=yourapikey&email=youremail'},
{'year': 2017,
'interval': 30,
'link': 'https://developer.nrel.gov/api/nsrdb/v2/solar/himawari-download.csv?names=2017&wkt=POINT%2891.287+23.832%29&interval=30&api_key=yourapikey&email=youremail'},
{'year': 2018,
'interval': 30,
'link': 'https://developer.nrel.gov/api/nsrdb/v2/solar/himawari-download.csv?names=2018&wkt=POINT%2891.287+23.832%29&interval=30&api_key=yourapikey&email=youremail'},
{'year': 2019,
'interval': 30,
'link': 'https://developer.nrel.gov/api/nsrdb/v2/solar/himawari-download.csv?names=2019&wkt=POINT%2891.287+23.832%29&interval=30&api_key=yourapikey&email=youremail'},
{'year': 2020,
'interval': 30,
'link': 'https://developer.nrel.gov/api/nsrdb/v2/solar/himawari-download.csv?names=2020&wkt=POINT%2891.287+23.832%29&interval=30&api_key=yourapikey&email=youremail'},
{'year': 2016,
'interval': 60,
'link': 'https://developer.nrel.gov/api/nsrdb/v2/solar/himawari-download.csv?names=2016&wkt=POINT%2891.287+23.832%29&interval=60&api_key=yourapikey&email=youremail'},
{'year': 2017,
'interval': 60,
'link': 'https://developer.nrel.gov/api/nsrdb/v2/solar/himawari-download.csv?names=2017&wkt=POINT%2891.287+23.832%29&interval=60&api_key=yourapikey&email=youremail'},
{'year': 2018,
'interval': 60,
'link': 'https://developer.nrel.gov/api/nsrdb/v2/solar/himawari-download.csv?names=2018&wkt=POINT%2891.287+23.832%29&interval=60&api_key=yourapikey&email=youremail'},
{'year': 2019,
'interval': 60,
'link': 'https://developer.nrel.gov/api/nsrdb/v2/solar/himawari-download.csv?names=2019&wkt=POINT%2891.287+23.832%29&interval=60&api_key=yourapikey&email=youremail'},
{'year': 2020,
'interval': 60,
'link': 'https://developer.nrel.gov/api/nsrdb/v2/solar/himawari-download.csv?names=2020&wkt=POINT%2891.287+23.832%29&interval=60&api_key=yourapikey&email=youremail'}]},
{'apiDocs': 'https://developer.nrel.gov/docs/solar/nsrdb/himawari7-download/',
'availableIntervals': [30, 60],
'enabled': True,
'displayName': 'Himawari 7',
'metadataLink': 'https://nsrdb.nrel.gov',
'name': 'himawari7',
'ranking': 20,
'availableYears': [2011, 2012, 2013, 2014, 2015],
'apiUrl': 'https://developer.nrel.gov/api/nsrdb/v2/solar/himawari7-download',
'links': [{'year': 2011,
'interval': 30,
'link': 'https://developer.nrel.gov/api/nsrdb/v2/solar/himawari7-download.csv?names=2011&wkt=POINT%2891.287+23.832%29&interval=30&api_key=yourapikey&email=youremail'},
{'year': 2012,
'interval': 30,
'link': 'https://developer.nrel.gov/api/nsrdb/v2/solar/himawari7-download.csv?names=2012&wkt=POINT%2891.287+23.832%29&interval=30&api_key=yourapikey&email=youremail'},
{'year': 2013,
'interval': 30,
'link': 'https://developer.nrel.gov/api/nsrdb/v2/solar/himawari7-download.csv?names=2013&wkt=POINT%2891.287+23.832%29&interval=30&api_key=yourapikey&email=youremail'},
{'year': 2014,
'interval': 30,
'link': 'https://developer.nrel.gov/api/nsrdb/v2/solar/himawari7-download.csv?names=2014&wkt=POINT%2891.287+23.832%29&interval=30&api_key=yourapikey&email=youremail'},
{'year': 2015,
'interval': 30,
'link': 'https://developer.nrel.gov/api/nsrdb/v2/solar/himawari7-download.csv?names=2015&wkt=POINT%2891.287+23.832%29&interval=30&api_key=yourapikey&email=youremail'},
{'year': 2011,
'interval': 60,
'link': 'https://developer.nrel.gov/api/nsrdb/v2/solar/himawari7-download.csv?names=2011&wkt=POINT%2891.287+23.832%29&interval=60&api_key=yourapikey&email=youremail'},
{'year': 2012,
'interval': 60,
'link': 'https://developer.nrel.gov/api/nsrdb/v2/solar/himawari7-download.csv?names=2012&wkt=POINT%2891.287+23.832%29&interval=60&api_key=yourapikey&email=youremail'},
{'year': 2013,
'interval': 60,
'link': 'https://developer.nrel.gov/api/nsrdb/v2/solar/himawari7-download.csv?names=2013&wkt=POINT%2891.287+23.832%29&interval=60&api_key=yourapikey&email=youremail'},
{'year': 2014,
'interval': 60,
'link': 'https://developer.nrel.gov/api/nsrdb/v2/solar/himawari7-download.csv?names=2014&wkt=POINT%2891.287+23.832%29&interval=60&api_key=yourapikey&email=youremail'},
{'year': 2015,
'interval': 60,
'link': 'https://developer.nrel.gov/api/nsrdb/v2/solar/himawari7-download.csv?names=2015&wkt=POINT%2891.287+23.832%29&interval=60&api_key=yourapikey&email=youremail'}]},
{'apiDocs': 'https://developer.nrel.gov/docs/solar/nsrdb/msg-iodc/',
'availableIntervals': [15, 30, 60],
'enabled': True,
'displayName': 'MSG IODC: PSM v3',
'metadataLink': 'https://nsrdb.nrel.gov/current-version',
'name': 'msg-iodc',
'ranking': 20,
'availableYears': [2017, 2018, 2019],
'apiUrl': 'https://developer.nrel.gov/api/nsrdb/v2/solar/msg-iodc-download',
'links': [{'year': 2017,
'interval': 15,
'link': 'https://developer.nrel.gov/api/nsrdb/v2/solar/msg-iodc-download.csv?names=2017&wkt=POINT%2891.287+23.832%29&interval=15&api_key=yourapikey&email=youremail'},
{'year': 2018,
'interval': 15,
'link': 'https://developer.nrel.gov/api/nsrdb/v2/solar/msg-iodc-download.csv?names=2018&wkt=POINT%2891.287+23.832%29&interval=15&api_key=yourapikey&email=youremail'},
{'year': 2019,
'interval': 15,
'link': 'https://developer.nrel.gov/api/nsrdb/v2/solar/msg-iodc-download.csv?names=2019&wkt=POINT%2891.287+23.832%29&interval=15&api_key=yourapikey&email=youremail'},
{'year': 2017,
'interval': 30,
'link': 'https://developer.nrel.gov/api/nsrdb/v2/solar/msg-iodc-download.csv?names=2017&wkt=POINT%2891.287+23.832%29&interval=30&api_key=yourapikey&email=youremail'},
{'year': 2018,
'interval': 30,
'link': 'https://developer.nrel.gov/api/nsrdb/v2/solar/msg-iodc-download.csv?names=2018&wkt=POINT%2891.287+23.832%29&interval=30&api_key=yourapikey&email=youremail'},
{'year': 2019,
'interval': 30,
'link': 'https://developer.nrel.gov/api/nsrdb/v2/solar/msg-iodc-download.csv?names=2019&wkt=POINT%2891.287+23.832%29&interval=30&api_key=yourapikey&email=youremail'},
{'year': 2017,
'interval': 60,
'link': 'https://developer.nrel.gov/api/nsrdb/v2/solar/msg-iodc-download.csv?names=2017&wkt=POINT%2891.287+23.832%29&interval=60&api_key=yourapikey&email=youremail'},
{'year': 2018,
'interval': 60,
'link': 'https://developer.nrel.gov/api/nsrdb/v2/solar/msg-iodc-download.csv?names=2018&wkt=POINT%2891.287+23.832%29&interval=60&api_key=yourapikey&email=youremail'},
{'year': 2019,
'interval': 60,
'link': 'https://developer.nrel.gov/api/nsrdb/v2/solar/msg-iodc-download.csv?names=2019&wkt=POINT%2891.287+23.832%29&interval=60&api_key=yourapikey&email=youremail'}]},
{'apiDocs': 'https://developer.nrel.gov/docs/solar/nsrdb/spectral-tmy-india-download/',
'availableIntervals': [60],
'enabled': True,
'displayName': 'SUNY International Spectral',
'metadataLink': 'https://nsrdb.nrel.gov',
'name': 'spectral-india-tmy',
'ranking': 40,
'availableYears': ['tmy'],
'apiUrl': 'https://developer.nrel.gov/api/nsrdb/v2/solar/spectral-india-tmy-download',
'links': [{'year': 'tmy',
'interval': 60,
'link': 'https://developer.nrel.gov/api/nsrdb/v2/solar/spectral-india-tmy-download.csv?names=tmy&wkt=POINT%2891.287+23.832%29&interval=60&api_key=yourapikey&email=youremail'}]},
{'apiDocs': 'https://developer.nrel.gov/docs/solar/nsrdb/suny-india-data-download/',
'availableIntervals': [60],
'enabled': True,
'displayName': 'SUNY International',
'metadataLink': 'https://nsrdb.nrel.gov',
'name': 'suny-india',
'ranking': 20,
'availableYears': [2000,
2001,
2002,
2003,
2004,
2005,
2006,
2007,
2008,
2009,
2010,
2011,
2012,
2013,
2014],
'apiUrl': 'https://developer.nrel.gov/api/nsrdb/v2/solar/suny-india-download',
'links': [{'year': 2000,
'interval': 60,
'link': 'https://developer.nrel.gov/api/nsrdb/v2/solar/suny-india-download.csv?names=2000&wkt=POINT%2891.287+23.832%29&interval=60&api_key=yourapikey&email=youremail'},
{'year': 2001,
'interval': 60,
'link': 'https://developer.nrel.gov/api/nsrdb/v2/solar/suny-india-download.csv?names=2001&wkt=POINT%2891.287+23.832%29&interval=60&api_key=yourapikey&email=youremail'},
{'year': 2002,
'interval': 60,
'link': 'https://developer.nrel.gov/api/nsrdb/v2/solar/suny-india-download.csv?names=2002&wkt=POINT%2891.287+23.832%29&interval=60&api_key=yourapikey&email=youremail'},
{'year': 2003,
'interval': 60,
'link': 'https://developer.nrel.gov/api/nsrdb/v2/solar/suny-india-download.csv?names=2003&wkt=POINT%2891.287+23.832%29&interval=60&api_key=yourapikey&email=youremail'},
{'year': 2004,
'interval': 60,
'link': 'https://developer.nrel.gov/api/nsrdb/v2/solar/suny-india-download.csv?names=2004&wkt=POINT%2891.287+23.832%29&interval=60&api_key=yourapikey&email=youremail'},
{'year': 2005,
'interval': 60,
'link': 'https://developer.nrel.gov/api/nsrdb/v2/solar/suny-india-download.csv?names=2005&wkt=POINT%2891.287+23.832%29&interval=60&api_key=yourapikey&email=youremail'},
{'year': 2006,
'interval': 60,
'link': 'https://developer.nrel.gov/api/nsrdb/v2/solar/suny-india-download.csv?names=2006&wkt=POINT%2891.287+23.832%29&interval=60&api_key=yourapikey&email=youremail'},
{'year': 2007,
'interval': 60,
'link': 'https://developer.nrel.gov/api/nsrdb/v2/solar/suny-india-download.csv?names=2007&wkt=POINT%2891.287+23.832%29&interval=60&api_key=yourapikey&email=youremail'},
{'year': 2008,
'interval': 60,
'link': 'https://developer.nrel.gov/api/nsrdb/v2/solar/suny-india-download.csv?names=2008&wkt=POINT%2891.287+23.832%29&interval=60&api_key=yourapikey&email=youremail'},
{'year': 2009,
'interval': 60,
'link': 'https://developer.nrel.gov/api/nsrdb/v2/solar/suny-india-download.csv?names=2009&wkt=POINT%2891.287+23.832%29&interval=60&api_key=yourapikey&email=youremail'},
{'year': 2010,
'interval': 60,
'link': 'https://developer.nrel.gov/api/nsrdb/v2/solar/suny-india-download.csv?names=2010&wkt=POINT%2891.287+23.832%29&interval=60&api_key=yourapikey&email=youremail'},
{'year': 2011,
'interval': 60,
'link': 'https://developer.nrel.gov/api/nsrdb/v2/solar/suny-india-download.csv?names=2011&wkt=POINT%2891.287+23.832%29&interval=60&api_key=yourapikey&email=youremail'},
{'year': 2012,
'interval': 60,
'link': 'https://developer.nrel.gov/api/nsrdb/v2/solar/suny-india-download.csv?names=2012&wkt=POINT%2891.287+23.832%29&interval=60&api_key=yourapikey&email=youremail'},
{'year': 2013,
'interval': 60,
'link': 'https://developer.nrel.gov/api/nsrdb/v2/solar/suny-india-download.csv?names=2013&wkt=POINT%2891.287+23.832%29&interval=60&api_key=yourapikey&email=youremail'},
{'year': 2014,
'interval': 60,
'link': 'https://developer.nrel.gov/api/nsrdb/v2/solar/suny-india-download.csv?names=2014&wkt=POINT%2891.287+23.832%29&interval=60&api_key=yourapikey&email=youremail'}]},
{'apiDocs': 'https://developer.nrel.gov/docs/solar/nsrdb/suny-india-tmy-data-download/',
'availableIntervals': [60],
'enabled': True,
'displayName': 'SUNY International TMY',
'metadataLink': 'https://nsrdb.nrel.gov',
'name': 'suny-india-tmy',
'ranking': 20,
'availableYears': ['tmy'],
'apiUrl': 'https://developer.nrel.gov/api/nsrdb/v2/solar/suny-india-tmy-download',
'links': [{'year': 'tmy',
'interval': 60,
'link': 'https://developer.nrel.gov/api/nsrdb/v2/solar/suny-india-tmy-download.csv?names=tmy&wkt=POINT%2891.287+23.832%29&interval=60&api_key=yourapikey&email=youremail'}]}]
Data Downloader¶
Download solar irradiance and meteorological data for a location.
Let’s get all the available links for the year 2016.
[4]:
links = get_nsrdb_download_links(year=2016, lat=47.6, lon=-122.3)
links
[4]:
['https://developer.nrel.gov/api/nsrdb/v2/solar/psm3-download.csv?names=2016&wkt=POINT%28-122.3+47.6%29&interval=30&api_key=yourapikey&email=youremail',
'https://developer.nrel.gov/api/nsrdb/v2/solar/psm3-download.csv?names=2016&wkt=POINT%28-122.3+47.6%29&interval=60&api_key=yourapikey&email=youremail']
Once we have the available links, we can download the data of interest.
Here, we will download from the first link.
[5]:
df = download_nsrdb_data(links[0], email=os.environ["EMAIL"])
[6]:
df.columns
[6]:
Index(['Year', 'Month', 'Day', 'Hour', 'Minute', 'Temperature', 'Clearsky DHI',
'Clearsky DNI', 'Clearsky GHI', 'Cloud Type', 'Dew Point', 'DHI', 'DNI',
'Fill Flag', 'GHI', 'Relative Humidity', 'Solar Zenith Angle',
'Surface Albedo', 'Pressure', 'Precipitable Water', 'Wind Direction',
'Wind Speed', 'Global Horizontal UV Irradiance (280-400nm)',
'Global Horizontal UV Irradiance (295-385nm)'],
dtype='object')
[7]:
df[["Temperature", "GHI", "Pressure", "Wind Speed", "Precipitable Water"]]
[7]:
| Temperature | GHI | Pressure | Wind Speed | Precipitable Water | |
|---|---|---|---|---|---|
| 2016-01-01 00:00:00 | -1 | 36 | 1010 | 0.9 | 0.430 |
| 2016-01-01 00:30:00 | -1 | 0 | 1010 | 0.8 | 0.423 |
| 2016-01-01 01:00:00 | -1 | 0 | 1010 | 0.8 | 0.416 |
| 2016-01-01 01:30:00 | -1 | 0 | 1010 | 0.7 | 0.411 |
| 2016-01-01 02:00:00 | -2 | 0 | 1010 | 0.7 | 0.406 |
| ... | ... | ... | ... | ... | ... |
| 2016-12-31 21:30:00 | 1 | 272 | 990 | 1.2 | 1.062 |
| 2016-12-31 22:00:00 | 1 | 237 | 990 | 1.3 | 1.090 |
| 2016-12-31 22:30:00 | 1 | 192 | 990 | 1.3 | 1.082 |
| 2016-12-31 23:00:00 | 1 | 140 | 990 | 1.3 | 1.075 |
| 2016-12-31 23:30:00 | 1 | 84 | 990 | 1.3 | 1.075 |
17568 rows × 5 columns
The index in the
DataFramereturned automatically accounts for the leap years.
[8]:
feb = df.loc["2016-02"][["Year", "Month", "Day", "Minute"]]
feb.tail()
[8]:
| Year | Month | Day | Minute | |
|---|---|---|---|---|
| 2016-02-29 21:30:00 | 2016 | 2 | 29 | 30 |
| 2016-02-29 22:00:00 | 2016 | 2 | 29 | 0 |
| 2016-02-29 22:30:00 | 2016 | 2 | 29 | 30 |
| 2016-02-29 23:00:00 | 2016 | 2 | 29 | 0 |
| 2016-02-29 23:30:00 | 2016 | 2 | 29 | 30 |