dazhiyang/bsrn-crs

<!-- This file is uploaded as the Hugging Face dataset README; keep content user-facing (no internal maintainer or upload-only notes). -->

BSRN CAMS Radiation Service (CRS) All-sky Data

All-sky solar radiation data for Baseline Surface Radiation Network (BSRN) stations. These parquet files provide satellite-derived irradiance from the CAMS Radiation Service (CRS) [1].

Dataset Description

Each file contains 1-minute all-sky irradiance variables at a single BSRN station location. Data are retrieved from the SoDa CRS API via the bsrn Python package.

File Structure

Station folders use the lowercase BSRN three-letter code (e.g. qiq, abs, asp, brb).

{station}/
  {station}{MM}{YY}_crs.parquet   # One file per month

Examples:

• —qiq/qiq0124_crs.parquet — QIQ, January 2024
• —abs/abs0321_crs.parquet — ABS, March 2021

Variables

• —Index: UTC DatetimeIndex (1-minute resolution, start-of-interval labeled).
• —Time coverage: Variable by station; Himawari coverage starts 2016-01-01, MSG coverage starts 2004-01-01.

Usage

Load from Hugging Face

from huggingface_hub import hf_hub_download
import pandas as pd

# Download a single file; path is {station}/{station}{MM}{YY}_crs.parquet
path = hf_hub_download(
    repo_id="dazhiyang/bsrn-crs",
    filename="qiq/qiq0124_crs.parquet",
    repo_type="dataset",
)
df = pd.read_parquet(path)
# df has DatetimeIndex (UTC) and columns: ghi_crs, bni_crs, dhi_crs

Use with bsrn package

The bsrn package can fetch CRS data automatically during QC and modeling workflows.

from bsrn.io.crs import fetch_crs

# Fetch aligned CRS data for a target index
# station_code = "QIQ"
crs_df = fetch_crs(target_index, station_code="QIQ")

Data Sources

• —CAMS Radiation Service: SoDa-Pro
• —Station inventory: BSRN FTP

References

1. 1.Qu, Z., Oumbe, A., Blanc, P., Espinar, B., Gschwind, B., Wald, L., ... & Schroedter-Homscheidt, M. (2017). Fast clear-sky irradiance model for CAMS radiation service. Solar Energy, 158, 286-305.

1. 1.Gschwind, B., Wald, L., Blanc, P., Lefèvre, M., Schroedter-Homscheidt, M., & Arola, A. (2019). Improving the McClear model estimating the downwelling solar radiation at ground level in cloud-free conditions – McClear-v3. Meteorologische Zeitschrift, 28(2).

License

This dataset mirrors publicly available CAMS Radiation Service data. Access via SoDa-Pro is subject to CAMS License.