dazhiyang/bsrn-crs

---
language: en
license: mit
configs:
- config_name: abs
data_files:
- split: abs
path: abs/*.parquet
- config_name: asp
data_files:
- split: asp
path: asp/*.parquet
- config_name: brb
data_files:
- split: brb
path: brb/*.parquet
- config_name: bud
data_files:
- split: bud
path: bud/*.parquet
- config_name: cab
data_files:
- split: cab
path: cab/*.parquet
- config_name: cam
data_files:
- split: cam
path: cam/*.parquet
- config_name: car
data_files:
- split: car
path: car/*.parquet
- config_name: cnr
data_files:
- split: cnr
path: cnr/*.parquet
- config_name: coc
data_files:
- split: coc
path: coc/*.parquet
- config_name: daa
data_files:
- split: daa
path: daa/*.parquet
- config_name: dwn
data_files:
- split: dwn
path: dwn/*.parquet
- config_name: ena
data_files:
- split: ena
path: ena/*.parquet
- config_name: flo
data_files:
- split: flo
path: flo/*.parquet
- config_name: fua
data_files:
- split: fua
path: fua/*.parquet
- config_name: gob
data_files:
- split: gob
path: gob/*.parquet
- config_name: how
data_files:
- split: how
path: how/*.parquet
- config_name: ilo
data_files:
- split: ilo
path: ilo/*.parquet
- config_name: ino
data_files:
- split: ino
path: ino/*.parquet
- config_name: ish
data_files:
- split: ish
path: ish/*.parquet
- config_name: iza
data_files:
- split: iza
path: iza/*.parquet
- config_name: kwa
data_files:
- split: kwa
path: kwa/*.parquet
- config_name: lau
data_files:
- split: lau
path: lau/*.parquet
- config_name: lin
data_files:
- split: lin
path: lin/*.parquet
- config_name: lmp
data_files:
- split: lmp
path: lmp/*.parquet
- config_name: mnm
data_files:
- split: mnm
path: mnm/*.parquet
- config_name: pal
data_files:
- split: pal
path: pal/*.parquet
- config_name: par
data_files:
- split: par
path: par/*.parquet
- config_name: pay
data_files:
- split: pay
path: pay/*.parquet
- config_name: ptr
data_files:
- split: ptr
path: ptr/*.parquet
- config_name: qiq
data_files:
- split: qiq
path: qiq/*.parquet
- config_name: run
data_files:
- split: run
path: run/*.parquet
- config_name: sap
data_files:
- split: sap
path: sap/*.parquet
- config_name: sbo
data_files:
- split: sbo
path: sbo/*.parquet
- config_name: sms
data_files:
- split: sms
path: sms/*.parquet
- config_name: son
data_files:
- split: son
path: son/*.parquet
- config_name: tam
data_files:
- split: tam
path: tam/*.parquet
- config_name: tat
data_files:
- split: tat
path: tat/*.parquet
- config_name: yus
data_files:
- split: yus
path: yus/*.parquet
tags:
- solar
- radiation
- bsrn
pretty_name: BSRN CAMS CRS All-sky Data
---

<!-- 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)](https://bsrn.awi.de/) 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

| Column | Description | Source | Units (raw) |
|-----------|---------------------------------------|---------------|-------------|
| ghi_crs | All-sky global horizontal irradiance | CAMS CRS | W/m² |
| bni_crs | All-sky beam normal irradiance | CAMS CRS | W/m² |
| dhi_crs | All-sky diffuse horizontal irradiance | CAMS CRS | W/m² |

- **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

```python
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.

```python
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](https://www.soda-pro.com/web-services/radiation/cams-radiation-service)
- **Station inventory**: BSRN FTP

## References

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.

2. 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](https://ads.atmosphere.copernicus.eu/terms/).