From 879523b204956d4d71f58acf11821bf001810c81 Mon Sep 17 00:00:00 2001 From: Kevin Anderson Date: Mon, 16 Dec 2024 17:32:18 -0500 Subject: [PATCH 1/8] update release date --- docs/sphinx/source/whatsnew/v0.11.2.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/sphinx/source/whatsnew/v0.11.2.rst b/docs/sphinx/source/whatsnew/v0.11.2.rst index b2fb64fa9c..f622aee052 100644 --- a/docs/sphinx/source/whatsnew/v0.11.2.rst +++ b/docs/sphinx/source/whatsnew/v0.11.2.rst @@ -1,8 +1,8 @@ .. _whatsnew_01120: -v0.11.2 (Anticipated December, 2024) ------------------------------------- +v0.11.2 (December 16, 2024) +--------------------------- Deprecations ~~~~~~~~~~~~ From a02e1a664239f431f2f5f7edb89b5148f45fa32e Mon Sep 17 00:00:00 2001 From: Kevin Anderson Date: Mon, 16 Dec 2024 17:32:37 -0500 Subject: [PATCH 2/8] nix empty/redundant sections --- docs/sphinx/source/whatsnew/v0.11.2.rst | 9 --------- 1 file changed, 9 deletions(-) diff --git a/docs/sphinx/source/whatsnew/v0.11.2.rst b/docs/sphinx/source/whatsnew/v0.11.2.rst index f622aee052..e6560069ec 100644 --- a/docs/sphinx/source/whatsnew/v0.11.2.rst +++ b/docs/sphinx/source/whatsnew/v0.11.2.rst @@ -29,10 +29,6 @@ Bug Fixes (:issue:`2132` :pull:`2133`) * Changed ``dni_extra`` to a required parameter in :py:func:`pvlib.irradiance.ghi_from_poa_driesse_2023` (:issue:`2279` :pull:`2331`) - - -Bug fixes -~~~~~~~~~ * :py:func:`~pvlib.spa.julian_day_dt` now accounts for the 10 day difference between Julian and Gregorian calendars prior to the year 1582. (:issue:`2077`, :pull:`2249`) * Corrected sign of temperature coefficient ``dEgdT`` in :py:func:`~pvlib.pvsystem.fit_desoto_sandia`. @@ -73,11 +69,6 @@ Testing ~~~~~~~ * Updated test files to track new PVGIS 5.3 data. (:pull:`2305`) - -Requirements -~~~~~~~~~~~~ - - Maintenance ~~~~~~~~~~~ * Added a decorator to deprecate renamed keyword arguments in functions, From 7ced58a338cecadf9bc6e753f6b6a14cdcec78fe Mon Sep 17 00:00:00 2001 From: Kevin Anderson Date: Mon, 16 Dec 2024 17:34:59 -0500 Subject: [PATCH 3/8] reorder entries --- docs/sphinx/source/whatsnew/v0.11.2.rst | 30 +++++++++++-------------- 1 file changed, 13 insertions(+), 17 deletions(-) diff --git a/docs/sphinx/source/whatsnew/v0.11.2.rst b/docs/sphinx/source/whatsnew/v0.11.2.rst index e6560069ec..cf0ccb0554 100644 --- a/docs/sphinx/source/whatsnew/v0.11.2.rst +++ b/docs/sphinx/source/whatsnew/v0.11.2.rst @@ -6,13 +6,9 @@ v0.11.2 (December 16, 2024) Deprecations ~~~~~~~~~~~~ -* Deprecated terms ``dni_clearsky`` and ``clearsky_dni``, replaced with ``dni_clear``. - Affected functions are :py:func:`~pvlib.irradiance.dirindex` and :py:func:`~pvlib.irradiance.dni`. - (:issue:`2272`, :pull:`2274`) -* Deprecated term ``ghi_clearsky``, replaced with ``ghi_clear``. - Affected functions are :py:func:`~pvlib.irradiance.dirindex` and :py:func:`~pvlib.irradiance.clearsky_index`. - (:issue:`2272`, :pull:`2306`) - +* Deprecated terms ``dni_clearsky`` and ``clearsky_dni``, replaced with ``dni_clear`` and ``ghi_clear``. + Affected functions are :py:func:`~pvlib.irradiance.dirindex`, :py:func:`~pvlib.irradiance.dni` + and :py:func:`~pvlib.irradiance.clearsky_index`. Enhancements ~~~~~~~~~~~~ @@ -43,27 +39,27 @@ Documentation :py:class:`~pvlib.pvsystem.SingleAxisTrackerMount`, and :py:class:`~pvlib.pvsystem.FixedMount` docstrings. Various formatting edits for clarity. (:issue:`1942`, :pull:`2232`) -* Added a new citation style guide (:ref:`reference_style`) to the contributing - page. (:issue:`2202`, :pull:`2226`) * Updated :py:func:`~pvlib.irradiance.reindl` to include definitions of terms and a new "notes" section (:issue:`2183`, :pull:`2193`) * Clarified the error message in :py:func:`~pvlib.clearsky.detect_clearsky` when windows contain fewer than three data points (:issue:`2005`, :pull:`2281`) -* Added a new :ref:`nomenclature` page, in place of the Variables and Symbols - page, using the sphinx glossary directive. (:issue:`1421`, :pull:`2234`) -* Explained how to write docstrings for new functions in :ref:`example-docstring` - (:discussion:`2081`, :pull:`2254`) * Clarify mounting cases for parameters for :py:func:`~pvlib.temperature.sapm_module`, :py:func:`~pvlib.temperature.sapm_cell` and :py:func:`~pvlib.temperature.pvsyst_cell`. (:issue:`1323`, :pull:`2293`) +* Added a example to :py:func:`~pvlib.pvsystem.retrieve_sam` docstring to + demonstrate how to retrieve a database from the SAM repo. (:pull:`2313`) +* Added a new citation style guide (:ref:`reference_style`) to the contributing + page. (:issue:`2202`, :pull:`2226`) +* Explained how to write docstrings for new functions in :ref:`example-docstring` + (:discussion:`2081`, :pull:`2254`) +* Added a section in the style guide for parameter naming and units best practices. + See :ref:`documentation-units`. (:issue:`2205`, :pull:`2248`) +* Added a new :ref:`nomenclature` page, in place of the Variables and Symbols + page, using the sphinx glossary directive. (:issue:`1421`, :pull:`2234`) * Added the following variables to the :ref:`nomenclature` page: - `spectra` and `spectra_components` (:issue:`2150`, :pull:`2264`) -* Added a section in the style guide for parameter naming and units best practices. - See :ref:`documentation-units`. (:issue:`2205`, :pull:`2248`) -* Added a example to :py:func:`~pvlib.pvsystem.retrieve_sam` docstring to - demonstrate how to retrieve a database from the SAM repo. (:pull:`2313`) Testing ~~~~~~~ From 95472732cbce8c98fd888461593155b76ced1453 Mon Sep 17 00:00:00 2001 From: Kevin Anderson Date: Mon, 16 Dec 2024 17:37:31 -0500 Subject: [PATCH 4/8] use present tense --- docs/sphinx/source/whatsnew/v0.11.2.rst | 34 ++++++++++++------------- 1 file changed, 17 insertions(+), 17 deletions(-) diff --git a/docs/sphinx/source/whatsnew/v0.11.2.rst b/docs/sphinx/source/whatsnew/v0.11.2.rst index cf0ccb0554..4ceef44515 100644 --- a/docs/sphinx/source/whatsnew/v0.11.2.rst +++ b/docs/sphinx/source/whatsnew/v0.11.2.rst @@ -6,14 +6,14 @@ v0.11.2 (December 16, 2024) Deprecations ~~~~~~~~~~~~ -* Deprecated terms ``dni_clearsky`` and ``clearsky_dni``, replaced with ``dni_clear`` and ``ghi_clear``. +* Deprecate terms ``dni_clearsky`` and ``clearsky_dni``, replace with ``dni_clear`` and ``ghi_clear``. Affected functions are :py:func:`~pvlib.irradiance.dirindex`, :py:func:`~pvlib.irradiance.dni` and :py:func:`~pvlib.irradiance.clearsky_index`. Enhancements ~~~~~~~~~~~~ -* :py:func:`~pvlib.atmosphere.rh_from_tdew` and :py:func:`~pvlib.atmosphere.tdew_from_rh` - added. (:issue:`1744`, :pull:`2286`) +* Add :py:func:`~pvlib.atmosphere.rh_from_tdew` and :py:func:`~pvlib.atmosphere.tdew_from_rh`. + (:issue:`1744`, :pull:`2286`) * :py:func:`~pvlib.ivtools.sdm.fit_desoto` now allows input of initial parameter guesses. (:issue:`1014`, :pull:`2291`) @@ -23,51 +23,51 @@ Bug Fixes (:issue:`1338`, :pull:`2227`) * Handle DST transitions that happen at midnight in :py:func:`pvlib.solarposition.hour_angle` (:issue:`2132` :pull:`2133`) -* Changed ``dni_extra`` to a required parameter in :py:func:`pvlib.irradiance.ghi_from_poa_driesse_2023` +* Change ``dni_extra`` to a required parameter in :py:func:`pvlib.irradiance.ghi_from_poa_driesse_2023` (:issue:`2279` :pull:`2331`) * :py:func:`~pvlib.spa.julian_day_dt` now accounts for the 10 day difference between Julian and Gregorian calendars prior to the year 1582. (:issue:`2077`, :pull:`2249`) -* Corrected sign of temperature coefficient ``dEgdT`` in :py:func:`~pvlib.pvsystem.fit_desoto_sandia`. +* Correct sign of temperature coefficient ``dEgdT`` in :py:func:`~pvlib.pvsystem.fit_desoto_sandia`. Results may differ slightly from previous versions. (:issue:`2311`, :pull:`2322`) Documentation ~~~~~~~~~~~~~ -* Edited docstrings for :py:func:`~pvlib.pvsystem.dc_ohms_from_percent` and +* Edit docstrings for :py:func:`~pvlib.pvsystem.dc_ohms_from_percent` and :py:func:`~pvlib.pvsystem.dc_ohmic_losses` for clarity. (:issue:`1601`, :pull:`2229`) -* Added 'freestanding' and 'insulated' `racking_model` options for cell +* Add 'freestanding' and 'insulated' `racking_model` options for cell temperature calculation in :py:class:`~pvlib.pvsystem.PVSystem` :py:class:`~pvlib.pvsystem.SingleAxisTrackerMount`, and :py:class:`~pvlib.pvsystem.FixedMount` docstrings. Various formatting edits for clarity. (:issue:`1942`, :pull:`2232`) -* Updated :py:func:`~pvlib.irradiance.reindl` to include definitions of terms +* Update :py:func:`~pvlib.irradiance.reindl` to include definitions of terms and a new "notes" section (:issue:`2183`, :pull:`2193`) -* Clarified the error message in :py:func:`~pvlib.clearsky.detect_clearsky` when +* Clarify the error message in :py:func:`~pvlib.clearsky.detect_clearsky` when windows contain fewer than three data points (:issue:`2005`, :pull:`2281`) * Clarify mounting cases for parameters for :py:func:`~pvlib.temperature.sapm_module`, :py:func:`~pvlib.temperature.sapm_cell` and :py:func:`~pvlib.temperature.pvsyst_cell`. (:issue:`1323`, :pull:`2293`) -* Added a example to :py:func:`~pvlib.pvsystem.retrieve_sam` docstring to +* Add an example to :py:func:`~pvlib.pvsystem.retrieve_sam` docstring to demonstrate how to retrieve a database from the SAM repo. (:pull:`2313`) -* Added a new citation style guide (:ref:`reference_style`) to the contributing +* Add a new citation style guide (:ref:`reference_style`) to the contributing page. (:issue:`2202`, :pull:`2226`) -* Explained how to write docstrings for new functions in :ref:`example-docstring` +* Explain how to write docstrings for new functions in :ref:`example-docstring` (:discussion:`2081`, :pull:`2254`) -* Added a section in the style guide for parameter naming and units best practices. +* Add a section in the style guide for parameter naming and units best practices. See :ref:`documentation-units`. (:issue:`2205`, :pull:`2248`) -* Added a new :ref:`nomenclature` page, in place of the Variables and Symbols +* Add a new :ref:`nomenclature` page, in place of the Variables and Symbols page, using the sphinx glossary directive. (:issue:`1421`, :pull:`2234`) -* Added the following variables to the :ref:`nomenclature` page: +* Add the following variables to the :ref:`nomenclature` page: - `spectra` and `spectra_components` (:issue:`2150`, :pull:`2264`) Testing ~~~~~~~ -* Updated test files to track new PVGIS 5.3 data. (:pull:`2305`) +* Update test files to track new PVGIS 5.3 data. (:pull:`2305`) Maintenance ~~~~~~~~~~~ -* Added a decorator to deprecate renamed keyword arguments in functions, +* Add a decorator to deprecate renamed keyword arguments in functions, :py:func:`pvlib._deprecation.renamed_kwarg_warning`. (:pull:`2237`) From 7d8bcda450e1114ec255b2f88824c5b512afafd4 Mon Sep 17 00:00:00 2001 From: Kevin Anderson Date: Mon, 16 Dec 2024 17:39:50 -0500 Subject: [PATCH 5/8] discussion -> discuss --- docs/sphinx/source/whatsnew/v0.11.2.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/sphinx/source/whatsnew/v0.11.2.rst b/docs/sphinx/source/whatsnew/v0.11.2.rst index 4ceef44515..100d48fabe 100644 --- a/docs/sphinx/source/whatsnew/v0.11.2.rst +++ b/docs/sphinx/source/whatsnew/v0.11.2.rst @@ -51,7 +51,7 @@ Documentation * Add a new citation style guide (:ref:`reference_style`) to the contributing page. (:issue:`2202`, :pull:`2226`) * Explain how to write docstrings for new functions in :ref:`example-docstring` - (:discussion:`2081`, :pull:`2254`) + (:discuss:`2081`, :pull:`2254`) * Add a section in the style guide for parameter naming and units best practices. See :ref:`documentation-units`. (:issue:`2205`, :pull:`2248`) * Add a new :ref:`nomenclature` page, in place of the Variables and Symbols From 9e4242905a90f7ca0815522078d0b60ec9cf7c9f Mon Sep 17 00:00:00 2001 From: Kevin Anderson Date: Mon, 16 Dec 2024 17:59:31 -0500 Subject: [PATCH 6/8] add missing contributors --- docs/sphinx/source/whatsnew/v0.11.2.rst | 15 +++++++++++++++ 1 file changed, 15 insertions(+) diff --git a/docs/sphinx/source/whatsnew/v0.11.2.rst b/docs/sphinx/source/whatsnew/v0.11.2.rst index 100d48fabe..3c384216b1 100644 --- a/docs/sphinx/source/whatsnew/v0.11.2.rst +++ b/docs/sphinx/source/whatsnew/v0.11.2.rst @@ -83,3 +83,18 @@ Contributors * Kevin Anderson (:ghuser:`kandersolar`) * Scott Nelson (:ghuser:`scttnlsn`) * Ioannis Sifnaios (:ghuser:`IoannisSifnaios`) +* Adam R. Jensen (:ghuser:`AdamRJensen`) +* Anton Driesse (:ghuser:`adriesse`) +* Will Holmgren (:ghuser:`wholmgren`) +* Umay Akkoseoglu (:ghuser:`uakkoseo`) +* Mark Campanelli (:ghuser:`markcampanelli`) +* :ghuser:`iblasi` +* Hiromasa Ihara (:ghuser:`miettal`) +* Yunho Kee (:ghuser:`yhkee0404`) +* Hamilton Kibbe (:ghuser:`hamiltonkibbe`) +* Felix Korbelius (:ghuser:`FelixKoTU`) +* Michael Deceglie (:ghuser:`mdeceglie`) +* Will Hobbs (:ghuser:`williamhobbs`) +* Todd Karin (:ghuser:`toddkarin`) +* Lucas Schneeberger (:ghuser:`lucasschn`) +* Roma Koulikov (:ghuser:`matsuobasho`) From fcb915959c9ac1979d6a1ab438211e2674e0b29f Mon Sep 17 00:00:00 2001 From: Kevin Anderson Date: Mon, 16 Dec 2024 18:08:27 -0500 Subject: [PATCH 7/8] final tweaks --- docs/sphinx/source/whatsnew/v0.11.2.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/sphinx/source/whatsnew/v0.11.2.rst b/docs/sphinx/source/whatsnew/v0.11.2.rst index 3c384216b1..0110cc4708 100644 --- a/docs/sphinx/source/whatsnew/v0.11.2.rst +++ b/docs/sphinx/source/whatsnew/v0.11.2.rst @@ -27,7 +27,7 @@ Bug Fixes (:issue:`2279` :pull:`2331`) * :py:func:`~pvlib.spa.julian_day_dt` now accounts for the 10 day difference between Julian and Gregorian calendars prior to the year 1582. (:issue:`2077`, :pull:`2249`) -* Correct sign of temperature coefficient ``dEgdT`` in :py:func:`~pvlib.pvsystem.fit_desoto_sandia`. +* Correct sign of temperature coefficient ``dEgdT`` in :py:func:`~pvlib.ivtools.sdm.fit_desoto_sandia`. Results may differ slightly from previous versions. (:issue:`2311`, :pull:`2322`) Documentation @@ -35,7 +35,7 @@ Documentation * Edit docstrings for :py:func:`~pvlib.pvsystem.dc_ohms_from_percent` and :py:func:`~pvlib.pvsystem.dc_ohmic_losses` for clarity. (:issue:`1601`, :pull:`2229`) * Add 'freestanding' and 'insulated' `racking_model` options for cell - temperature calculation in :py:class:`~pvlib.pvsystem.PVSystem` + temperature calculation in :py:class:`~pvlib.pvsystem.PVSystem`, :py:class:`~pvlib.pvsystem.SingleAxisTrackerMount`, and :py:class:`~pvlib.pvsystem.FixedMount` docstrings. Various formatting edits for clarity. (:issue:`1942`, :pull:`2232`) From 9380e3fe34f24550edb1f990a2bc244f2dfd335f Mon Sep 17 00:00:00 2001 From: Kevin Anderson Date: Mon, 16 Dec 2024 18:21:42 -0500 Subject: [PATCH 8/8] fix duplicate contributor entry --- docs/sphinx/source/whatsnew/v0.11.2.rst | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/docs/sphinx/source/whatsnew/v0.11.2.rst b/docs/sphinx/source/whatsnew/v0.11.2.rst index 0110cc4708..ab63431e0d 100644 --- a/docs/sphinx/source/whatsnew/v0.11.2.rst +++ b/docs/sphinx/source/whatsnew/v0.11.2.rst @@ -78,7 +78,7 @@ Contributors * Dave Pitts (:ghuser:`dgapitts`) * Kurt Rhee (:ghuser:`kurt-rhee`) * Mark Mikofski (:ghuser:`mikofski`) -* matsuobasho (:ghuser:`matsuobasho`) +* Roma Koulikov (:ghuser:`matsuobasho`) * Echedey Luis (:ghuser:`echedey-ls`) * Kevin Anderson (:ghuser:`kandersolar`) * Scott Nelson (:ghuser:`scttnlsn`) @@ -97,4 +97,3 @@ Contributors * Will Hobbs (:ghuser:`williamhobbs`) * Todd Karin (:ghuser:`toddkarin`) * Lucas Schneeberger (:ghuser:`lucasschn`) -* Roma Koulikov (:ghuser:`matsuobasho`)