diff --git a/docs/sphinx/source/user_guide/extras/nomenclature.rst b/docs/sphinx/source/user_guide/extras/nomenclature.rst index 2bfab1aea3..9507680e7e 100644 --- a/docs/sphinx/source/user_guide/extras/nomenclature.rst +++ b/docs/sphinx/source/user_guide/extras/nomenclature.rst @@ -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 diff --git a/docs/sphinx/source/user_guide/modeling_topics/iam.rst b/docs/sphinx/source/user_guide/modeling_topics/iam.rst index ecd591133e..3097164604 100644 --- a/docs/sphinx/source/user_guide/modeling_topics/iam.rst +++ b/docs/sphinx/source/user_guide/modeling_topics/iam.rst @@ -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 `) models. Conceptually, IAM is the fraction of incident light that is transmitted to the PV cell, normalized to the fraction transmitted at normal incidence: @@ -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 diff --git a/docs/sphinx/source/whatsnew/v0.15.0.rst b/docs/sphinx/source/whatsnew/v0.15.0.rst index 26da6bd210..856aa32bf1 100644 --- a/docs/sphinx/source/whatsnew/v0.15.0.rst +++ b/docs/sphinx/source/whatsnew/v0.15.0.rst @@ -1,8 +1,8 @@ .. _whatsnew_0_15_0: -v0.15.0 (Feb 3, 2026) ---------------------- +v0.15.0 (February 3, 2026) +-------------------------- Breaking Changes ~~~~~~~~~~~~~~~~ diff --git a/docs/sphinx/source/whatsnew/v0.15.1.rst b/docs/sphinx/source/whatsnew/v0.15.1.rst index d5ea67b355..c2f3a1de3c 100644 --- a/docs/sphinx/source/whatsnew/v0.15.1.rst +++ b/docs/sphinx/source/whatsnew/v0.15.1.rst @@ -1,15 +1,8 @@ .. _whatsnew_0_15_1: -v0.15.1 (Anticipated March 2026) --------------------------------- - -Breaking Changes -~~~~~~~~~~~~~~~~ - - -Deprecations -~~~~~~~~~~~~ +v0.15.1 (April 21, 2026) +------------------------ Bug fixes @@ -22,44 +15,42 @@ 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` + - :term:`iam` + - :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` @@ -74,13 +65,6 @@ Testing produces consistent results for vectorized and scalar inputs. (:issue:`2649`, :pull:`2661`) -Benchmarking -~~~~~~~~~~~~ - - -Requirements -~~~~~~~~~~~~ - Maintenance ~~~~~~~~~~~ @@ -104,4 +88,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`) diff --git a/pvlib/tracking.py b/pvlib/tracking.py index 07cc9a709e..de82f44ffa 100644 --- a/pvlib/tracking.py +++ b/pvlib/tracking.py @@ -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