Skip to content

Conversation

@kandersolar
Copy link
Member

@kandersolar kandersolar commented Feb 5, 2026

  • [ ] Closes #xxxx
  • I am familiar with the contributing guidelines
  • [ ] Tests added
  • [ ] Updates entries in docs/sphinx/source/reference for API changes.
  • Adds description and name entries in the appropriate "what's new" file in docs/sphinx/source/whatsnew for all changes. Includes link to the GitHub Issue with :issue:`num` or this Pull Request with :pull:`num`. Includes contributor name and/or GitHub username (link with :ghuser:`user`).
  • [ ] New code is fully documented. Includes numpydoc compliant docstrings, examples, and comments where necessary.
  • Pull request is nearly complete and ready for detailed review.
  • Maintainer: Appropriate GitHub Labels (including remote-data) and Milestone are assigned to the Pull Request and linked Issue.

Continuing in a broader thrust of developing our user guide section. Previously:

See also:

Docs build: https://pvlib-python--2683.org.readthedocs.build/en/2683/user_guide/modeling_topics/iam.html

@kandersolar kandersolar added this to the v0.15.1 milestone Feb 5, 2026
Copy link
Member

@RDaxini RDaxini left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Nice job @kandersolar , this is great. Thank you for putting this together! I left some comments on a few relatively minor things, but besides those few points this LGTM

@echedey-ls
Copy link
Member

I'm glad to see pvlib incorporating these guides. I'm sure it will be very useful at many knowledge stages.

My two cents are:

  • Maybe include at some point, even inside parentheses, a reference to circumsolar radiation usually being applied the direct IAM modifier.
  • Note that IAM is also dependent on the wavelength, but characterization simplifies that since spectral performance modelling is infrequent and it's easier to characterize.

Thanks @kandersolar for hauling this initiative.

@kandersolar
Copy link
Member Author

Note that IAM is also dependent on the wavelength, but characterization simplifies that since spectral performance modelling is infrequent and it's easier to characterize.

Good point. Reminder to add other missing aspects of these IAM models too:

  • Polarization
  • The light's "azimuth" angle, in the module's reference frame

Copy link
Member

@adriesse adriesse left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Good initiative!!

kandersolar and others added 4 commits February 10, 2026 09:26
Co-authored-by: Echedey Luis <80125792+echedey-ls@users.noreply.github.com>
Co-authored-by: Cliff Hansen <cwhanse@sandia.gov>
Co-authored-by: Rajiv Daxini <143435106+RDaxini@users.noreply.github.com>
Co-authored-by: Anton Driesse <anton.driesse@pvperformancelabs.com>
Co-authored-by: Anton Driesse <anton.driesse@pvperformancelabs.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants