solarforecastarbiter.io.fetch.bsrn.parse_bsrn

solarforecastarbiter.io.fetch.bsrn.parse_bsrn(fbuf)[source]

Parse a buffered BSRN station-to-archive file into a DataFrame.

The BSRN (Baseline Surface Radiation Network) is a world wide network of high-quality solar radiation monitoring stations as described in [1]. The function only parses the basic measurements (LR0100), which include global, diffuse, direct and downwelling long-wave radiation [2]. Future updates may include parsing of additional data and meta-data.

BSRN files are freely available and can be accessed via FTP [3]. Required

username and password are easily obtainable as described in the BSRN’s Data Release Guidelines [4].

Parameters:fbuf (io.StringIO) – A buffer containing the data to be parsed.
Returns:data (DataFrame) – A DataFrame with the columns as described below. For more extensive description of the variables, consult [2].

Notes

The data DataFrame includes the following fields:

Key Format Description
day int Day of the month 1-31
minute int Minute of the day 0-1439
ghi float Mean global horizontal irradiance [W/m^2]
ghi_std float Std. global horizontal irradiance [W/m^2]
ghi_min float Min. global horizontal irradiance [W/m^2]
ghi_max float Max. global horizontal irradiance [W/m^2]
dni float Mean direct normal irradiance [W/m^2]
dni_std float Std. direct normal irradiance [W/m^2]
dni_min float Min. direct normal irradiance [W/m^2]
dni_max float Max. direct normal irradiance [W/m^2]
dhi float Mean diffuse horizontal irradiance [W/m^2]
dhi_std float Std. diffuse horizontal irradiance [W/m^2]
dhi_min float Min. diffuse horizontal irradiance [W/m^2]
dhi_max float Max. diffuse horizontal irradiance [W/m^2]
lwd float Mean. downward long-wave radiation [W/m^2]
lwd_std float Std. downward long-wave radiation [W/m^2]
lwd_min float Min. downward long-wave radiation [W/m^2]
lwd_max float Max. downward long-wave radiation [W/m^2]
temp_air float Air temperature [°C]
relative_humidity float Relative humidity [%]
pressure float Atmospheric pressure [hPa]

References

[1]World Radiation Monitoring Center - Baseline Surface Radiation Network (BSRN)
[2](1, 2) Update of the Technical Plan for BSRN Data Management, 2013, Global Climate Observing System (GCOS) GCOS-172.
[3]BSRN Data Retrieval via FTP
[4]BSRN Data Release Guidelines