bsrn.io.nsrdb.download_nsrdb

bsrn.io.nsrdb.download_nsrdb(latitude, longitude, year, api_key, email, variant='conus', timeout=120)

Download NSRDB data from NLR API.

Parameters:

• latitude (float) – Site latitude [degrees].

• longitude (float) – Site longitude [degrees].

• year (int) – Calendar year to download.

• api_key (str) – NLR developer API key.

• email (str) – User email registered with the API.

• variant (str, default "conus") – NSRDB variant name (see NSRDB_VARIANTS).

• timeout (int, default 120) – HTTP request timeout [s].

Returns:

df – NSRDB irradiance columns for the requested year.

Return type:

pd.DataFrame

Raises:

• ValueError – If year is outside the variant’s year range.

• ValueError – If the location is not within the variant’s spatial coverage.

References

[1]

Sengupta, M., Xie, Y., Lopez, A., Habte, A., Maclaurin, G., & Shelby, J. (2018). The national solar radiation data base (NSRDB). Renewable and Sustainable Energy Reviews, 89, 51-60.

[2]

Xie, Y., Yang, J., Sengupta, M., Liu, Y., & Zhou, X. (2022). Improving the prediction of DNI with physics-based representation of all-sky circumsolar radiation. Solar Energy, 231, 758-766.

[3]

Xie, Y., Sengupta, M., Yang, J., Buster, G., Benton, B., Habte, A., & Liu, Y. (2023). Integration of a physics-based direct normal irradiance (DNI) model to enhance the National Solar Radiation Database (NSRDB). Solar energy, 266, 112195.

[4]

Xie, Y., Sengupta, M., & Dudhia, J. (2016). A Fast All-sky Radiation Model for Solar applications (FARMS): Algorithm and performance evaluation. Solar Energy, 135, 435-445.