Skip to content

DOC: clarify hsu soiling ratio minimum value in docstring#2743

Open
Omesh37 wants to merge 2 commits intopvlib:mainfrom
Omesh37:doc/hsu-soiling-ratio-minimum-value
Open

DOC: clarify hsu soiling ratio minimum value in docstring#2743
Omesh37 wants to merge 2 commits intopvlib:mainfrom
Omesh37:doc/hsu-soiling-ratio-minimum-value

Conversation

@Omesh37
Copy link
Copy Markdown

@Omesh37 Omesh37 commented Apr 26, 2026

Closes #2534

Summary

Improved the pvlib.soiling.hsu docstring to clarify that the model
has an implicit minimum soiling ratio of ~0.6563, due to the
mathematical limit of the error function in the model equation:

SR = 1 - 0.3437 * erf(0.17 * ω^0.8473)

As erf → 1.0 at large inputs, SR cannot drop below 1 - 0.3437 = 0.6563.

Changes

  • Updated Returns docstring in pvlib/soiling.py
  • Updated function summary paragraph
  • Added whatsnew entry under v0.15.2

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Possible improvement to pvlib.soiling.hsu documentation

1 participant