Skip to content
Merged
Show file tree
Hide file tree
Changes from 8 commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
3 changes: 3 additions & 0 deletions docs/sphinx/source/user_guide/extras/nomenclature.rst
Original file line number Diff line number Diff line change
Expand Up @@ -106,6 +106,9 @@ There is a convention on consistent variable names throughout the library:
gri
Ground-reflected irradiance

iam
Incidence angle modifier

i_sc
Short circuit module current

Expand Down
4 changes: 2 additions & 2 deletions docs/sphinx/source/user_guide/modeling_topics/iam.rst
Original file line number Diff line number Diff line change
Expand Up @@ -15,7 +15,7 @@ the reduction at normal incidence is implicit in the PV module's power rating
and does not need to be accounted for separately in a performance model.
Therefore, only the extra reduction at non-normal incidence should be modeled.

This is done using incidence angle modififer (:term:`IAM`) models.
This is done using incidence angle modififer (:term:`IAM <iam>`) models.
Conceptually, IAM is the fraction of incident light that is
transmitted to the PV cell, normalized to the fraction transmitted at normal incidence:

Expand Down Expand Up @@ -74,7 +74,7 @@ following table:
+-------------------------------------------+---------+-------------------------------------------+
| :py:func:`~pvlib.iam.schlick` | direct | Does not take module-specific parameters |
+-------------------------------------------+---------+-------------------------------------------+
| :py:func:`~pvlib.iam.schlick_diffuse` | diffuse | Does not take module-specific parmaeters |
| :py:func:`~pvlib.iam.schlick_diffuse` | diffuse | Does not take module-specific parameters |
+-------------------------------------------+---------+-------------------------------------------+

In addition to the core models above, pvlib provides several other functions
Expand Down
57 changes: 22 additions & 35 deletions docs/sphinx/source/whatsnew/v0.15.1.rst
Original file line number Diff line number Diff line change
@@ -1,15 +1,8 @@
.. _whatsnew_0_15_1:


v0.15.1 (Anticipated March 2026)
--------------------------------

Breaking Changes
~~~~~~~~~~~~~~~~


Deprecations
~~~~~~~~~~~~
v0.15.1 (April 20, 2026)
------------------------


Bug fixes
Expand All @@ -22,44 +15,41 @@ Bug fixes
(:issue:`2645`, :pull:`2646`)
* Update URLs in :py:mod:`pvlib.iotools.psm4` to use nlr.gov instead of
nrel.gov. (:issue:`2701`, :pull:`2705`)
* Fix a bug in :py:func:`pvlib.iotools.era5._m_to_cm` where meters were
incorrectly divided by 100 instead of multiplied, causing precipitations to be
underestimated by a factor of 10,000 when ``map_variables=True``.
* Fix a bug in :py:func:`pvlib.iotools.get_era5` where conversion of
precipitation in meters to ``cm`` was underestimated by a factor of 10,000 when ``map_variables=True``.
(:issue:`2724`, :pull:`2725`)


Enhancements
~~~~~~~~~~~~
* Use ``k`` and ``cap_adjustment`` from :py:func:`pvlib.pvsystem.Array.module_parameters`
* Use ``k`` and ``cap_adjustment`` from :py:attr:`pvlib.pvsystem.Array.module_parameters`
in :py:func:`pvlib.pvsystem.PVSystem.pvwatts_dc`
(:issue:`2714`, :pull:`2715`)
* Include `ross` and `faiman_rad` in the allowed models within
* Include ``ross`` and ``faiman_rad`` in the allowed models within
:py:meth:`pvlib.pvsystem.PVSystem.get_cell_temperature` (:issue:`2625`, :pull:`2631`)
* Accelerate the internals of :py:func:`~pvlib.solarpostion.ephemeris`. (:pull:`2626`)
* Accelerate the intervals of :py:func:`~pvlib.pvsystem.singlediode` when
`method='lambertw'`. (:pull:`2732`, :pull:`2723`)
* :py:func:`~pvlib.tracking.singleaxis` accepts negative values for
parameter `axis_tilt`. (:pull:`2702`, :issue:`1976`)
* Accelerate the internals of :py:func:`~pvlib.solarposition.ephemeris`. (:pull:`2626`)
* Accelerate the internals of :py:func:`~pvlib.pvsystem.singlediode` when
``method='lambertw'``. (:pull:`2732`, :pull:`2723`)
* Accept negative ``axis_tilt`` values in :py:func:`~pvlib.tracking.singleaxis`. (:pull:`2702`, :issue:`1976`)


Documentation
~~~~~~~~~~~~~
* Add examples for run_model_from_poa() and run_model_from_effective_irradiance()
* Add examples for :py:meth:`pvlib.modelchain.ModelChain.run_model_from_poa` and :py:meth:`~pvlib.modelchain.ModelChain.run_model_from_effective_irradiance`
(:issue:`1043`, :pull:`2621`)
* Add the following terms to the :ref:`nomenclature` page
(:issue:`2564`, :pull:`2663`):

- :term:`clearness_index`
- :term:`clearsky_index`
- :term:`aod`
- :term:`aod500`
- :term:`clearness_index`
- :term:`clearsky_index`
- :term:`aod`
Comment thread
kandersolar marked this conversation as resolved.
- :term:`aod500`

* Provide an overview of IAM modeling functionality in :ref:`iam`. (:pull:`2683`)
* Add an overview of IAM modeling functionality in new documentation page :ref:`iam`. (:pull:`2683`)
* Add AI checkbox to PR template, and auto-generate a comment on PRs
from first-time contributors regarding AI and contributing guidelines.
(:issue:`2617`, :pull:`2624`)
* Update :py:class:`pvlib.pvsystem.PVSystem` docstring to state that
``module_type`` is optional.
* Clarify :py:class:`pvlib.pvsystem.PVSystem` parameter ``module_type`` is optional.
(:issue:`2634`, :pull:`2713`)
* Fix a broken docstring reference to ``grounddiffuse`` in
:py:func:`pvlib.irradiance.poa_components`
Expand All @@ -74,13 +64,6 @@ Testing
produces consistent results for vectorized and scalar inputs.
(:issue:`2649`, :pull:`2661`)

Benchmarking
~~~~~~~~~~~~


Requirements
~~~~~~~~~~~~


Maintenance
~~~~~~~~~~~
Expand All @@ -104,4 +87,8 @@ Contributors
* Jean-Baptiste Pasquier (:ghuser:`pasquierjb`)
* Rodrigo Amaro e Silva (:ghuser:`ramaroesilva`)
* James Fulton (:ghuser:`dfulu`)

* Will Holmgren (:ghuser:`wholmgren`)
* Mark Campanelli (:ghuser:`markcampanelli`)
* Chirag Sharma (:ghuser:`Chirag3841`)
* Will Hobbs (:ghuser:`williamhobbs`)
* Adam R. Jensen (:ghuser:`adamrjensen`)
2 changes: 1 addition & 1 deletion pvlib/tracking.py
Original file line number Diff line number Diff line change
Expand Up @@ -45,7 +45,7 @@ def singleaxis(apparent_zenith, solar_azimuth,
The tilt of the axis of rotation (i.e, the y-axis defined by
``axis_azimuth``) with respect to horizontal (degrees). Positive
``axis_tilt`` is *downward* in the direction of ``axis_azimuth``. For
example, for a tracker with ``axis_azimuth``=180 and ``axis_tilt``=10,
example, for a tracker with ``axis_azimuth=180`` and ``axis_tilt=10``,
the north end is higher than the south end of the axis.

axis_azimuth : float, default 0
Expand Down
Loading