Merge branch 'main' into diffuse-components-support

Author: cbcrespo

.gitattributes

@@ -1,2 +1,4 @@
+# ensure right line ending normalization in all contributor setups
+* text=auto
 # reduce the number of merge conflicts
 docs/sphinx/source/whatsnew/* merge=union

docs/examples/system-models/oedi_9068.py …amples/system-models/noplot_oedi_9068.pydocs/examples/system-models/oedi_9068.py renamed to docs/examples/system-models/noplot_oedi_9068.py docs/examples/system-models/oedi_9068.py renamed to docs/examples/system-models/noplot_oedi_9068.py

@@ -13,9 +13,15 @@
 #
 # The system has public monitoring data available at the Open Energy Data
 # Initiative (OEDI) under `System ID
-# 9068 <https://data.openei.org/s3_viewer?bucket=oedi-data-lake&prefix=pvdaq%2F2023-solar-data-prize%2F9068_OEDI%2F>`__.
+# 9068 <https://data.openei.org/s3_viewer?bucket=oedi-data-lake&prefix=pvdaq%2F2023-solar-data-prize%2F9068_OEDI%2F>`__.  # noqa: E501
 # For more information about the system, see its `OEDI
 # page <https://openei.org/wiki/PVDAQ/Sites/SR_CO>`__.
+#
+# .. warning::
+#    This example requires user-provided credentials to be run at step
+#    :ref:`Fetch weather data <fetch_weather_data>`. Therefore, it is not
+#    executed as part of documentation build process and it's more
+#    susceptible to API changes. Please, report any issues you may find.
 
 # sphinx_gallery_thumbnail_path = "_images/OEDI_9068_daily_timeseries.png"
 import pvlib
@@ -132,6 +138,7 @@
 # %%
 # Fetch weather data
 # ------------------
+# .. _fetch_weather_data:
 #
 # The system does have measured plane-of-array irradiance data, but the
 # measurements suffer from row-to-row shading and tracker stalls. In this

docs/sphinx/source/conf.py

@@ -20,9 +20,9 @@
 # for generating GH links with linenumbers
 import inspect
 
-# import distutils before calling pd.show_versions()
-# https://github.com/pypa/setuptools/issues/3044
-import distutils  # noqa: F401
+# to escape special characters in sphinx-gallery OS-dependant regex
+import re
+
 import pandas as pd
 
 pd.show_versions()
@@ -384,12 +384,19 @@ def setup(app):
 # https://github.com/pvlib/pvlib-python/issues/837
 suppress_warnings = ['ref.footnote']
 
+os_re_sep = re.escape(os.path.sep)
 # settings for sphinx-gallery
 sphinx_gallery_conf = {
     'examples_dirs': ['../../examples'],  # location of gallery scripts
     'gallery_dirs': ['gallery'],  # location of generated output
-    # execute only files starting with plot_
-    'filename_pattern': 'plot_',
+
+    # do not execute gallery examples filenames that begin with noplot_
+    # first group + sep := match folders up to filename
+    # negative lookahead + match anything but sep := match filename (if valid)
+    # https://sphinx-gallery.github.io/stable/configuration.html#parsing-and-executing-examples-via-matching-patterns  # noqa: E501
+    # unix: filename_pattern = '^(.*)/(?!noplot_)([^/]*)$'
+    # win: filename_pattern = '^(.*)\\\\(?!noplot_)([^\\\\]*)$'
+    'filename_pattern': rf"^(.*){os_re_sep}(?!noplot_)([^{os_re_sep}]*)$",
 
     # directory where function/class granular galleries are stored
     'backreferences_dir': 'reference/generated/gallery_backreferences',

docs/sphinx/source/reference/iotools.rst

@@ -80,6 +80,8 @@ Satellite-derived irradiance and weather data for the Americas.
    iotools.get_nsrdb_psm4_tmy
    iotools.get_nsrdb_psm4_conus
    iotools.get_nsrdb_psm4_full_disc
+   iotools.get_nsrdb_psm4_polar
+   iotools.get_nsrdb_psm4_polar_tmy
    iotools.read_nsrdb_psm4
 
 

docs/sphinx/source/whatsnew/v0.15.3.rst

@@ -14,12 +14,20 @@ Deprecations
 
 Bug fixes
 ~~~~~~~~~
+* :py:func:`~pvlib.solarposition.sun_rise_set_transit_spa` now returns
+  sunrise, sunset, and transit for the *local* calendar day of each input
+  timestamp, restoring the behavior from before v0.11.1. Evening-local
+  timestamps, which fall on the next calendar day in UTC, previously
+  returned the following day's values. (:issue:`2238`)
 
 
 Enhancements
 ~~~~~~~~~~~~
-* Add support for diffuse irradiance components to :py:func:`pvlib.irradiance.isotropic`
-  when ``return_components=True``. (:issue:`2750`, :pull:`2787`)
+* Add iotools functions to retrieve irradiance and weather data from NSRDB PSM4 Polar,
+  which provides satellite-derived irradiance data above 60 degree latitude.
+  :py:func:`~pvlib.iotools.get_nsrdb_psm4_polar` and
+  :py:func:`~pvlib.iotools.get_nsrdb_psm4_polar_tmy`.
+  (:issue:`2639`, :pull:`2807`)
 * Ensure all timezones are available in all OSs. (:issue:`2795`, :pull:`2809`)
 
 
@@ -44,14 +52,18 @@ Requirements
 
 Maintenance
 ~~~~~~~~~~~
+* Fix some gallery examples not being run. Only gallery examples whose filename begins with ``noplot_`` will be excluded. (:issue:`2790`, :pull:`2792`)
 * Removed unused internal function ``clearsky._is_leap_year`` (:issue:`2768`, :pull:`2813`)
 * Fix documentation builds on runner images lacking link-type timezones. (:issue:`2795`, :pull:`2809`)
 
 
 Contributors
 ~~~~~~~~~~~~
+* Adam R. Jensen (:ghuser:`AdamRJensen`)
+* Erin Tonita (:ghuser:`etoni044`)
 * Eesh Saxena (:ghuser:`eeshsaxena`)
 * Karl Hill (:ghuser:`karlhillx`)
 * Mathias Aschwanden (:ghuser:`maschwanden`)
 * Yonry Zhu (:ghuser:`yonryzhu`)
 * Darshan Gowda (:ghuser:`dgowdaan-cmyk`)
+* Leonardo Scappatura (:ghuser:`Leonard013`)