Add an example or documentation on using 'bhi' from ERA5

Open Beginner friendly
#2,880 2 comments 0 reactions 0 assignees View on GitHub

Maintainers usually reply within 1 day

@anshurajbisoyi98-ctrl is already working on this.

Since Oct 4, 2026.

Assessment

Difficulty
2/5
Estimated time
1-3 hours
Newbie friendliness
66/100
Issue type
Documentation
Clarity
Mostly clear
Activity status
Active
Tech stack
python
Domain
documentation

Research direction

Start by reading the get_era5 docstring and existing gallery examples for ERA5 data. Clarify that bhi is direct irradiance through a horizontal surface and explain whether and how users should convert it to DNI; the issue allows either a docstring update or a gallery example. Done when the documentation makes the parameter’s meaning and conversion need clear to users.

Written by the indexing model from the issue text.

Description

Is your feature request related to a problem? Please describe.
The bhi parameter from ERA5 (total_sky_direct_solar_radiation_at_surface, https://codes.ecmwf.int/grib/param-db/228021) is direct irradiance through a horizontal surface. This is not very common in PV, and users may not know how to convert it to DNI, or that it needs to be converted.

Describe the solution you'd like
Either some more details in the get_era5 docstring, or a gallery example.

Dominant language
Python
Stars
1.7k
Forks
1.2k
Avg merge
3d 4h
Merged PRs (30d)
8

Getting set up

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from pvlib/pvlib-python

All issues in pvlib/pvlib-python

Similar issues

More Python issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.