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

Activity

1. anshurajbisoyi98-ctrl commented on Oct 4, 2026

   

   anshurajbisoyi98-ctrl

   on Oct 4, 2026

   More actions

   Hi, I’d like to contribute to this issue. I propose starting with a focused update to the get_era5 docstring explaining BHI versus DNI and how to convert between them, including the relevant limitations. Would you prefer this approach or a gallery example?
2. williamhobbs commented on Oct 7, 2026

   

   williamhobbs

   on Oct 7, 2026

   ContributorAuthor

   More actions

   @anshurajbisoyi98-ctrl, my personal opinion is that the priority should be:

   1. A short docstring description of BHI, e.g., something like the ECMWF description: "[The returned parameter bhi is the amount of radiation passing through a horizontal plane, not a plane perpendicular to the direction of the Sun [(dni)]"
   2. A more detailed update to the docstring (maybe a table, like read_bsrn and get_merra2?)
   3. An even more detailed update to the docstring with some suggestion about how to use solar position to convert from BHI to DNI
   4. A gallery example

   No need for a gallery example until at least one or two of the higher priority items are added. And maybe no need for a gallery example at all.

   But I'll defer to maintainers on what, if anything, should be pursued.

   👍React with 👍1Reacted by Rajiv Daxini