bsrn.io.nsrdb.add_nsrdb_columns#

bsrn.io.nsrdb.add_nsrdb_columns(df, station_code=None, lat=None, lon=None, elev=None, variant='conus')[source]#

Adds NSRDB all-sky columns to a DataFrame. Fetches data from Hugging Face automatically.

Location can be given by BSRN station code or by explicit lat/lon/elev.

Parameters:

  • df (pd.DataFrame) – DataFrame to which columns will be added. Index must be DatetimeIndex.

  • station_code (str, optional) – BSRN station abbreviation. [e.g. ‘BIL’] Used if lat/lon/elev not provided.

  • lat (float, optional) – Latitude. [degrees] Required for non-BSRN stations if station_code omitted.

  • lon (float, optional) – Longitude. [degrees] Required for non-BSRN stations if station_code omitted.

  • elev (float, optional) – Elevation. [m] Required for non-BSRN stations if station_code omitted.

  • variant (str, default "conus") – NSRDB variant name: ‘conus’, ‘full-disc’, or ‘aggregated’.

Returns:

df – The input DataFrame with added NSRDB columns.

Return type:

pd.DataFrame

Raises: