Skip to content

Add support for return_components to irradiance.isotropic#2787

Open
cbcrespo wants to merge 3 commits into
pvlib:mainfrom
cbcrespo:isotropic_components
Open

Add support for return_components to irradiance.isotropic#2787
cbcrespo wants to merge 3 commits into
pvlib:mainfrom
cbcrespo:isotropic_components

Conversation

@cbcrespo

@cbcrespo cbcrespo commented Jun 18, 2026

Copy link
Copy Markdown
Contributor
  • Closes #xxxx
  • I am familiar with the contributing guidelines
  • I attest that all AI-generated material has been vetted for accuracy and is in compliance with the pvlib license
  • 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.

This PR is part of my GSoC 2026 project. One of the goals is to add support for return_components to all diffuse transposition models in pvlib, which currently is supported by some models (e.g. perez) but not others. This parameter allows the user to choose whether they want only the total diffuse irradiance (default), or are interested in the split between different diffuse components (sky diffuse, circumsolar, horizon brightening).

This has been implemented for irradiance.reindl in #2775.

For irradiance.isotropic specifically, return_components=True does not return additional information, but has been added in order to be consistent with other diffuse transposition models.

The docstrings have been changed accordingly, and a new test was added.

@kandersolar kandersolar added this to the v0.15.3 milestone Jun 18, 2026
@AdamRJensen AdamRJensen added the GSoC Contributions related to Google Summer of Code. label Jun 19, 2026

@AdamRJensen AdamRJensen left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

LGTM

@AdamRJensen

Copy link
Copy Markdown
Member

Misssing a whatsnew entry fyi

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

Labels

enhancement GSoC Contributions related to Google Summer of Code.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants