From c87885c079caccd5ee65d50104ede2eec7493418 Mon Sep 17 00:00:00 2001
From: echedey-ls <80125792+echedey-ls@users.noreply.github.com>
Date: Mon, 6 Nov 2023 18:10:59 +0100
Subject: [PATCH 001/185] Update shading.py

---
 pvlib/shading.py | 108 +++++------------------------------------------
 1 file changed, 11 insertions(+), 97 deletions(-)

diff --git a/pvlib/shading.py b/pvlib/shading.py
index 007e24e1b7..848a28c217 100644
--- a/pvlib/shading.py
+++ b/pvlib/shading.py
@@ -85,7 +85,7 @@ def masking_angle(surface_tilt, gcr, slant_height):
     ----------
     .. [1] D. Passias and B. Källbäck, "Shading effects in rows of solar cell
        panels", Solar Cells, Volume 11, Pages 281-291.  1984.
-       :doi:`10.1016/0379-6787(84)90017-6`
+       DOI: 10.1016/0379-6787(84)90017-6
     .. [2] Gilman, P. et al., (2018). "SAM Photovoltaic Model Technical
        Reference Update", NREL Technical Report NREL/TP-6A20-67399.
        Available at https://www.nrel.gov/docs/fy18osti/67399.pdf
@@ -167,7 +167,7 @@ def masking_angle_passias(surface_tilt, gcr):
     ----------
     .. [1] D. Passias and B. Källbäck, "Shading effects in rows of solar cell
        panels", Solar Cells, Volume 11, Pages 281-291.  1984.
-       :doi:`10.1016/0379-6787(84)90017-6`
+       DOI: 10.1016/0379-6787(84)90017-6
     """
     # wrap it in an array so that division by zero is handled well
     beta = np.radians(np.array(surface_tilt))
@@ -226,7 +226,7 @@ def sky_diffuse_passias(masking_angle):
     ----------
     .. [1] D. Passias and B. Källbäck, "Shading effects in rows of solar cell
        panels", Solar Cells, Volume 11, Pages 281-291.  1984.
-       :doi:`10.1016/0379-6787(84)90017-6`
+       DOI: 10.1016/0379-6787(84)90017-6
     .. [2] Gilman, P. et al., (2018). "SAM Photovoltaic Model Technical
        Reference Update", NREL Technical Report NREL/TP-6A20-67399.
        Available at https://www.nrel.gov/docs/fy18osti/67399.pdf
@@ -234,111 +234,25 @@ def sky_diffuse_passias(masking_angle):
     return 1 - cosd(masking_angle/2)**2
 
 
-def projected_solar_zenith_angle(solar_zenith, solar_azimuth,
-                                 axis_tilt, axis_azimuth):
+def projected_solar_zenith_angle(apparent_zenith, azimuth):
     r"""
     Calculate projected solar zenith angle in degrees.
 
-    This solar zenith angle is projected onto the plane whose normal vector is
-    defined by ``axis_tilt`` and ``axis_azimuth``. The normal vector is in the
-    direction of ``axis_azimuth`` (clockwise from north) and tilted from
-    horizontal by ``axis_tilt``. See Figure 5 in [1]_:
-
-    .. figure:: ../../_images/Anderson_Mikofski_2020_Fig5.jpg
-       :alt: Wire diagram of coordinates systems to obtain the projected angle.
-       :align: center
-       :scale: 50 %
-
-       Fig. 5, [1]_: Solar coordinates projection onto tracker rotation plane.
-
     Parameters
     ----------
-    solar_zenith : numeric
+    apparent_zenith : numeric
         Sun's apparent zenith in degrees.
-    solar_azimuth : numeric
+    azimuth : numeric
         Sun's azimuth in degrees.
-    axis_tilt : numeric
-        Axis tilt angle in degrees. From horizontal plane to array plane.
-    axis_azimuth : numeric
-        Axis azimuth angle in degrees.
-        North = 0°; East = 90°; South = 180°; West = 270°
 
     Returns
     -------
     Projected_solar_zenith : numeric
         In degrees.
-
-    Notes
-    -----
-    This projection has a variety of applications in PV. For example:
-
-    - Projecting the sun's position onto the plane perpendicular to
-      the axis of a single-axis tracker (i.e. the plane
-      whose normal vector coincides with the tracker torque tube)
-      yields the tracker rotation angle that maximizes direct irradiance
-      capture. This tracking strategy is called *true-tracking*. Learn more
-      about tracking in
-      :ref:`sphx_glr_gallery_solar-tracking_plot_single_axis_tracking.py`.
-
-    - Self-shading in large PV arrays is often modeled by assuming
-      a simplified 2-D array geometry where the sun's position is
-      projected onto the plane perpendicular to the PV rows.
-      The projected zenith angle is then used for calculations
-      regarding row-to-row shading.
-
-    Examples
-    --------
-    Calculate the ideal true-tracking angle for a horizontal north-south
-    single-axis tracker:
-
-    >>> rotation = projected_solar_zenith_angle(solar_zenith, solar_azimuth,
-    >>>                                         axis_tilt=0, axis_azimuth=180)
-
-    Calculate the projected zenith angle in a south-facing fixed tilt array
-    (note: the ``axis_azimuth`` of a fixed-tilt row points along the length
-    of the row):
-
-    >>> psza = projected_solar_zenith_angle(solar_zenith, solar_azimuth,
-    >>>                                     axis_tilt=0, axis_azimuth=90)
-
-    References
-    ----------
-    .. [1] K. Anderson and M. Mikofski, 'Slope-Aware Backtracking for
-       Single-Axis Trackers', National Renewable Energy Lab. (NREL), Golden,
-       CO (United States);
-       NREL/TP-5K00-76626, Jul. 2020. :doi:`10.2172/1660126`.
-
-    See Also
-    --------
-    pvlib.solarposition.get_solarposition
     """
-    # Assume the tracker reference frame is right-handed. Positive y-axis is
-    # oriented along tracking axis; from north, the y-axis is rotated clockwise
-    # by the axis azimuth and tilted from horizontal by the axis tilt. The
-    # positive x-axis is 90 deg clockwise from the y-axis and parallel to
-    # horizontal (e.g., if the y-axis is south, the x-axis is west); the
-    # positive z-axis is normal to the x and y axes, pointed upward.
-
-    # Since elevation = 90 - zenith, sin(90-x) = cos(x) & cos(90-x) = sin(x):
-    # Notation from [1], modified to use zenith instead of elevation
-    # cos(elevation) = sin(zenith) and sin(elevation) = cos(zenith)
-    # Avoid recalculating these values
-    sind_solar_zenith = sind(solar_zenith)
-    cosd_axis_azimuth = cosd(axis_azimuth)
-    sind_axis_azimuth = sind(axis_azimuth)
-    sind_axis_tilt = sind(axis_tilt)
-
-    # Sun's x, y, z coords
-    sx = sind_solar_zenith * sind(solar_azimuth)
-    sy = sind_solar_zenith * cosd(solar_azimuth)
-    sz = cosd(solar_zenith)
-    # Eq. (4); sx', sz' values from sun coordinates projected onto surface
-    sx_prime = sx * cosd_axis_azimuth - sy * sind_axis_azimuth
-    sz_prime = (
-        sx * sind_axis_azimuth * sind_axis_tilt
-        + sy * sind_axis_tilt * cosd_axis_azimuth
-        + sz * cosd(axis_tilt)
+    apparent_zenith = np.radians(apparent_zenith)
+    azimuth = np.radians(azimuth)
+    return np.degrees(
+        np.arctan2(np.sin(azimuth) * np.sin(apparent_zenith),
+                   np.cos(apparent_zenith))
     )
-    # Eq. (5); angle between sun's beam and surface
-    theta_T = np.degrees(np.arctan2(sx_prime, sz_prime))
-    return theta_T

From 4fc6cd8e0ac327975a0a97ab237c7c58c1997439 Mon Sep 17 00:00:00 2001
From: echedey-ls <80125792+echedey-ls@users.noreply.github.com>
Date: Mon, 6 Nov 2023 19:05:23 +0100
Subject: [PATCH 002/185] Minimal test

---
 pvlib/tests/test_shading.py | 146 +++++-------------------------------
 1 file changed, 20 insertions(+), 126 deletions(-)

diff --git a/pvlib/tests/test_shading.py b/pvlib/tests/test_shading.py
index 8d609d1e3f..40bfcaab23 100644
--- a/pvlib/tests/test_shading.py
+++ b/pvlib/tests/test_shading.py
@@ -4,29 +4,27 @@
 from pandas.testing import assert_series_equal
 from numpy.testing import assert_allclose
 import pytest
-from datetime import timezone, timedelta
 
 from pvlib import shading
 
 
 @pytest.fixture
 def test_system():
-    syst = {
-        "height": 1.0,
-        "pitch": 2.0,
-        "surface_tilt": 30.0,
-        "surface_azimuth": 180.0,
-        "rotation": -30.0,
-    }  # rotation of right edge relative to horizontal
-    syst["gcr"] = 1.0 / syst["pitch"]
+    syst = {'height': 1.0,
+            'pitch': 2.,
+            'surface_tilt': 30.,
+            'surface_azimuth': 180.,
+            'rotation': -30.}  # rotation of right edge relative to horizontal
+    syst['gcr'] = 1.0 / syst['pitch']
     return syst
 
 
 def test__ground_angle(test_system):
     ts = test_system
-    x = np.array([0.0, 0.5, 1.0])
-    angles = shading.ground_angle(ts["surface_tilt"], ts["gcr"], x)
-    expected_angles = np.array([0.0, 5.866738789543952, 9.896090638982903])
+    x = np.array([0., 0.5, 1.0])
+    angles = shading.ground_angle(
+        ts['surface_tilt'], ts['gcr'], x)
+    expected_angles = np.array([0., 5.866738789543952, 9.896090638982903])
     assert np.allclose(angles, expected_angles)
 
 
@@ -40,7 +38,7 @@ def test__ground_angle_zero_gcr():
 
 @pytest.fixture
 def surface_tilt():
-    idx = pd.date_range("2019-01-01", freq="h", periods=3)
+    idx = pd.date_range('2019-01-01', freq='h', periods=3)
     return pd.Series([0, 20, 90], index=idx)
 
 
@@ -109,117 +107,13 @@ def test_sky_diffuse_passias_scalar(average_masking_angle, shading_loss):
         assert np.isclose(loss, actual_loss)
 
 
-@pytest.fixture
-def true_tracking_angle_and_inputs_NREL():
-    # data from NREL 'Slope-Aware Backtracking for Single-Axis Trackers'
-    # doi.org/10.2172/1660126 ; Accessed on 2023-11-06.
-    tzinfo = timezone(timedelta(hours=-5))
-    axis_tilt_angle = 9.666  # deg
-    axis_azimuth_angle = 195.0  # deg
-    timedata = pd.DataFrame(
-        columns=("Apparent Elevation", "Solar Azimuth", "True-Tracking"),
-        data=(
-            (2.404287, 122.791770, -84.440),
-            (11.263058, 133.288729, -72.604),
-            (18.733558, 145.285552, -59.861),
-            (24.109076, 158.939435, -45.578),
-            (26.810735, 173.931802, -28.764),
-            (26.482495, 189.371536, -8.475),
-            (23.170447, 204.136810, 15.120),
-            (17.296785, 217.446538, 39.562),
-            (9.461862, 229.102218, 61.587),
-            (0.524817, 239.330401, 79.530),
-        ),
-    )
-    timedata.index = pd.date_range(
-        "2019-01-01T08", "2019-01-01T17", freq="1H", tz=tzinfo
-    )
-    timedata["Apparent Zenith"] = 90.0 - timedata["Apparent Elevation"]
-    return (axis_tilt_angle, axis_azimuth_angle, timedata)
-
-
-@pytest.fixture
-def projected_solar_zenith_angle_edge_cases():
-    premises_and_result_matrix = pd.DataFrame(
-        data=[
-            # s_zen | s_azm | ax_tilt | ax_azm | psza
-            [   0,       0,      0,        0,      0],
-            [   0,     180,      0,        0,      0],
-            [   0,       0,      0,      180,      0],
-            [   0,     180,      0,      180,      0],
-            [  45,       0,      0,      180,      0],
-            [  45,      90,      0,      180,    -45],
-            [  45,     270,      0,      180,     45],
-            [  45,      90,     90,      180,    -90],
-            [  45,     270,     90,      180,     90],
-            [  45,      90,     90,        0,     90],
-            [  45,     270,     90,        0,    -90],
-            [  45,      45,     90,      180,   -135],
-            [  45,     315,     90,      180,    135],
-        ],
-        columns=["solar_zenith", "solar_azimuth", "axis_tilt", "axis_azimuth",
-                 "psza"],
-    )
-    return premises_and_result_matrix
-
-
-def test_projected_solar_zenith_angle_numeric(
-    true_tracking_angle_and_inputs_NREL,
-    projected_solar_zenith_angle_edge_cases
-):
-    psza_func = shading.projected_solar_zenith_angle
-    axis_tilt, axis_azimuth, timedata = true_tracking_angle_and_inputs_NREL
-    # test against data provided by NREL
-    psz = psza_func(
-        timedata["Apparent Zenith"],
-        timedata["Solar Azimuth"],
-        axis_tilt,
-        axis_azimuth,
-    )
-    assert_allclose(psz, timedata["True-Tracking"], atol=1e-3)
-    # test by changing axis azimuth and tilt
-    psza = psza_func(
-        timedata["Apparent Zenith"],
-        timedata["Solar Azimuth"],
-        -axis_tilt,
-        axis_azimuth - 180,
-    )
-    assert_allclose(psza, -timedata["True-Tracking"], atol=1e-3)
-
-    # test edge cases
-    solar_zenith, solar_azimuth, axis_tilt, axis_azimuth, psza_expected = (
-        v for _, v in projected_solar_zenith_angle_edge_cases.items()
-    )
-    psza = psza_func(
-        solar_zenith,
-        solar_azimuth,
-        axis_tilt,
-        axis_azimuth,
-    )
-    assert_allclose(psza, psza_expected, atol=1e-9)
-
-
-@pytest.mark.parametrize(
-    "cast_type, cast_func",
-    [
-        (float, lambda x: float(x)),
-        (np.ndarray, lambda x: np.array([x])),
-        (pd.Series, lambda x: pd.Series(data=[x])),
-    ],
-)
-def test_projected_solar_zenith_angle_datatypes(
-    cast_type, cast_func, true_tracking_angle_and_inputs_NREL
-):
+def test_projected_solar_zenith_angle():
     psz_func = shading.projected_solar_zenith_angle
-    axis_tilt, axis_azimuth, timedata = true_tracking_angle_and_inputs_NREL
-    sun_apparent_zenith = timedata["Apparent Zenith"].iloc[0]
-    sun_azimuth = timedata["Solar Azimuth"].iloc[0]
-
-    axis_tilt, axis_azimuth, sun_apparent_zenith, sun_azimuth = (
-        cast_func(sun_apparent_zenith),
-        cast_func(sun_azimuth),
-        cast_func(axis_tilt),
-        cast_func(axis_azimuth),
-    )
-    psz = psz_func(sun_apparent_zenith, axis_azimuth, axis_tilt, axis_azimuth)
-    assert isinstance(psz, cast_type)
+    for app_zenith, azimuth, expected, atolerance, type in (
+        (90., 120., 90, 1e-3, float),
+        ([30], [100], [30], 1, np.ndarray),
+        (pd.Series([60]), pd.Series([135]), 50, 1, pd.Series)
+    ):
+        psz = psz_func(app_zenith, azimuth)
+        assert_allclose(psz, expected, atol=atolerance)
+        assert isinstance(psz, type)

From 2a72f331817f00c3d5d32760eca0280594123ae9 Mon Sep 17 00:00:00 2001
From: echedey-ls <80125792+echedey-ls@users.noreply.github.com>
Date: Wed, 8 Nov 2023 16:28:25 +0100
Subject: [PATCH 003/185] Implementation

From NREL paper
---
 pvlib/shading.py | 44 +++++++++++++++++++++++++++++++++++---------
 1 file changed, 35 insertions(+), 9 deletions(-)

diff --git a/pvlib/shading.py b/pvlib/shading.py
index 848a28c217..a8e3af5cd9 100644
--- a/pvlib/shading.py
+++ b/pvlib/shading.py
@@ -234,25 +234,51 @@ def sky_diffuse_passias(masking_angle):
     return 1 - cosd(masking_angle/2)**2
 
 
-def projected_solar_zenith_angle(apparent_zenith, azimuth):
+def projected_solar_zenith_angle(surface_tilt, surface_azimuth,
+                                 solar_apparent_zenith, solar_azimuth):
     r"""
     Calculate projected solar zenith angle in degrees.
 
+    This is common in track and shadow computation [1]_ [2]_ [3]_.
+
     Parameters
     ----------
-    apparent_zenith : numeric
+    surface_tilt : numeric
+        Array tilt angle in degrees. From horizontal plane to array plane.
+    surface_azimuth : numeric
+        Array azimuth angle in degrees.
+        North = 0°; East = 90°; South = 180°; West = 270°
+    solar_apparent_zenith : numeric
         Sun's apparent zenith in degrees.
-    azimuth : numeric
+    solar_azimuth : numeric
         Sun's azimuth in degrees.
 
     Returns
     -------
     Projected_solar_zenith : numeric
         In degrees.
+
+    References
+    ----------
+    .. [1] K. Anderson and M. Mikofski, ‘Slope-Aware Backtracking for
+       Single-Axis Trackers’, National Renewable Energy Lab. (NREL), Golden,
+       CO (United States); Det Norske Veritas Group, Oslo (Norway),
+       NREL/TP-5K00-76626, Jul. 2020. :doi:`10.2172/1660126`.
+    .. [2] W. F. Marion and A. P. Dobos, ‘Rotation Angle for the Optimum
+       Tracking of One-Axis Trackers’, National Renewable Energy Lab. (NREL),
+       Golden, CO (United States), NREL/TP-6A20-58891, Jul. 2013.
+       :doi:`10.2172/1089596`.
+    .. [3] E. Lorenzo, L. Narvarte, and J. Muñoz, ‘Tracking and back-tracking’,
+       Progress in Photovoltaics: Research and Applications, vol. 19, no. 6,
+       pp. 747–753, 2011, :doi:`10.1002/pip.1085`.
     """
-    apparent_zenith = np.radians(apparent_zenith)
-    azimuth = np.radians(azimuth)
-    return np.degrees(
-        np.arctan2(np.sin(azimuth) * np.sin(apparent_zenith),
-                   np.cos(apparent_zenith))
-    )
+    # Notation from [1]
+    sx = cosd(solar_apparent_zenith) * cosd(solar_azimuth)
+    sy = cosd(solar_apparent_zenith) * cosd(solar_azimuth)
+    sz = sind(solar_apparent_zenith)
+    sx_prime = sx * cosd(surface_azimuth) - sy * sind(surface_azimuth)
+    sz_prime = (sx * sind(surface_azimuth) * sind(surface_tilt)
+                + sy * sind(surface_tilt) * cosd(surface_azimuth)
+                + sz * cosd(surface_tilt))
+    theta_T = np.degrees(np.arctan2(sx_prime, sz_prime))
+    return theta_T

From d6e80675012cd3b15e4bbffc1496a2533bd8b109 Mon Sep 17 00:00:00 2001
From: echedey-ls <80125792+echedey-ls@users.noreply.github.com>
Date: Wed, 8 Nov 2023 22:46:17 +0100
Subject: [PATCH 004/185] Fix, fix, fix, fix & format

---
 pvlib/shading.py            | 12 +++---
 pvlib/tests/test_shading.py | 77 ++++++++++++++++++++++++++++++++-----
 2 files changed, 73 insertions(+), 16 deletions(-)

diff --git a/pvlib/shading.py b/pvlib/shading.py
index a8e3af5cd9..9ea0bbb8d7 100644
--- a/pvlib/shading.py
+++ b/pvlib/shading.py
@@ -235,7 +235,7 @@ def sky_diffuse_passias(masking_angle):
 
 
 def projected_solar_zenith_angle(surface_tilt, surface_azimuth,
-                                 solar_apparent_zenith, solar_azimuth):
+                                 solar_apparent_elevation, solar_azimuth):
     r"""
     Calculate projected solar zenith angle in degrees.
 
@@ -248,8 +248,8 @@ def projected_solar_zenith_angle(surface_tilt, surface_azimuth,
     surface_azimuth : numeric
         Array azimuth angle in degrees.
         North = 0°; East = 90°; South = 180°; West = 270°
-    solar_apparent_zenith : numeric
-        Sun's apparent zenith in degrees.
+    solar_apparent_elevation : numeric
+        Sun's apparent elevation in degrees.
     solar_azimuth : numeric
         Sun's azimuth in degrees.
 
@@ -273,9 +273,9 @@ def projected_solar_zenith_angle(surface_tilt, surface_azimuth,
        pp. 747–753, 2011, :doi:`10.1002/pip.1085`.
     """
     # Notation from [1]
-    sx = cosd(solar_apparent_zenith) * cosd(solar_azimuth)
-    sy = cosd(solar_apparent_zenith) * cosd(solar_azimuth)
-    sz = sind(solar_apparent_zenith)
+    sx = cosd(solar_apparent_elevation) * sind(solar_azimuth)
+    sy = cosd(solar_apparent_elevation) * cosd(solar_azimuth)
+    sz = sind(solar_apparent_elevation)
     sx_prime = sx * cosd(surface_azimuth) - sy * sind(surface_azimuth)
     sz_prime = (sx * sind(surface_azimuth) * sind(surface_tilt)
                 + sy * sind(surface_tilt) * cosd(surface_azimuth)
diff --git a/pvlib/tests/test_shading.py b/pvlib/tests/test_shading.py
index 40bfcaab23..340cfd7289 100644
--- a/pvlib/tests/test_shading.py
+++ b/pvlib/tests/test_shading.py
@@ -4,6 +4,7 @@
 from pandas.testing import assert_series_equal
 from numpy.testing import assert_allclose
 import pytest
+from datetime import timezone, timedelta
 
 from pvlib import shading
 
@@ -38,7 +39,7 @@ def test__ground_angle_zero_gcr():
 
 @pytest.fixture
 def surface_tilt():
-    idx = pd.date_range('2019-01-01', freq='h', periods=3)
+    idx = pd.date_range("2019-01-01", freq="h", periods=3)
     return pd.Series([0, 20, 90], index=idx)
 
 
@@ -107,13 +108,69 @@ def test_sky_diffuse_passias_scalar(average_masking_angle, shading_loss):
         assert np.isclose(loss, actual_loss)
 
 
-def test_projected_solar_zenith_angle():
+@pytest.fixture
+def true_tracking_angle_and_inputs():
+    # data retrieved from NREL Slope-Aware Backtracking for Single-Axis
+    # Trackers
+    # doi.org/10.2172/1660126 ; Accessed on 2023-11-06.
+    tzinfo = timezone(timedelta(hours=-5))
+    array_tilt_angle = 9.666  # deg
+    array_azimuth_angle = 195.0  # deg
+    timedata = pd.DataFrame(
+        columns=("Apparent Elevation", "Solar Azimuth", "True-Tracking"),
+        data=(
+            (2.404287, 122.791770, -84.440),
+            (11.263058, 133.288729, -72.604),
+            (18.733558, 145.285552, -59.861),
+            (24.109076, 158.939435, -45.578),
+            (26.810735, 173.931802, -28.764),
+            (26.482495, 189.371536, -8.475),
+            (23.170447, 204.136810, 15.120),
+            (17.296785, 217.446538, 39.562),
+            (9.461862, 229.102218, 61.587),
+            (0.524817, 239.330401, 79.530),
+        ),
+    )
+    timedata.index = pd.date_range(
+        "2019-01-01T08", "2019-01-01T17", freq="1H", tz=tzinfo
+    )
+    timedata["Apparent Zenith"] = 90.0 - timedata["Apparent Elevation"]
+    return (array_tilt_angle, array_azimuth_angle, timedata)
+
+
+def test_projected_solar_zenith_angle_numeric(true_tracking_angle_and_inputs):
+    psz_func = shading.projected_solar_zenith_angle
+    array_tilt, array_azimuth, timedata = true_tracking_angle_and_inputs
+    psz = psz_func(
+        array_tilt,
+        array_azimuth,
+        timedata["Apparent Elevation"],
+        timedata["Solar Azimuth"],
+    )
+    assert_allclose(psz, timedata["True-Tracking"], atol=1e-3)
+
+
+@pytest.mark.parametrize(
+    "cast_type, cast_func",
+    [
+        (float, float),
+        (np.ndarray, lambda x: np.array([x])),
+        (pd.Series, lambda x: pd.Series(data=[x])),
+    ],
+)
+def test_projected_solar_zenith_angle_dataypes(
+    cast_type, cast_func, true_tracking_angle_and_inputs
+):
     psz_func = shading.projected_solar_zenith_angle
-    for app_zenith, azimuth, expected, atolerance, type in (
-        (90., 120., 90, 1e-3, float),
-        ([30], [100], [30], 1, np.ndarray),
-        (pd.Series([60]), pd.Series([135]), 50, 1, pd.Series)
-    ):
-        psz = psz_func(app_zenith, azimuth)
-        assert_allclose(psz, expected, atol=atolerance)
-        assert isinstance(psz, type)
+    array_tilt, array_azimuth, timedata = true_tracking_angle_and_inputs
+    sun_apparent_zenith = timedata["Apparent Zenith"].iloc[0]
+    sun_azimuth = timedata["Solar Azimuth"].iloc[0]
+
+    array_tilt, array_azimuth, sun_apparent_zenith, sun_azimuth = (
+        cast_func(array_tilt),
+        cast_func(array_azimuth),
+        cast_func(sun_apparent_zenith),
+        cast_func(sun_azimuth),
+    )
+    psz = psz_func(array_tilt, array_azimuth, sun_apparent_zenith, array_azimuth)
+    assert isinstance(psz, cast_type)

From 13a56d4806d944892a4f81604e916bcaa90c378c Mon Sep 17 00:00:00 2001
From: echedey-ls <80125792+echedey-ls@users.noreply.github.com>
Date: Wed, 8 Nov 2023 22:50:19 +0100
Subject: [PATCH 005/185] Format issues

---
 pvlib/tests/test_shading.py | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/pvlib/tests/test_shading.py b/pvlib/tests/test_shading.py
index 340cfd7289..ce5ea7d833 100644
--- a/pvlib/tests/test_shading.py
+++ b/pvlib/tests/test_shading.py
@@ -172,5 +172,7 @@ def test_projected_solar_zenith_angle_dataypes(
         cast_func(sun_apparent_zenith),
         cast_func(sun_azimuth),
     )
-    psz = psz_func(array_tilt, array_azimuth, sun_apparent_zenith, array_azimuth)
+    psz = psz_func(
+        array_tilt, array_azimuth, sun_apparent_zenith, array_azimuth
+    )
     assert isinstance(psz, cast_type)

From f012aae858ace2edb1ad4a43edd23b44b1a58410 Mon Sep 17 00:00:00 2001
From: echedey-ls <80125792+echedey-ls@users.noreply.github.com>
Date: Wed, 8 Nov 2023 23:15:58 +0100
Subject: [PATCH 006/185] Extend tests (compare with singleaxis) & format with
 ruff

---
 pvlib/shading.py            | 8 +++++---
 pvlib/tests/test_shading.py | 9 +++++++--
 2 files changed, 12 insertions(+), 5 deletions(-)

diff --git a/pvlib/shading.py b/pvlib/shading.py
index 9ea0bbb8d7..93d44e5404 100644
--- a/pvlib/shading.py
+++ b/pvlib/shading.py
@@ -277,8 +277,10 @@ def projected_solar_zenith_angle(surface_tilt, surface_azimuth,
     sy = cosd(solar_apparent_elevation) * cosd(solar_azimuth)
     sz = sind(solar_apparent_elevation)
     sx_prime = sx * cosd(surface_azimuth) - sy * sind(surface_azimuth)
-    sz_prime = (sx * sind(surface_azimuth) * sind(surface_tilt)
-                + sy * sind(surface_tilt) * cosd(surface_azimuth)
-                + sz * cosd(surface_tilt))
+    sz_prime = (
+        sx * sind(surface_azimuth) * sind(surface_tilt)
+        + sy * sind(surface_tilt) * cosd(surface_azimuth)
+        + sz * cosd(surface_tilt)
+    )
     theta_T = np.degrees(np.arctan2(sx_prime, sz_prime))
     return theta_T
diff --git a/pvlib/tests/test_shading.py b/pvlib/tests/test_shading.py
index ce5ea7d833..27849f7a8a 100644
--- a/pvlib/tests/test_shading.py
+++ b/pvlib/tests/test_shading.py
@@ -6,9 +6,9 @@
 import pytest
 from datetime import timezone, timedelta
 
+import pvlib
 from pvlib import shading
 
-
 @pytest.fixture
 def test_system():
     syst = {'height': 1.0,
@@ -148,7 +148,12 @@ def test_projected_solar_zenith_angle_numeric(true_tracking_angle_and_inputs):
         timedata["Solar Azimuth"],
     )
     assert_allclose(psz, timedata["True-Tracking"], atol=1e-3)
-
+    # test equivalence against pvlib.tracking.singleaxis
+    singleaxis = pvlib.tracking.singleaxis(90-timedata["Apparent Elevation"],
+                                           timedata["Solar Azimuth"],
+                                           array_tilt, array_azimuth,
+                                           backtrack=False)
+    assert_allclose(psz, singleaxis["tracker_theta"])
 
 @pytest.mark.parametrize(
     "cast_type, cast_func",

From 6dd9a3bb03653caa93a2448d270cbdeedcc2cbeb Mon Sep 17 00:00:00 2001
From: echedey-ls <80125792+echedey-ls@users.noreply.github.com>
Date: Wed, 8 Nov 2023 23:24:51 +0100
Subject: [PATCH 007/185] Format fixes

---
 pvlib/tests/test_shading.py | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/pvlib/tests/test_shading.py b/pvlib/tests/test_shading.py
index 27849f7a8a..2a4352fdc8 100644
--- a/pvlib/tests/test_shading.py
+++ b/pvlib/tests/test_shading.py
@@ -9,6 +9,7 @@
 import pvlib
 from pvlib import shading
 
+
 @pytest.fixture
 def test_system():
     syst = {'height': 1.0,
@@ -155,6 +156,7 @@ def test_projected_solar_zenith_angle_numeric(true_tracking_angle_and_inputs):
                                            backtrack=False)
     assert_allclose(psz, singleaxis["tracker_theta"])
 
+
 @pytest.mark.parametrize(
     "cast_type, cast_func",
     [

From e8743dbec6f986ad96f84420cdd1139ca5ff32e1 Mon Sep 17 00:00:00 2001
From: echedey-ls <80125792+echedey-ls@users.noreply.github.com>
Date: Thu, 9 Nov 2023 21:50:16 +0100
Subject: [PATCH 008/185] Upgrade tests

---
 pvlib/tests/test_shading.py | 10 +++++++++-
 1 file changed, 9 insertions(+), 1 deletion(-)

diff --git a/pvlib/tests/test_shading.py b/pvlib/tests/test_shading.py
index 2a4352fdc8..497480f8d2 100644
--- a/pvlib/tests/test_shading.py
+++ b/pvlib/tests/test_shading.py
@@ -150,11 +150,19 @@ def test_projected_solar_zenith_angle_numeric(true_tracking_angle_and_inputs):
     )
     assert_allclose(psz, timedata["True-Tracking"], atol=1e-3)
     # test equivalence against pvlib.tracking.singleaxis
-    singleaxis = pvlib.tracking.singleaxis(90-timedata["Apparent Elevation"],
+    singleaxis = pvlib.tracking.singleaxis(timedata["Apparent Zenith"],
                                            timedata["Solar Azimuth"],
                                            array_tilt, array_azimuth,
                                            backtrack=False)
     assert_allclose(psz, singleaxis["tracker_theta"])
+    # test by changing axis azimuth and tilt
+    psz = psz_func(
+        -array_tilt,
+        array_azimuth-180,
+        timedata["Apparent Elevation"],
+        timedata["Solar Azimuth"],
+    )
+    assert_allclose(psz, -timedata["True-Tracking"], atol=1e-3)
 
 
 @pytest.mark.parametrize(

From 6030774802369eec30b33f4041007bdfc6c10b20 Mon Sep 17 00:00:00 2001
From: echedey-ls <80125792+echedey-ls@users.noreply.github.com>
Date: Thu, 9 Nov 2023 21:51:44 +0100
Subject: [PATCH 009/185] Array -> Axis

---
 pvlib/shading.py            |  4 ++--
 pvlib/tests/test_shading.py | 30 +++++++++++++++---------------
 2 files changed, 17 insertions(+), 17 deletions(-)

diff --git a/pvlib/shading.py b/pvlib/shading.py
index 93d44e5404..165e54e90c 100644
--- a/pvlib/shading.py
+++ b/pvlib/shading.py
@@ -244,9 +244,9 @@ def projected_solar_zenith_angle(surface_tilt, surface_azimuth,
     Parameters
     ----------
     surface_tilt : numeric
-        Array tilt angle in degrees. From horizontal plane to array plane.
+        Axis tilt angle in degrees. From horizontal plane to array plane.
     surface_azimuth : numeric
-        Array azimuth angle in degrees.
+        Axis azimuth angle in degrees.
         North = 0°; East = 90°; South = 180°; West = 270°
     solar_apparent_elevation : numeric
         Sun's apparent elevation in degrees.
diff --git a/pvlib/tests/test_shading.py b/pvlib/tests/test_shading.py
index 497480f8d2..0def278789 100644
--- a/pvlib/tests/test_shading.py
+++ b/pvlib/tests/test_shading.py
@@ -115,8 +115,8 @@ def true_tracking_angle_and_inputs():
     # Trackers
     # doi.org/10.2172/1660126 ; Accessed on 2023-11-06.
     tzinfo = timezone(timedelta(hours=-5))
-    array_tilt_angle = 9.666  # deg
-    array_azimuth_angle = 195.0  # deg
+    axis_tilt_angle = 9.666  # deg
+    axis_azimuth_angle = 195.0  # deg
     timedata = pd.DataFrame(
         columns=("Apparent Elevation", "Solar Azimuth", "True-Tracking"),
         data=(
@@ -136,15 +136,15 @@ def true_tracking_angle_and_inputs():
         "2019-01-01T08", "2019-01-01T17", freq="1H", tz=tzinfo
     )
     timedata["Apparent Zenith"] = 90.0 - timedata["Apparent Elevation"]
-    return (array_tilt_angle, array_azimuth_angle, timedata)
+    return (axis_tilt_angle, axis_azimuth_angle, timedata)
 
 
 def test_projected_solar_zenith_angle_numeric(true_tracking_angle_and_inputs):
     psz_func = shading.projected_solar_zenith_angle
-    array_tilt, array_azimuth, timedata = true_tracking_angle_and_inputs
+    axis_tilt, axis_azimuth, timedata = true_tracking_angle_and_inputs
     psz = psz_func(
-        array_tilt,
-        array_azimuth,
+        axis_tilt,
+        axis_azimuth,
         timedata["Apparent Elevation"],
         timedata["Solar Azimuth"],
     )
@@ -152,13 +152,13 @@ def test_projected_solar_zenith_angle_numeric(true_tracking_angle_and_inputs):
     # test equivalence against pvlib.tracking.singleaxis
     singleaxis = pvlib.tracking.singleaxis(timedata["Apparent Zenith"],
                                            timedata["Solar Azimuth"],
-                                           array_tilt, array_azimuth,
+                                           axis_tilt, axis_azimuth,
                                            backtrack=False)
     assert_allclose(psz, singleaxis["tracker_theta"])
     # test by changing axis azimuth and tilt
     psz = psz_func(
-        -array_tilt,
-        array_azimuth-180,
+        -axis_tilt,
+        axis_azimuth-180,
         timedata["Apparent Elevation"],
         timedata["Solar Azimuth"],
     )
@@ -169,7 +169,7 @@ def test_projected_solar_zenith_angle_numeric(true_tracking_angle_and_inputs):
     "cast_type, cast_func",
     [
         (float, float),
-        (np.ndarray, lambda x: np.array([x])),
+        (np.ndaxis, lambda x: np.axis([x])),
         (pd.Series, lambda x: pd.Series(data=[x])),
     ],
 )
@@ -177,17 +177,17 @@ def test_projected_solar_zenith_angle_dataypes(
     cast_type, cast_func, true_tracking_angle_and_inputs
 ):
     psz_func = shading.projected_solar_zenith_angle
-    array_tilt, array_azimuth, timedata = true_tracking_angle_and_inputs
+    axis_tilt, axis_azimuth, timedata = true_tracking_angle_and_inputs
     sun_apparent_zenith = timedata["Apparent Zenith"].iloc[0]
     sun_azimuth = timedata["Solar Azimuth"].iloc[0]
 
-    array_tilt, array_azimuth, sun_apparent_zenith, sun_azimuth = (
-        cast_func(array_tilt),
-        cast_func(array_azimuth),
+    axis_tilt, axis_azimuth, sun_apparent_zenith, sun_azimuth = (
+        cast_func(axis_tilt),
+        cast_func(axis_azimuth),
         cast_func(sun_apparent_zenith),
         cast_func(sun_azimuth),
     )
     psz = psz_func(
-        array_tilt, array_azimuth, sun_apparent_zenith, array_azimuth
+        axis_tilt, axis_azimuth, sun_apparent_zenith, axis_azimuth
     )
     assert isinstance(psz, cast_type)

From 62763824451bacf9fd970d9f4873a483644acb76 Mon Sep 17 00:00:00 2001
From: echedey-ls <80125792+echedey-ls@users.noreply.github.com>
Date: Thu, 9 Nov 2023 21:52:32 +0100
Subject: [PATCH 010/185] type

---
 pvlib/tests/test_shading.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/pvlib/tests/test_shading.py b/pvlib/tests/test_shading.py
index 0def278789..de28077877 100644
--- a/pvlib/tests/test_shading.py
+++ b/pvlib/tests/test_shading.py
@@ -173,7 +173,7 @@ def test_projected_solar_zenith_angle_numeric(true_tracking_angle_and_inputs):
         (pd.Series, lambda x: pd.Series(data=[x])),
     ],
 )
-def test_projected_solar_zenith_angle_dataypes(
+def test_projected_solar_zenith_angle_datatypes(
     cast_type, cast_func, true_tracking_angle_and_inputs
 ):
     psz_func = shading.projected_solar_zenith_angle

From 509699f3fb5eb0de7a10a34f77a27d18cca9ae24 Mon Sep 17 00:00:00 2001
From: echedey-ls <80125792+echedey-ls@users.noreply.github.com>
Date: Thu, 9 Nov 2023 21:56:31 +0100
Subject: [PATCH 011/185] Whatsnew

---
 docs/sphinx/source/whatsnew/v0.10.3.rst | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/docs/sphinx/source/whatsnew/v0.10.3.rst b/docs/sphinx/source/whatsnew/v0.10.3.rst
index 4d222fca06..87b6c72f1f 100644
--- a/docs/sphinx/source/whatsnew/v0.10.3.rst
+++ b/docs/sphinx/source/whatsnew/v0.10.3.rst
@@ -23,6 +23,8 @@ Enhancements
 * Add :py:func:`pvlib.iotools.read_solaranywhere` and
   :py:func:`pvlib.iotools.get_solaranywhere` for reading and retrieving
   SolarAnywhere solar irradiance data. (:pull:`1497`, :discuss:`1310`)
+* Added function :py:func:`pvlib.shading.projected_solar_zenith_angle`,
+  a common calculation in shading and tracking. (:issue:`1734`, :pull:`1904`)
 
 Bug fixes
 ~~~~~~~~~
@@ -73,3 +75,4 @@ Contributors
 * Mark Mikofski (:ghuser:`mikofski`)
 * Phoebe Pearce (:ghuser:`phoebe-p`)
 * Eva-Maria Grommes (:ghuser:`EwaGomez`)
+* Echedey Luis (:ghuser:`echedey-ls`)

From 5ff8fd8e8d5fbc199088f0c583961785acf068e0 Mon Sep 17 00:00:00 2001
From: echedey-ls <80125792+echedey-ls@users.noreply.github.com>
Date: Thu, 9 Nov 2023 21:58:37 +0100
Subject: [PATCH 012/185] xd

---
 pvlib/tests/test_shading.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/pvlib/tests/test_shading.py b/pvlib/tests/test_shading.py
index de28077877..006237b171 100644
--- a/pvlib/tests/test_shading.py
+++ b/pvlib/tests/test_shading.py
@@ -169,7 +169,7 @@ def test_projected_solar_zenith_angle_numeric(true_tracking_angle_and_inputs):
     "cast_type, cast_func",
     [
         (float, float),
-        (np.ndaxis, lambda x: np.axis([x])),
+        (np.ndarray, lambda x: np.axis([x])),
         (pd.Series, lambda x: pd.Series(data=[x])),
     ],
 )

From 04126e07ff1520ea4b4d8b97f0d2b26031757157 Mon Sep 17 00:00:00 2001
From: echedey-ls <80125792+echedey-ls@users.noreply.github.com>
Date: Thu, 9 Nov 2023 22:01:49 +0100
Subject: [PATCH 013/185] bruh

---
 pvlib/tests/test_shading.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/pvlib/tests/test_shading.py b/pvlib/tests/test_shading.py
index 006237b171..e86926a865 100644
--- a/pvlib/tests/test_shading.py
+++ b/pvlib/tests/test_shading.py
@@ -169,7 +169,7 @@ def test_projected_solar_zenith_angle_numeric(true_tracking_angle_and_inputs):
     "cast_type, cast_func",
     [
         (float, float),
-        (np.ndarray, lambda x: np.axis([x])),
+        (np.ndarray, lambda x: np.array([x])),
         (pd.Series, lambda x: pd.Series(data=[x])),
     ],
 )

From 607a24605f7fe8532e3cd6da42eb7ff0f3d10271 Mon Sep 17 00:00:00 2001
From: echedey-ls <80125792+echedey-ls@users.noreply.github.com>
Date: Thu, 9 Nov 2023 22:05:12 +0100
Subject: [PATCH 014/185] Minor Python optimization a la tracking.singleaxis

---
 pvlib/shading.py | 9 ++++++---
 1 file changed, 6 insertions(+), 3 deletions(-)

diff --git a/pvlib/shading.py b/pvlib/shading.py
index 165e54e90c..9ed7647218 100644
--- a/pvlib/shading.py
+++ b/pvlib/shading.py
@@ -276,10 +276,13 @@ def projected_solar_zenith_angle(surface_tilt, surface_azimuth,
     sx = cosd(solar_apparent_elevation) * sind(solar_azimuth)
     sy = cosd(solar_apparent_elevation) * cosd(solar_azimuth)
     sz = sind(solar_apparent_elevation)
-    sx_prime = sx * cosd(surface_azimuth) - sy * sind(surface_azimuth)
+    cosd_surface_azimuth = cosd(surface_azimuth)
+    sind_surface_azimuth = sind(surface_azimuth)
+    sind_surface_tilt = sind(surface_tilt)
+    sx_prime = sx * cosd_surface_azimuth - sy * sind_surface_azimuth
     sz_prime = (
-        sx * sind(surface_azimuth) * sind(surface_tilt)
-        + sy * sind(surface_tilt) * cosd(surface_azimuth)
+        sx * sind_surface_azimuth * sind_surface_tilt
+        + sy * sind_surface_tilt * cosd_surface_azimuth
         + sz * cosd(surface_tilt)
     )
     theta_T = np.degrees(np.arctan2(sx_prime, sz_prime))

From 240b55190bd9542b46b3780f91d038cff9e3f2f1 Mon Sep 17 00:00:00 2001
From: echedey-ls <80125792+echedey-ls@users.noreply.github.com>
Date: Thu, 9 Nov 2023 22:19:38 +0100
Subject: [PATCH 015/185] Comment and minor optimizations

---
 pvlib/shading.py | 14 ++++++++++----
 1 file changed, 10 insertions(+), 4 deletions(-)

diff --git a/pvlib/shading.py b/pvlib/shading.py
index 9ed7647218..145f0f2590 100644
--- a/pvlib/shading.py
+++ b/pvlib/shading.py
@@ -272,18 +272,24 @@ def projected_solar_zenith_angle(surface_tilt, surface_azimuth,
        Progress in Photovoltaics: Research and Applications, vol. 19, no. 6,
        pp. 747–753, 2011, :doi:`10.1002/pip.1085`.
     """
-    # Notation from [1]
-    sx = cosd(solar_apparent_elevation) * sind(solar_azimuth)
-    sy = cosd(solar_apparent_elevation) * cosd(solar_azimuth)
-    sz = sind(solar_apparent_elevation)
+    # Avoid recalculating these values
+    cosd_solar_apparent_elevation = cosd(solar_apparent_elevation)
     cosd_surface_azimuth = cosd(surface_azimuth)
     sind_surface_azimuth = sind(surface_azimuth)
     sind_surface_tilt = sind(surface_tilt)
+
+    # Notation from [1]
+    # Sun's x, y, z coords
+    sx = cosd_solar_apparent_elevation * sind(solar_azimuth)
+    sy = cosd_solar_apparent_elevation * cosd(solar_azimuth)
+    sz = sind(solar_apparent_elevation)
+    # Eq. (4); sx', sz' values from sun coordinates projected onto surface
     sx_prime = sx * cosd_surface_azimuth - sy * sind_surface_azimuth
     sz_prime = (
         sx * sind_surface_azimuth * sind_surface_tilt
         + sy * sind_surface_tilt * cosd_surface_azimuth
         + sz * cosd(surface_tilt)
     )
+    # Eq. (5); angle between sun's beam and surface
     theta_T = np.degrees(np.arctan2(sx_prime, sz_prime))
     return theta_T

From 997def6afa533035a3369f0c05f7f861267271a7 Mon Sep 17 00:00:00 2001
From: echedey-ls <80125792+echedey-ls@users.noreply.github.com>
Date: Thu, 9 Nov 2023 22:50:19 +0100
Subject: [PATCH 016/185] Surface -> Axis

Co-Authored-By: Kevin Anderson <57452607+kandersolar@users.noreply.github.com>
---
 pvlib/shading.py | 20 ++++++++++----------
 1 file changed, 10 insertions(+), 10 deletions(-)

diff --git a/pvlib/shading.py b/pvlib/shading.py
index 145f0f2590..f48a54ad3d 100644
--- a/pvlib/shading.py
+++ b/pvlib/shading.py
@@ -234,7 +234,7 @@ def sky_diffuse_passias(masking_angle):
     return 1 - cosd(masking_angle/2)**2
 
 
-def projected_solar_zenith_angle(surface_tilt, surface_azimuth,
+def projected_solar_zenith_angle(axis_tilt, axis_azimuth,
                                  solar_apparent_elevation, solar_azimuth):
     r"""
     Calculate projected solar zenith angle in degrees.
@@ -243,9 +243,9 @@ def projected_solar_zenith_angle(surface_tilt, surface_azimuth,
 
     Parameters
     ----------
-    surface_tilt : numeric
+    axis_tilt : numeric
         Axis tilt angle in degrees. From horizontal plane to array plane.
-    surface_azimuth : numeric
+    axis_azimuth : numeric
         Axis azimuth angle in degrees.
         North = 0°; East = 90°; South = 180°; West = 270°
     solar_apparent_elevation : numeric
@@ -274,9 +274,9 @@ def projected_solar_zenith_angle(surface_tilt, surface_azimuth,
     """
     # Avoid recalculating these values
     cosd_solar_apparent_elevation = cosd(solar_apparent_elevation)
-    cosd_surface_azimuth = cosd(surface_azimuth)
-    sind_surface_azimuth = sind(surface_azimuth)
-    sind_surface_tilt = sind(surface_tilt)
+    cosd_axis_azimuth = cosd(axis_azimuth)
+    sind_axis_azimuth = sind(axis_azimuth)
+    sind_axis_tilt = sind(axis_tilt)
 
     # Notation from [1]
     # Sun's x, y, z coords
@@ -284,11 +284,11 @@ def projected_solar_zenith_angle(surface_tilt, surface_azimuth,
     sy = cosd_solar_apparent_elevation * cosd(solar_azimuth)
     sz = sind(solar_apparent_elevation)
     # Eq. (4); sx', sz' values from sun coordinates projected onto surface
-    sx_prime = sx * cosd_surface_azimuth - sy * sind_surface_azimuth
+    sx_prime = sx * cosd_axis_azimuth - sy * sind_axis_azimuth
     sz_prime = (
-        sx * sind_surface_azimuth * sind_surface_tilt
-        + sy * sind_surface_tilt * cosd_surface_azimuth
-        + sz * cosd(surface_tilt)
+        sx * sind_axis_azimuth * sind_axis_tilt
+        + sy * sind_axis_tilt * cosd_axis_azimuth
+        + sz * cosd(axis_tilt)
     )
     # Eq. (5); angle between sun's beam and surface
     theta_T = np.degrees(np.arctan2(sx_prime, sz_prime))

From 79120556b9e160556e96b2648bb22374fb51c5a2 Mon Sep 17 00:00:00 2001
From: echedey-ls <80125792+echedey-ls@users.noreply.github.com>
Date: Thu, 9 Nov 2023 23:13:03 +0100
Subject: [PATCH 017/185] Elevation -> Zenith

Co-Authored-By: Kevin Anderson <57452607+kandersolar@users.noreply.github.com>
---
 pvlib/shading.py | 18 ++++++++++--------
 1 file changed, 10 insertions(+), 8 deletions(-)

diff --git a/pvlib/shading.py b/pvlib/shading.py
index f48a54ad3d..b7c6b02f4e 100644
--- a/pvlib/shading.py
+++ b/pvlib/shading.py
@@ -235,7 +235,7 @@ def sky_diffuse_passias(masking_angle):
 
 
 def projected_solar_zenith_angle(axis_tilt, axis_azimuth,
-                                 solar_apparent_elevation, solar_azimuth):
+                                 solar_zenith, solar_azimuth):
     r"""
     Calculate projected solar zenith angle in degrees.
 
@@ -248,8 +248,8 @@ def projected_solar_zenith_angle(axis_tilt, axis_azimuth,
     axis_azimuth : numeric
         Axis azimuth angle in degrees.
         North = 0°; East = 90°; South = 180°; West = 270°
-    solar_apparent_elevation : numeric
-        Sun's apparent elevation in degrees.
+    solar_zenith : numeric
+        Sun's apparent zenith in degrees.
     solar_azimuth : numeric
         Sun's azimuth in degrees.
 
@@ -272,17 +272,19 @@ def projected_solar_zenith_angle(axis_tilt, axis_azimuth,
        Progress in Photovoltaics: Research and Applications, vol. 19, no. 6,
        pp. 747–753, 2011, :doi:`10.1002/pip.1085`.
     """
+    # Notation from [1], modified to use zenith instead of elevation
+    # Since elevation = 90 - zenith, sin(90-x) = cos(x) & cos(90-x) = sin(x):
+    # cos(elevation) = sin(zenith) and sin(elevation) = cos(zenith)
     # Avoid recalculating these values
-    cosd_solar_apparent_elevation = cosd(solar_apparent_elevation)
+    sind_solar_zenith = sind(solar_zenith)
     cosd_axis_azimuth = cosd(axis_azimuth)
     sind_axis_azimuth = sind(axis_azimuth)
     sind_axis_tilt = sind(axis_tilt)
 
-    # Notation from [1]
     # Sun's x, y, z coords
-    sx = cosd_solar_apparent_elevation * sind(solar_azimuth)
-    sy = cosd_solar_apparent_elevation * cosd(solar_azimuth)
-    sz = sind(solar_apparent_elevation)
+    sx = sind_solar_zenith * sind(solar_azimuth)
+    sy = sind_solar_zenith * cosd(solar_azimuth)
+    sz = cosd(solar_zenith)
     # Eq. (4); sx', sz' values from sun coordinates projected onto surface
     sx_prime = sx * cosd_axis_azimuth - sy * sind_axis_azimuth
     sz_prime = (

From f068e3e7e6b8d848c1382caeb7804f6be012bd44 Mon Sep 17 00:00:00 2001
From: echedey-ls <80125792+echedey-ls@users.noreply.github.com>
Date: Thu, 9 Nov 2023 23:27:09 +0100
Subject: [PATCH 018/185] Elev -> Zenith

Co-Authored-By: Kevin Anderson <57452607+kandersolar@users.noreply.github.com>
---
 pvlib/tests/test_shading.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/pvlib/tests/test_shading.py b/pvlib/tests/test_shading.py
index e86926a865..0e44a42354 100644
--- a/pvlib/tests/test_shading.py
+++ b/pvlib/tests/test_shading.py
@@ -145,7 +145,7 @@ def test_projected_solar_zenith_angle_numeric(true_tracking_angle_and_inputs):
     psz = psz_func(
         axis_tilt,
         axis_azimuth,
-        timedata["Apparent Elevation"],
+        timedata["Apparent Zenith"],
         timedata["Solar Azimuth"],
     )
     assert_allclose(psz, timedata["True-Tracking"], atol=1e-3)
@@ -159,7 +159,7 @@ def test_projected_solar_zenith_angle_numeric(true_tracking_angle_and_inputs):
     psz = psz_func(
         -axis_tilt,
         axis_azimuth-180,
-        timedata["Apparent Elevation"],
+        timedata["Apparent Zenith"],
         timedata["Solar Azimuth"],
     )
     assert_allclose(psz, -timedata["True-Tracking"], atol=1e-3)

From a5f4a850ea83514a5d1babc167f950207103b2b4 Mon Sep 17 00:00:00 2001
From: echedey-ls <80125792+echedey-ls@users.noreply.github.com>
Date: Wed, 24 Jan 2024 22:14:41 +0100
Subject: [PATCH 019/185] Update shading.py

---
 pvlib/shading.py | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/pvlib/shading.py b/pvlib/shading.py
index b7c6b02f4e..c19b9a4423 100644
--- a/pvlib/shading.py
+++ b/pvlib/shading.py
@@ -260,17 +260,17 @@ def projected_solar_zenith_angle(axis_tilt, axis_azimuth,
 
     References
     ----------
-    .. [1] K. Anderson and M. Mikofski, ‘Slope-Aware Backtracking for
-       Single-Axis Trackers’, National Renewable Energy Lab. (NREL), Golden,
+    .. [1] K. Anderson and M. Mikofski, 'Slope-Aware Backtracking for
+       Single-Axis Trackers', National Renewable Energy Lab. (NREL), Golden,
        CO (United States); Det Norske Veritas Group, Oslo (Norway),
        NREL/TP-5K00-76626, Jul. 2020. :doi:`10.2172/1660126`.
-    .. [2] W. F. Marion and A. P. Dobos, ‘Rotation Angle for the Optimum
-       Tracking of One-Axis Trackers’, National Renewable Energy Lab. (NREL),
+    .. [2] W. F. Marion and A. P. Dobos, 'Rotation Angle for the Optimum
+       Tracking of One-Axis Trackers', National Renewable Energy Lab. (NREL),
        Golden, CO (United States), NREL/TP-6A20-58891, Jul. 2013.
        :doi:`10.2172/1089596`.
-    .. [3] E. Lorenzo, L. Narvarte, and J. Muñoz, ‘Tracking and back-tracking’,
+    .. [3] E. Lorenzo, L. Narvarte, and J. Muñoz, 'Tracking and back-tracking',
        Progress in Photovoltaics: Research and Applications, vol. 19, no. 6,
-       pp. 747–753, 2011, :doi:`10.1002/pip.1085`.
+       pp. 747-753, 2011, :doi:`10.1002/pip.1085`.
     """
     # Notation from [1], modified to use zenith instead of elevation
     # Since elevation = 90 - zenith, sin(90-x) = cos(x) & cos(90-x) = sin(x):

From a854e27f01a3ba28b13626bb6e325f13b1b20d0b Mon Sep 17 00:00:00 2001
From: echedey-ls <80125792+echedey-ls@users.noreply.github.com>
Date: Wed, 24 Jan 2024 23:02:39 +0100
Subject: [PATCH 020/185] Update docstring

Co-Authored-By: Anton Driesse <9001027+adriesse@users.noreply.github.com>
---
 pvlib/shading.py | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/pvlib/shading.py b/pvlib/shading.py
index c19b9a4423..00bac7397d 100644
--- a/pvlib/shading.py
+++ b/pvlib/shading.py
@@ -238,8 +238,11 @@ def projected_solar_zenith_angle(axis_tilt, axis_azimuth,
                                  solar_zenith, solar_azimuth):
     r"""
     Calculate projected solar zenith angle in degrees.
+    This is the solar zenith angle projected onto the tracker rotation plane or
+    the plane defined by its normal vector and the azimuth.
 
-    This is common in track and shadow computation [1]_ [2]_ [3]_.
+    Computing said value is common in track and shadow algorithms.
+    See [1]_ [2]_ [3]_.
 
     Parameters
     ----------

From 2d82375c37952acfb0785093b49ea914705bfe8a Mon Sep 17 00:00:00 2001
From: echedey-ls <80125792+echedey-ls@users.noreply.github.com>
Date: Wed, 24 Jan 2024 23:25:56 +0100
Subject: [PATCH 021/185] Add comments from `tracking.singleaxis`

Co-Authored-By: Will Holmgren <william.holmgren@gmail.com>
Co-Authored-By: Mark Mikofski <bwana.marko@yahoo.com>
---
 pvlib/shading.py | 17 ++++++++++++++++-
 1 file changed, 16 insertions(+), 1 deletion(-)

diff --git a/pvlib/shading.py b/pvlib/shading.py
index 00bac7397d..3665bbdf35 100644
--- a/pvlib/shading.py
+++ b/pvlib/shading.py
@@ -275,8 +275,15 @@ def projected_solar_zenith_angle(axis_tilt, axis_azimuth,
        Progress in Photovoltaics: Research and Applications, vol. 19, no. 6,
        pp. 747-753, 2011, :doi:`10.1002/pip.1085`.
     """
-    # Notation from [1], modified to use zenith instead of elevation
+    # Assume the tracker reference frame is right-handed. Positive y-axis is
+    # oriented along tracking axis; from north, the y-axis is rotated clockwise
+    # by the axis azimuth and tilted from horizontal by the axis tilt. The
+    # positive x-axis is 90 deg clockwise from the y-axis and parallel to
+    # horizontal (e.g., if the y-axis is south, the x-axis is west); the
+    # positive z-axis is normal to the x and y axes, pointed upward.
+
     # Since elevation = 90 - zenith, sin(90-x) = cos(x) & cos(90-x) = sin(x):
+    # Notation from [1], modified to use zenith instead of elevation
     # cos(elevation) = sin(zenith) and sin(elevation) = cos(zenith)
     # Avoid recalculating these values
     sind_solar_zenith = sind(solar_zenith)
@@ -295,6 +302,14 @@ def projected_solar_zenith_angle(axis_tilt, axis_azimuth,
         + sy * sind_axis_tilt * cosd_axis_azimuth
         + sz * cosd(axis_tilt)
     )
+    # The ideal tracking angle wid is the rotation to place the sun position
+    # vector (xp, yp, zp) in the (x, z) plane, which is normal to the panel and
+    # contains the axis of rotation.  wid = 0 indicates that the panel is
+    # horizontal. Here, our convention is that a clockwise rotation is
+    # positive, to view rotation angles in the same frame of reference as
+    # azimuth. For example, for a system with tracking axis oriented south, a
+    # rotation toward the east is negative, and a rotation to the west is
+    # positive. This is a right-handed rotation around the tracker y-axis.
     # Eq. (5); angle between sun's beam and surface
     theta_T = np.degrees(np.arctan2(sx_prime, sz_prime))
     return theta_T

From 5f2472168c2a28fe57666ba7bd3fb276edd320c3 Mon Sep 17 00:00:00 2001
From: echedey-ls <80125792+echedey-ls@users.noreply.github.com>
Date: Thu, 25 Jan 2024 17:18:58 +0100
Subject: [PATCH 022/185] Singleaxis implementation port & test addition, based
 on old pvlib.tracking.singleaxis

---
 pvlib/shading.py            |  3 +-
 pvlib/tests/test_shading.py | 98 ++++++++++++++++++++++++++++++-------
 2 files changed, 81 insertions(+), 20 deletions(-)

diff --git a/pvlib/shading.py b/pvlib/shading.py
index 3665bbdf35..0bd7affa40 100644
--- a/pvlib/shading.py
+++ b/pvlib/shading.py
@@ -234,8 +234,7 @@ def sky_diffuse_passias(masking_angle):
     return 1 - cosd(masking_angle/2)**2
 
 
-def projected_solar_zenith_angle(axis_tilt, axis_azimuth,
-                                 solar_zenith, solar_azimuth):
+def projected_solar_zenith_angle(axis_tilt, axis_azimuth, solar_zenith, solar_azimuth):
     r"""
     Calculate projected solar zenith angle in degrees.
     This is the solar zenith angle projected onto the tracker rotation plane or
diff --git a/pvlib/tests/test_shading.py b/pvlib/tests/test_shading.py
index 0e44a42354..1ecfb8d03a 100644
--- a/pvlib/tests/test_shading.py
+++ b/pvlib/tests/test_shading.py
@@ -110,9 +110,8 @@ def test_sky_diffuse_passias_scalar(average_masking_angle, shading_loss):
 
 
 @pytest.fixture
-def true_tracking_angle_and_inputs():
-    # data retrieved from NREL Slope-Aware Backtracking for Single-Axis
-    # Trackers
+def true_tracking_angle_and_inputs_NREL():
+    # data from NREL 'Slope-Aware Backtracking for Single-Axis Trackers'
     # doi.org/10.2172/1660126 ; Accessed on 2023-11-06.
     tzinfo = timezone(timedelta(hours=-5))
     axis_tilt_angle = 9.666  # deg
@@ -139,9 +138,69 @@ def true_tracking_angle_and_inputs():
     return (axis_tilt_angle, axis_azimuth_angle, timedata)
 
 
-def test_projected_solar_zenith_angle_numeric(true_tracking_angle_and_inputs):
+@pytest.fixture
+def singleaxis_psz_implementation_port_data():
+    # data generated with the PSZ angle implementation in tracking.singleaxis
+    # See GitHub issue #1734 & PR #1904
+    axis_tilt_angle = 12.224
+    axis_azimuth_angle = 187.2
+
+    singleaxis_result = pd.DataFrame(
+        columns=[
+            "Apparent Zenith",
+            "Solar Azimuth",
+            "tracker_theta",
+            "surface_azimuth",
+            "surface_tilt",
+        ],
+        data=[
+            [88.86131915, 116.14911543, -84.67346, 98.330924, 84.794565],
+            [85.67558254, 119.46577753, -80.544188, 99.219659, 80.760477],
+            [82.4784391, 122.90558458, -76.226064, 100.171259, 76.5443],
+            [79.37555806, 126.48822166, -71.79054, 101.184411, 72.217365],
+            [76.40491865, 130.23239671, -67.237442, 102.276947, 67.781439],
+            [73.59273783, 134.15525777, -62.55178, 103.476096, 63.224495],
+            [70.96318968, 138.2715258, -57.713941, 104.819827, 58.53107],
+            [68.54068323, 142.59233032, -52.702658, 106.361922, 53.685798],
+            [66.35031258, 147.12377575, -47.496592, 108.18131, 48.676053],
+            [64.41759166, 151.8653323, -42.07579, 110.39903, 43.495367],
+            [62.76775062, 156.80824414, -36.423404, 113.210504, 38.148938],
+            [61.42469841, 161.9342438, -30.527799, 116.950922, 32.663696],
+            [60.40974474, 167.21493901, -24.385012, 122.236817, 27.108957],
+            [59.74022062, 172.61222482, -18.001341, 130.288224, 21.645102],
+            [59.42818646, 178.07994717, -11.395651, 143.610698, 16.652493],
+            [59.47944177, 183.56677914, -4.600779, 166.390187, 13.048796],
+            [59.89302187, 189.01995634, 2.336615, 198.108, 12.441979],
+            [60.66128258, 194.38926277, 9.358232, 225.094855, 15.351466],
+            [61.77055542, 199.63057627, 16.398369, 241.465486, 20.352345],
+            [63.20224386, 204.70842576, 23.389598, 251.116742, 26.231294],
+            [64.93416116, 209.59729217, 30.268795, 257.259578, 32.425598],
+            [66.94189859, 214.28170196, 36.982274, 261.49605, 38.674352],
+            [69.20004673, 218.75538494, 43.489104, 264.617474, 44.841832],
+            [71.68314725, 223.01986867, 49.762279, 267.042188, 50.852813],
+            [74.36628597, 227.08285659, 55.787916, 269.007999, 56.666604],
+            [77.22520074, 230.95665462, 61.562937, 270.658956, 62.264111],
+            [80.23550305, 234.65680797, 67.091395, 272.086933, 67.639267],
+            [83.3693091, 238.20102038, 72.378024, 273.352342, 72.790188],
+            [86.57992299, 241.60837123, 77.408775, 274.492262, 77.698775],
+            [89.70940444, 244.89880789, 82.045935, 275.505443, 82.227402],
+        ],
+    )
+    singleaxis_result.index = pd.date_range(
+        "2024-01-25 08:40",
+        "2024-01-25 18:20",
+        freq="20min",
+        tz=timezone(timedelta(hours=1)),
+    )
+    return (axis_tilt_angle, axis_azimuth_angle, singleaxis_result)
+
+
+def test_projected_solar_zenith_angle_numeric(
+    true_tracking_angle_and_inputs_NREL, singleaxis_psz_implementation_port_data
+):
     psz_func = shading.projected_solar_zenith_angle
-    axis_tilt, axis_azimuth, timedata = true_tracking_angle_and_inputs
+    axis_tilt, axis_azimuth, timedata = true_tracking_angle_and_inputs_NREL
+    # test against data provided by NREL
     psz = psz_func(
         axis_tilt,
         axis_azimuth,
@@ -149,35 +208,40 @@ def test_projected_solar_zenith_angle_numeric(true_tracking_angle_and_inputs):
         timedata["Solar Azimuth"],
     )
     assert_allclose(psz, timedata["True-Tracking"], atol=1e-3)
-    # test equivalence against pvlib.tracking.singleaxis
-    singleaxis = pvlib.tracking.singleaxis(timedata["Apparent Zenith"],
-                                           timedata["Solar Azimuth"],
-                                           axis_tilt, axis_azimuth,
-                                           backtrack=False)
-    assert_allclose(psz, singleaxis["tracker_theta"])
     # test by changing axis azimuth and tilt
     psz = psz_func(
         -axis_tilt,
-        axis_azimuth-180,
+        axis_azimuth - 180,
         timedata["Apparent Zenith"],
         timedata["Solar Azimuth"],
     )
     assert_allclose(psz, -timedata["True-Tracking"], atol=1e-3)
 
+    # test implementation port from tracking.singleaxis
+    axis_tilt, axis_azimuth, singleaxis = singleaxis_psz_implementation_port_data
+    psz = pvlib.tracking.singleaxis(
+        singleaxis["Apparent Zenith"],
+        singleaxis["Solar Azimuth"],
+        axis_tilt,
+        axis_azimuth,
+        backtrack=False,
+    )
+    assert_allclose(psz["tracker_theta"], singleaxis["tracker_theta"], atol=1e-6)
+
 
 @pytest.mark.parametrize(
     "cast_type, cast_func",
     [
-        (float, float),
+        (float, lambda x: float(x)),
         (np.ndarray, lambda x: np.array([x])),
         (pd.Series, lambda x: pd.Series(data=[x])),
     ],
 )
 def test_projected_solar_zenith_angle_datatypes(
-    cast_type, cast_func, true_tracking_angle_and_inputs
+    cast_type, cast_func, true_tracking_angle_and_inputs_NREL
 ):
     psz_func = shading.projected_solar_zenith_angle
-    axis_tilt, axis_azimuth, timedata = true_tracking_angle_and_inputs
+    axis_tilt, axis_azimuth, timedata = true_tracking_angle_and_inputs_NREL
     sun_apparent_zenith = timedata["Apparent Zenith"].iloc[0]
     sun_azimuth = timedata["Solar Azimuth"].iloc[0]
 
@@ -187,7 +251,5 @@ def test_projected_solar_zenith_angle_datatypes(
         cast_func(sun_apparent_zenith),
         cast_func(sun_azimuth),
     )
-    psz = psz_func(
-        axis_tilt, axis_azimuth, sun_apparent_zenith, axis_azimuth
-    )
+    psz = psz_func(axis_tilt, axis_azimuth, sun_apparent_zenith, axis_azimuth)
     assert isinstance(psz, cast_type)

From 049a8cc27c43c53828d7b0f1882f15b2b6eeff66 Mon Sep 17 00:00:00 2001
From: echedey-ls <80125792+echedey-ls@users.noreply.github.com>
Date: Thu, 25 Jan 2024 17:21:45 +0100
Subject: [PATCH 023/185] Update v0.10.4.rst

---
 docs/sphinx/source/whatsnew/v0.10.4.rst | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/docs/sphinx/source/whatsnew/v0.10.4.rst b/docs/sphinx/source/whatsnew/v0.10.4.rst
index 30abfbfe2a..c61ce8c658 100644
--- a/docs/sphinx/source/whatsnew/v0.10.4.rst
+++ b/docs/sphinx/source/whatsnew/v0.10.4.rst
@@ -14,6 +14,8 @@ Enhancements
   the SOLRAD ground station network. (:pull:`1967`)
 * Added metadata parsing to :py:func:`~pvlib.iotools.read_solrad` to follow the standard iotools
   convention of returning a tuple of (data, meta). Previously the function only returned a dataframe. (:pull:`1968`)
+* Added function :py:func:`pvlib.shading.projected_solar_zenith_angle`,
+  a common calculation in shading and tracking. (:issue:`1734`, :pull:`1904`)
 
 
 Bug fixes

From a3185df3b4d5d42a347ff3efe6933932edbea5bb Mon Sep 17 00:00:00 2001
From: echedey-ls <80125792+echedey-ls@users.noreply.github.com>
Date: Thu, 25 Jan 2024 17:26:16 +0100
Subject: [PATCH 024/185] Linter

---
 pvlib/shading.py            |  3 ++-
 pvlib/tests/test_shading.py | 12 +++++++++---
 2 files changed, 11 insertions(+), 4 deletions(-)

diff --git a/pvlib/shading.py b/pvlib/shading.py
index 0bd7affa40..3665bbdf35 100644
--- a/pvlib/shading.py
+++ b/pvlib/shading.py
@@ -234,7 +234,8 @@ def sky_diffuse_passias(masking_angle):
     return 1 - cosd(masking_angle/2)**2
 
 
-def projected_solar_zenith_angle(axis_tilt, axis_azimuth, solar_zenith, solar_azimuth):
+def projected_solar_zenith_angle(axis_tilt, axis_azimuth,
+                                 solar_zenith, solar_azimuth):
     r"""
     Calculate projected solar zenith angle in degrees.
     This is the solar zenith angle projected onto the tracker rotation plane or
diff --git a/pvlib/tests/test_shading.py b/pvlib/tests/test_shading.py
index 1ecfb8d03a..85e2335bae 100644
--- a/pvlib/tests/test_shading.py
+++ b/pvlib/tests/test_shading.py
@@ -196,7 +196,8 @@ def singleaxis_psz_implementation_port_data():
 
 
 def test_projected_solar_zenith_angle_numeric(
-    true_tracking_angle_and_inputs_NREL, singleaxis_psz_implementation_port_data
+    true_tracking_angle_and_inputs_NREL,
+    singleaxis_psz_implementation_port_data
 ):
     psz_func = shading.projected_solar_zenith_angle
     axis_tilt, axis_azimuth, timedata = true_tracking_angle_and_inputs_NREL
@@ -218,7 +219,8 @@ def test_projected_solar_zenith_angle_numeric(
     assert_allclose(psz, -timedata["True-Tracking"], atol=1e-3)
 
     # test implementation port from tracking.singleaxis
-    axis_tilt, axis_azimuth, singleaxis = singleaxis_psz_implementation_port_data
+    axis_tilt, axis_azimuth, singleaxis = \
+        singleaxis_psz_implementation_port_data
     psz = pvlib.tracking.singleaxis(
         singleaxis["Apparent Zenith"],
         singleaxis["Solar Azimuth"],
@@ -226,7 +228,11 @@ def test_projected_solar_zenith_angle_numeric(
         axis_azimuth,
         backtrack=False,
     )
-    assert_allclose(psz["tracker_theta"], singleaxis["tracker_theta"], atol=1e-6)
+    assert_allclose(
+        psz["tracker_theta"],
+        singleaxis["tracker_theta"],
+        atol=1e-6
+    )
 
 
 @pytest.mark.parametrize(

From b9f1a7696f341a3a344460d16e696a4fbc261a69 Mon Sep 17 00:00:00 2001
From: echedey-ls <80125792+echedey-ls@users.noreply.github.com>
Date: Thu, 25 Jan 2024 21:06:24 +0100
Subject: [PATCH 025/185] Code review

Co-Authored-By: Cliff Hansen <5393711+cwhanse@users.noreply.github.com>
---
 pvlib/shading.py | 25 +++++--------------------
 1 file changed, 5 insertions(+), 20 deletions(-)

diff --git a/pvlib/shading.py b/pvlib/shading.py
index 3665bbdf35..a19e02369a 100644
--- a/pvlib/shading.py
+++ b/pvlib/shading.py
@@ -238,11 +238,11 @@ def projected_solar_zenith_angle(axis_tilt, axis_azimuth,
                                  solar_zenith, solar_azimuth):
     r"""
     Calculate projected solar zenith angle in degrees.
-    This is the solar zenith angle projected onto the tracker rotation plane or
-    the plane defined by its normal vector and the azimuth.
 
-    Computing said value is common in track and shadow algorithms.
-    See [1]_ [2]_ [3]_.
+    This solar zenith angle is projected onto the plane whose normal vector is
+    defined by ``axis_tilt`` and ``axis_azimuth``. The normal vector is in the
+    direction of ``axis_azimuth`` (clockwise from north) and tilted from
+    horizontal by ``axis_tilt``. See Figure 5 in [1]_.
 
     Parameters
     ----------
@@ -265,15 +265,8 @@ def projected_solar_zenith_angle(axis_tilt, axis_azimuth,
     ----------
     .. [1] K. Anderson and M. Mikofski, 'Slope-Aware Backtracking for
        Single-Axis Trackers', National Renewable Energy Lab. (NREL), Golden,
-       CO (United States); Det Norske Veritas Group, Oslo (Norway),
+       CO (United States);
        NREL/TP-5K00-76626, Jul. 2020. :doi:`10.2172/1660126`.
-    .. [2] W. F. Marion and A. P. Dobos, 'Rotation Angle for the Optimum
-       Tracking of One-Axis Trackers', National Renewable Energy Lab. (NREL),
-       Golden, CO (United States), NREL/TP-6A20-58891, Jul. 2013.
-       :doi:`10.2172/1089596`.
-    .. [3] E. Lorenzo, L. Narvarte, and J. Muñoz, 'Tracking and back-tracking',
-       Progress in Photovoltaics: Research and Applications, vol. 19, no. 6,
-       pp. 747-753, 2011, :doi:`10.1002/pip.1085`.
     """
     # Assume the tracker reference frame is right-handed. Positive y-axis is
     # oriented along tracking axis; from north, the y-axis is rotated clockwise
@@ -302,14 +295,6 @@ def projected_solar_zenith_angle(axis_tilt, axis_azimuth,
         + sy * sind_axis_tilt * cosd_axis_azimuth
         + sz * cosd(axis_tilt)
     )
-    # The ideal tracking angle wid is the rotation to place the sun position
-    # vector (xp, yp, zp) in the (x, z) plane, which is normal to the panel and
-    # contains the axis of rotation.  wid = 0 indicates that the panel is
-    # horizontal. Here, our convention is that a clockwise rotation is
-    # positive, to view rotation angles in the same frame of reference as
-    # azimuth. For example, for a system with tracking axis oriented south, a
-    # rotation toward the east is negative, and a rotation to the west is
-    # positive. This is a right-handed rotation around the tracker y-axis.
     # Eq. (5); angle between sun's beam and surface
     theta_T = np.degrees(np.arctan2(sx_prime, sz_prime))
     return theta_T

From f7d1d8042671b745a05668c46f2d651bf7b68951 Mon Sep 17 00:00:00 2001
From: echedey-ls <80125792+echedey-ls@users.noreply.github.com>
Date: Sat, 27 Jan 2024 01:12:49 +0100
Subject: [PATCH 026/185] Add Fig 5 [1] (still gotta check the built output)

---
 pvlib/shading.py | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/pvlib/shading.py b/pvlib/shading.py
index a19e02369a..cc2c41a56f 100644
--- a/pvlib/shading.py
+++ b/pvlib/shading.py
@@ -244,6 +244,10 @@ def projected_solar_zenith_angle(axis_tilt, axis_azimuth,
     direction of ``axis_azimuth`` (clockwise from north) and tilted from
     horizontal by ``axis_tilt``. See Figure 5 in [1]_.
 
+    .. image:: ../../_images/Anderson_Mikofski_2020_Fig5.jpg
+      :alt: Fig. 5: Solar coordinates projection onto tracker rotation plane.
+      :align: center
+
     Parameters
     ----------
     axis_tilt : numeric

From 1880f6ac0a988f41596dc37505ca4bebaa240c4e Mon Sep 17 00:00:00 2001
From: echedey-ls <80125792+echedey-ls@users.noreply.github.com>
Date: Sat, 27 Jan 2024 01:28:42 +0100
Subject: [PATCH 027/185] Add caption, change size and describe in alternate
 text

---
 pvlib/shading.py | 7 +++++--
 1 file changed, 5 insertions(+), 2 deletions(-)

diff --git a/pvlib/shading.py b/pvlib/shading.py
index cc2c41a56f..a163fcfca6 100644
--- a/pvlib/shading.py
+++ b/pvlib/shading.py
@@ -242,11 +242,14 @@ def projected_solar_zenith_angle(axis_tilt, axis_azimuth,
     This solar zenith angle is projected onto the plane whose normal vector is
     defined by ``axis_tilt`` and ``axis_azimuth``. The normal vector is in the
     direction of ``axis_azimuth`` (clockwise from north) and tilted from
-    horizontal by ``axis_tilt``. See Figure 5 in [1]_.
+    horizontal by ``axis_tilt``. See Figure 5 in [1]_:
 
     .. image:: ../../_images/Anderson_Mikofski_2020_Fig5.jpg
-      :alt: Fig. 5: Solar coordinates projection onto tracker rotation plane.
+      :alt: Wire diagram of coordinates systems to obtain the projected angle.
       :align: center
+      :scale: 75 %
+
+      Fig. 5, [1]_: Solar coordinates projection onto tracker rotation plane.
 
     Parameters
     ----------

From d9f242a36ed66ff284a66ba1b72fd240ac39c95c Mon Sep 17 00:00:00 2001
From: echedey-ls <80125792+echedey-ls@users.noreply.github.com>
Date: Sat, 27 Jan 2024 12:20:08 +0100
Subject: [PATCH 028/185] rST fixes ?

---
 pvlib/shading.py | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/pvlib/shading.py b/pvlib/shading.py
index a163fcfca6..38330461ba 100644
--- a/pvlib/shading.py
+++ b/pvlib/shading.py
@@ -245,11 +245,11 @@ def projected_solar_zenith_angle(axis_tilt, axis_azimuth,
     horizontal by ``axis_tilt``. See Figure 5 in [1]_:
 
     .. image:: ../../_images/Anderson_Mikofski_2020_Fig5.jpg
-      :alt: Wire diagram of coordinates systems to obtain the projected angle.
-      :align: center
-      :scale: 75 %
+       :alt: Wire diagram of coordinates systems to obtain the projected angle.
+       :align: center
+       :scale: 75 %
 
-      Fig. 5, [1]_: Solar coordinates projection onto tracker rotation plane.
+       Fig. 5, [1]_: Solar coordinates projection onto tracker rotation plane.
 
     Parameters
     ----------

From 379ca9593a00a439f579e82e55c3a7bcae7bb881 Mon Sep 17 00:00:00 2001
From: echedey-ls <80125792+echedey-ls@users.noreply.github.com>
Date: Sat, 27 Jan 2024 12:49:45 +0100
Subject: [PATCH 029/185] Figures have captions, images do not

https://pandemic-overview.readthedocs.io/en/latest/myGuides/reStructuredText-Images-and-Figures-Examples.html#id18
---
 pvlib/shading.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/pvlib/shading.py b/pvlib/shading.py
index 38330461ba..a11500d8c7 100644
--- a/pvlib/shading.py
+++ b/pvlib/shading.py
@@ -244,7 +244,7 @@ def projected_solar_zenith_angle(axis_tilt, axis_azimuth,
     direction of ``axis_azimuth`` (clockwise from north) and tilted from
     horizontal by ``axis_tilt``. See Figure 5 in [1]_:
 
-    .. image:: ../../_images/Anderson_Mikofski_2020_Fig5.jpg
+    .. figure:: ../../_images/Anderson_Mikofski_2020_Fig5.jpg
        :alt: Wire diagram of coordinates systems to obtain the projected angle.
        :align: center
        :scale: 75 %

From 62e99ad162a201c053eedec59a0009b902dbfcf6 Mon Sep 17 00:00:00 2001
From: echedey-ls <80125792+echedey-ls@users.noreply.github.com>
Date: Thu, 8 Feb 2024 23:01:36 +0100
Subject: [PATCH 030/185] Flip arguments order

---
 pvlib/shading.py            | 12 ++++++------
 pvlib/tests/test_shading.py | 14 +++++++-------
 2 files changed, 13 insertions(+), 13 deletions(-)

diff --git a/pvlib/shading.py b/pvlib/shading.py
index a11500d8c7..04d0d66ae8 100644
--- a/pvlib/shading.py
+++ b/pvlib/shading.py
@@ -234,8 +234,8 @@ def sky_diffuse_passias(masking_angle):
     return 1 - cosd(masking_angle/2)**2
 
 
-def projected_solar_zenith_angle(axis_tilt, axis_azimuth,
-                                 solar_zenith, solar_azimuth):
+def projected_solar_zenith_angle(solar_zenith, solar_azimuth,
+                                 axis_tilt, axis_azimuth):
     r"""
     Calculate projected solar zenith angle in degrees.
 
@@ -253,15 +253,15 @@ def projected_solar_zenith_angle(axis_tilt, axis_azimuth,
 
     Parameters
     ----------
+    solar_zenith : numeric
+        Sun's apparent zenith in degrees.
+    solar_azimuth : numeric
+        Sun's azimuth in degrees.
     axis_tilt : numeric
         Axis tilt angle in degrees. From horizontal plane to array plane.
     axis_azimuth : numeric
         Axis azimuth angle in degrees.
         North = 0°; East = 90°; South = 180°; West = 270°
-    solar_zenith : numeric
-        Sun's apparent zenith in degrees.
-    solar_azimuth : numeric
-        Sun's azimuth in degrees.
 
     Returns
     -------
diff --git a/pvlib/tests/test_shading.py b/pvlib/tests/test_shading.py
index 85e2335bae..35e1605ba9 100644
--- a/pvlib/tests/test_shading.py
+++ b/pvlib/tests/test_shading.py
@@ -203,18 +203,18 @@ def test_projected_solar_zenith_angle_numeric(
     axis_tilt, axis_azimuth, timedata = true_tracking_angle_and_inputs_NREL
     # test against data provided by NREL
     psz = psz_func(
-        axis_tilt,
-        axis_azimuth,
         timedata["Apparent Zenith"],
         timedata["Solar Azimuth"],
+        axis_tilt,
+        axis_azimuth,
     )
     assert_allclose(psz, timedata["True-Tracking"], atol=1e-3)
     # test by changing axis azimuth and tilt
     psz = psz_func(
-        -axis_tilt,
-        axis_azimuth - 180,
         timedata["Apparent Zenith"],
         timedata["Solar Azimuth"],
+        -axis_tilt,
+        axis_azimuth - 180,
     )
     assert_allclose(psz, -timedata["True-Tracking"], atol=1e-3)
 
@@ -252,10 +252,10 @@ def test_projected_solar_zenith_angle_datatypes(
     sun_azimuth = timedata["Solar Azimuth"].iloc[0]
 
     axis_tilt, axis_azimuth, sun_apparent_zenith, sun_azimuth = (
-        cast_func(axis_tilt),
-        cast_func(axis_azimuth),
         cast_func(sun_apparent_zenith),
         cast_func(sun_azimuth),
+        cast_func(axis_tilt),
+        cast_func(axis_azimuth),
     )
-    psz = psz_func(axis_tilt, axis_azimuth, sun_apparent_zenith, axis_azimuth)
+    psz = psz_func(sun_apparent_zenith, axis_azimuth, axis_tilt, axis_azimuth)
     assert isinstance(psz, cast_type)

From 4f584eae1a54bb01a896e147d481c1ac72d0bc6c Mon Sep 17 00:00:00 2001
From: echedey-ls <80125792+echedey-ls@users.noreply.github.com>
Date: Thu, 8 Feb 2024 23:02:57 +0100
Subject: [PATCH 031/185] I forgot :skull:

---
 pvlib/tests/test_shading.py | 16 ----------------
 1 file changed, 16 deletions(-)

diff --git a/pvlib/tests/test_shading.py b/pvlib/tests/test_shading.py
index 35e1605ba9..f9770c0497 100644
--- a/pvlib/tests/test_shading.py
+++ b/pvlib/tests/test_shading.py
@@ -218,22 +218,6 @@ def test_projected_solar_zenith_angle_numeric(
     )
     assert_allclose(psz, -timedata["True-Tracking"], atol=1e-3)
 
-    # test implementation port from tracking.singleaxis
-    axis_tilt, axis_azimuth, singleaxis = \
-        singleaxis_psz_implementation_port_data
-    psz = pvlib.tracking.singleaxis(
-        singleaxis["Apparent Zenith"],
-        singleaxis["Solar Azimuth"],
-        axis_tilt,
-        axis_azimuth,
-        backtrack=False,
-    )
-    assert_allclose(
-        psz["tracker_theta"],
-        singleaxis["tracker_theta"],
-        atol=1e-6
-    )
-
 
 @pytest.mark.parametrize(
     "cast_type, cast_func",

From 238d123669246979a33997e4cef3b68c5f862050 Mon Sep 17 00:00:00 2001
From: echedey-ls <80125792+echedey-ls@users.noreply.github.com>
Date: Thu, 8 Feb 2024 23:04:49 +0100
Subject: [PATCH 032/185] Linter are you happy now?

---
 pvlib/tests/test_shading.py | 1 -
 1 file changed, 1 deletion(-)

diff --git a/pvlib/tests/test_shading.py b/pvlib/tests/test_shading.py
index f9770c0497..f1f26a2da6 100644
--- a/pvlib/tests/test_shading.py
+++ b/pvlib/tests/test_shading.py
@@ -6,7 +6,6 @@
 import pytest
 from datetime import timezone, timedelta
 
-import pvlib
 from pvlib import shading
 
 

From 98a254d409cf0c93392280ff1752b42b1ced88fd Mon Sep 17 00:00:00 2001
From: echedey-ls <80125792+echedey-ls@users.noreply.github.com>
Date: Fri, 9 Feb 2024 12:03:29 +0100
Subject: [PATCH 033/185] Remove port test and add edge cases test

Co-Authored-By: Kevin Anderson <57452607+kandersolar@users.noreply.github.com>
---
 pvlib/tests/test_shading.py | 113 +++++++++++++++---------------------
 1 file changed, 46 insertions(+), 67 deletions(-)

diff --git a/pvlib/tests/test_shading.py b/pvlib/tests/test_shading.py
index f1f26a2da6..a0fd7beac7 100644
--- a/pvlib/tests/test_shading.py
+++ b/pvlib/tests/test_shading.py
@@ -11,21 +11,22 @@
 
 @pytest.fixture
 def test_system():
-    syst = {'height': 1.0,
-            'pitch': 2.,
-            'surface_tilt': 30.,
-            'surface_azimuth': 180.,
-            'rotation': -30.}  # rotation of right edge relative to horizontal
-    syst['gcr'] = 1.0 / syst['pitch']
+    syst = {
+        "height": 1.0,
+        "pitch": 2.0,
+        "surface_tilt": 30.0,
+        "surface_azimuth": 180.0,
+        "rotation": -30.0,
+    }  # rotation of right edge relative to horizontal
+    syst["gcr"] = 1.0 / syst["pitch"]
     return syst
 
 
 def test__ground_angle(test_system):
     ts = test_system
-    x = np.array([0., 0.5, 1.0])
-    angles = shading.ground_angle(
-        ts['surface_tilt'], ts['gcr'], x)
-    expected_angles = np.array([0., 5.866738789543952, 9.896090638982903])
+    x = np.array([0.0, 0.5, 1.0])
+    angles = shading.ground_angle(ts["surface_tilt"], ts["gcr"], x)
+    expected_angles = np.array([0.0, 5.866738789543952, 9.896090638982903])
     assert np.allclose(angles, expected_angles)
 
 
@@ -138,70 +139,36 @@ def true_tracking_angle_and_inputs_NREL():
 
 
 @pytest.fixture
-def singleaxis_psz_implementation_port_data():
-    # data generated with the PSZ angle implementation in tracking.singleaxis
-    # See GitHub issue #1734 & PR #1904
-    axis_tilt_angle = 12.224
-    axis_azimuth_angle = 187.2
-
-    singleaxis_result = pd.DataFrame(
-        columns=[
-            "Apparent Zenith",
-            "Solar Azimuth",
-            "tracker_theta",
-            "surface_azimuth",
-            "surface_tilt",
-        ],
+def projected_solar_zenith_angle_edge_cases():
+    premises_and_result_matrix = pd.DataFrame(
         data=[
-            [88.86131915, 116.14911543, -84.67346, 98.330924, 84.794565],
-            [85.67558254, 119.46577753, -80.544188, 99.219659, 80.760477],
-            [82.4784391, 122.90558458, -76.226064, 100.171259, 76.5443],
-            [79.37555806, 126.48822166, -71.79054, 101.184411, 72.217365],
-            [76.40491865, 130.23239671, -67.237442, 102.276947, 67.781439],
-            [73.59273783, 134.15525777, -62.55178, 103.476096, 63.224495],
-            [70.96318968, 138.2715258, -57.713941, 104.819827, 58.53107],
-            [68.54068323, 142.59233032, -52.702658, 106.361922, 53.685798],
-            [66.35031258, 147.12377575, -47.496592, 108.18131, 48.676053],
-            [64.41759166, 151.8653323, -42.07579, 110.39903, 43.495367],
-            [62.76775062, 156.80824414, -36.423404, 113.210504, 38.148938],
-            [61.42469841, 161.9342438, -30.527799, 116.950922, 32.663696],
-            [60.40974474, 167.21493901, -24.385012, 122.236817, 27.108957],
-            [59.74022062, 172.61222482, -18.001341, 130.288224, 21.645102],
-            [59.42818646, 178.07994717, -11.395651, 143.610698, 16.652493],
-            [59.47944177, 183.56677914, -4.600779, 166.390187, 13.048796],
-            [59.89302187, 189.01995634, 2.336615, 198.108, 12.441979],
-            [60.66128258, 194.38926277, 9.358232, 225.094855, 15.351466],
-            [61.77055542, 199.63057627, 16.398369, 241.465486, 20.352345],
-            [63.20224386, 204.70842576, 23.389598, 251.116742, 26.231294],
-            [64.93416116, 209.59729217, 30.268795, 257.259578, 32.425598],
-            [66.94189859, 214.28170196, 36.982274, 261.49605, 38.674352],
-            [69.20004673, 218.75538494, 43.489104, 264.617474, 44.841832],
-            [71.68314725, 223.01986867, 49.762279, 267.042188, 50.852813],
-            [74.36628597, 227.08285659, 55.787916, 269.007999, 56.666604],
-            [77.22520074, 230.95665462, 61.562937, 270.658956, 62.264111],
-            [80.23550305, 234.65680797, 67.091395, 272.086933, 67.639267],
-            [83.3693091, 238.20102038, 72.378024, 273.352342, 72.790188],
-            [86.57992299, 241.60837123, 77.408775, 274.492262, 77.698775],
-            [89.70940444, 244.89880789, 82.045935, 275.505443, 82.227402],
+        # s_zen | s_azim | ax_tilt | ax_azim | psza
+            [0,     0,        0,        0,      0],
+            [0,     180,      0,        0,      0],
+            [0,     0,        0,      180,      0],
+            [0,     180,      0,      180,      0],
+            [45,    0,        0,      180,      0],
+            [45,    90,       0,      180,    -45],
+            [45,    270,      0,      180,     45],
+            [45,    90,       90,     180,    -90],
+            [45,    270,      90,     180,     90],
+            [45,    90,       90,     0,       90],
+            [45,    270,      90,     0,      -90],
+            [45,    45,       90,     180,   -135],
+            [45,    315,      90,     180,    135],
         ],
+        columns=["solar_zenith", "solar_azimuth", "axis_tilt", "axis_azimuth", "psza"],
     )
-    singleaxis_result.index = pd.date_range(
-        "2024-01-25 08:40",
-        "2024-01-25 18:20",
-        freq="20min",
-        tz=timezone(timedelta(hours=1)),
-    )
-    return (axis_tilt_angle, axis_azimuth_angle, singleaxis_result)
+    return premises_and_result_matrix
 
 
 def test_projected_solar_zenith_angle_numeric(
-    true_tracking_angle_and_inputs_NREL,
-    singleaxis_psz_implementation_port_data
+    true_tracking_angle_and_inputs_NREL, projected_solar_zenith_angle_edge_cases
 ):
-    psz_func = shading.projected_solar_zenith_angle
+    psza_func = shading.projected_solar_zenith_angle
     axis_tilt, axis_azimuth, timedata = true_tracking_angle_and_inputs_NREL
     # test against data provided by NREL
-    psz = psz_func(
+    psz = psza_func(
         timedata["Apparent Zenith"],
         timedata["Solar Azimuth"],
         axis_tilt,
@@ -209,13 +176,25 @@ def test_projected_solar_zenith_angle_numeric(
     )
     assert_allclose(psz, timedata["True-Tracking"], atol=1e-3)
     # test by changing axis azimuth and tilt
-    psz = psz_func(
+    psza = psza_func(
         timedata["Apparent Zenith"],
         timedata["Solar Azimuth"],
         -axis_tilt,
         axis_azimuth - 180,
     )
-    assert_allclose(psz, -timedata["True-Tracking"], atol=1e-3)
+    assert_allclose(psza, -timedata["True-Tracking"], atol=1e-3)
+
+    # test edge cases
+    solar_zenith, solar_azimuth, axis_tilt, axis_azimuth, psza_expected = (
+        v for _, v in projected_solar_zenith_angle_edge_cases.items()
+    )
+    psza = psza_func(
+        solar_zenith,
+        solar_azimuth,
+        axis_tilt,
+        axis_azimuth,
+    )
+    assert_allclose(psza, psza_expected, atol=1e-9)
 
 
 @pytest.mark.parametrize(

From 4616175542d0ec41bc8f06cbf3924ed05a55cba3 Mon Sep 17 00:00:00 2001
From: echedey-ls <80125792+echedey-ls@users.noreply.github.com>
Date: Fri, 9 Feb 2024 12:18:13 +0100
Subject: [PATCH 034/185] Update test_shading.py

Co-Authored-By: Kevin Anderson <57452607+kandersolar@users.noreply.github.com>
---
 pvlib/tests/test_shading.py | 34 ++++++++++++++++++----------------
 1 file changed, 18 insertions(+), 16 deletions(-)

diff --git a/pvlib/tests/test_shading.py b/pvlib/tests/test_shading.py
index a0fd7beac7..f570c4eb89 100644
--- a/pvlib/tests/test_shading.py
+++ b/pvlib/tests/test_shading.py
@@ -142,28 +142,30 @@ def true_tracking_angle_and_inputs_NREL():
 def projected_solar_zenith_angle_edge_cases():
     premises_and_result_matrix = pd.DataFrame(
         data=[
-        # s_zen | s_azim | ax_tilt | ax_azim | psza
-            [0,     0,        0,        0,      0],
-            [0,     180,      0,        0,      0],
-            [0,     0,        0,      180,      0],
-            [0,     180,      0,      180,      0],
-            [45,    0,        0,      180,      0],
-            [45,    90,       0,      180,    -45],
-            [45,    270,      0,      180,     45],
-            [45,    90,       90,     180,    -90],
-            [45,    270,      90,     180,     90],
-            [45,    90,       90,     0,       90],
-            [45,    270,      90,     0,      -90],
-            [45,    45,       90,     180,   -135],
-            [45,    315,      90,     180,    135],
+            # s_zen | s_azim | ax_tilt | ax_azim | psza
+                [0,     0,        0,        0,      0],
+                [0,     180,      0,        0,      0],
+                [0,     0,        0,      180,      0],
+                [0,     180,      0,      180,      0],
+                [45,    0,        0,      180,      0],
+                [45,    90,       0,      180,    -45],
+                [45,    270,      0,      180,     45],
+                [45,    90,       90,     180,    -90],
+                [45,    270,      90,     180,     90],
+                [45,    90,       90,     0,       90],
+                [45,    270,      90,     0,      -90],
+                [45,    45,       90,     180,   -135],
+                [45,    315,      90,     180,    135],
         ],
-        columns=["solar_zenith", "solar_azimuth", "axis_tilt", "axis_azimuth", "psza"],
+        columns=["solar_zenith", "solar_azimuth", "axis_tilt", "axis_azimuth",
+                 "psza"],
     )
     return premises_and_result_matrix
 
 
 def test_projected_solar_zenith_angle_numeric(
-    true_tracking_angle_and_inputs_NREL, projected_solar_zenith_angle_edge_cases
+true_tracking_angle_and_inputs_NREL,
+    projected_solar_zenith_angle_edge_cases
 ):
     psza_func = shading.projected_solar_zenith_angle
     axis_tilt, axis_azimuth, timedata = true_tracking_angle_and_inputs_NREL

From 33ffd284f1ddad18bb561e5a846013b34a399e48 Mon Sep 17 00:00:00 2001
From: echedey-ls <80125792+echedey-ls@users.noreply.github.com>
Date: Fri, 9 Feb 2024 13:12:45 +0100
Subject: [PATCH 035/185] Indentation xd

---
 pvlib/tests/test_shading.py | 28 ++++++++++++++--------------
 1 file changed, 14 insertions(+), 14 deletions(-)

diff --git a/pvlib/tests/test_shading.py b/pvlib/tests/test_shading.py
index f570c4eb89..3d398ba980 100644
--- a/pvlib/tests/test_shading.py
+++ b/pvlib/tests/test_shading.py
@@ -142,20 +142,20 @@ def true_tracking_angle_and_inputs_NREL():
 def projected_solar_zenith_angle_edge_cases():
     premises_and_result_matrix = pd.DataFrame(
         data=[
-            # s_zen | s_azim | ax_tilt | ax_azim | psza
-                [0,     0,        0,        0,      0],
-                [0,     180,      0,        0,      0],
-                [0,     0,        0,      180,      0],
-                [0,     180,      0,      180,      0],
-                [45,    0,        0,      180,      0],
-                [45,    90,       0,      180,    -45],
-                [45,    270,      0,      180,     45],
-                [45,    90,       90,     180,    -90],
-                [45,    270,      90,     180,     90],
-                [45,    90,       90,     0,       90],
-                [45,    270,      90,     0,      -90],
-                [45,    45,       90,     180,   -135],
-                [45,    315,      90,     180,    135],
+                # s_zen | s_azm | ax_tilt | ax_azm | psza
+                [   0,     0,        0,        0,      0],
+                [   0,     180,      0,        0,      0],
+                [   0,     0,        0,      180,      0],
+                [   0,     180,      0,      180,      0],
+                [   45,    0,        0,      180,      0],
+                [   45,    90,       0,      180,    -45],
+                [   45,    270,      0,      180,     45],
+                [   45,    90,       90,     180,    -90],
+                [   45,    270,      90,     180,     90],
+                [   45,    90,       90,     0,       90],
+                [   45,    270,      90,     0,      -90],
+                [   45,    45,       90,     180,   -135],
+                [   45,    315,      90,     180,    135],
         ],
         columns=["solar_zenith", "solar_azimuth", "axis_tilt", "axis_azimuth",
                  "psza"],

From 8526bc68e77ee0fb695595d9275681ad46b9ad55 Mon Sep 17 00:00:00 2001
From: echedey-ls <80125792+echedey-ls@users.noreply.github.com>
Date: Fri, 9 Feb 2024 13:14:46 +0100
Subject: [PATCH 036/185] Update test_shading.py

---
 pvlib/tests/test_shading.py | 28 ++++++++++++++--------------
 1 file changed, 14 insertions(+), 14 deletions(-)

diff --git a/pvlib/tests/test_shading.py b/pvlib/tests/test_shading.py
index 3d398ba980..8c8dcc342e 100644
--- a/pvlib/tests/test_shading.py
+++ b/pvlib/tests/test_shading.py
@@ -142,20 +142,20 @@ def true_tracking_angle_and_inputs_NREL():
 def projected_solar_zenith_angle_edge_cases():
     premises_and_result_matrix = pd.DataFrame(
         data=[
-                # s_zen | s_azm | ax_tilt | ax_azm | psza
-                [   0,     0,        0,        0,      0],
-                [   0,     180,      0,        0,      0],
-                [   0,     0,        0,      180,      0],
-                [   0,     180,      0,      180,      0],
-                [   45,    0,        0,      180,      0],
-                [   45,    90,       0,      180,    -45],
-                [   45,    270,      0,      180,     45],
-                [   45,    90,       90,     180,    -90],
-                [   45,    270,      90,     180,     90],
-                [   45,    90,       90,     0,       90],
-                [   45,    270,      90,     0,      -90],
-                [   45,    45,       90,     180,   -135],
-                [   45,    315,      90,     180,    135],
+            # s_zen | s_azm | ax_tilt | ax_azm | psza
+            [   0,     0,        0,        0,      0],
+            [   0,     180,      0,        0,      0],
+            [   0,     0,        0,      180,      0],
+            [   0,     180,      0,      180,      0],
+            [   45,    0,        0,      180,      0],
+            [   45,    90,       0,      180,    -45],
+            [   45,    270,      0,      180,     45],
+            [   45,    90,       90,     180,    -90],
+            [   45,    270,      90,     180,     90],
+            [   45,    90,       90,     0,       90],
+            [   45,    270,      90,     0,      -90],
+            [   45,    45,       90,     180,   -135],
+            [   45,    315,      90,     180,    135],
         ],
         columns=["solar_zenith", "solar_azimuth", "axis_tilt", "axis_azimuth",
                  "psza"],

From bde3656a5d0eeb8b2fca59953bfa3c43b3c28cc8 Mon Sep 17 00:00:00 2001
From: echedey-ls <80125792+echedey-ls@users.noreply.github.com>
Date: Fri, 9 Feb 2024 13:17:58 +0100
Subject: [PATCH 037/185] I forgot how to code

---
 pvlib/tests/test_shading.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/pvlib/tests/test_shading.py b/pvlib/tests/test_shading.py
index 8c8dcc342e..a5dc03ebfc 100644
--- a/pvlib/tests/test_shading.py
+++ b/pvlib/tests/test_shading.py
@@ -164,7 +164,7 @@ def projected_solar_zenith_angle_edge_cases():
 
 
 def test_projected_solar_zenith_angle_numeric(
-true_tracking_angle_and_inputs_NREL,
+    true_tracking_angle_and_inputs_NREL,
     projected_solar_zenith_angle_edge_cases
 ):
     psza_func = shading.projected_solar_zenith_angle

From 51e37500b8d2bc9c0580361c42521c8d7f5cef19 Mon Sep 17 00:00:00 2001
From: echedey-ls <80125792+echedey-ls@users.noreply.github.com>
Date: Fri, 9 Feb 2024 20:27:34 +0100
Subject: [PATCH 038/185] Align data

---
 pvlib/tests/test_shading.py | 22 +++++++++++-----------
 1 file changed, 11 insertions(+), 11 deletions(-)

diff --git a/pvlib/tests/test_shading.py b/pvlib/tests/test_shading.py
index a5dc03ebfc..8d609d1e3f 100644
--- a/pvlib/tests/test_shading.py
+++ b/pvlib/tests/test_shading.py
@@ -143,19 +143,19 @@ def projected_solar_zenith_angle_edge_cases():
     premises_and_result_matrix = pd.DataFrame(
         data=[
             # s_zen | s_azm | ax_tilt | ax_azm | psza
-            [   0,     0,        0,        0,      0],
+            [   0,       0,      0,        0,      0],
             [   0,     180,      0,        0,      0],
-            [   0,     0,        0,      180,      0],
+            [   0,       0,      0,      180,      0],
             [   0,     180,      0,      180,      0],
-            [   45,    0,        0,      180,      0],
-            [   45,    90,       0,      180,    -45],
-            [   45,    270,      0,      180,     45],
-            [   45,    90,       90,     180,    -90],
-            [   45,    270,      90,     180,     90],
-            [   45,    90,       90,     0,       90],
-            [   45,    270,      90,     0,      -90],
-            [   45,    45,       90,     180,   -135],
-            [   45,    315,      90,     180,    135],
+            [  45,       0,      0,      180,      0],
+            [  45,      90,      0,      180,    -45],
+            [  45,     270,      0,      180,     45],
+            [  45,      90,     90,      180,    -90],
+            [  45,     270,     90,      180,     90],
+            [  45,      90,     90,        0,     90],
+            [  45,     270,     90,        0,    -90],
+            [  45,      45,     90,      180,   -135],
+            [  45,     315,     90,      180,    135],
         ],
         columns=["solar_zenith", "solar_azimuth", "axis_tilt", "axis_azimuth",
                  "psza"],

From 35738a486c04239e7aa4a508dae6bd56066ff158 Mon Sep 17 00:00:00 2001
From: echedey-ls <80125792+echedey-ls@users.noreply.github.com>
Date: Tue, 27 Feb 2024 23:57:58 +0100
Subject: [PATCH 039/185] Docstring suggestion from Kevin

Co-Authored-By: Kevin Anderson <57452607+kandersolar@users.noreply.github.com>
---
 pvlib/shading.py | 38 ++++++++++++++++++++++++++++++++++++++
 1 file changed, 38 insertions(+)

diff --git a/pvlib/shading.py b/pvlib/shading.py
index 04d0d66ae8..474b83512c 100644
--- a/pvlib/shading.py
+++ b/pvlib/shading.py
@@ -268,12 +268,50 @@ def projected_solar_zenith_angle(solar_zenith, solar_azimuth,
     Projected_solar_zenith : numeric
         In degrees.
 
+    Notes
+    -----
+    This projection has a variety of applications in PV. For example:
+
+    - Projecting the sun's position onto the plane perpendicular to
+      the axis of a single-axis tracker (i.e. the plane
+      whose normal vector coincides with the tracker torque tube)
+      yields the tracker rotation angle that maximizes direct irradiance
+      capture.  This tracking strategy is called
+      :ref:`true-tracking
+      <sphx_glr_examples_plot_single_axis_tracking.py:True-tracking>`.
+
+    - Self-shading in large PV arrays is often modeled by assuming
+      a simplified 2-D array geometry where the sun's position is
+      projected onto the plane perpendicular to the PV rows.
+      The projected zenith angle is then used for calculations
+      regarding row-to-row shading.
+
+    Examples
+    --------
+
+    Calculate the ideal true-tracking angle for a horizontal north-south
+    single-axis tracker:
+
+    >>> rotation = projected_solar_zenith_angle(solar_zenith, solar_azimuth,
+    >>>                                         axis_tilt=0, axis_azimuth=180)
+
+    Calculate the projected zenith angle in a south-facing fixed tilt array
+    (note: the ``axis_azimuth`` of a fixed-tilt row points along the length
+    of the row):
+
+    >>> psza = projected_solar_zenith_angle(solar_zenith, solar_azimuth,
+    >>>                                     axis_tilt=0, axis_azimuth=90)
+
     References
     ----------
     .. [1] K. Anderson and M. Mikofski, 'Slope-Aware Backtracking for
        Single-Axis Trackers', National Renewable Energy Lab. (NREL), Golden,
        CO (United States);
        NREL/TP-5K00-76626, Jul. 2020. :doi:`10.2172/1660126`.
+
+    See Also
+    --------
+    pvlib.solarposition.get_solarposition
     """
     # Assume the tracker reference frame is right-handed. Positive y-axis is
     # oriented along tracking axis; from north, the y-axis is rotated clockwise

From 8d679c3a1574fe356e3e438d3ce0b2ba60508572 Mon Sep 17 00:00:00 2001
From: echedey-ls <80125792+echedey-ls@users.noreply.github.com>
Date: Wed, 28 Feb 2024 00:24:04 +0100
Subject: [PATCH 040/185] Update link to example?

---
 pvlib/shading.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/pvlib/shading.py b/pvlib/shading.py
index 474b83512c..3172accaf4 100644
--- a/pvlib/shading.py
+++ b/pvlib/shading.py
@@ -278,7 +278,7 @@ def projected_solar_zenith_angle(solar_zenith, solar_azimuth,
       yields the tracker rotation angle that maximizes direct irradiance
       capture.  This tracking strategy is called
       :ref:`true-tracking
-      <sphx_glr_examples_plot_single_axis_tracking.py:True-tracking>`.
+      <sphx_glr_plot_single_axis_tracking.py:True-tracking>`.
 
     - Self-shading in large PV arrays is often modeled by assuming
       a simplified 2-D array geometry where the sun's position is

From 4a907c1ae0c436b540b37086f2bb001c25ec78c7 Mon Sep 17 00:00:00 2001
From: Mark Mikofski <bwana.marko@yahoo.com>
Date: Thu, 4 May 2023 00:06:02 -0700
Subject: [PATCH 041/185] add linear shade loss for thin films

---
 pvlib/tracking.py | 77 +++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 77 insertions(+)

diff --git a/pvlib/tracking.py b/pvlib/tracking.py
index 9c4103e7f0..9ea476831f 100644
--- a/pvlib/tracking.py
+++ b/pvlib/tracking.py
@@ -406,3 +406,80 @@ def calc_cross_axis_tilt(
     # equation 26
     beta_c = _calc_beta_c(v, delta_gamma, axis_tilt)
     return np.degrees(beta_c)
+
+
+def tracker_shaded_fraction(tracker_theta, gcr, projected_solar_zenith,
+                            cross_axis_slope):
+    """
+    Shade fraction (FS) for trackers with a common angle on an east-west slope.
+
+    Parameters
+    ----------
+    tracker_theta : numeric
+        The tracker rotation angle in degrees from horizontal.
+    gcr : float
+        The ground coverage ratio as a fraction equal to the collector width
+        over the horizontal row-to-row pitch.
+    projected_solar_zenith : numeric
+        Zenith angle in degrees of the solar vector projected into the plane
+        perpendicular to the tracker axes.
+    cross_axis_slope : float
+        Angle of the plane containing the tracker axes in degrees from
+        horizontal.
+
+    Returns
+    -------
+    shade_fraction : numeric
+        The fraction of the collector width shaded by an adjacent row. A
+        value of 1 is completely shaded and zero is no shade.
+
+    References
+    ----------
+    Mark A. Mikofski, "First Solar Irradiance Shade Losses on Sloped Terrain,"
+    PVPMC, 2023
+    """
+    theta_g_rad = np.radians(cross_axis_slope)
+    # angle opposite shadow cast on the ground, z
+    angle_z = (
+        np.pi / 2 - np.radians(tracker_theta)
+        + np.radians(projected_solar_zenith))
+    # angle opposite the collector width, L
+    angle_gcr = (
+        np.pi / 2 - np.radians(projected_solar_zenith)
+        - theta_g_rad)
+    # ratio of shadow, z, to pitch, P
+    zp = gcr * np.sin(angle_z) / np.sin(angle_gcr)
+    # there's only row-to-row shade loss if the shadow on the ground, z, is
+    # longer than row-to-row pitch projected on the ground, P*cos(theta_g)
+    zp_cos_g = zp*np.cos(theta_g_rad)
+    # shade fraction
+    fs = 0 if zp_cos_g <= 1 else 1 - 1/zp_cos_g
+    return fs
+
+
+def linear_shade_loss(shade_fraction, diffuse_fraction):
+    """
+    Fraction of power lost to linear shade loss applicable to CdTe modules like
+    First Solar.
+
+    Parameters
+    ----------
+    shade_fraction : numeric
+        The fraction of the collector width shaded by an adjacent row. A
+        value of 1 is completely shaded and zero is no shade.
+    diffuse_fraction : numeric
+        The ratio of diffuse plane of array (poa) irradiance to global poa.
+        A value of 1 is completely diffuse and zero is no diffuse.
+
+    Returns
+    -------
+    linear_shade_loss : numeric
+        The fraction of power lost due to linear shading. A value of 1 is all
+        power lost and zero is no loss.
+
+    References
+    ----------
+    Mark A. Mikofski, "First Solar Irradiance Shade Losses on Sloped Terrain,"
+    PVPMC, 2023
+    """
+    return 1 - shade_fraction * (1 - diffuse_fraction)

From 234288d620e4a554b3d18d945f8b4375c7e48d76 Mon Sep 17 00:00:00 2001
From: Mark Mikofski <bwana.marko@yahoo.com>
Date: Thu, 4 May 2023 00:39:51 -0700
Subject: [PATCH 042/185] add tests, update docs, what's new

---
 docs/sphinx/source/reference/tracking.rst |  2 +
 docs/sphinx/source/whatsnew/v0.9.6.rst    | 46 +++++++++++++++++++++++
 pvlib/tests/test_tracking.py              | 25 ++++++++++++
 pvlib/tracking.py                         | 18 ++++++---
 4 files changed, 86 insertions(+), 5 deletions(-)
 create mode 100644 docs/sphinx/source/whatsnew/v0.9.6.rst

diff --git a/docs/sphinx/source/reference/tracking.rst b/docs/sphinx/source/reference/tracking.rst
index 6d3f7fc4eb..b5ccd48ea3 100644
--- a/docs/sphinx/source/reference/tracking.rst
+++ b/docs/sphinx/source/reference/tracking.rst
@@ -13,3 +13,5 @@ Functions
    tracking.calc_axis_tilt
    tracking.calc_cross_axis_tilt
    tracking.calc_surface_orientation
+   tracking.tracker_shaded_fraction
+   tracking.linear_shade_loss
diff --git a/docs/sphinx/source/whatsnew/v0.9.6.rst b/docs/sphinx/source/whatsnew/v0.9.6.rst
new file mode 100644
index 0000000000..0efb6231e2
--- /dev/null
+++ b/docs/sphinx/source/whatsnew/v0.9.6.rst
@@ -0,0 +1,46 @@
+.. _whatsnew_0960:
+
+
+v0.9.6 (Anticipated June 2023)
+------------------------------
+
+
+Deprecations
+~~~~~~~~~~~~
+
+
+Enhancements
+~~~~~~~~~~~~
+* added functions `pvlib.tracking.tracker_shaded_fraction` and
+  `pvlib.tracking.linear_shade_loss` to calculate row-to-row shade and apply
+  linear shade loss for thin film CdTe modules like First Solar.
+  (:issue:`1689`, :pull:`1690`)
+
+Bug fixes
+~~~~~~~~~
+* `data` can no longer be left unspecified in
+  :py:meth:`pvlib.modelchain.ModelChain.run_model_from_effective_irradiance`.
+  (:issue:`1713`, :pull:`1720`)
+
+Testing
+~~~~~~~
+
+
+Documentation
+~~~~~~~~~~~~~
+* Updated the description of the interval parameter in
+  :py:func:`pvlib.iotools.get_psm3`. (:issue:`1702`, :pull:`1712`)
+
+Benchmarking
+~~~~~~~~~~~~~
+
+
+Requirements
+~~~~~~~~~~~~
+
+
+Contributors
+~~~~~~~~~~~~
+* Adam R. Jensen (:ghuser:`adamrjensen`)
+* Siddharth Kaul (:ghuser:`k10blogger`)
+* Mark A. Mikofski (:ghuser:`mikofski`)
diff --git a/pvlib/tests/test_tracking.py b/pvlib/tests/test_tracking.py
index 4febc73389..3d3153babb 100644
--- a/pvlib/tests/test_tracking.py
+++ b/pvlib/tests/test_tracking.py
@@ -472,3 +472,28 @@ def test_calc_surface_orientation_special():
         # in a modulo-360 sense.
         np.testing.assert_allclose(np.round(out['surface_azimuth'], 4) % 360,
                                    expected_azimuths, rtol=1e-5, atol=1e-5)
+
+
+@pytest.fixture
+def expected_fs():
+    # trivial case, 80% gcr, no slope, trackers & psz at 45-deg, 
+    z = np.sqrt(2*0.8*0.8)
+    return 1 - 1/z
+
+
+def test_tracker_shade_fraction(expected_fs):
+    """closes gh1690"""
+    fs = tracking.tracker_shaded_fraction(45.0, 0.8, 45.0, 0)
+    assert np.isclose(fs, expected_fs)
+    # same trivial case with 40%, shadow is only 0.565-m long < 1-m r2r P
+    zero_fs = tracking.tracker_shaded_fraction(45.0, 0.4, 45.0, 0)
+    assert np.isclose(zero_fs, 0)
+
+
+def test_linear_shade_loss(expected_fs):
+    loss = tracking.linear_shade_loss(expected_fs, 0.2)
+    assert np.isclose(loss, 0.09289321881345258)
+    loss_no_df = tracking.linear_shade_loss(expected_fs, 0)
+    assert np.isclose(loss_no_df, expected_fs)
+    no_loss = tracking.linear_shade_loss(expected_fs, 1.0)
+    assert np.isclose(no_loss, 0)
diff --git a/pvlib/tracking.py b/pvlib/tracking.py
index 9ea476831f..24d8d6a44f 100644
--- a/pvlib/tracking.py
+++ b/pvlib/tracking.py
@@ -477,9 +477,17 @@ def linear_shade_loss(shade_fraction, diffuse_fraction):
         The fraction of power lost due to linear shading. A value of 1 is all
         power lost and zero is no loss.
 
-    References
-    ----------
-    Mark A. Mikofski, "First Solar Irradiance Shade Losses on Sloped Terrain,"
-    PVPMC, 2023
+    See also
+    --------
+    pvlib.tracking.tracker_shaded_fraction
+
+    Example
+    -------
+    >>> from pvlib import tracking
+    >>> fs = tracking.tracker_shaded_fraction(45.0, 0.8, 45.0, 0)
+    >>> loss = tracking.linear_shade_loss(fs, 0.2)
+    >>> P_no_shade = 100  # [kWdc]  DC output from modules
+    >>> P_linear_shade = P_no_shade * (1-loss)  # [kWdc] output after loss
+    # 90.71067811865476 [kWdc]
     """
-    return 1 - shade_fraction * (1 - diffuse_fraction)
+    return shade_fraction * (1 - diffuse_fraction)

From fb0e5d1b571bd73a10816520fa2aaf13ca6935d2 Mon Sep 17 00:00:00 2001
From: Mark Mikofski <bwana.marko@yahoo.com>
Date: Thu, 4 May 2023 00:51:26 -0700
Subject: [PATCH 043/185] fix what's new gh issue and pr links

---
 docs/sphinx/source/whatsnew/v0.9.6.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/sphinx/source/whatsnew/v0.9.6.rst b/docs/sphinx/source/whatsnew/v0.9.6.rst
index 0efb6231e2..ddc45f8c2a 100644
--- a/docs/sphinx/source/whatsnew/v0.9.6.rst
+++ b/docs/sphinx/source/whatsnew/v0.9.6.rst
@@ -14,7 +14,7 @@ Enhancements
 * added functions `pvlib.tracking.tracker_shaded_fraction` and
   `pvlib.tracking.linear_shade_loss` to calculate row-to-row shade and apply
   linear shade loss for thin film CdTe modules like First Solar.
-  (:issue:`1689`, :pull:`1690`)
+  (:issue:`1689`, :issue:`1690`, :pull:`1725`)
 
 Bug fixes
 ~~~~~~~~~

From aa4b6e8cb5a95ada94b776c4ebc1141012bce6ce Mon Sep 17 00:00:00 2001
From: Mark Mikofski <bwana.marko@yahoo.com>
Date: Thu, 4 May 2023 01:02:17 -0700
Subject: [PATCH 044/185] fix trailing whitespace

---
 pvlib/tests/test_tracking.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/pvlib/tests/test_tracking.py b/pvlib/tests/test_tracking.py
index 3d3153babb..e21a51c1a5 100644
--- a/pvlib/tests/test_tracking.py
+++ b/pvlib/tests/test_tracking.py
@@ -476,7 +476,7 @@ def test_calc_surface_orientation_special():
 
 @pytest.fixture
 def expected_fs():
-    # trivial case, 80% gcr, no slope, trackers & psz at 45-deg, 
+    # trivial case, 80% gcr, no slope, trackers & psz at 45-deg
     z = np.sqrt(2*0.8*0.8)
     return 1 - 1/z
 

From 18b21878a3ed5132ecaa4f965faed04317c01df2 Mon Sep 17 00:00:00 2001
From: Mark Mikofski <bwana.marko@yahoo.com>
Date: Fri, 5 May 2023 23:27:56 -0700
Subject: [PATCH 045/185] responding to comments

- move linear shade loss to shading module
- don't use ternary, doesn't work on vectors, instead use np.where()
- set cross axis default to zero
- test vectors
- update docs
---
 .../effects_on_pv_system_output/shading.rst   |  3 +
 docs/sphinx/source/reference/tracking.rst     |  2 -
 docs/sphinx/source/whatsnew/v0.9.6.rst        |  4 +-
 pvlib/shading.py                              | 85 +++++++++++++++++++
 pvlib/tests/test_shading.py                   | 43 ++++++++++
 pvlib/tests/test_tracking.py                  | 25 ------
 pvlib/tracking.py                             | 85 -------------------
 7 files changed, 133 insertions(+), 114 deletions(-)

diff --git a/docs/sphinx/source/reference/effects_on_pv_system_output/shading.rst b/docs/sphinx/source/reference/effects_on_pv_system_output/shading.rst
index a0fd74a795..189c299fa2 100644
--- a/docs/sphinx/source/reference/effects_on_pv_system_output/shading.rst
+++ b/docs/sphinx/source/reference/effects_on_pv_system_output/shading.rst
@@ -11,3 +11,6 @@ Shading
    shading.masking_angle_passias
    shading.sky_diffuse_passias
    shading.projected_solar_zenith_angle
+   shading.tracker_shaded_fraction
+   shading.linear_shade_loss
+   
diff --git a/docs/sphinx/source/reference/tracking.rst b/docs/sphinx/source/reference/tracking.rst
index b5ccd48ea3..6d3f7fc4eb 100644
--- a/docs/sphinx/source/reference/tracking.rst
+++ b/docs/sphinx/source/reference/tracking.rst
@@ -13,5 +13,3 @@ Functions
    tracking.calc_axis_tilt
    tracking.calc_cross_axis_tilt
    tracking.calc_surface_orientation
-   tracking.tracker_shaded_fraction
-   tracking.linear_shade_loss
diff --git a/docs/sphinx/source/whatsnew/v0.9.6.rst b/docs/sphinx/source/whatsnew/v0.9.6.rst
index ddc45f8c2a..65575f03bd 100644
--- a/docs/sphinx/source/whatsnew/v0.9.6.rst
+++ b/docs/sphinx/source/whatsnew/v0.9.6.rst
@@ -11,8 +11,8 @@ Deprecations
 
 Enhancements
 ~~~~~~~~~~~~
-* added functions `pvlib.tracking.tracker_shaded_fraction` and
-  `pvlib.tracking.linear_shade_loss` to calculate row-to-row shade and apply
+* added functions `pvlib.shading.tracker_shaded_fraction` and
+  `pvlib.shading.linear_shade_loss` to calculate row-to-row shade and apply
   linear shade loss for thin film CdTe modules like First Solar.
   (:issue:`1689`, :issue:`1690`, :pull:`1725`)
 
diff --git a/pvlib/shading.py b/pvlib/shading.py
index 3172accaf4..8bf3b2bd2b 100644
--- a/pvlib/shading.py
+++ b/pvlib/shading.py
@@ -343,3 +343,88 @@ def projected_solar_zenith_angle(solar_zenith, solar_azimuth,
     # Eq. (5); angle between sun's beam and surface
     theta_T = np.degrees(np.arctan2(sx_prime, sz_prime))
     return theta_T
+
+
+def tracker_shaded_fraction(tracker_theta, gcr, projected_solar_zenith,
+                            cross_axis_slope=0):
+    """
+    Shade fraction (FS) for trackers with a common angle on an east-west slope.
+
+    Parameters
+    ----------
+    tracker_theta : numeric
+        The tracker rotation angle in degrees from horizontal.
+    gcr : float
+        The ground coverage ratio as a fraction equal to the collector width
+        over the horizontal row-to-row pitch.
+    projected_solar_zenith : numeric
+        Zenith angle in degrees of the solar vector projected into the plane
+        perpendicular to the tracker axes.
+    cross_axis_slope : float, default 0
+        Angle of the plane containing the tracker axes in degrees from
+        horizontal.
+
+    Returns
+    -------
+    shade_fraction : numeric
+        The fraction of the collector width shaded by an adjacent row. A
+        value of 1 is completely shaded and zero is no shade.
+
+    References
+    ----------
+    Mark A. Mikofski, "First Solar Irradiance Shade Losses on Sloped Terrain,"
+    PVPMC, 2023
+    """
+    theta_g_rad = np.radians(cross_axis_slope)
+    # angle opposite shadow cast on the ground, z
+    angle_z = (
+        np.pi / 2 - np.radians(tracker_theta)
+        + np.radians(projected_solar_zenith))
+    # angle opposite the collector width, L
+    angle_gcr = (
+        np.pi / 2 - np.radians(projected_solar_zenith)
+        - theta_g_rad)
+    # ratio of shadow, z, to pitch, P
+    zp = gcr * np.sin(angle_z) / np.sin(angle_gcr)
+    # there's only row-to-row shade loss if the shadow on the ground, z, is
+    # longer than row-to-row pitch projected on the ground, P*cos(theta_g)
+    zp_cos_g = zp*np.cos(theta_g_rad)
+    # shade fraction
+    fs = np.where(zp_cos_g <= 1, 0, 1 - 1/zp_cos_g)
+    return fs
+
+
+def linear_shade_loss(shade_fraction, diffuse_fraction):
+    """
+    Fraction of power lost to linear shade loss applicable to CdTe modules like
+    First Solar.
+
+    Parameters
+    ----------
+    shade_fraction : numeric
+        The fraction of the collector width shaded by an adjacent row. A
+        value of 1 is completely shaded and zero is no shade.
+    diffuse_fraction : numeric
+        The ratio of diffuse plane of array (poa) irradiance to global poa.
+        A value of 1 is completely diffuse and zero is no diffuse.
+
+    Returns
+    -------
+    linear_shade_loss : numeric
+        The fraction of power lost due to linear shading. A value of 1 is all
+        power lost and zero is no loss.
+
+    See also
+    --------
+    pvlib.tracking.tracker_shaded_fraction
+
+    Example
+    -------
+    >>> from pvlib import tracking
+    >>> fs = tracking.tracker_shaded_fraction(45.0, 0.8, 45.0, 0)
+    >>> loss = tracking.linear_shade_loss(fs, 0.2)
+    >>> P_no_shade = 100  # [kWdc]  DC output from modules
+    >>> P_linear_shade = P_no_shade * (1-loss)  # [kWdc] output after loss
+    # 90.71067811865476 [kWdc]
+    """
+    return shade_fraction * (1 - diffuse_fraction)
diff --git a/pvlib/tests/test_shading.py b/pvlib/tests/test_shading.py
index 8d609d1e3f..9df6e2291b 100644
--- a/pvlib/tests/test_shading.py
+++ b/pvlib/tests/test_shading.py
@@ -223,3 +223,46 @@ def test_projected_solar_zenith_angle_datatypes(
     )
     psz = psz_func(sun_apparent_zenith, axis_azimuth, axis_tilt, axis_azimuth)
     assert isinstance(psz, cast_type)
+
+
+@pytest.fixture
+def expected_fs():
+    # trivial case, 80% gcr, no slope, trackers & psz at 45-deg
+    z0 = np.sqrt(2*0.8*0.8)
+    # another trivial case, 60% gcr, no slope, trackers & psz at 60-deg
+    z1 = 2*0.6
+    # 30-deg isosceles, 60% gcr, no slope, 30-deg trackers, psz at 60-deg
+    z2 = 0.6*np.sqrt(3)
+    z = np.array([z0, z1, z2])
+    return 1 - 1/z
+
+
+def test_tracker_shade_fraction(expected_fs):
+    """closes gh1690"""
+    fs = shading.tracker_shaded_fraction(45.0, 0.8, 45.0)
+    assert np.isclose(fs, expected_fs[0])
+    # same trivial case with 40%, shadow is only 0.565-m long < 1-m r2r P
+    zero_fs = shading.tracker_shaded_fraction(45.0, 0.4, 45.0)
+    assert np.isclose(zero_fs, 0)
+    # test vectors
+    tracker_theta = [45.0, 60.0, 30.0]
+    gcr = [0.8, 0.6, 0.6]
+    psz = [45.0, 60.0, 60.0]
+    slope = [0]*3
+    fs_vec = shading.tracker_shaded_fraction(
+        tracker_theta, gcr, psz, slope)
+    assert np.allclose(fs_vec, expected_fs)
+
+
+def test_linear_shade_loss(expected_fs):
+    loss = shading.linear_shade_loss(expected_fs[0], 0.2)
+    assert np.isclose(loss, 0.09289321881345258)
+    # if no diffuse, shade fraction is the loss
+    loss_no_df = shading.linear_shade_loss(expected_fs[0], 0)
+    assert np.isclose(loss_no_df, expected_fs[0])
+    # if all diffuse, no shade loss
+    no_loss = shading.linear_shade_loss(expected_fs[0], 1.0)
+    assert np.isclose(no_loss, 0)
+    vec_loss = shading.linear_shade_loss(expected_fs, 0.2)
+    expected_loss = np.array([0.09289322, 0.13333333, 0.03019964])
+    assert np.allclose(vec_loss, expected_loss)
diff --git a/pvlib/tests/test_tracking.py b/pvlib/tests/test_tracking.py
index e21a51c1a5..4febc73389 100644
--- a/pvlib/tests/test_tracking.py
+++ b/pvlib/tests/test_tracking.py
@@ -472,28 +472,3 @@ def test_calc_surface_orientation_special():
         # in a modulo-360 sense.
         np.testing.assert_allclose(np.round(out['surface_azimuth'], 4) % 360,
                                    expected_azimuths, rtol=1e-5, atol=1e-5)
-
-
-@pytest.fixture
-def expected_fs():
-    # trivial case, 80% gcr, no slope, trackers & psz at 45-deg
-    z = np.sqrt(2*0.8*0.8)
-    return 1 - 1/z
-
-
-def test_tracker_shade_fraction(expected_fs):
-    """closes gh1690"""
-    fs = tracking.tracker_shaded_fraction(45.0, 0.8, 45.0, 0)
-    assert np.isclose(fs, expected_fs)
-    # same trivial case with 40%, shadow is only 0.565-m long < 1-m r2r P
-    zero_fs = tracking.tracker_shaded_fraction(45.0, 0.4, 45.0, 0)
-    assert np.isclose(zero_fs, 0)
-
-
-def test_linear_shade_loss(expected_fs):
-    loss = tracking.linear_shade_loss(expected_fs, 0.2)
-    assert np.isclose(loss, 0.09289321881345258)
-    loss_no_df = tracking.linear_shade_loss(expected_fs, 0)
-    assert np.isclose(loss_no_df, expected_fs)
-    no_loss = tracking.linear_shade_loss(expected_fs, 1.0)
-    assert np.isclose(no_loss, 0)
diff --git a/pvlib/tracking.py b/pvlib/tracking.py
index 24d8d6a44f..9c4103e7f0 100644
--- a/pvlib/tracking.py
+++ b/pvlib/tracking.py
@@ -406,88 +406,3 @@ def calc_cross_axis_tilt(
     # equation 26
     beta_c = _calc_beta_c(v, delta_gamma, axis_tilt)
     return np.degrees(beta_c)
-
-
-def tracker_shaded_fraction(tracker_theta, gcr, projected_solar_zenith,
-                            cross_axis_slope):
-    """
-    Shade fraction (FS) for trackers with a common angle on an east-west slope.
-
-    Parameters
-    ----------
-    tracker_theta : numeric
-        The tracker rotation angle in degrees from horizontal.
-    gcr : float
-        The ground coverage ratio as a fraction equal to the collector width
-        over the horizontal row-to-row pitch.
-    projected_solar_zenith : numeric
-        Zenith angle in degrees of the solar vector projected into the plane
-        perpendicular to the tracker axes.
-    cross_axis_slope : float
-        Angle of the plane containing the tracker axes in degrees from
-        horizontal.
-
-    Returns
-    -------
-    shade_fraction : numeric
-        The fraction of the collector width shaded by an adjacent row. A
-        value of 1 is completely shaded and zero is no shade.
-
-    References
-    ----------
-    Mark A. Mikofski, "First Solar Irradiance Shade Losses on Sloped Terrain,"
-    PVPMC, 2023
-    """
-    theta_g_rad = np.radians(cross_axis_slope)
-    # angle opposite shadow cast on the ground, z
-    angle_z = (
-        np.pi / 2 - np.radians(tracker_theta)
-        + np.radians(projected_solar_zenith))
-    # angle opposite the collector width, L
-    angle_gcr = (
-        np.pi / 2 - np.radians(projected_solar_zenith)
-        - theta_g_rad)
-    # ratio of shadow, z, to pitch, P
-    zp = gcr * np.sin(angle_z) / np.sin(angle_gcr)
-    # there's only row-to-row shade loss if the shadow on the ground, z, is
-    # longer than row-to-row pitch projected on the ground, P*cos(theta_g)
-    zp_cos_g = zp*np.cos(theta_g_rad)
-    # shade fraction
-    fs = 0 if zp_cos_g <= 1 else 1 - 1/zp_cos_g
-    return fs
-
-
-def linear_shade_loss(shade_fraction, diffuse_fraction):
-    """
-    Fraction of power lost to linear shade loss applicable to CdTe modules like
-    First Solar.
-
-    Parameters
-    ----------
-    shade_fraction : numeric
-        The fraction of the collector width shaded by an adjacent row. A
-        value of 1 is completely shaded and zero is no shade.
-    diffuse_fraction : numeric
-        The ratio of diffuse plane of array (poa) irradiance to global poa.
-        A value of 1 is completely diffuse and zero is no diffuse.
-
-    Returns
-    -------
-    linear_shade_loss : numeric
-        The fraction of power lost due to linear shading. A value of 1 is all
-        power lost and zero is no loss.
-
-    See also
-    --------
-    pvlib.tracking.tracker_shaded_fraction
-
-    Example
-    -------
-    >>> from pvlib import tracking
-    >>> fs = tracking.tracker_shaded_fraction(45.0, 0.8, 45.0, 0)
-    >>> loss = tracking.linear_shade_loss(fs, 0.2)
-    >>> P_no_shade = 100  # [kWdc]  DC output from modules
-    >>> P_linear_shade = P_no_shade * (1-loss)  # [kWdc] output after loss
-    # 90.71067811865476 [kWdc]
-    """
-    return shade_fraction * (1 - diffuse_fraction)

From 4163a7269869563c7df6d5c5c8c2060e46d2b444 Mon Sep 17 00:00:00 2001
From: Mark Mikofski <bwana.marko@yahoo.com>
Date: Fri, 5 May 2023 23:42:34 -0700
Subject: [PATCH 046/185] update docstring for linear shade loss

- applicable to other monolithic thin film like CIGS, not just CdTe
- only when shade is perpendicular to scribe lines
---
 pvlib/shading.py | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/pvlib/shading.py b/pvlib/shading.py
index 8bf3b2bd2b..0f2eac49f5 100644
--- a/pvlib/shading.py
+++ b/pvlib/shading.py
@@ -396,8 +396,9 @@ def tracker_shaded_fraction(tracker_theta, gcr, projected_solar_zenith,
 
 def linear_shade_loss(shade_fraction, diffuse_fraction):
     """
-    Fraction of power lost to linear shade loss applicable to CdTe modules like
-    First Solar.
+    Fraction of power lost to linear shade loss applicable to monolithic thin
+    film modules like First Solar CdTe, where the shadow is perpendicular to
+    cell scribe lines.
 
     Parameters
     ----------

From 1ebf8ea61ac31ae5dc36182afb262c5eff4bb42f Mon Sep 17 00:00:00 2001
From: Mark Mikofski <bwana.marko@yahoo.com>
Date: Fri, 5 May 2023 23:51:05 -0700
Subject: [PATCH 047/185] update example in linear_shade_loss

---
 pvlib/shading.py | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/pvlib/shading.py b/pvlib/shading.py
index 0f2eac49f5..8e7cf7659b 100644
--- a/pvlib/shading.py
+++ b/pvlib/shading.py
@@ -417,13 +417,13 @@ def linear_shade_loss(shade_fraction, diffuse_fraction):
 
     See also
     --------
-    pvlib.tracking.tracker_shaded_fraction
+    pvlib.shading.tracker_shaded_fraction
 
     Example
     -------
-    >>> from pvlib import tracking
-    >>> fs = tracking.tracker_shaded_fraction(45.0, 0.8, 45.0, 0)
-    >>> loss = tracking.linear_shade_loss(fs, 0.2)
+    >>> from pvlib import shading
+    >>> fs = shading.tracker_shaded_fraction(45.0, 0.8, 45.0, 0)
+    >>> loss = shading.linear_shade_loss(fs, 0.2)
     >>> P_no_shade = 100  # [kWdc]  DC output from modules
     >>> P_linear_shade = P_no_shade * (1-loss)  # [kWdc] output after loss
     # 90.71067811865476 [kWdc]

From de2144f8d63fae11d1edea5a02900b1f314fd5b4 Mon Sep 17 00:00:00 2001
From: Mark Mikofski <bwana.marko@yahoo.com>
Date: Sat, 6 May 2023 01:10:28 -0700
Subject: [PATCH 048/185] add figure and formulas to shaded fraction

---
 .../FSLR_irrad_shade_loss_slope_terrain.png   | Bin 0 -> 127773 bytes
 pvlib/shading.py                              |  30 +++++++++++++++++-
 2 files changed, 29 insertions(+), 1 deletion(-)
 create mode 100644 docs/sphinx/source/_images/FSLR_irrad_shade_loss_slope_terrain.png

diff --git a/docs/sphinx/source/_images/FSLR_irrad_shade_loss_slope_terrain.png b/docs/sphinx/source/_images/FSLR_irrad_shade_loss_slope_terrain.png
new file mode 100644
index 0000000000000000000000000000000000000000..d2f01c2e887a1f85abb952d33d02175272df15be
GIT binary patch
literal 127773
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

literal 0
HcmV?d00001

diff --git a/pvlib/shading.py b/pvlib/shading.py
index 8e7cf7659b..5514d098c2 100644
--- a/pvlib/shading.py
+++ b/pvlib/shading.py
@@ -347,7 +347,7 @@ def projected_solar_zenith_angle(solar_zenith, solar_azimuth,
 
 def tracker_shaded_fraction(tracker_theta, gcr, projected_solar_zenith,
                             cross_axis_slope=0):
-    """
+    r"""
     Shade fraction (FS) for trackers with a common angle on an east-west slope.
 
     Parameters
@@ -370,6 +370,34 @@ def tracker_shaded_fraction(tracker_theta, gcr, projected_solar_zenith,
         The fraction of the collector width shaded by an adjacent row. A
         value of 1 is completely shaded and zero is no shade.
 
+    See also
+    --------
+    pvlib.shading.linear_shade_loss
+
+
+    The shaded fraction is derived using trigonometery and similar triangles
+    from the tracker rotation :math:`\beta`, the ground slope :math:`\theta_g`,
+    the projected solar zenith (psz) :math:`\theta`, the collector width
+    :math:`L`, the row-to-row pitch :math:`P`, and the shadow length :math:`z`
+    as shown in the image below.
+
+    .. image:: /_images/FSLR_irrad_shade_loss_slope_terrain.png
+
+    The ratio of the shadow length to the pitch, :math:`z/P`, is given by the
+    following relation where the ground coverage ratio (GCR) is :math:`L/P`:
+
+    .. math::
+       \frac{z/P}{\sin{\left(\frac{\pi}{2}-\beta+\theta\right)}}
+       = \frac{GCR}{\sin{\left(\frac{\pi}{2}-\theta-\theta_g\right)}}
+
+    Then the shaded fraction :math:`w/L` is derived from :math:`z/P` as
+    follows:
+
+    .. math::
+       \frac{w}{L} = 1 - \frac{P}{z\cos{\theta_g}}
+
+    Finally, shade is zero if :math:`z\cos{\theta_g}/P \le 1`.
+
     References
     ----------
     Mark A. Mikofski, "First Solar Irradiance Shade Losses on Sloped Terrain,"

From 6aa43f0b749e289e560d0003ee8592b22f6a5b70 Mon Sep 17 00:00:00 2001
From: Mark Mikofski <bwana.marko@yahoo.com>
Date: Wed, 10 May 2023 21:11:02 -0700
Subject: [PATCH 049/185] shaded fraction consistently

---
 pvlib/shading.py | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/pvlib/shading.py b/pvlib/shading.py
index 5514d098c2..fc4700a77f 100644
--- a/pvlib/shading.py
+++ b/pvlib/shading.py
@@ -348,7 +348,7 @@ def projected_solar_zenith_angle(solar_zenith, solar_azimuth,
 def tracker_shaded_fraction(tracker_theta, gcr, projected_solar_zenith,
                             cross_axis_slope=0):
     r"""
-    Shade fraction (FS) for trackers with a common angle on an east-west slope.
+    Shaded fraction for trackers with a common angle on an east-west slope.
 
     Parameters
     ----------
@@ -366,7 +366,7 @@ def tracker_shaded_fraction(tracker_theta, gcr, projected_solar_zenith,
 
     Returns
     -------
-    shade_fraction : numeric
+    shaded_fraction : numeric
         The fraction of the collector width shaded by an adjacent row. A
         value of 1 is completely shaded and zero is no shade.
 
@@ -417,12 +417,12 @@ def tracker_shaded_fraction(tracker_theta, gcr, projected_solar_zenith,
     # there's only row-to-row shade loss if the shadow on the ground, z, is
     # longer than row-to-row pitch projected on the ground, P*cos(theta_g)
     zp_cos_g = zp*np.cos(theta_g_rad)
-    # shade fraction
+    # shaded fraction (fs)
     fs = np.where(zp_cos_g <= 1, 0, 1 - 1/zp_cos_g)
     return fs
 
 
-def linear_shade_loss(shade_fraction, diffuse_fraction):
+def linear_shade_loss(shaded_fraction, diffuse_fraction):
     """
     Fraction of power lost to linear shade loss applicable to monolithic thin
     film modules like First Solar CdTe, where the shadow is perpendicular to
@@ -430,7 +430,7 @@ def linear_shade_loss(shade_fraction, diffuse_fraction):
 
     Parameters
     ----------
-    shade_fraction : numeric
+    shaded_fraction : numeric
         The fraction of the collector width shaded by an adjacent row. A
         value of 1 is completely shaded and zero is no shade.
     diffuse_fraction : numeric
@@ -456,4 +456,4 @@ def linear_shade_loss(shade_fraction, diffuse_fraction):
     >>> P_linear_shade = P_no_shade * (1-loss)  # [kWdc] output after loss
     # 90.71067811865476 [kWdc]
     """
-    return shade_fraction * (1 - diffuse_fraction)
+    return shaded_fraction * (1 - diffuse_fraction)

From c34a2f640ad43389c64e8e9640c6499c2e1f0cc2 Mon Sep 17 00:00:00 2001
From: echedey-ls <80125792+echedey-ls@users.noreply.github.com>
Date: Sat, 3 Feb 2024 10:26:48 +0100
Subject: [PATCH 050/185] Add alternative text to image

---
 pvlib/shading.py | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/pvlib/shading.py b/pvlib/shading.py
index fc4700a77f..8aba3aa574 100644
--- a/pvlib/shading.py
+++ b/pvlib/shading.py
@@ -382,6 +382,8 @@ def tracker_shaded_fraction(tracker_theta, gcr, projected_solar_zenith,
     as shown in the image below.
 
     .. image:: /_images/FSLR_irrad_shade_loss_slope_terrain.png
+       :alt: Cross-section of two arrays on a sloped terrain and the resulting
+             shade.
 
     The ratio of the shadow length to the pitch, :math:`z/P`, is given by the
     following relation where the ground coverage ratio (GCR) is :math:`L/P`:

From 6b9f4781be283d78005d3b77c793fc914b91e7a8 Mon Sep 17 00:00:00 2001
From: echedey-ls <80125792+echedey-ls@users.noreply.github.com>
Date: Sun, 4 Feb 2024 00:12:59 +0100
Subject: [PATCH 051/185] Update implementation based on PSZ PR. See
 description.

Commit highlights :sparkles: :
* I think I made all the code a bit more legible; sorry for the big changes @mikofski
* Tests a bit more complete (not much, still consider the same test data)
* Rename shaded fraction acronym from `fs` to `sf`
* Asserts changed to `assert_allclose` for a more legible output in case of failure

Co-Authored-By: Mark Mikofski <bwana.marko@yahoo.com>
---
 pvlib/shading.py            | 43 +++++++++++-------
 pvlib/tests/test_shading.py | 88 +++++++++++++++++++++----------------
 2 files changed, 78 insertions(+), 53 deletions(-)

diff --git a/pvlib/shading.py b/pvlib/shading.py
index 8aba3aa574..e37b987299 100644
--- a/pvlib/shading.py
+++ b/pvlib/shading.py
@@ -345,22 +345,25 @@ def projected_solar_zenith_angle(solar_zenith, solar_azimuth,
     return theta_T
 
 
-def tracker_shaded_fraction(tracker_theta, gcr, projected_solar_zenith,
-                            cross_axis_slope=0):
+def tracker_shaded_fraction(solar_zenith, solar_azimuth, tracker_tilt,
+                            tracker_azimuth, gcr, cross_axis_slope=0):
     r"""
     Shaded fraction for trackers with a common angle on an east-west slope.
 
     Parameters
     ----------
-    tracker_theta : numeric
-        The tracker rotation angle in degrees from horizontal.
-    gcr : float
+    solar_zenith : numeric
+        Solar position zenith, in degrees.
+    solar_azimuth : numeric
+        Solar position azimuth, in degrees.
+    tracker_tilt : numeric
+        In degrees.
+    tracker_azimuth : numeric
+        In degrees. North=0º, South=180º, East=90º, West=270º.
+    gcr : numeric
         The ground coverage ratio as a fraction equal to the collector width
         over the horizontal row-to-row pitch.
-    projected_solar_zenith : numeric
-        Zenith angle in degrees of the solar vector projected into the plane
-        perpendicular to the tracker axes.
-    cross_axis_slope : float, default 0
+    cross_axis_slope : numeric, default 0
         Angle of the plane containing the tracker axes in degrees from
         horizontal.
 
@@ -406,9 +409,19 @@ def tracker_shaded_fraction(tracker_theta, gcr, projected_solar_zenith,
     PVPMC, 2023
     """
     theta_g_rad = np.radians(cross_axis_slope)
+    # projected solar zenith:
+    # consider the angle the sun direct beam has on the vertical plane which
+    # contains the tracker normal vector, with respect to a horizontal line
+    projected_solar_zenith = projected_solar_zenith_angle(
+        0,  # no rotation from the horizontal
+        # the vector that defines the projection plane for prior conditions
+        tracker_azimuth-90,
+        solar_zenith,
+        solar_azimuth
+    )
     # angle opposite shadow cast on the ground, z
     angle_z = (
-        np.pi / 2 - np.radians(tracker_theta)
+        np.pi / 2 - np.radians(tracker_tilt)
         + np.radians(projected_solar_zenith))
     # angle opposite the collector width, L
     angle_gcr = (
@@ -419,9 +432,9 @@ def tracker_shaded_fraction(tracker_theta, gcr, projected_solar_zenith,
     # there's only row-to-row shade loss if the shadow on the ground, z, is
     # longer than row-to-row pitch projected on the ground, P*cos(theta_g)
     zp_cos_g = zp*np.cos(theta_g_rad)
-    # shaded fraction (fs)
-    fs = np.where(zp_cos_g <= 1, 0, 1 - 1/zp_cos_g)
-    return fs
+    # shaded fraction (sf)
+    sf = np.where(zp_cos_g <= 1, 0, 1 - 1/zp_cos_g)
+    return sf
 
 
 def linear_shade_loss(shaded_fraction, diffuse_fraction):
@@ -452,8 +465,8 @@ def linear_shade_loss(shaded_fraction, diffuse_fraction):
     Example
     -------
     >>> from pvlib import shading
-    >>> fs = shading.tracker_shaded_fraction(45.0, 0.8, 45.0, 0)
-    >>> loss = shading.linear_shade_loss(fs, 0.2)
+    >>> sf = shading.tracker_shaded_fraction(45.0, 0.8, 45.0, 0)
+    >>> loss = shading.linear_shade_loss(sf, 0.2)
     >>> P_no_shade = 100  # [kWdc]  DC output from modules
     >>> P_linear_shade = P_no_shade * (1-loss)  # [kWdc] output after loss
     # 90.71067811865476 [kWdc]
diff --git a/pvlib/tests/test_shading.py b/pvlib/tests/test_shading.py
index 9df6e2291b..13d4ac1532 100644
--- a/pvlib/tests/test_shading.py
+++ b/pvlib/tests/test_shading.py
@@ -226,43 +226,55 @@ def test_projected_solar_zenith_angle_datatypes(
 
 
 @pytest.fixture
-def expected_fs():
-    # trivial case, 80% gcr, no slope, trackers & psz at 45-deg
-    z0 = np.sqrt(2*0.8*0.8)
-    # another trivial case, 60% gcr, no slope, trackers & psz at 60-deg
-    z1 = 2*0.6
-    # 30-deg isosceles, 60% gcr, no slope, 30-deg trackers, psz at 60-deg
-    z2 = 0.6*np.sqrt(3)
-    z = np.array([z0, z1, z2])
-    return 1 - 1/z
-
-
-def test_tracker_shade_fraction(expected_fs):
-    """closes gh1690"""
-    fs = shading.tracker_shaded_fraction(45.0, 0.8, 45.0)
-    assert np.isclose(fs, expected_fs[0])
-    # same trivial case with 40%, shadow is only 0.565-m long < 1-m r2r P
-    zero_fs = shading.tracker_shaded_fraction(45.0, 0.4, 45.0)
-    assert np.isclose(zero_fs, 0)
-    # test vectors
-    tracker_theta = [45.0, 60.0, 30.0]
-    gcr = [0.8, 0.6, 0.6]
-    psz = [45.0, 60.0, 60.0]
-    slope = [0]*3
-    fs_vec = shading.tracker_shaded_fraction(
-        tracker_theta, gcr, psz, slope)
-    assert np.allclose(fs_vec, expected_fs)
-
-
-def test_linear_shade_loss(expected_fs):
-    loss = shading.linear_shade_loss(expected_fs[0], 0.2)
-    assert np.isclose(loss, 0.09289321881345258)
+def sf_premises_and_expected():
+    """Data comprised of solar position, tracker orientations, ground coverage
+    ratios and terrain slopes with respective shade fractions (sf)"""   
+    # preserve tracker_shade_fraction's args order and append shadow depth, z
+    premises_and_results = pd.DataFrame(
+        columns=["solar_zenith", "solar_azimuth", "tracker_tilt",
+                 "tracker_azimuth", "gcr", "cross_axis_slope", "z"],
+        data=(
+            # trivial case, 80% gcr, no slope, trackers & psz at 45-deg
+            (45, 90., 45, 90., 0.8, 0, np.sqrt(2*0.8*0.8)),
+            # another trivial case, 60% gcr, no slope, trackers & psz at 60-deg
+            (60, 120, 60, 120, 0.6, 0, 2*0.6),
+            # 30-deg isosceles, 60% gcr, no slope, 30-deg trackers, psz 60-deg
+            (60, 135, 30, 135, 0.6, 0, 0.6*np.sqrt(3)),
+            # no shading, 40% gcr, shadow is only 0.565-m long < 1-m r2r P
+            (45, 180, 45, 180, 0.4, 0, 1)  # z := 1 means no shadow
+        ))
+    # append shaded fraction
+    premises_and_results["shaded_fraction"] = 1 - 1/premises_and_results["z"]
+    return premises_and_results
+
+
+def test_tracker_shade_fraction(sf_premises_and_expected):
+    """Tests tracker_shade_fraction"""
+    # unwrap sf_premises_and_expected values premises and expected results
+    premises = sf_premises_and_expected.drop(columns=["z", "shaded_fraction"])
+    expected_sf_array = sf_premises_and_expected["shaded_fraction"]
+    # test scalar inputs from the row iterator
+    # series label := corresponding index in expected_sf_array
+    for index, premise in premises.iterrows():
+        expected_result = expected_sf_array[index]
+        sf = shading.tracker_shaded_fraction(**premise)
+        assert_allclose(sf, expected_result)
+
+    # test vector inputs
+    sf_vec = shading.tracker_shaded_fraction(**premises)
+    assert_allclose(sf_vec, expected_sf_array)
+
+
+def test_linear_shade_loss(sf_premises_and_expected):
+    expected_sf_array = sf_premises_and_expected["shaded_fraction"]
+    loss = shading.linear_shade_loss(expected_sf_array[0], 0.2)
+    assert_allclose(loss, 0.09289321881345258)
     # if no diffuse, shade fraction is the loss
-    loss_no_df = shading.linear_shade_loss(expected_fs[0], 0)
-    assert np.isclose(loss_no_df, expected_fs[0])
+    loss_no_df = shading.linear_shade_loss(expected_sf_array[0], 0)
+    assert_allclose(loss_no_df, expected_sf_array[0])
     # if all diffuse, no shade loss
-    no_loss = shading.linear_shade_loss(expected_fs[0], 1.0)
-    assert np.isclose(no_loss, 0)
-    vec_loss = shading.linear_shade_loss(expected_fs, 0.2)
-    expected_loss = np.array([0.09289322, 0.13333333, 0.03019964])
-    assert np.allclose(vec_loss, expected_loss)
+    no_loss = shading.linear_shade_loss(expected_sf_array[0], 1.0)
+    assert_allclose(no_loss, 0)
+    vec_loss = shading.linear_shade_loss(expected_sf_array, 0.2)
+    expected_loss = np.array([0.09289322, 0.13333333, 0.03019964, 0.0])
+    assert_allclose(vec_loss, expected_loss)

From c3a9569b9943a96e01f20c101b4a986e383142f1 Mon Sep 17 00:00:00 2001
From: echedey-ls <80125792+echedey-ls@users.noreply.github.com>
Date: Sun, 4 Feb 2024 00:24:51 +0100
Subject: [PATCH 052/185] Whatsnew entries

Co-Authored-By: Mark Mikofski <bwana.marko@yahoo.com>
---
 docs/sphinx/source/whatsnew/v0.10.4.rst |  6 ++++
 docs/sphinx/source/whatsnew/v0.9.6.rst  | 46 -------------------------
 2 files changed, 6 insertions(+), 46 deletions(-)
 delete mode 100644 docs/sphinx/source/whatsnew/v0.9.6.rst

diff --git a/docs/sphinx/source/whatsnew/v0.10.4.rst b/docs/sphinx/source/whatsnew/v0.10.4.rst
index c61ce8c658..779a8dc269 100644
--- a/docs/sphinx/source/whatsnew/v0.10.4.rst
+++ b/docs/sphinx/source/whatsnew/v0.10.4.rst
@@ -17,6 +17,10 @@ Enhancements
 * Added function :py:func:`pvlib.shading.projected_solar_zenith_angle`,
   a common calculation in shading and tracking. (:issue:`1734`, :pull:`1904`)
 
+* Added functions `pvlib.shading.tracker_shaded_fraction` and
+  `pvlib.shading.linear_shade_loss` to calculate row-to-row shade and apply
+  linear shade loss for thin film CdTe modules like First Solar.
+  (:issue:`1689`, :issue:`1690`, :pull:`1962`)
 
 Bug fixes
 ~~~~~~~~~
@@ -61,3 +65,5 @@ Contributors
 * Adam R. Jensen (:ghuser:`AdamRJensen`)
 * Kevin Anderson (:ghuser:`kandersolar`)
 * Peter Dudfield (:ghuser:`peterdudfield`)
+* Mark A. Mikofski (:ghuser:`mikofski`)
+* Echedey Luis (:ghuser:`echedey-ls`)
diff --git a/docs/sphinx/source/whatsnew/v0.9.6.rst b/docs/sphinx/source/whatsnew/v0.9.6.rst
deleted file mode 100644
index 65575f03bd..0000000000
--- a/docs/sphinx/source/whatsnew/v0.9.6.rst
+++ /dev/null
@@ -1,46 +0,0 @@
-.. _whatsnew_0960:
-
-
-v0.9.6 (Anticipated June 2023)
-------------------------------
-
-
-Deprecations
-~~~~~~~~~~~~
-
-
-Enhancements
-~~~~~~~~~~~~
-* added functions `pvlib.shading.tracker_shaded_fraction` and
-  `pvlib.shading.linear_shade_loss` to calculate row-to-row shade and apply
-  linear shade loss for thin film CdTe modules like First Solar.
-  (:issue:`1689`, :issue:`1690`, :pull:`1725`)
-
-Bug fixes
-~~~~~~~~~
-* `data` can no longer be left unspecified in
-  :py:meth:`pvlib.modelchain.ModelChain.run_model_from_effective_irradiance`.
-  (:issue:`1713`, :pull:`1720`)
-
-Testing
-~~~~~~~
-
-
-Documentation
-~~~~~~~~~~~~~
-* Updated the description of the interval parameter in
-  :py:func:`pvlib.iotools.get_psm3`. (:issue:`1702`, :pull:`1712`)
-
-Benchmarking
-~~~~~~~~~~~~~
-
-
-Requirements
-~~~~~~~~~~~~
-
-
-Contributors
-~~~~~~~~~~~~
-* Adam R. Jensen (:ghuser:`adamrjensen`)
-* Siddharth Kaul (:ghuser:`k10blogger`)
-* Mark A. Mikofski (:ghuser:`mikofski`)

From 4bb02ab994cc7c99c74d5b780aed97ad55024e56 Mon Sep 17 00:00:00 2001
From: echedey-ls <80125792+echedey-ls@users.noreply.github.com>
Date: Sun, 4 Feb 2024 00:26:53 +0100
Subject: [PATCH 053/185] Linter

---
 pvlib/tests/test_shading.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/pvlib/tests/test_shading.py b/pvlib/tests/test_shading.py
index 13d4ac1532..8a56ad519d 100644
--- a/pvlib/tests/test_shading.py
+++ b/pvlib/tests/test_shading.py
@@ -228,7 +228,7 @@ def test_projected_solar_zenith_angle_datatypes(
 @pytest.fixture
 def sf_premises_and_expected():
     """Data comprised of solar position, tracker orientations, ground coverage
-    ratios and terrain slopes with respective shade fractions (sf)"""   
+    ratios and terrain slopes with respective shade fractions (sf)"""
     # preserve tracker_shade_fraction's args order and append shadow depth, z
     premises_and_results = pd.DataFrame(
         columns=["solar_zenith", "solar_azimuth", "tracker_tilt",

From 78c481e5dbffa97386faf065821aad438ec7898a Mon Sep 17 00:00:00 2001
From: echedey-ls <80125792+echedey-ls@users.noreply.github.com>
Date: Sun, 4 Feb 2024 01:02:39 +0100
Subject: [PATCH 054/185] Clear things, convert Mark's reference to a reference

---
 pvlib/shading.py            |  4 ++--
 pvlib/tests/test_shading.py | 15 +++++++++------
 2 files changed, 11 insertions(+), 8 deletions(-)

diff --git a/pvlib/shading.py b/pvlib/shading.py
index e37b987299..71fc7bee15 100644
--- a/pvlib/shading.py
+++ b/pvlib/shading.py
@@ -405,8 +405,8 @@ def tracker_shaded_fraction(solar_zenith, solar_azimuth, tracker_tilt,
 
     References
     ----------
-    Mark A. Mikofski, "First Solar Irradiance Shade Losses on Sloped Terrain,"
-    PVPMC, 2023
+    .. [1] Mark A. Mikofski, "First Solar Irradiance Shade Losses on Sloped 
+       Terrain," PVPMC, 2023
     """
     theta_g_rad = np.radians(cross_axis_slope)
     # projected solar zenith:
diff --git a/pvlib/tests/test_shading.py b/pvlib/tests/test_shading.py
index 8a56ad519d..dbfae6355f 100644
--- a/pvlib/tests/test_shading.py
+++ b/pvlib/tests/test_shading.py
@@ -228,8 +228,11 @@ def test_projected_solar_zenith_angle_datatypes(
 @pytest.fixture
 def sf_premises_and_expected():
     """Data comprised of solar position, tracker orientations, ground coverage
-    ratios and terrain slopes with respective shade fractions (sf)"""
-    # preserve tracker_shade_fraction's args order and append shadow depth, z
+    ratios and terrain slopes with respective shade fractions (sf).
+    Returns a 2-tuple with the premises to be used directly in
+    tracker_shade_fraction(...) in the first element and the expected shaded
+    fractions on the second element"""
+    # tracker_shade_fraction's args order and append shadow depth, z
     premises_and_results = pd.DataFrame(
         columns=["solar_zenith", "solar_azimuth", "tracker_tilt",
                  "tracker_azimuth", "gcr", "cross_axis_slope", "z"],
@@ -245,14 +248,14 @@ def sf_premises_and_expected():
         ))
     # append shaded fraction
     premises_and_results["shaded_fraction"] = 1 - 1/premises_and_results["z"]
-    return premises_and_results
+    return (premises_and_results.drop(columns=["z", "shaded_fraction"]),
+            premises_and_results["shaded_fraction"])
 
 
 def test_tracker_shade_fraction(sf_premises_and_expected):
     """Tests tracker_shade_fraction"""
     # unwrap sf_premises_and_expected values premises and expected results
-    premises = sf_premises_and_expected.drop(columns=["z", "shaded_fraction"])
-    expected_sf_array = sf_premises_and_expected["shaded_fraction"]
+    premises, expected_sf_array = sf_premises_and_expected
     # test scalar inputs from the row iterator
     # series label := corresponding index in expected_sf_array
     for index, premise in premises.iterrows():
@@ -266,7 +269,7 @@ def test_tracker_shade_fraction(sf_premises_and_expected):
 
 
 def test_linear_shade_loss(sf_premises_and_expected):
-    expected_sf_array = sf_premises_and_expected["shaded_fraction"]
+    _, expected_sf_array = sf_premises_and_expected  # Premises are not needed
     loss = shading.linear_shade_loss(expected_sf_array[0], 0.2)
     assert_allclose(loss, 0.09289321881345258)
     # if no diffuse, shade fraction is the loss

From 0ce0d68c1503d0c9643d25c4b5d70e9c4b8cb092 Mon Sep 17 00:00:00 2001
From: echedey-ls <80125792+echedey-ls@users.noreply.github.com>
Date: Sun, 4 Feb 2024 01:07:24 +0100
Subject: [PATCH 055/185] Linter

---
 pvlib/shading.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/pvlib/shading.py b/pvlib/shading.py
index 71fc7bee15..862f070920 100644
--- a/pvlib/shading.py
+++ b/pvlib/shading.py
@@ -405,7 +405,7 @@ def tracker_shaded_fraction(solar_zenith, solar_azimuth, tracker_tilt,
 
     References
     ----------
-    .. [1] Mark A. Mikofski, "First Solar Irradiance Shade Losses on Sloped 
+    .. [1] Mark A. Mikofski, "First Solar Irradiance Shade Losses on Sloped
        Terrain," PVPMC, 2023
     """
     theta_g_rad = np.radians(cross_axis_slope)

From 74b421538d643fd02c9998ab4f4a5297fa62e628 Mon Sep 17 00:00:00 2001
From: echedey-ls <80125792+echedey-ls@users.noreply.github.com>
Date: Thu, 15 Feb 2024 20:33:00 +0100
Subject: [PATCH 056/185] Update according to changes at PSZA PR

---
 pvlib/shading.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/pvlib/shading.py b/pvlib/shading.py
index 862f070920..ceecb25097 100644
--- a/pvlib/shading.py
+++ b/pvlib/shading.py
@@ -413,11 +413,11 @@ def tracker_shaded_fraction(solar_zenith, solar_azimuth, tracker_tilt,
     # consider the angle the sun direct beam has on the vertical plane which
     # contains the tracker normal vector, with respect to a horizontal line
     projected_solar_zenith = projected_solar_zenith_angle(
+        solar_zenith,
+        solar_azimuth,
         0,  # no rotation from the horizontal
         # the vector that defines the projection plane for prior conditions
         tracker_azimuth-90,
-        solar_zenith,
-        solar_azimuth
     )
     # angle opposite shadow cast on the ground, z
     angle_z = (

From 909cc23c6982727d830750555e13fba272f4f468 Mon Sep 17 00:00:00 2001
From: echedey-ls <80125792+echedey-ls@users.noreply.github.com>
Date: Wed, 28 Feb 2024 00:32:58 +0100
Subject: [PATCH 057/185] Another commit, another try

---
 pvlib/shading.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/pvlib/shading.py b/pvlib/shading.py
index ceecb25097..874b45bd5f 100644
--- a/pvlib/shading.py
+++ b/pvlib/shading.py
@@ -278,7 +278,7 @@ def projected_solar_zenith_angle(solar_zenith, solar_azimuth,
       yields the tracker rotation angle that maximizes direct irradiance
       capture.  This tracking strategy is called
       :ref:`true-tracking
-      <sphx_glr_plot_single_axis_tracking.py:True-tracking>`.
+      <sphx_glr_gallery_solar-tracking_plot_single_axis_tracking.py:True-tracking>`.
 
     - Self-shading in large PV arrays is often modeled by assuming
       a simplified 2-D array geometry where the sun's position is

From e3e73f6c0f160cd321ebfb0081e8792370c45004 Mon Sep 17 00:00:00 2001
From: echedey-ls <80125792+echedey-ls@users.noreply.github.com>
Date: Fri, 8 Mar 2024 17:03:27 +0100
Subject: [PATCH 058/185] Ahhh, I rebased too fast

---
 pvlib/shading.py | 15 +++++++--------
 1 file changed, 7 insertions(+), 8 deletions(-)

diff --git a/pvlib/shading.py b/pvlib/shading.py
index 874b45bd5f..b6cf08b69a 100644
--- a/pvlib/shading.py
+++ b/pvlib/shading.py
@@ -85,7 +85,7 @@ def masking_angle(surface_tilt, gcr, slant_height):
     ----------
     .. [1] D. Passias and B. Källbäck, "Shading effects in rows of solar cell
        panels", Solar Cells, Volume 11, Pages 281-291.  1984.
-       DOI: 10.1016/0379-6787(84)90017-6
+       :doi:`10.1016/0379-6787(84)90017-6`
     .. [2] Gilman, P. et al., (2018). "SAM Photovoltaic Model Technical
        Reference Update", NREL Technical Report NREL/TP-6A20-67399.
        Available at https://www.nrel.gov/docs/fy18osti/67399.pdf
@@ -167,7 +167,7 @@ def masking_angle_passias(surface_tilt, gcr):
     ----------
     .. [1] D. Passias and B. Källbäck, "Shading effects in rows of solar cell
        panels", Solar Cells, Volume 11, Pages 281-291.  1984.
-       DOI: 10.1016/0379-6787(84)90017-6
+       :doi:`10.1016/0379-6787(84)90017-6`
     """
     # wrap it in an array so that division by zero is handled well
     beta = np.radians(np.array(surface_tilt))
@@ -226,7 +226,7 @@ def sky_diffuse_passias(masking_angle):
     ----------
     .. [1] D. Passias and B. Källbäck, "Shading effects in rows of solar cell
        panels", Solar Cells, Volume 11, Pages 281-291.  1984.
-       DOI: 10.1016/0379-6787(84)90017-6
+       :doi:`10.1016/0379-6787(84)90017-6`
     .. [2] Gilman, P. et al., (2018). "SAM Photovoltaic Model Technical
        Reference Update", NREL Technical Report NREL/TP-6A20-67399.
        Available at https://www.nrel.gov/docs/fy18osti/67399.pdf
@@ -247,7 +247,7 @@ def projected_solar_zenith_angle(solar_zenith, solar_azimuth,
     .. figure:: ../../_images/Anderson_Mikofski_2020_Fig5.jpg
        :alt: Wire diagram of coordinates systems to obtain the projected angle.
        :align: center
-       :scale: 75 %
+       :scale: 50 %
 
        Fig. 5, [1]_: Solar coordinates projection onto tracker rotation plane.
 
@@ -276,9 +276,9 @@ def projected_solar_zenith_angle(solar_zenith, solar_azimuth,
       the axis of a single-axis tracker (i.e. the plane
       whose normal vector coincides with the tracker torque tube)
       yields the tracker rotation angle that maximizes direct irradiance
-      capture.  This tracking strategy is called
-      :ref:`true-tracking
-      <sphx_glr_gallery_solar-tracking_plot_single_axis_tracking.py:True-tracking>`.
+      capture. This tracking strategy is called *true-tracking*. Learn more
+      about tracking in
+      :ref:`sphx_glr_gallery_solar-tracking_plot_single_axis_tracking.py`.
 
     - Self-shading in large PV arrays is often modeled by assuming
       a simplified 2-D array geometry where the sun's position is
@@ -288,7 +288,6 @@ def projected_solar_zenith_angle(solar_zenith, solar_azimuth,
 
     Examples
     --------
-
     Calculate the ideal true-tracking angle for a horizontal north-south
     single-axis tracker:
 

From cbb0b04afd7cd7e610917c1dbaac9e3f639a6bb9 Mon Sep 17 00:00:00 2001
From: echedey-ls <80125792+echedey-ls@users.noreply.github.com>
Date: Fri, 8 Mar 2024 17:05:38 +0100
Subject: [PATCH 059/185] whatsnews

---
 docs/sphinx/source/whatsnew/v0.10.3.rst | 1 -
 docs/sphinx/source/whatsnew/v0.10.4.rst | 2 --
 2 files changed, 3 deletions(-)

diff --git a/docs/sphinx/source/whatsnew/v0.10.3.rst b/docs/sphinx/source/whatsnew/v0.10.3.rst
index 87b6c72f1f..786989fe26 100644
--- a/docs/sphinx/source/whatsnew/v0.10.3.rst
+++ b/docs/sphinx/source/whatsnew/v0.10.3.rst
@@ -75,4 +75,3 @@ Contributors
 * Mark Mikofski (:ghuser:`mikofski`)
 * Phoebe Pearce (:ghuser:`phoebe-p`)
 * Eva-Maria Grommes (:ghuser:`EwaGomez`)
-* Echedey Luis (:ghuser:`echedey-ls`)
diff --git a/docs/sphinx/source/whatsnew/v0.10.4.rst b/docs/sphinx/source/whatsnew/v0.10.4.rst
index 779a8dc269..e75ead7a5c 100644
--- a/docs/sphinx/source/whatsnew/v0.10.4.rst
+++ b/docs/sphinx/source/whatsnew/v0.10.4.rst
@@ -16,7 +16,6 @@ Enhancements
   convention of returning a tuple of (data, meta). Previously the function only returned a dataframe. (:pull:`1968`)
 * Added function :py:func:`pvlib.shading.projected_solar_zenith_angle`,
   a common calculation in shading and tracking. (:issue:`1734`, :pull:`1904`)
-
 * Added functions `pvlib.shading.tracker_shaded_fraction` and
   `pvlib.shading.linear_shade_loss` to calculate row-to-row shade and apply
   linear shade loss for thin film CdTe modules like First Solar.
@@ -66,4 +65,3 @@ Contributors
 * Kevin Anderson (:ghuser:`kandersolar`)
 * Peter Dudfield (:ghuser:`peterdudfield`)
 * Mark A. Mikofski (:ghuser:`mikofski`)
-* Echedey Luis (:ghuser:`echedey-ls`)

From 96b61a807b696e2ea034832b3fda7ea4383c9e6e Mon Sep 17 00:00:00 2001
From: echedey-ls <80125792+echedey-ls@users.noreply.github.com>
Date: Fri, 8 Mar 2024 17:07:08 +0100
Subject: [PATCH 060/185] Update v0.10.4.rst

---
 docs/sphinx/source/whatsnew/v0.10.4.rst | 2 --
 1 file changed, 2 deletions(-)

diff --git a/docs/sphinx/source/whatsnew/v0.10.4.rst b/docs/sphinx/source/whatsnew/v0.10.4.rst
index e75ead7a5c..330c2cc92b 100644
--- a/docs/sphinx/source/whatsnew/v0.10.4.rst
+++ b/docs/sphinx/source/whatsnew/v0.10.4.rst
@@ -14,8 +14,6 @@ Enhancements
   the SOLRAD ground station network. (:pull:`1967`)
 * Added metadata parsing to :py:func:`~pvlib.iotools.read_solrad` to follow the standard iotools
   convention of returning a tuple of (data, meta). Previously the function only returned a dataframe. (:pull:`1968`)
-* Added function :py:func:`pvlib.shading.projected_solar_zenith_angle`,
-  a common calculation in shading and tracking. (:issue:`1734`, :pull:`1904`)
 * Added functions `pvlib.shading.tracker_shaded_fraction` and
   `pvlib.shading.linear_shade_loss` to calculate row-to-row shade and apply
   linear shade loss for thin film CdTe modules like First Solar.

From d2b92914d8cf5342e80721893caae2bdacb3dde4 Mon Sep 17 00:00:00 2001
From: echedey-ls <80125792+echedey-ls@users.noreply.github.com>
Date: Fri, 8 Mar 2024 17:11:37 +0100
Subject: [PATCH 061/185] Update v0.10.3.rst

---
 docs/sphinx/source/whatsnew/v0.10.3.rst | 2 --
 1 file changed, 2 deletions(-)

diff --git a/docs/sphinx/source/whatsnew/v0.10.3.rst b/docs/sphinx/source/whatsnew/v0.10.3.rst
index 786989fe26..4d222fca06 100644
--- a/docs/sphinx/source/whatsnew/v0.10.3.rst
+++ b/docs/sphinx/source/whatsnew/v0.10.3.rst
@@ -23,8 +23,6 @@ Enhancements
 * Add :py:func:`pvlib.iotools.read_solaranywhere` and
   :py:func:`pvlib.iotools.get_solaranywhere` for reading and retrieving
   SolarAnywhere solar irradiance data. (:pull:`1497`, :discuss:`1310`)
-* Added function :py:func:`pvlib.shading.projected_solar_zenith_angle`,
-  a common calculation in shading and tracking. (:issue:`1734`, :pull:`1904`)
 
 Bug fixes
 ~~~~~~~~~

From bbc6115923a7c1a4b6ad8a8a4bebeaeb6bb505aa Mon Sep 17 00:00:00 2001
From: echedey-ls <80125792+echedey-ls@users.noreply.github.com>
Date: Thu, 14 Mar 2024 20:20:45 +0100
Subject: [PATCH 062/185] Rename to `shaded_fraction1d`, change params to
 `surface_*` instead of `tracker_*`

---
 pvlib/shading.py            | 24 ++++++++++++++----------
 pvlib/tests/test_shading.py | 35 +++++++++++++++++------------------
 2 files changed, 31 insertions(+), 28 deletions(-)

diff --git a/pvlib/shading.py b/pvlib/shading.py
index b6cf08b69a..961efad4c1 100644
--- a/pvlib/shading.py
+++ b/pvlib/shading.py
@@ -344,10 +344,13 @@ def projected_solar_zenith_angle(solar_zenith, solar_azimuth,
     return theta_T
 
 
-def tracker_shaded_fraction(solar_zenith, solar_azimuth, tracker_tilt,
-                            tracker_azimuth, gcr, cross_axis_slope=0):
+def shaded_fraction1d(solar_zenith, solar_azimuth, surface_tilt,
+                      surface_azimuth, gcr, cross_axis_slope=0):
     r"""
-    Shaded fraction for trackers with a common angle on an east-west slope.
+    Shaded fraction in the vertical dimension of the rows.
+
+    Assumes both the shaded row and the one blocking the direct beam share
+    the same tilt and azimuth values.
 
     Parameters
     ----------
@@ -355,16 +358,17 @@ def tracker_shaded_fraction(solar_zenith, solar_azimuth, tracker_tilt,
         Solar position zenith, in degrees.
     solar_azimuth : numeric
         Solar position azimuth, in degrees.
-    tracker_tilt : numeric
+    surface_tilt : numeric
         In degrees.
-    tracker_azimuth : numeric
+    surface_azimuth : numeric
         In degrees. North=0º, South=180º, East=90º, West=270º.
     gcr : numeric
         The ground coverage ratio as a fraction equal to the collector width
         over the horizontal row-to-row pitch.
     cross_axis_slope : numeric, default 0
-        Angle of the plane containing the tracker axes in degrees from
-        horizontal.
+        Angle of the plane containing the rows' axes in degrees from
+        horizontal. A row axis is defined by the vector product of
+        ``surface_tilt`` and ``surface_azimuth``.
 
     Returns
     -------
@@ -377,7 +381,7 @@ def tracker_shaded_fraction(solar_zenith, solar_azimuth, tracker_tilt,
     pvlib.shading.linear_shade_loss
 
 
-    The shaded fraction is derived using trigonometery and similar triangles
+    The shaded fraction is derived using trigonometry and similar triangles
     from the tracker rotation :math:`\beta`, the ground slope :math:`\theta_g`,
     the projected solar zenith (psz) :math:`\theta`, the collector width
     :math:`L`, the row-to-row pitch :math:`P`, and the shadow length :math:`z`
@@ -416,11 +420,11 @@ def tracker_shaded_fraction(solar_zenith, solar_azimuth, tracker_tilt,
         solar_azimuth,
         0,  # no rotation from the horizontal
         # the vector that defines the projection plane for prior conditions
-        tracker_azimuth-90,
+        surface_azimuth-90,
     )
     # angle opposite shadow cast on the ground, z
     angle_z = (
-        np.pi / 2 - np.radians(tracker_tilt)
+        np.pi / 2 - np.radians(surface_tilt)
         + np.radians(projected_solar_zenith))
     # angle opposite the collector width, L
     angle_gcr = (
diff --git a/pvlib/tests/test_shading.py b/pvlib/tests/test_shading.py
index dbfae6355f..077c90e461 100644
--- a/pvlib/tests/test_shading.py
+++ b/pvlib/tests/test_shading.py
@@ -227,44 +227,43 @@ def test_projected_solar_zenith_angle_datatypes(
 
 @pytest.fixture
 def sf_premises_and_expected():
-    """Data comprised of solar position, tracker orientations, ground coverage
+    """Data comprised of solar position, rows orientations, ground coverage
     ratios and terrain slopes with respective shade fractions (sf).
     Returns a 2-tuple with the premises to be used directly in
-    tracker_shade_fraction(...) in the first element and the expected shaded
+    shaded_fraction1d(...) in the first element and the expected shaded
     fractions on the second element"""
-    # tracker_shade_fraction's args order and append shadow depth, z
+    # shaded_fraction1d's args order and append shadow depth, z
     premises_and_results = pd.DataFrame(
-        columns=["solar_zenith", "solar_azimuth", "tracker_tilt",
-                 "tracker_azimuth", "gcr", "cross_axis_slope", "z"],
+        columns=["solar_zenith", "solar_azimuth", "surface_tilt",
+                 "surface_azimuth", "gcr", "cross_axis_slope", "z"],
         data=(
-            # trivial case, 80% gcr, no slope, trackers & psz at 45-deg
-            (45, 90., 45, 90., 0.8, 0, np.sqrt(2*0.8*0.8)),
-            # another trivial case, 60% gcr, no slope, trackers & psz at 60-deg
+            # trivial case, 80% gcr, no slope, rows & psz at 45-deg
+            (45, 90., 45, 90., 0.8, 0, 0.8*np.sqrt(2)),
+            # another trivial case, 60% gcr, no slope, rows & psz at 60-deg
             (60, 120, 60, 120, 0.6, 0, 2*0.6),
-            # 30-deg isosceles, 60% gcr, no slope, 30-deg trackers, psz 60-deg
+            # 30-deg isosceles, 60% gcr, no slope, 30-deg rows, psz 60-deg
             (60, 135, 30, 135, 0.6, 0, 0.6*np.sqrt(3)),
             # no shading, 40% gcr, shadow is only 0.565-m long < 1-m r2r P
             (45, 180, 45, 180, 0.4, 0, 1)  # z := 1 means no shadow
         ))
     # append shaded fraction
     premises_and_results["shaded_fraction"] = 1 - 1/premises_and_results["z"]
+    # return 1st: premises dataframe first and 2nd: shaded fraction series
     return (premises_and_results.drop(columns=["z", "shaded_fraction"]),
             premises_and_results["shaded_fraction"])
 
 
-def test_tracker_shade_fraction(sf_premises_and_expected):
-    """Tests tracker_shade_fraction"""
+def test_shade_fraction1d(sf_premises_and_expected):
+    """Tests shaded_fraction1d"""
     # unwrap sf_premises_and_expected values premises and expected results
     premises, expected_sf_array = sf_premises_and_expected
-    # test scalar inputs from the row iterator
-    # series label := corresponding index in expected_sf_array
-    for index, premise in premises.iterrows():
-        expected_result = expected_sf_array[index]
-        sf = shading.tracker_shaded_fraction(**premise)
-        assert_allclose(sf, expected_result)
+    # test scalar input
+    expected_result = expected_sf_array.iloc[0]
+    sf = shading.shaded_fraction1d(**premises.iloc[0])
+    assert_allclose(sf, expected_result)
 
     # test vector inputs
-    sf_vec = shading.tracker_shaded_fraction(**premises)
+    sf_vec = shading.shaded_fraction1d(**premises)
     assert_allclose(sf_vec, expected_sf_array)
 
 

From 39a3ba9999052b2ee7a450b22ededc78e0f89c17 Mon Sep 17 00:00:00 2001
From: echedey-ls <80125792+echedey-ls@users.noreply.github.com>
Date: Thu, 14 Mar 2024 20:25:53 +0100
Subject: [PATCH 063/185] Left this tracker refs behind

---
 pvlib/shading.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/pvlib/shading.py b/pvlib/shading.py
index 961efad4c1..bf1ad3574e 100644
--- a/pvlib/shading.py
+++ b/pvlib/shading.py
@@ -382,7 +382,7 @@ def shaded_fraction1d(solar_zenith, solar_azimuth, surface_tilt,
 
 
     The shaded fraction is derived using trigonometry and similar triangles
-    from the tracker rotation :math:`\beta`, the ground slope :math:`\theta_g`,
+    from the row rotation :math:`\beta`, the ground slope :math:`\theta_g`,
     the projected solar zenith (psz) :math:`\theta`, the collector width
     :math:`L`, the row-to-row pitch :math:`P`, and the shadow length :math:`z`
     as shown in the image below.
@@ -414,7 +414,7 @@ def shaded_fraction1d(solar_zenith, solar_azimuth, surface_tilt,
     theta_g_rad = np.radians(cross_axis_slope)
     # projected solar zenith:
     # consider the angle the sun direct beam has on the vertical plane which
-    # contains the tracker normal vector, with respect to a horizontal line
+    # contains the row's normal vector, with respect to a horizontal line
     projected_solar_zenith = projected_solar_zenith_angle(
         solar_zenith,
         solar_azimuth,

From a3ccf3ef3ddfc926022d1e15734248c27730401b Mon Sep 17 00:00:00 2001
From: echedey-ls <80125792+echedey-ls@users.noreply.github.com>
Date: Thu, 14 Mar 2024 20:31:35 +0100
Subject: [PATCH 064/185] Change rename in rst entries

---
 .../source/reference/effects_on_pv_system_output/shading.rst    | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/sphinx/source/reference/effects_on_pv_system_output/shading.rst b/docs/sphinx/source/reference/effects_on_pv_system_output/shading.rst
index 189c299fa2..9acb17176a 100644
--- a/docs/sphinx/source/reference/effects_on_pv_system_output/shading.rst
+++ b/docs/sphinx/source/reference/effects_on_pv_system_output/shading.rst
@@ -11,6 +11,6 @@ Shading
    shading.masking_angle_passias
    shading.sky_diffuse_passias
    shading.projected_solar_zenith_angle
-   shading.tracker_shaded_fraction
+   shading.shaded_fraction1d
    shading.linear_shade_loss
    

From e5fffcaaa1f382b1c2d9ede8fd6e2d3dcf4082ce Mon Sep 17 00:00:00 2001
From: echedey-ls <80125792+echedey-ls@users.noreply.github.com>
Date: Thu, 14 Mar 2024 21:15:36 +0100
Subject: [PATCH 065/185] Add another testcase

---
 pvlib/tests/test_shading.py | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/pvlib/tests/test_shading.py b/pvlib/tests/test_shading.py
index 077c90e461..7103831635 100644
--- a/pvlib/tests/test_shading.py
+++ b/pvlib/tests/test_shading.py
@@ -244,7 +244,9 @@ def sf_premises_and_expected():
             # 30-deg isosceles, 60% gcr, no slope, 30-deg rows, psz 60-deg
             (60, 135, 30, 135, 0.6, 0, 0.6*np.sqrt(3)),
             # no shading, 40% gcr, shadow is only 0.565-m long < 1-m r2r P
-            (45, 180, 45, 180, 0.4, 0, 1)  # z := 1 means no shadow
+            (45, 180, 45, 180, 0.4, 0, 1),  # z := 1 means no shadow
+            # no shading, sun behind (~1st case, row azimuth+180, lower zenith)
+            (40, 180, 45, 90., 0.8, 0, 1),  # z := 1 means no shadow
         ))
     # append shaded fraction
     premises_and_results["shaded_fraction"] = 1 - 1/premises_and_results["z"]

From 457d4b4813b65d9c06a0e9798ddc4e7f13557dbb Mon Sep 17 00:00:00 2001
From: echedey-ls <80125792+echedey-ls@users.noreply.github.com>
Date: Thu, 14 Mar 2024 21:16:26 +0100
Subject: [PATCH 066/185] Improve docs references, clarify nomenclature

Co-Authored-By: Kevin Anderson <57452607+kandersolar@users.noreply.github.com>
---
 .../_images/Anderson_Mikofski_2020_Fig9.png    | Bin 0 -> 36860 bytes
 .../FSLR_irrad_shade_loss_slope_terrain.png    | Bin 127773 -> 0 bytes
 pvlib/shading.py                               |  12 +++++++++---
 3 files changed, 9 insertions(+), 3 deletions(-)
 create mode 100644 docs/sphinx/source/_images/Anderson_Mikofski_2020_Fig9.png
 delete mode 100644 docs/sphinx/source/_images/FSLR_irrad_shade_loss_slope_terrain.png

diff --git a/docs/sphinx/source/_images/Anderson_Mikofski_2020_Fig9.png b/docs/sphinx/source/_images/Anderson_Mikofski_2020_Fig9.png
new file mode 100644
index 0000000000000000000000000000000000000000..8e49952d1f7393c9129198fca97217f5ecc71de3
GIT binary patch
literal 36860
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
LI`iUm2l4*_rj@mW

literal 0
HcmV?d00001

diff --git a/docs/sphinx/source/_images/FSLR_irrad_shade_loss_slope_terrain.png b/docs/sphinx/source/_images/FSLR_irrad_shade_loss_slope_terrain.png
deleted file mode 100644
index d2f01c2e887a1f85abb952d33d02175272df15be..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 127773
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

diff --git a/pvlib/shading.py b/pvlib/shading.py
index bf1ad3574e..a7d0f82e46 100644
--- a/pvlib/shading.py
+++ b/pvlib/shading.py
@@ -387,9 +387,9 @@ def shaded_fraction1d(solar_zenith, solar_azimuth, surface_tilt,
     :math:`L`, the row-to-row pitch :math:`P`, and the shadow length :math:`z`
     as shown in the image below.
 
-    .. image:: /_images/FSLR_irrad_shade_loss_slope_terrain.png
+    .. image:: /_images/Anderson_Mikofski_2020_Fig9.png
        :alt: Cross-section of two arrays on a sloped terrain and the resulting
-             shade.
+             shade. Figure 9, [1]_
 
     The ratio of the shadow length to the pitch, :math:`z/P`, is given by the
     following relation where the ground coverage ratio (GCR) is :math:`L/P`:
@@ -408,9 +408,15 @@ def shaded_fraction1d(solar_zenith, solar_azimuth, surface_tilt,
 
     References
     ----------
-    .. [1] Mark A. Mikofski, "First Solar Irradiance Shade Losses on Sloped
+    .. [1] K. Anderson and M. Mikofski, 'Slope-Aware Backtracking for
+       Single-Axis Trackers', National Renewable Energy Lab. (NREL), Golden,
+       CO (United States);
+       NREL/TP-5K00-76626, Jul. 2020. :doi:`10.2172/1660126`.
+    .. [2] Mark A. Mikofski, "First Solar Irradiance Shade Losses on Sloped
        Terrain," PVPMC, 2023
     """
+    # Original implementation by Mikofski, updated to conform to codebase by
+    # Echedey. For nomenclature, please refer to [2].
     theta_g_rad = np.radians(cross_axis_slope)
     # projected solar zenith:
     # consider the angle the sun direct beam has on the vertical plane which

From f11858e71b5cd67460a5d69b401444cf2f1f9314 Mon Sep 17 00:00:00 2001
From: echedey-ls <80125792+echedey-ls@users.noreply.github.com>
Date: Thu, 14 Mar 2024 21:21:15 +0100
Subject: [PATCH 067/185] Update test_shading.py

---
 pvlib/tests/test_shading.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/pvlib/tests/test_shading.py b/pvlib/tests/test_shading.py
index 7103831635..f701186336 100644
--- a/pvlib/tests/test_shading.py
+++ b/pvlib/tests/test_shading.py
@@ -280,5 +280,5 @@ def test_linear_shade_loss(sf_premises_and_expected):
     no_loss = shading.linear_shade_loss(expected_sf_array[0], 1.0)
     assert_allclose(no_loss, 0)
     vec_loss = shading.linear_shade_loss(expected_sf_array, 0.2)
-    expected_loss = np.array([0.09289322, 0.13333333, 0.03019964, 0.0])
+    expected_loss = np.array([0.09289322, 0.13333333, 0.03019964, 0., 0.])
     assert_allclose(vec_loss, expected_loss)

From 0ab37206858b821ae183102cb07abf78f2565024 Mon Sep 17 00:00:00 2001
From: echedey-ls <80125792+echedey-ls@users.noreply.github.com>
Date: Sun, 24 Mar 2024 19:09:34 +0100
Subject: [PATCH 068/185] Remove linear_shade_loss

---
 .../effects_on_pv_system_output/shading.rst   |  1 -
 docs/sphinx/source/whatsnew/v0.10.4.rst       |  4 ---
 pvlib/shading.py                              | 36 +------------------
 pvlib/tests/test_shading.py                   | 15 --------
 4 files changed, 1 insertion(+), 55 deletions(-)

diff --git a/docs/sphinx/source/reference/effects_on_pv_system_output/shading.rst b/docs/sphinx/source/reference/effects_on_pv_system_output/shading.rst
index 9acb17176a..57cfe0b806 100644
--- a/docs/sphinx/source/reference/effects_on_pv_system_output/shading.rst
+++ b/docs/sphinx/source/reference/effects_on_pv_system_output/shading.rst
@@ -12,5 +12,4 @@ Shading
    shading.sky_diffuse_passias
    shading.projected_solar_zenith_angle
    shading.shaded_fraction1d
-   shading.linear_shade_loss
    
diff --git a/docs/sphinx/source/whatsnew/v0.10.4.rst b/docs/sphinx/source/whatsnew/v0.10.4.rst
index 1cd2f98b0f..8212b4b94f 100644
--- a/docs/sphinx/source/whatsnew/v0.10.4.rst
+++ b/docs/sphinx/source/whatsnew/v0.10.4.rst
@@ -16,10 +16,6 @@ Enhancements
   the SOLRAD ground station network. (:pull:`1967`)
 * Added metadata parsing to :py:func:`~pvlib.iotools.read_solrad` to follow the standard iotools
   convention of returning a tuple of (data, meta). Previously the function only returned a dataframe. (:pull:`1968`)
-* Added functions `pvlib.shading.tracker_shaded_fraction` and
-  `pvlib.shading.linear_shade_loss` to calculate row-to-row shade and apply
-  linear shade loss for thin film CdTe modules like First Solar.
-  (:issue:`1689`, :issue:`1690`, :pull:`1962`)
 
 
 Bug fixes
diff --git a/pvlib/shading.py b/pvlib/shading.py
index a7d0f82e46..f3e57984b3 100644
--- a/pvlib/shading.py
+++ b/pvlib/shading.py
@@ -378,7 +378,7 @@ def shaded_fraction1d(solar_zenith, solar_azimuth, surface_tilt,
 
     See also
     --------
-    pvlib.shading.linear_shade_loss
+    pvlib.tracking.projected_solar_zenith_angle
 
 
     The shaded fraction is derived using trigonometry and similar triangles
@@ -446,38 +446,4 @@ def shaded_fraction1d(solar_zenith, solar_azimuth, surface_tilt,
     return sf
 
 
-def linear_shade_loss(shaded_fraction, diffuse_fraction):
-    """
-    Fraction of power lost to linear shade loss applicable to monolithic thin
-    film modules like First Solar CdTe, where the shadow is perpendicular to
-    cell scribe lines.
-
-    Parameters
-    ----------
-    shaded_fraction : numeric
-        The fraction of the collector width shaded by an adjacent row. A
-        value of 1 is completely shaded and zero is no shade.
-    diffuse_fraction : numeric
-        The ratio of diffuse plane of array (poa) irradiance to global poa.
-        A value of 1 is completely diffuse and zero is no diffuse.
 
-    Returns
-    -------
-    linear_shade_loss : numeric
-        The fraction of power lost due to linear shading. A value of 1 is all
-        power lost and zero is no loss.
-
-    See also
-    --------
-    pvlib.shading.tracker_shaded_fraction
-
-    Example
-    -------
-    >>> from pvlib import shading
-    >>> sf = shading.tracker_shaded_fraction(45.0, 0.8, 45.0, 0)
-    >>> loss = shading.linear_shade_loss(sf, 0.2)
-    >>> P_no_shade = 100  # [kWdc]  DC output from modules
-    >>> P_linear_shade = P_no_shade * (1-loss)  # [kWdc] output after loss
-    # 90.71067811865476 [kWdc]
-    """
-    return shaded_fraction * (1 - diffuse_fraction)
diff --git a/pvlib/tests/test_shading.py b/pvlib/tests/test_shading.py
index c4aa4d179f..4d810ed8ae 100644
--- a/pvlib/tests/test_shading.py
+++ b/pvlib/tests/test_shading.py
@@ -267,18 +267,3 @@ def test_shade_fraction1d(sf_premises_and_expected):
     # test vector inputs
     sf_vec = shading.shaded_fraction1d(**premises)
     assert_allclose(sf_vec, expected_sf_array)
-
-
-def test_linear_shade_loss(sf_premises_and_expected):
-    _, expected_sf_array = sf_premises_and_expected  # Premises are not needed
-    loss = shading.linear_shade_loss(expected_sf_array[0], 0.2)
-    assert_allclose(loss, 0.09289321881345258)
-    # if no diffuse, shade fraction is the loss
-    loss_no_df = shading.linear_shade_loss(expected_sf_array[0], 0)
-    assert_allclose(loss_no_df, expected_sf_array[0])
-    # if all diffuse, no shade loss
-    no_loss = shading.linear_shade_loss(expected_sf_array[0], 1.0)
-    assert_allclose(no_loss, 0)
-    vec_loss = shading.linear_shade_loss(expected_sf_array, 0.2)
-    expected_loss = np.array([0.09289322, 0.13333333, 0.03019964, 0., 0.])
-    assert_allclose(vec_loss, expected_loss)

From e6da6e82ed30304e1ba1bd0ff3b176476c9608fb Mon Sep 17 00:00:00 2001
From: echedey-ls <80125792+echedey-ls@users.noreply.github.com>
Date: Thu, 28 Mar 2024 18:46:12 +0100
Subject: [PATCH 069/185] First implementation of the new shaded fraction model
 (missing figure)

---
 .../_images/Anderson_Mikofski_2020_Fig9.png   | Bin 36860 -> 0 bytes
 pvlib/shading.py                              | 170 +++++++++++-------
 pvlib/tests/test_shading.py                   | 104 +++++++----
 3 files changed, 175 insertions(+), 99 deletions(-)
 delete mode 100644 docs/sphinx/source/_images/Anderson_Mikofski_2020_Fig9.png

diff --git a/docs/sphinx/source/_images/Anderson_Mikofski_2020_Fig9.png b/docs/sphinx/source/_images/Anderson_Mikofski_2020_Fig9.png
deleted file mode 100644
index 8e49952d1f7393c9129198fca97217f5ecc71de3..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 36860
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
LI`iUm2l4*_rj@mW

diff --git a/pvlib/shading.py b/pvlib/shading.py
index f3e57984b3..d6237bebff 100644
--- a/pvlib/shading.py
+++ b/pvlib/shading.py
@@ -344,13 +344,29 @@ def projected_solar_zenith_angle(solar_zenith, solar_azimuth,
     return theta_T
 
 
-def shaded_fraction1d(solar_zenith, solar_azimuth, surface_tilt,
-                      surface_azimuth, gcr, cross_axis_slope=0):
+def shaded_fraction1d(
+    solar_zenith,
+    solar_azimuth,
+    trackers_axis_azimuth,
+    shaded_tracker_tilt,
+    *,
+    collector_width,
+    row_pitch,
+    surface_to_axis_offset=0,
+    cross_axis_slope=0,
+    shading_tracker_tilt=None,
+):
     r"""
-    Shaded fraction in the vertical dimension of the rows.
+    Shaded fraction in the vertical dimension of tilted rows.
 
-    Assumes both the shaded row and the one blocking the direct beam share
-    the same tilt and azimuth values.
+    If ``shading_tracker_tilt`` isn't provided, assumes both the shaded
+    row and the one blocking the direct beam
+    share the same tilt and azimuth values.
+
+    If only the GCR is known, feed GCR into ``trackers_vertical_length`` and
+    specify ``trackers_row_pitch=1``.
+
+    .. versionadded:: TODO
 
     Parameters
     ----------
@@ -358,17 +374,22 @@ def shaded_fraction1d(solar_zenith, solar_azimuth, surface_tilt,
         Solar position zenith, in degrees.
     solar_azimuth : numeric
         Solar position azimuth, in degrees.
-    surface_tilt : numeric
-        In degrees.
-    surface_azimuth : numeric
+    trackers_axis_azimuth : numeric
         In degrees. North=0º, South=180º, East=90º, West=270º.
-    gcr : numeric
-        The ground coverage ratio as a fraction equal to the collector width
-        over the horizontal row-to-row pitch.
+    shaded_tracker_tilt : numeric
+        Tilt of the tracker receiving the shade in degrees.
+    collector_width : numeric
+        Vertical length of a tilted tracker. The returned ``shaded fraction``
+        is the ratio of the shadow over this value.
+    row_pitch : numeric
+        Axis-to-axis horizontal spacing of the trackers.
+    surface_to_axis_offset : numeric, default 0
+        Distance between the rotating axis and the collector surface.
     cross_axis_slope : numeric, default 0
-        Angle of the plane containing the rows' axes in degrees from
-        horizontal. A row axis is defined by the vector product of
-        ``surface_tilt`` and ``surface_azimuth``.
+        Angle of the plane containing the rows' axes from
+        horizontal. In degrees.
+    shading_tracker_tilt : numeric, optional
+        Tilt of the tracker casting the shadow.
 
     Returns
     -------
@@ -376,74 +397,85 @@ def shaded_fraction1d(solar_zenith, solar_azimuth, surface_tilt,
         The fraction of the collector width shaded by an adjacent row. A
         value of 1 is completely shaded and zero is no shade.
 
+    Notes
+    -----
+    All length parameters must have the same units to produce a reasonable
+    result.
+
+    Parameters are defined as follow:
+
+    .. figure:: Anderson_Jensen_2024_Fig3.png
+        :alt: Diagram showing the two trackers and the parameters of the model.
+
+        +------------------+----------------------------+---------------------+
+        | Symbol           | Parameter                  | Units               |
+        +==================+============================+=====================+
+        | :math:`\theta_1` | ``shading_tracker_tilt``   |                     |
+        +------------------+----------------------------+                     |
+        | :math:`\theta_2` | ``shaded_tracker_tilt``    | Degrees             |
+        +------------------+----------------------------+ :math:`^{\circ}`    |
+        | :math:`\beta_c`  | ``cross_axis_slope``       |                     |
+        +------------------+----------------------------+---------------------+
+        | :math:`p`        | ``row_pitch``              |                     |
+        +------------------+----------------------------+ Any consistent      |
+        | :math:`l`        | ``collector_width``        | length unit.        |
+        +------------------+----------------------------+ E.g. :math:`m` for  |
+        | :math:`z_0`      | ``surface_to_axis_offset`` | all parameters.     |
+        +------------------+----------------------------+---------------------+
+        | :math:`f_s`      | Return value               | Dimensionless       |
+        +------------------+----------------------------+---------------------+
+        Figure 3 of [1]_.
+
     See also
     --------
     pvlib.tracking.projected_solar_zenith_angle
 
-
-    The shaded fraction is derived using trigonometry and similar triangles
-    from the row rotation :math:`\beta`, the ground slope :math:`\theta_g`,
-    the projected solar zenith (psz) :math:`\theta`, the collector width
-    :math:`L`, the row-to-row pitch :math:`P`, and the shadow length :math:`z`
-    as shown in the image below.
-
-    .. image:: /_images/Anderson_Mikofski_2020_Fig9.png
-       :alt: Cross-section of two arrays on a sloped terrain and the resulting
-             shade. Figure 9, [1]_
-
-    The ratio of the shadow length to the pitch, :math:`z/P`, is given by the
-    following relation where the ground coverage ratio (GCR) is :math:`L/P`:
-
-    .. math::
-       \frac{z/P}{\sin{\left(\frac{\pi}{2}-\beta+\theta\right)}}
-       = \frac{GCR}{\sin{\left(\frac{\pi}{2}-\theta-\theta_g\right)}}
-
-    Then the shaded fraction :math:`w/L` is derived from :math:`z/P` as
-    follows:
-
-    .. math::
-       \frac{w}{L} = 1 - \frac{P}{z\cos{\theta_g}}
-
-    Finally, shade is zero if :math:`z\cos{\theta_g}/P \le 1`.
-
     References
     ----------
-    .. [1] K. Anderson and M. Mikofski, 'Slope-Aware Backtracking for
-       Single-Axis Trackers', National Renewable Energy Lab. (NREL), Golden,
-       CO (United States);
-       NREL/TP-5K00-76626, Jul. 2020. :doi:`10.2172/1660126`.
-    .. [2] Mark A. Mikofski, "First Solar Irradiance Shade Losses on Sloped
-       Terrain," PVPMC, 2023
+    .. [1] TODO
     """
-    # Original implementation by Mikofski, updated to conform to codebase by
-    # Echedey. For nomenclature, please refer to [2].
-    theta_g_rad = np.radians(cross_axis_slope)
+    # For nomenclature you may refer to [1].
+
+    # tilt of the tracker casting the shadow defaults to shaded tracker tilt
+    if shading_tracker_tilt is None:
+        shading_tracker_tilt = shaded_tracker_tilt
+
     # projected solar zenith:
     # consider the angle the sun direct beam has on the vertical plane which
     # contains the row's normal vector, with respect to a horizontal line
     projected_solar_zenith = projected_solar_zenith_angle(
         solar_zenith,
         solar_azimuth,
-        0,  # no rotation from the horizontal
+        0,  # no rotation from the horizontal plane
         # the vector that defines the projection plane for prior conditions
-        surface_azimuth-90,
+        trackers_axis_azimuth,
+    )
+    
+    # calculate repeated elements 
+    thetas_1_S_diff = shading_tracker_tilt - projected_solar_zenith
+    thetas_2_S_diff = shaded_tracker_tilt - projected_solar_zenith
+    thetaS_tilt_diff = projected_solar_zenith - cross_axis_slope
+
+    cos_theta_2_S_diff_abs = np.abs(cosd(thetas_2_S_diff))
+
+    # Eq. (12) of [1]
+    t_asterisk = (
+        0.5
+        + np.abs(cosd(thetas_1_S_diff)) / cos_theta_2_S_diff_abs / 2
+        + (
+            np.sign(projected_solar_zenith)
+            * surface_to_axis_offset
+            / collector_width
+            / cos_theta_2_S_diff_abs
+            * (sind(thetas_2_S_diff) - sind(thetas_1_S_diff))
+        )
+        - (
+            row_pitch
+            / collector_width
+            * cosd(thetaS_tilt_diff)
+            / cos_theta_2_S_diff_abs
+            / cosd(cross_axis_slope)
+        )
     )
-    # angle opposite shadow cast on the ground, z
-    angle_z = (
-        np.pi / 2 - np.radians(surface_tilt)
-        + np.radians(projected_solar_zenith))
-    # angle opposite the collector width, L
-    angle_gcr = (
-        np.pi / 2 - np.radians(projected_solar_zenith)
-        - theta_g_rad)
-    # ratio of shadow, z, to pitch, P
-    zp = gcr * np.sin(angle_z) / np.sin(angle_gcr)
-    # there's only row-to-row shade loss if the shadow on the ground, z, is
-    # longer than row-to-row pitch projected on the ground, P*cos(theta_g)
-    zp_cos_g = zp*np.cos(theta_g_rad)
-    # shaded fraction (sf)
-    sf = np.where(zp_cos_g <= 1, 0, 1 - 1/zp_cos_g)
-    return sf
-
-
 
+    return np.clip(t_asterisk, 0, 1)
diff --git a/pvlib/tests/test_shading.py b/pvlib/tests/test_shading.py
index 4d810ed8ae..6cd1be30b7 100644
--- a/pvlib/tests/test_shading.py
+++ b/pvlib/tests/test_shading.py
@@ -2,11 +2,12 @@
 import pandas as pd
 
 from pandas.testing import assert_series_equal
-from numpy.testing import assert_allclose
+from numpy.testing import assert_allclose, assert_approx_equal
 import pytest
 from datetime import timezone, timedelta
 
 from pvlib import shading
+from pvlib.tools import atand
 
 
 @pytest.fixture
@@ -226,44 +227,87 @@ def test_projected_solar_zenith_angle_datatypes(
 
 
 @pytest.fixture
-def sf_premises_and_expected():
-    """Data comprised of solar position, rows orientations, ground coverage
-    ratios and terrain slopes with respective shade fractions (sf).
-    Returns a 2-tuple with the premises to be used directly in
-    shaded_fraction1d(...) in the first element and the expected shaded
-    fractions on the second element"""
-    # shaded_fraction1d's args order and append shadow depth, z
-    premises_and_results = pd.DataFrame(
-        columns=["solar_zenith", "solar_azimuth", "surface_tilt",
-                 "surface_azimuth", "gcr", "cross_axis_slope", "z"],
+def sf1d_premises_and_expected():
+    """Data comprised of solar position, rows parameters and terrain slope
+    with respective shade fractions (sf). Returns a 2-tuple with the premises
+    to be used directly in shaded_fraction1d(...) in the first element and
+    the expected shaded fractions in the second element.
+    See [1] in shaded_fraction1d()
+    Test data sourced from http://doi.org/10.5281/zenodo.10513987
+    """
+    test_data = pd.DataFrame(
+        columns=["x_L", "z_L", "theta_L", "x_R", "z_R", "theta_R", "z_0", "l",
+                 "theta_s", "f_s"],
         data=(
-            # trivial case, 80% gcr, no slope, rows & psz at 45-deg
-            (45, 90., 45, 90., 0.8, 0, 0.8*np.sqrt(2)),
-            # another trivial case, 60% gcr, no slope, rows & psz at 60-deg
-            (60, 120, 60, 120, 0.6, 0, 2*0.6),
-            # 30-deg isosceles, 60% gcr, no slope, 30-deg rows, psz 60-deg
-            (60, 135, 30, 135, 0.6, 0, 0.6*np.sqrt(3)),
-            # no shading, 40% gcr, shadow is only 0.565-m long < 1-m r2r P
-            (45, 180, 45, 180, 0.4, 0, 1),  # z := 1 means no shadow
-            # no shading, sun behind (~1st case, row azimuth+180, lower zenith)
-            (40, 180, 45, 90., 0.8, 0, 1),  # z := 1 means no shadow
-        ))
-    # append shaded fraction
-    premises_and_results["shaded_fraction"] = 1 - 1/premises_and_results["z"]
+            (1, 0.2,  50, 0,   0,  25,    0, 0.5,  80, 1),
+            (1, 0.1,  50, 0,   0,  25, 0.05, 0.5,  80, 0.937191),
+            (1,   0,  50, 0, 0.1,  25,    0, 0.5,  80, 0.30605),
+            (1,   0,  50, 0, 0.2,  25,    0, 0.5,  80, 0),
+            (1, 0.2, -25, 0,   0, -50,    0, 0.5, -80, 0),
+            (1, 0.1, -25, 0,   0, -50,    0, 0.5, -80, 0.30605),
+            (1,   0, -25, 0, 0.1, -50,  0.1, 0.5, -80, 0.881549),
+            (1,   0, -25, 0, 0.2, -50,    0, 0.5, -80, 1),
+            (1, 0.2,   5, 0,   0,  25, 0.05, 0.5,  80, 0.832499),
+            (1, 0.2, -25, 0,   0,  25, 0.05, 0.5,  80, 0.832499),
+            (1, 0.2,   5, 0,   0, -45, 0.05, 0.5,  80, 0.832499),
+            (1, 0.2, -25, 0,   0, -45, 0.05, 0.5,  80, 0.832499),
+            (1,   0, -25, 0, 0.2,  25, 0.05, 0.5, -80, 0.832499),
+            (1,   0, -25, 0, 0.2,  -5, 0.05, 0.5, -80, 0.832499),
+            (1,   0,  45, 0, 0.2,  25, 0.05, 0.5, -80, 0.832499),
+            (1,   0,  45, 0, 0.2,  -5, 0.05, 0.5, -80, 0.832499),
+        ),
+    )  # fmt: skip
+
+    test_data["cross_axis_slope"] = atand(
+        (test_data["z_R"] - test_data["z_L"])
+        / (test_data["x_L"] - test_data["x_R"])
+    )
+    test_data["row_pitch"] = test_data["x_L"] - test_data["x_R"]
+    # switch Left/Right trackers if needed to make the right one the shaded
+    where_switch = test_data["theta_s"] >= 0
+    test_data["theta_L"], test_data["theta_R"] = (
+        np.where(
+            where_switch,
+            test_data["theta_L"],
+            test_data["theta_R"],
+        ),
+        np.where(
+            where_switch,
+            test_data["theta_R"],
+            test_data["theta_L"],
+        ),
+    )
+    test_data.rename(
+        columns={
+            "theta_L": "shading_tracker_tilt",
+            "theta_R": "shaded_tracker_tilt",
+            "z_0": "surface_to_axis_offset",
+            "l": "collector_width",
+            "theta_s": "solar_zenith",  # for the projected solar zenith angle
+            "f_s": "shaded_fraction",
+        },
+        inplace=True,
+    )
+    test_data.drop(columns=["x_L", "z_L", "x_R", "z_R"], inplace=True)
+    # for the projected solar zenith angle
+    # this returns the same psz angle as test_data["solar_zenith"]
+    test_data["solar_azimuth"], test_data["trackers_axis_azimuth"] = 180, 90
+
     # return 1st: premises dataframe first and 2nd: shaded fraction series
-    return (premises_and_results.drop(columns=["z", "shaded_fraction"]),
-            premises_and_results["shaded_fraction"])
+    return (test_data.drop(columns=["shaded_fraction"]),
+            test_data["shaded_fraction"])
 
 
-def test_shade_fraction1d(sf_premises_and_expected):
+def test_shaded_fraction1d(sf1d_premises_and_expected):
     """Tests shaded_fraction1d"""
     # unwrap sf_premises_and_expected values premises and expected results
-    premises, expected_sf_array = sf_premises_and_expected
+    premises, expected_sf_array = sf1d_premises_and_expected
+    premises.to_csv("C:/Users/Yo/Downloads/hola.csv")
     # test scalar input
     expected_result = expected_sf_array.iloc[0]
     sf = shading.shaded_fraction1d(**premises.iloc[0])
-    assert_allclose(sf, expected_result)
+    assert_approx_equal(sf, expected_result, )
 
     # test vector inputs
     sf_vec = shading.shaded_fraction1d(**premises)
-    assert_allclose(sf_vec, expected_sf_array)
+    assert_allclose(sf_vec, expected_sf_array, atol=1e-6)

From 4ce165567c3e5129912cef9be596b2e8b72b1bfc Mon Sep 17 00:00:00 2001
From: echedey-ls <80125792+echedey-ls@users.noreply.github.com>
Date: Fri, 29 Mar 2024 15:30:23 +0100
Subject: [PATCH 070/185] Create Anderson_Jensen_2024_Fig3.png

---
 .../_images/Anderson_Jensen_2024_Fig3.png       | Bin 0 -> 66997 bytes
 1 file changed, 0 insertions(+), 0 deletions(-)
 create mode 100644 docs/sphinx/source/_images/Anderson_Jensen_2024_Fig3.png

diff --git a/docs/sphinx/source/_images/Anderson_Jensen_2024_Fig3.png b/docs/sphinx/source/_images/Anderson_Jensen_2024_Fig3.png
new file mode 100644
index 0000000000000000000000000000000000000000..d239d9d4f414d9d28a685fa5fee49a7a20db0dd8
GIT binary patch
literal 66997
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

literal 0
HcmV?d00001


From 60b7e2e8c1a189547a1d5328c95746d5dd0bc686 Mon Sep 17 00:00:00 2001
From: echedey-ls <80125792+echedey-ls@users.noreply.github.com>
Date: Fri, 29 Mar 2024 15:49:54 +0100
Subject: [PATCH 071/185] Update shading.py

---
 pvlib/shading.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/pvlib/shading.py b/pvlib/shading.py
index d6237bebff..bb3edafab1 100644
--- a/pvlib/shading.py
+++ b/pvlib/shading.py
@@ -404,7 +404,7 @@ def shaded_fraction1d(
 
     Parameters are defined as follow:
 
-    .. figure:: Anderson_Jensen_2024_Fig3.png
+    .. figure:: _images/Anderson_Jensen_2024_Fig3.png
         :alt: Diagram showing the two trackers and the parameters of the model.
 
         +------------------+----------------------------+---------------------+

From 2d23cb275b41884ec6284c211620608ba1a8abd8 Mon Sep 17 00:00:00 2001
From: echedey-ls <80125792+echedey-ls@users.noreply.github.com>
Date: Fri, 29 Mar 2024 17:41:19 +0100
Subject: [PATCH 072/185] Update shading.py

---
 pvlib/shading.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/pvlib/shading.py b/pvlib/shading.py
index bb3edafab1..396acb4213 100644
--- a/pvlib/shading.py
+++ b/pvlib/shading.py
@@ -404,7 +404,7 @@ def shaded_fraction1d(
 
     Parameters are defined as follow:
 
-    .. figure:: _images/Anderson_Jensen_2024_Fig3.png
+    .. figure:: ../../_images/Anderson_Jensen_2024_Fig3.png
         :alt: Diagram showing the two trackers and the parameters of the model.
 
         +------------------+----------------------------+---------------------+

From 78a451ca9735d49d4b4e1add8d13d2eb0dfc13a6 Mon Sep 17 00:00:00 2001
From: echedey-ls <80125792+echedey-ls@users.noreply.github.com>
Date: Mon, 1 Apr 2024 03:05:01 +0200
Subject: [PATCH 073/185] Update shading.py

---
 pvlib/shading.py | 38 ++++++++++++++++++++------------------
 1 file changed, 20 insertions(+), 18 deletions(-)

diff --git a/pvlib/shading.py b/pvlib/shading.py
index 396acb4213..aecd87b896 100644
--- a/pvlib/shading.py
+++ b/pvlib/shading.py
@@ -407,24 +407,26 @@ def shaded_fraction1d(
     .. figure:: ../../_images/Anderson_Jensen_2024_Fig3.png
         :alt: Diagram showing the two trackers and the parameters of the model.
 
-        +------------------+----------------------------+---------------------+
-        | Symbol           | Parameter                  | Units               |
-        +==================+============================+=====================+
-        | :math:`\theta_1` | ``shading_tracker_tilt``   |                     |
-        +------------------+----------------------------+                     |
-        | :math:`\theta_2` | ``shaded_tracker_tilt``    | Degrees             |
-        +------------------+----------------------------+ :math:`^{\circ}`    |
-        | :math:`\beta_c`  | ``cross_axis_slope``       |                     |
-        +------------------+----------------------------+---------------------+
-        | :math:`p`        | ``row_pitch``              |                     |
-        +------------------+----------------------------+ Any consistent      |
-        | :math:`l`        | ``collector_width``        | length unit.        |
-        +------------------+----------------------------+ E.g. :math:`m` for  |
-        | :math:`z_0`      | ``surface_to_axis_offset`` | all parameters.     |
-        +------------------+----------------------------+---------------------+
-        | :math:`f_s`      | Return value               | Dimensionless       |
-        +------------------+----------------------------+---------------------+
-        Figure 3 of [1]_.
+        Figure 3 of [1]_. See correspondence between this nomenclature and the
+        function parameters in the table below.
+
+    +------------------+----------------------------+---------------------+
+    | Symbol           | Parameter                  | Units               |
+    +==================+============================+=====================+
+    | :math:`\theta_1` | ``shading_tracker_tilt``   |                     |
+    +------------------+----------------------------+                     |
+    | :math:`\theta_2` | ``shaded_tracker_tilt``    | Degrees             |
+    +------------------+----------------------------+ :math:`^{\circ}`    |
+    | :math:`\beta_c`  | ``cross_axis_slope``       |                     |
+    +------------------+----------------------------+---------------------+
+    | :math:`p`        | ``row_pitch``              |                     |
+    +------------------+----------------------------+ Any consistent      |
+    | :math:`l`        | ``collector_width``        | length unit.        |
+    +------------------+----------------------------+ E.g. :math:`m` for  |
+    | :math:`z_0`      | ``surface_to_axis_offset`` | all parameters.     |
+    +------------------+----------------------------+---------------------+
+    | :math:`f_s`      | Return value               | Dimensionless       |
+    +------------------+----------------------------+---------------------+
 
     See also
     --------

From 28128f64fa7558401d023c74b8c64514d3887306 Mon Sep 17 00:00:00 2001
From: echedey-ls <80125792+echedey-ls@users.noreply.github.com>
Date: Mon, 1 Apr 2024 03:06:11 +0200
Subject: [PATCH 074/185] lintaaargggg

---
 pvlib/shading.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/pvlib/shading.py b/pvlib/shading.py
index aecd87b896..6d7ef959de 100644
--- a/pvlib/shading.py
+++ b/pvlib/shading.py
@@ -452,8 +452,8 @@ def shaded_fraction1d(
         # the vector that defines the projection plane for prior conditions
         trackers_axis_azimuth,
     )
-    
-    # calculate repeated elements 
+
+    # calculate repeated elements
     thetas_1_S_diff = shading_tracker_tilt - projected_solar_zenith
     thetas_2_S_diff = shaded_tracker_tilt - projected_solar_zenith
     thetaS_tilt_diff = projected_solar_zenith - cross_axis_slope

From f4acf39b91a9f3e1ea7b9d1c37acc82a3edc10ee Mon Sep 17 00:00:00 2001
From: echedey-ls <80125792+echedey-ls@users.noreply.github.com>
Date: Tue, 2 Apr 2024 18:47:58 +0200
Subject: [PATCH 075/185] Fill reference

---
 pvlib/shading.py | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/pvlib/shading.py b/pvlib/shading.py
index 6d7ef959de..1e9e4aabc9 100644
--- a/pvlib/shading.py
+++ b/pvlib/shading.py
@@ -434,7 +434,9 @@ def shaded_fraction1d(
 
     References
     ----------
-    .. [1] TODO
+    .. [1] Kevin S. Anderson, Adam R. Jensen; Shaded fraction and backtracking
+        in single-axis trackers on rolling terrain. J. Renewable Sustainable
+        Energy 1 March 2024; 16 (2): 023504. :doi:`10.1063/5.0202220`
     """
     # For nomenclature you may refer to [1].
 

From 104d18536f465ec36410d90cfb97f52e97035dfe Mon Sep 17 00:00:00 2001
From: echedey-ls <80125792+echedey-ls@users.noreply.github.com>
Date: Tue, 2 Apr 2024 18:48:10 +0200
Subject: [PATCH 076/185] Next release 0.10.5?

---
 pvlib/shading.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/pvlib/shading.py b/pvlib/shading.py
index 1e9e4aabc9..1df7dc158f 100644
--- a/pvlib/shading.py
+++ b/pvlib/shading.py
@@ -366,7 +366,7 @@ def shaded_fraction1d(
     If only the GCR is known, feed GCR into ``trackers_vertical_length`` and
     specify ``trackers_row_pitch=1``.
 
-    .. versionadded:: TODO
+    .. versionadded:: 0.10.5
 
     Parameters
     ----------

From 894ff9f1e9f69447e00a42d2c8f2d6239f2ccf58 Mon Sep 17 00:00:00 2001
From: echedey-ls <80125792+echedey-ls@users.noreply.github.com>
Date: Fri, 5 Apr 2024 13:37:19 +0200
Subject: [PATCH 077/185] Fix tests

---
 pvlib/tests/test_shading.py | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/pvlib/tests/test_shading.py b/pvlib/tests/test_shading.py
index 6cd1be30b7..7f4b9dcc8b 100644
--- a/pvlib/tests/test_shading.py
+++ b/pvlib/tests/test_shading.py
@@ -302,12 +302,13 @@ def test_shaded_fraction1d(sf1d_premises_and_expected):
     """Tests shaded_fraction1d"""
     # unwrap sf_premises_and_expected values premises and expected results
     premises, expected_sf_array = sf1d_premises_and_expected
-    premises.to_csv("C:/Users/Yo/Downloads/hola.csv")
     # test scalar input
     expected_result = expected_sf_array.iloc[0]
     sf = shading.shaded_fraction1d(**premises.iloc[0])
-    assert_approx_equal(sf, expected_result, )
+    assert_approx_equal(sf, expected_result)
+    assert isinstance(sf, float)
 
-    # test vector inputs
+    # test Series inputs
     sf_vec = shading.shaded_fraction1d(**premises)
     assert_allclose(sf_vec, expected_sf_array, atol=1e-6)
+    assert isinstance(sf_vec, pd.Series)

From f147881e66ae307e275c5d0e6edb9130279e3b29 Mon Sep 17 00:00:00 2001
From: echedey-ls <80125792+echedey-ls@users.noreply.github.com>
Date: Fri, 5 Apr 2024 14:10:00 +0200
Subject: [PATCH 078/185] Update test_shading.py

---
 pvlib/tests/test_shading.py | 21 ++++++++-------------
 1 file changed, 8 insertions(+), 13 deletions(-)

diff --git a/pvlib/tests/test_shading.py b/pvlib/tests/test_shading.py
index 7f4b9dcc8b..ebbde01b0f 100644
--- a/pvlib/tests/test_shading.py
+++ b/pvlib/tests/test_shading.py
@@ -265,17 +265,10 @@ def sf1d_premises_and_expected():
     test_data["row_pitch"] = test_data["x_L"] - test_data["x_R"]
     # switch Left/Right trackers if needed to make the right one the shaded
     where_switch = test_data["theta_s"] >= 0
-    test_data["theta_L"], test_data["theta_R"] = (
-        np.where(
-            where_switch,
-            test_data["theta_L"],
-            test_data["theta_R"],
-        ),
-        np.where(
-            where_switch,
-            test_data["theta_R"],
-            test_data["theta_L"],
-        ),
+    test_data["theta_L"], test_data["theta_R"] = np.where(
+        where_switch,
+        (test_data["theta_L"], test_data["theta_R"]),
+        (test_data["theta_R"], test_data["theta_L"]),
     )
     test_data.rename(
         columns={
@@ -294,8 +287,10 @@ def sf1d_premises_and_expected():
     test_data["solar_azimuth"], test_data["trackers_axis_azimuth"] = 180, 90
 
     # return 1st: premises dataframe first and 2nd: shaded fraction series
-    return (test_data.drop(columns=["shaded_fraction"]),
-            test_data["shaded_fraction"])
+    return (
+        test_data.drop(columns=["shaded_fraction"]),
+        test_data["shaded_fraction"],
+    )
 
 
 def test_shaded_fraction1d(sf1d_premises_and_expected):

From 4d11294ce74558d4a845eb753c6bc221b4d03f91 Mon Sep 17 00:00:00 2001
From: echedey-ls <80125792+echedey-ls@users.noreply.github.com>
Date: Wed, 10 Apr 2024 19:54:07 +0200
Subject: [PATCH 079/185] Little improvement to table definitions

---
 pvlib/shading.py | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/pvlib/shading.py b/pvlib/shading.py
index 1df7dc158f..858184ba89 100644
--- a/pvlib/shading.py
+++ b/pvlib/shading.py
@@ -419,11 +419,11 @@ def shaded_fraction1d(
     +------------------+----------------------------+ :math:`^{\circ}`    |
     | :math:`\beta_c`  | ``cross_axis_slope``       |                     |
     +------------------+----------------------------+---------------------+
-    | :math:`p`        | ``row_pitch``              |                     |
-    +------------------+----------------------------+ Any consistent      |
-    | :math:`l`        | ``collector_width``        | length unit.        |
-    +------------------+----------------------------+ E.g. :math:`m` for  |
-    | :math:`z_0`      | ``surface_to_axis_offset`` | all parameters.     |
+    | :math:`p`        | ``row_pitch``              | Any consistent      |
+    +------------------+----------------------------+ length unit across  |
+    | :math:`l`        | ``collector_width``        | all these           |
+    +------------------+----------------------------+ parameters, e.g.    |
+    | :math:`z_0`      | ``surface_to_axis_offset`` | :math:`m`.          |
     +------------------+----------------------------+---------------------+
     | :math:`f_s`      | Return value               | Dimensionless       |
     +------------------+----------------------------+---------------------+

From 69c76cf83fdd7469d54b608a93f1582be3805cf0 Mon Sep 17 00:00:00 2001
From: echedey-ls <80125792+echedey-ls@users.noreply.github.com>
Date: Mon, 15 Apr 2024 19:15:12 +0200
Subject: [PATCH 080/185] Change `l` to `\ell`

Co-Authored-By: Kevin Anderson <57452607+kandersolar@users.noreply.github.com>
---
 pvlib/shading.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/pvlib/shading.py b/pvlib/shading.py
index 858184ba89..3fb3c260be 100644
--- a/pvlib/shading.py
+++ b/pvlib/shading.py
@@ -421,7 +421,7 @@ def shaded_fraction1d(
     +------------------+----------------------------+---------------------+
     | :math:`p`        | ``row_pitch``              | Any consistent      |
     +------------------+----------------------------+ length unit across  |
-    | :math:`l`        | ``collector_width``        | all these           |
+    | :math:`\ell`     | ``collector_width``        | all these           |
     +------------------+----------------------------+ parameters, e.g.    |
     | :math:`z_0`      | ``surface_to_axis_offset`` | :math:`m`.          |
     +------------------+----------------------------+---------------------+

From 758f5e728b88a95652c9bd5f0e3f983770f8a642 Mon Sep 17 00:00:00 2001
From: echedey-ls <80125792+echedey-ls@users.noreply.github.com>
Date: Mon, 15 Apr 2024 19:15:45 +0200
Subject: [PATCH 081/185] `pvlib.tracking.projected_solar_zenith_angle` to
 `pvlib.shading.projected_solar_zenith_angle`

Co-Authored-By: Kevin Anderson <57452607+kandersolar@users.noreply.github.com>
---
 pvlib/shading.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/pvlib/shading.py b/pvlib/shading.py
index 3fb3c260be..26c7daeb60 100644
--- a/pvlib/shading.py
+++ b/pvlib/shading.py
@@ -430,7 +430,7 @@ def shaded_fraction1d(
 
     See also
     --------
-    pvlib.tracking.projected_solar_zenith_angle
+    pvlib.shading.projected_solar_zenith_angle
 
     References
     ----------

From 6882dfa97b3ad617d98930329338c6ba8ac2ea51 Mon Sep 17 00:00:00 2001
From: echedey-ls <80125792+echedey-ls@users.noreply.github.com>
Date: Mon, 15 Apr 2024 19:17:55 +0200
Subject: [PATCH 082/185] pitch references to `pitch`

Co-Authored-By: Kevin Anderson <57452607+kandersolar@users.noreply.github.com>
---
 pvlib/shading.py            | 10 +++++-----
 pvlib/tests/test_shading.py |  2 +-
 2 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/pvlib/shading.py b/pvlib/shading.py
index 26c7daeb60..79cb4ee3f9 100644
--- a/pvlib/shading.py
+++ b/pvlib/shading.py
@@ -351,7 +351,7 @@ def shaded_fraction1d(
     shaded_tracker_tilt,
     *,
     collector_width,
-    row_pitch,
+    pitch,
     surface_to_axis_offset=0,
     cross_axis_slope=0,
     shading_tracker_tilt=None,
@@ -364,7 +364,7 @@ def shaded_fraction1d(
     share the same tilt and azimuth values.
 
     If only the GCR is known, feed GCR into ``trackers_vertical_length`` and
-    specify ``trackers_row_pitch=1``.
+    specify ``pitch=1``.
 
     .. versionadded:: 0.10.5
 
@@ -381,7 +381,7 @@ def shaded_fraction1d(
     collector_width : numeric
         Vertical length of a tilted tracker. The returned ``shaded fraction``
         is the ratio of the shadow over this value.
-    row_pitch : numeric
+    pitch : numeric
         Axis-to-axis horizontal spacing of the trackers.
     surface_to_axis_offset : numeric, default 0
         Distance between the rotating axis and the collector surface.
@@ -419,7 +419,7 @@ def shaded_fraction1d(
     +------------------+----------------------------+ :math:`^{\circ}`    |
     | :math:`\beta_c`  | ``cross_axis_slope``       |                     |
     +------------------+----------------------------+---------------------+
-    | :math:`p`        | ``row_pitch``              | Any consistent      |
+    | :math:`p`        | ``pitch``                  | Any consistent      |
     +------------------+----------------------------+ length unit across  |
     | :math:`\ell`     | ``collector_width``        | all these           |
     +------------------+----------------------------+ parameters, e.g.    |
@@ -474,7 +474,7 @@ def shaded_fraction1d(
             * (sind(thetas_2_S_diff) - sind(thetas_1_S_diff))
         )
         - (
-            row_pitch
+            pitch
             / collector_width
             * cosd(thetaS_tilt_diff)
             / cos_theta_2_S_diff_abs
diff --git a/pvlib/tests/test_shading.py b/pvlib/tests/test_shading.py
index ebbde01b0f..d71aa2ac16 100644
--- a/pvlib/tests/test_shading.py
+++ b/pvlib/tests/test_shading.py
@@ -262,7 +262,7 @@ def sf1d_premises_and_expected():
         (test_data["z_R"] - test_data["z_L"])
         / (test_data["x_L"] - test_data["x_R"])
     )
-    test_data["row_pitch"] = test_data["x_L"] - test_data["x_R"]
+    test_data["pitch"] = test_data["x_L"] - test_data["x_R"]
     # switch Left/Right trackers if needed to make the right one the shaded
     where_switch = test_data["theta_s"] >= 0
     test_data["theta_L"], test_data["theta_R"] = np.where(

From 4ef45676114068294fd02a6d6c82a21d12dd044d Mon Sep 17 00:00:00 2001
From: echedey-ls <80125792+echedey-ls@users.noreply.github.com>
Date: Mon, 15 Apr 2024 19:28:47 +0200
Subject: [PATCH 083/185] `trackers_axis_azimuth` to `axis_azimuth`

Co-Authored-By: Kevin Anderson <57452607+kandersolar@users.noreply.github.com>
---
 pvlib/shading.py            | 6 +++---
 pvlib/tests/test_shading.py | 2 +-
 2 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/pvlib/shading.py b/pvlib/shading.py
index 79cb4ee3f9..18f38a7294 100644
--- a/pvlib/shading.py
+++ b/pvlib/shading.py
@@ -347,7 +347,7 @@ def projected_solar_zenith_angle(solar_zenith, solar_azimuth,
 def shaded_fraction1d(
     solar_zenith,
     solar_azimuth,
-    trackers_axis_azimuth,
+    axis_azimuth,
     shaded_tracker_tilt,
     *,
     collector_width,
@@ -374,7 +374,7 @@ def shaded_fraction1d(
         Solar position zenith, in degrees.
     solar_azimuth : numeric
         Solar position azimuth, in degrees.
-    trackers_axis_azimuth : numeric
+    axis_azimuth : numeric
         In degrees. North=0º, South=180º, East=90º, West=270º.
     shaded_tracker_tilt : numeric
         Tilt of the tracker receiving the shade in degrees.
@@ -452,7 +452,7 @@ def shaded_fraction1d(
         solar_azimuth,
         0,  # no rotation from the horizontal plane
         # the vector that defines the projection plane for prior conditions
-        trackers_axis_azimuth,
+        axis_azimuth,
     )
 
     # calculate repeated elements
diff --git a/pvlib/tests/test_shading.py b/pvlib/tests/test_shading.py
index d71aa2ac16..411d7d18c3 100644
--- a/pvlib/tests/test_shading.py
+++ b/pvlib/tests/test_shading.py
@@ -284,7 +284,7 @@ def sf1d_premises_and_expected():
     test_data.drop(columns=["x_L", "z_L", "x_R", "z_R"], inplace=True)
     # for the projected solar zenith angle
     # this returns the same psz angle as test_data["solar_zenith"]
-    test_data["solar_azimuth"], test_data["trackers_axis_azimuth"] = 180, 90
+    test_data["solar_azimuth"], test_data["axis_azimuth"] = 180, 90
 
     # return 1st: premises dataframe first and 2nd: shaded fraction series
     return (

From 574a1a21b9da3b562c91e9a6d5c81d5f5a202c71 Mon Sep 17 00:00:00 2001
From: echedey-ls <80125792+echedey-ls@users.noreply.github.com>
Date: Mon, 15 Apr 2024 23:57:47 +0200
Subject: [PATCH 084/185] whatsnews

Co-Authored-By: Kevin Anderson <57452607+kandersolar@users.noreply.github.com>
---
 docs/sphinx/source/whatsnew/v0.10.4.rst | 1 -
 docs/sphinx/source/whatsnew/v0.10.5.rst | 5 ++++-
 2 files changed, 4 insertions(+), 2 deletions(-)

diff --git a/docs/sphinx/source/whatsnew/v0.10.4.rst b/docs/sphinx/source/whatsnew/v0.10.4.rst
index 8212b4b94f..a194c5e522 100644
--- a/docs/sphinx/source/whatsnew/v0.10.4.rst
+++ b/docs/sphinx/source/whatsnew/v0.10.4.rst
@@ -64,7 +64,6 @@ Contributors
 * Roma Koulikov (:ghuser:`matsuobasho`)
 * Adam R. Jensen (:ghuser:`AdamRJensen`)
 * Peter Dudfield (:ghuser:`peterdudfield`)
-* Mark A. Mikofski (:ghuser:`mikofski`)
 * Anton Driesse (:ghuser:`adriesse`)
 * Mark Mikofski (:ghuser:`mikofski`)
 * Will Holmgren (:ghuser:`wholmgren`)
diff --git a/docs/sphinx/source/whatsnew/v0.10.5.rst b/docs/sphinx/source/whatsnew/v0.10.5.rst
index e7097ea5b4..0257fd5abd 100644
--- a/docs/sphinx/source/whatsnew/v0.10.5.rst
+++ b/docs/sphinx/source/whatsnew/v0.10.5.rst
@@ -11,7 +11,8 @@ Deprecations
 
 Enhancements
 ~~~~~~~~~~~~
-
+* Added function :py:func:`pvlib.shading.shaded_fraction1d`, to calculate the
+  shade perpendicular to ``axis_azimuth``. (:issue:`1689`, :pull:`1725`, :pull:`1962`)
 
 Bug fixes
 ~~~~~~~~~
@@ -31,3 +32,5 @@ Requirements
 
 Contributors
 ~~~~~~~~~~~~
+* Mark Mikofski (:ghuser:`mikofski`)
+* Echedey Luis (:ghuser:`echedey-ls`)

From efac0b37f095e794ff038fae7110f8dc55685c9c Mon Sep 17 00:00:00 2001
From: echedey-ls <80125792+echedey-ls@users.noreply.github.com>
Date: Tue, 16 Apr 2024 00:05:18 +0200
Subject: [PATCH 085/185] Update v0.10.5.rst

Co-Authored-By: Kevin Anderson <57452607+kandersolar@users.noreply.github.com>
---
 docs/sphinx/source/whatsnew/v0.10.5.rst | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/sphinx/source/whatsnew/v0.10.5.rst b/docs/sphinx/source/whatsnew/v0.10.5.rst
index 0257fd5abd..5d8778ec85 100644
--- a/docs/sphinx/source/whatsnew/v0.10.5.rst
+++ b/docs/sphinx/source/whatsnew/v0.10.5.rst
@@ -14,6 +14,7 @@ Enhancements
 * Added function :py:func:`pvlib.shading.shaded_fraction1d`, to calculate the
   shade perpendicular to ``axis_azimuth``. (:issue:`1689`, :pull:`1725`, :pull:`1962`)
 
+
 Bug fixes
 ~~~~~~~~~
 

From 3a726b8737663ebadad3ce39eddcf4458b21808b Mon Sep 17 00:00:00 2001
From: echedey-ls <80125792+echedey-ls@users.noreply.github.com>
Date: Tue, 16 Apr 2024 00:25:32 +0200
Subject: [PATCH 086/185] Change `tilt`s to `rotation`s and add `axis_tilt`

Co-Authored-By: Kevin Anderson <57452607+kandersolar@users.noreply.github.com>
---
 pvlib/shading.py | 49 +++++++++++++++++++++++++-----------------------
 1 file changed, 26 insertions(+), 23 deletions(-)

diff --git a/pvlib/shading.py b/pvlib/shading.py
index 18f38a7294..bcadcd6ad1 100644
--- a/pvlib/shading.py
+++ b/pvlib/shading.py
@@ -348,20 +348,22 @@ def shaded_fraction1d(
     solar_zenith,
     solar_azimuth,
     axis_azimuth,
-    shaded_tracker_tilt,
+    shaded_tracker_rotation,
     *,
     collector_width,
     pitch,
+    axis_tilt=0,
     surface_to_axis_offset=0,
     cross_axis_slope=0,
-    shading_tracker_tilt=None,
+    shading_tracker_rotation=None,
 ):
     r"""
-    Shaded fraction in the vertical dimension of tilted rows.
+    Shaded fraction in the vertical dimension of tilted rows, or perpendicular
+    to the ``axis_azimuth`` of horizontal rows.
 
-    If ``shading_tracker_tilt`` isn't provided, assumes both the shaded
+    If ``shading_tracker_rotation`` isn't provided, assumes both the shaded
     row and the one blocking the direct beam
-    share the same tilt and azimuth values.
+    share the same rotation and azimuth values.
 
     If only the GCR is known, feed GCR into ``trackers_vertical_length`` and
     specify ``pitch=1``.
@@ -376,20 +378,24 @@ def shaded_fraction1d(
         Solar position azimuth, in degrees.
     axis_azimuth : numeric
         In degrees. North=0º, South=180º, East=90º, West=270º.
-    shaded_tracker_tilt : numeric
-        Tilt of the tracker receiving the shade in degrees.
+    shaded_tracker_rotation : numeric
+        Right-handed rotation of the tracker receiving the shade, with respect
+        to ``axis_azimuth``. In degrees :math:`^{\circ}`.
     collector_width : numeric
         Vertical length of a tilted tracker. The returned ``shaded fraction``
         is the ratio of the shadow over this value.
     pitch : numeric
         Axis-to-axis horizontal spacing of the trackers.
+    axis_tilt : numeric, default 0
+        Tilt of the rows axis from horizontal. In degrees :math:`^{\circ}`.
     surface_to_axis_offset : numeric, default 0
         Distance between the rotating axis and the collector surface.
     cross_axis_slope : numeric, default 0
         Angle of the plane containing the rows' axes from
         horizontal. In degrees.
-    shading_tracker_tilt : numeric, optional
-        Tilt of the tracker casting the shadow.
+    shading_tracker_rotation : numeric, optional
+        Right-handed rotation of the tracker casting the shadow, with respect
+        to ``axis_azimuth``. In degrees :math:`^{\circ}`.
 
     Returns
     -------
@@ -413,9 +419,9 @@ def shaded_fraction1d(
     +------------------+----------------------------+---------------------+
     | Symbol           | Parameter                  | Units               |
     +==================+============================+=====================+
-    | :math:`\theta_1` | ``shading_tracker_tilt``   |                     |
+    | :math:`\theta_1` |``shading_tracker_rotation``|                     |
     +------------------+----------------------------+                     |
-    | :math:`\theta_2` | ``shaded_tracker_tilt``    | Degrees             |
+    | :math:`\theta_2` | ``shaded_tracker_rotation``| Degrees             |
     +------------------+----------------------------+ :math:`^{\circ}`    |
     | :math:`\beta_c`  | ``cross_axis_slope``       |                     |
     +------------------+----------------------------+---------------------+
@@ -440,25 +446,22 @@ def shaded_fraction1d(
     """
     # For nomenclature you may refer to [1].
 
-    # tilt of the tracker casting the shadow defaults to shaded tracker tilt
-    if shading_tracker_tilt is None:
-        shading_tracker_tilt = shaded_tracker_tilt
+    # rotation of tracker casting the shadow defaults to shaded tracker's one
+    if shading_tracker_rotation is None:
+        shading_tracker_rotation = shaded_tracker_rotation
 
-    # projected solar zenith:
-    # consider the angle the sun direct beam has on the vertical plane which
-    # contains the row's normal vector, with respect to a horizontal line
+    # projected solar zenith angle
     projected_solar_zenith = projected_solar_zenith_angle(
         solar_zenith,
         solar_azimuth,
-        0,  # no rotation from the horizontal plane
-        # the vector that defines the projection plane for prior conditions
+        axis_tilt,
         axis_azimuth,
     )
 
     # calculate repeated elements
-    thetas_1_S_diff = shading_tracker_tilt - projected_solar_zenith
-    thetas_2_S_diff = shaded_tracker_tilt - projected_solar_zenith
-    thetaS_tilt_diff = projected_solar_zenith - cross_axis_slope
+    thetas_1_S_diff = shading_tracker_rotation - projected_solar_zenith
+    thetas_2_S_diff = shaded_tracker_rotation - projected_solar_zenith
+    thetaS_rotation_diff = projected_solar_zenith - cross_axis_slope
 
     cos_theta_2_S_diff_abs = np.abs(cosd(thetas_2_S_diff))
 
@@ -476,7 +479,7 @@ def shaded_fraction1d(
         - (
             pitch
             / collector_width
-            * cosd(thetaS_tilt_diff)
+            * cosd(thetaS_rotation_diff)
             / cos_theta_2_S_diff_abs
             / cosd(cross_axis_slope)
         )

From 300b912c6b9aa23178826fa9256b4b6f5870c426 Mon Sep 17 00:00:00 2001
From: echedey-ls <80125792+echedey-ls@users.noreply.github.com>
Date: Tue, 16 Apr 2024 00:30:02 +0200
Subject: [PATCH 087/185] Forgot to update tests :skull:

Co-Authored-By: Kevin Anderson <57452607+kandersolar@users.noreply.github.com>
---
 pvlib/tests/test_shading.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/pvlib/tests/test_shading.py b/pvlib/tests/test_shading.py
index 411d7d18c3..c96fa1c096 100644
--- a/pvlib/tests/test_shading.py
+++ b/pvlib/tests/test_shading.py
@@ -272,8 +272,8 @@ def sf1d_premises_and_expected():
     )
     test_data.rename(
         columns={
-            "theta_L": "shading_tracker_tilt",
-            "theta_R": "shaded_tracker_tilt",
+            "theta_L": "shading_tracker_rotation",
+            "theta_R": "shaded_tracker_rotation",
             "z_0": "surface_to_axis_offset",
             "l": "collector_width",
             "theta_s": "solar_zenith",  # for the projected solar zenith angle

From c1b39784693cd0745ba6257080092ed45768f524 Mon Sep 17 00:00:00 2001
From: echedey-ls <80125792+echedey-ls@users.noreply.github.com>
Date: Tue, 16 Apr 2024 22:54:13 +0200
Subject: [PATCH 088/185] Add examples section

---
 pvlib/shading.py | 54 ++++++++++++++++++++++++++++++++++++++++++++++--
 1 file changed, 52 insertions(+), 2 deletions(-)

diff --git a/pvlib/shading.py b/pvlib/shading.py
index bcadcd6ad1..d253cb40df 100644
--- a/pvlib/shading.py
+++ b/pvlib/shading.py
@@ -382,7 +382,7 @@ def shaded_fraction1d(
         Right-handed rotation of the tracker receiving the shade, with respect
         to ``axis_azimuth``. In degrees :math:`^{\circ}`.
     collector_width : numeric
-        Vertical length of a tilted tracker. The returned ``shaded fraction``
+        Vertical length of a tilted tracker. The returned ``shaded_fraction``
         is the ratio of the shadow over this value.
     pitch : numeric
         Axis-to-axis horizontal spacing of the trackers.
@@ -392,7 +392,8 @@ def shaded_fraction1d(
         Distance between the rotating axis and the collector surface.
     cross_axis_slope : numeric, default 0
         Angle of the plane containing the rows' axes from
-        horizontal. In degrees.
+        horizontal. Right-handed rotation with respect to ``axis_azimuth``.
+        In degrees :math:`^{\circ}`.
     shading_tracker_rotation : numeric, optional
         Right-handed rotation of the tracker casting the shadow, with respect
         to ``axis_azimuth``. In degrees :math:`^{\circ}`.
@@ -438,6 +439,55 @@ def shaded_fraction1d(
     --------
     pvlib.shading.projected_solar_zenith_angle
 
+    Examples
+    --------
+    Fixed-tilt south-facing array on flat terrain
+    ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+    Tilted tracker with a pitch of :math:`1.5m`, a collector width of
+    :math:`2m`, and tracker rotations of :math:`30^{\circ}`. In the morning.
+
+    >>> shaded_fraction1d(solar_zenith=80, solar_azimuth=104.5,
+    ...     axis_azimuth=90, shaded_tracker_rotation=30,
+    ...     shading_tracker_rotation=30, collector_width=2, pitch=1,
+    ...     axis_tilt=0, surface_to_axis_offset=0.05, cross_axis_slope=0)
+    0.6827437712114521
+
+    Fixed-tilt north-facing array on sloped terrain
+    ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+    Tilted tracker with a pitch of :math:`1m`, a collector width of
+    :math:`2.5m`, and tracker rotations of :math:`50^{\circ}` for the shaded
+    tracker and :math:`30^{\circ}` for the shading tracker. The rows are on a
+    :math:`10^{\circ}` slope, where their axis is on the most inclined
+    direction (zero cross-axis slope). Shaded in the morning.
+
+    >>> shaded_fraction1d(solar_zenith=65, solar_azimuth=75.5,
+    ...     axis_azimuth=270, shaded_tracker_rotation=50,
+    ...     shading_tracker_rotation=30, collector_width=2.5, pitch=1,
+    ...     axis_tilt=10, surface_to_axis_offset=0.05, cross_axis_slope=0)
+    0.6975923460352351
+
+    N-S single-axis tracker on sloped terrain
+    ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+    Horizontal trackers with a pitch of :math:`1m`, a collector width of
+    :math:`1.4m`, and tracker rotations of :math:`30^{\circ}` pointing east,
+    in the morning. Terrain slope is :math:`7^{\circ}` west-east (east-most
+    tracker is higher that the west-most tracker).
+
+    >>> shaded_fraction1d(solar_zenith=50, solar_azimuth=90, axis_azimuth=180,
+    ...     shaded_tracker_rotation=-30, collector_width=1.4, pitch=1,
+    ...     axis_tilt=0, surface_to_axis_offset=0.10, cross_axis_slope=7)
+    0.5828961460616938
+
+    Note the previous example only calculates the shaded fraction for the
+    west-most tracker. To calculate the shaded fraction for the east-most
+    tracker, you must input the corresponding ``shaded_tracker_rotation``
+    in the afternoon.
+
+    >>> shaded_fraction1d(solar_zenith=50, solar_azimuth=270, axis_azimuth=180,
+    ...     shaded_tracker_rotation=30, collector_width=1.4, pitch=1,
+    ...     axis_tilt=0, surface_to_axis_offset=0.10, cross_axis_slope=7)
+    0.4399034444363955
+
     References
     ----------
     .. [1] Kevin S. Anderson, Adam R. Jensen; Shaded fraction and backtracking

From db8edd6d68fc623f1a4227620cdf01b469a4b45c Mon Sep 17 00:00:00 2001
From: echedey-ls <80125792+echedey-ls@users.noreply.github.com>
Date: Sun, 21 Apr 2024 23:43:25 +0200
Subject: [PATCH 089/185] roles assumption messin w/ me docs :astonished:

---
 pvlib/shading.py | 33 +++++++++++++++++++++++++--------
 1 file changed, 25 insertions(+), 8 deletions(-)

diff --git a/pvlib/shading.py b/pvlib/shading.py
index d253cb40df..851085d966 100644
--- a/pvlib/shading.py
+++ b/pvlib/shading.py
@@ -359,7 +359,7 @@ def shaded_fraction1d(
 ):
     r"""
     Shaded fraction in the vertical dimension of tilted rows, or perpendicular
-    to the ``axis_azimuth`` of horizontal rows.
+    to the axis of horizontal rows.
 
     If ``shading_tracker_rotation`` isn't provided, assumes both the shaded
     row and the one blocking the direct beam
@@ -368,6 +368,14 @@ def shaded_fraction1d(
     If only the GCR is known, feed GCR into ``trackers_vertical_length`` and
     specify ``pitch=1``.
 
+    .. admonition::
+
+        This function assumes the roles of the shaded and shading trackers are
+        the same during all the day. If the trackers allow for different
+        shading or shaded roles, e.g. a N-S single-axis tracker, you must
+        switch the inputs depending on the sign of the projected solar zenith
+        angle. See :ref:`ns_sat_case`.
+
     .. versionadded:: 0.10.5
 
     Parameters
@@ -435,10 +443,6 @@ def shaded_fraction1d(
     | :math:`f_s`      | Return value               | Dimensionless       |
     +------------------+----------------------------+---------------------+
 
-    See also
-    --------
-    pvlib.shading.projected_solar_zenith_angle
-
     Examples
     --------
     Fixed-tilt south-facing array on flat terrain
@@ -466,20 +470,29 @@ def shaded_fraction1d(
     ...     axis_tilt=10, surface_to_axis_offset=0.05, cross_axis_slope=0)
     0.6975923460352351
 
+    .. _ns_sat_case:
+
     N-S single-axis tracker on sloped terrain
     ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
     Horizontal trackers with a pitch of :math:`1m`, a collector width of
     :math:`1.4m`, and tracker rotations of :math:`30^{\circ}` pointing east,
     in the morning. Terrain slope is :math:`7^{\circ}` west-east (east-most
-    tracker is higher that the west-most tracker).
+    tracker is higher than the west-most tracker).
 
     >>> shaded_fraction1d(solar_zenith=50, solar_azimuth=90, axis_azimuth=180,
     ...     shaded_tracker_rotation=-30, collector_width=1.4, pitch=1,
     ...     axis_tilt=0, surface_to_axis_offset=0.10, cross_axis_slope=7)
     0.5828961460616938
 
-    Note the previous example only calculates the shaded fraction for the
-    west-most tracker. To calculate the shaded fraction for the east-most
+    Note the previous example calculates the shaded fraction for the
+    west-most tracker, but it does actually assume it is the shaded tracker
+    during all the day, thou it is incorrect.
+    During the afternoon, it is the one casting the shadow onto the 
+    east-most tracker. You must switch the inputs depending on the sign of the
+    projected solar zenith angle.
+    See :py:func:`pvlib.shading.projected_solar_zenith_angle`.
+    
+    To calculate the shaded fraction for the east-most
     tracker, you must input the corresponding ``shaded_tracker_rotation``
     in the afternoon.
 
@@ -488,6 +501,10 @@ def shaded_fraction1d(
     ...     axis_tilt=0, surface_to_axis_offset=0.10, cross_axis_slope=7)
     0.4399034444363955
 
+    See also
+    --------
+    pvlib.shading.projected_solar_zenith_angle
+
     References
     ----------
     .. [1] Kevin S. Anderson, Adam R. Jensen; Shaded fraction and backtracking

From d65e64d5c910c7b120d05b7f2d2ea7bb1655818a Mon Sep 17 00:00:00 2001
From: echedey-ls <80125792+echedey-ls@users.noreply.github.com>
Date: Sun, 21 Apr 2024 23:43:25 +0200
Subject: [PATCH 090/185] roles assumption messin w/ me docs :astonished:

Co-Authored-By: Kevin Anderson <57452607+kandersolar@users.noreply.github.com>
---
 pvlib/shading.py | 33 +++++++++++++++++++++++++--------
 1 file changed, 25 insertions(+), 8 deletions(-)

diff --git a/pvlib/shading.py b/pvlib/shading.py
index d253cb40df..5a341370d0 100644
--- a/pvlib/shading.py
+++ b/pvlib/shading.py
@@ -359,7 +359,7 @@ def shaded_fraction1d(
 ):
     r"""
     Shaded fraction in the vertical dimension of tilted rows, or perpendicular
-    to the ``axis_azimuth`` of horizontal rows.
+    to the axis of horizontal rows.
 
     If ``shading_tracker_rotation`` isn't provided, assumes both the shaded
     row and the one blocking the direct beam
@@ -368,6 +368,14 @@ def shaded_fraction1d(
     If only the GCR is known, feed GCR into ``trackers_vertical_length`` and
     specify ``pitch=1``.
 
+    .. admonition::
+
+        This function assumes the roles of the shaded and shading trackers are
+        the same during all the day. If the trackers allow for different
+        shading or shaded roles, e.g. a N-S single-axis tracker, you must
+        switch the inputs depending on the sign of the projected solar zenith
+        angle. See :ref:`ns_sat_case`.
+
     .. versionadded:: 0.10.5
 
     Parameters
@@ -435,10 +443,6 @@ def shaded_fraction1d(
     | :math:`f_s`      | Return value               | Dimensionless       |
     +------------------+----------------------------+---------------------+
 
-    See also
-    --------
-    pvlib.shading.projected_solar_zenith_angle
-
     Examples
     --------
     Fixed-tilt south-facing array on flat terrain
@@ -466,20 +470,29 @@ def shaded_fraction1d(
     ...     axis_tilt=10, surface_to_axis_offset=0.05, cross_axis_slope=0)
     0.6975923460352351
 
+    .. _ns_sat_case:
+
     N-S single-axis tracker on sloped terrain
     ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
     Horizontal trackers with a pitch of :math:`1m`, a collector width of
     :math:`1.4m`, and tracker rotations of :math:`30^{\circ}` pointing east,
     in the morning. Terrain slope is :math:`7^{\circ}` west-east (east-most
-    tracker is higher that the west-most tracker).
+    tracker is higher than the west-most tracker).
 
     >>> shaded_fraction1d(solar_zenith=50, solar_azimuth=90, axis_azimuth=180,
     ...     shaded_tracker_rotation=-30, collector_width=1.4, pitch=1,
     ...     axis_tilt=0, surface_to_axis_offset=0.10, cross_axis_slope=7)
     0.5828961460616938
 
-    Note the previous example only calculates the shaded fraction for the
-    west-most tracker. To calculate the shaded fraction for the east-most
+    Note the previous example calculates the shaded fraction for the
+    west-most tracker, but it does actually assume it is the shaded tracker
+    during all the day, thou it is incorrect.
+    During the afternoon, it is the one casting the shadow onto the
+    east-most tracker. You must switch the inputs depending on the sign of the
+    projected solar zenith angle.
+    See :py:func:`pvlib.shading.projected_solar_zenith_angle`.
+
+    To calculate the shaded fraction for the east-most
     tracker, you must input the corresponding ``shaded_tracker_rotation``
     in the afternoon.
 
@@ -488,6 +501,10 @@ def shaded_fraction1d(
     ...     axis_tilt=0, surface_to_axis_offset=0.10, cross_axis_slope=7)
     0.4399034444363955
 
+    See also
+    --------
+    pvlib.shading.projected_solar_zenith_angle
+
     References
     ----------
     .. [1] Kevin S. Anderson, Adam R. Jensen; Shaded fraction and backtracking

From 90380970a9df6e0fe24e41e4f6cfc140ee553f8b Mon Sep 17 00:00:00 2001
From: echedey-ls <80125792+echedey-ls@users.noreply.github.com>
Date: Mon, 22 Apr 2024 13:14:07 +0200
Subject: [PATCH 091/185] Update shading.py

---
 pvlib/shading.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/pvlib/shading.py b/pvlib/shading.py
index 6b4bd6516e..0e4503848f 100644
--- a/pvlib/shading.py
+++ b/pvlib/shading.py
@@ -487,11 +487,11 @@ def shaded_fraction1d(
     Note the previous example calculates the shaded fraction for the
     west-most tracker in the morning, but it does actually assume it is the
     shaded tracker during all the day, thou it is incorrect.
-    During the afternoon, it is the one casting the shadow onto the 
+    During the afternoon, it is the one casting the shadow onto the
     east-most tracker. You must switch the inputs depending on the sign of the
     projected solar zenith angle.
     See :py:func:`pvlib.shading.projected_solar_zenith_angle`.
-    
+
     To calculate the shaded fraction for the east-most
     tracker, you must input the corresponding ``shaded_tracker_rotation``
     in the afternoon.

From 565280126d7759abc23eaa316cd16985adb6295a Mon Sep 17 00:00:00 2001
From: echedey-ls <80125792+echedey-ls@users.noreply.github.com>
Date: Tue, 23 Apr 2024 02:06:12 +0200
Subject: [PATCH 092/185] Update shading.py

---
 pvlib/shading.py | 10 ++++------
 1 file changed, 4 insertions(+), 6 deletions(-)

diff --git a/pvlib/shading.py b/pvlib/shading.py
index 0e4503848f..932e23d869 100644
--- a/pvlib/shading.py
+++ b/pvlib/shading.py
@@ -484,13 +484,11 @@ def shaded_fraction1d(
     ...     axis_tilt=0, surface_to_axis_offset=0.10, cross_axis_slope=7)
     0.5828961460616938
 
-    Note the previous example calculates the shaded fraction for the
-    west-most tracker in the morning, but it does actually assume it is the
-    shaded tracker during all the day, thou it is incorrect.
+    Note the previous example only is valid for the shaded fraction of the
+    west-most tracker in the morning, and assuming it is the
+    shaded tracker during all the day is incorrect.
     During the afternoon, it is the one casting the shadow onto the
-    east-most tracker. You must switch the inputs depending on the sign of the
-    projected solar zenith angle.
-    See :py:func:`pvlib.shading.projected_solar_zenith_angle`.
+    east-most tracker.
 
     To calculate the shaded fraction for the east-most
     tracker, you must input the corresponding ``shaded_tracker_rotation``

From 31affbaf63997be9c0bf2bf1189304ea01676dd6 Mon Sep 17 00:00:00 2001
From: echedey-ls <80125792+echedey-ls@users.noreply.github.com>
Date: Tue, 23 Apr 2024 02:06:31 +0200
Subject: [PATCH 093/185] Add gallery example

---
 .../plot_shaded_fraction1d_ns_hsat_example.py | 184 ++++++++++++++++++
 pvlib/shading.py                              |   5 +
 2 files changed, 189 insertions(+)
 create mode 100644 docs/examples/shading/plot_shaded_fraction1d_ns_hsat_example.py

diff --git a/docs/examples/shading/plot_shaded_fraction1d_ns_hsat_example.py b/docs/examples/shading/plot_shaded_fraction1d_ns_hsat_example.py
new file mode 100644
index 0000000000..10c2f89727
--- /dev/null
+++ b/docs/examples/shading/plot_shaded_fraction1d_ns_hsat_example.py
@@ -0,0 +1,184 @@
+"""
+:py:func:`pvlib.shading.shaded_fraction1d` N-S horizontal single-axis example
+==============================================================================
+
+This example illustrates how to calculate the shaded fraction of three rows
+in an N-S HSAT configuration.
+"""
+
+# %%
+# :py:func:`pvlib.shading.shaded_fraction1d` exposes a useful method for the
+# calculation of the shaded fraction of the width of a solar collector. Here,
+# the width is defined as the dimension perpendicular to the axis of rotation.
+# This method for calculating the shaded fraction also applies to fixed-tilt
+# systems with little changes.
+#
+# Reading its documentation is recommended to understand the parameters and
+# the method capabilities.
+#
+# Let's start by obtaining the true-tracking angles for each of the rows and
+# limiting the angles to the range of -50 to 50 degrees. This decision is
+# done to allow significant shade to be used as an example.
+#
+# Key functions used in this example are:
+# 1. :py:func:`pvlib.tracking.singleaxis` to calculate the tracking angles.
+# 2. :py:func:`pvlib.shading.projected_solar_zenith_angle` to calculate the
+#    projected solar zenith angle.
+# 3. :py:func:`pvlib.shading.shaded_fraction1d` to calculate the shaded
+#    fractions.
+#
+# .. sectionauthor:: Echedey Luis <echelual (at) gmail.com>
+
+import pvlib
+
+import numpy as np
+import pandas as pd
+import matplotlib.pyplot as plt
+from matplotlib.dates import DateFormatter
+
+# Define the solar system parameters
+latitude, longitude = 28.51, -13.89
+altitude = pvlib.location.lookup_altitude(latitude, longitude)
+
+axis_tilt = 3  # degrees
+axis_azimuth = 180  # degrees
+collector_width = 3.2  # m
+pitch = 4.15  # m
+gcr = collector_width / pitch
+cross_axis_slope = -5  # degrees
+surface_to_axis_offset = 0.07  # m
+
+# Generate a time range for the simulation
+times = pd.date_range(
+    start="2024-01-01T05",
+    end="2024-01-01T21",
+    freq="5min",
+    tz="Atlantic/Canary",
+)
+
+# Calculate the solar position
+solar_position = pvlib.solarposition.get_solarposition(
+    times, latitude, longitude, altitude
+)
+solar_azimuth = solar_position["azimuth"]
+solar_zenith = solar_position["apparent_zenith"]
+
+# Calculate the tracking angles
+rotation_angle = pvlib.tracking.singleaxis(
+    solar_zenith,
+    solar_azimuth,
+    axis_tilt,
+    axis_azimuth,
+    max_angle=(-50, 50),  # (min, max) degrees
+    backtrack=False,
+    gcr=gcr,
+    cross_axis_tilt=cross_axis_slope,
+)["tracker_theta"]
+
+# %%
+# The next step is to calculate the shaded fraction. Special care must be taken
+# to ensure that the shaded or shading tracker roles are correctly assigned
+# depending on the solar position.
+# This means we will have a result for each row, ``eastmost_shaded_fraction``,
+# ``middle_shaded_fraction``, and ``westmost_shaded_fraction``.
+# Switching the parameters will be based on the
+# sign of :py:func:`pvlib.shading.projected_solar_zenith_angle`.
+#
+# The following code is verbose to make it easier to understand the process,
+# but with some effort you may be able to simplify it. This verbosity also
+# allows to change the premises easily per case, e.g., in case of a tracker
+# failure or with a different system configuration.
+
+psza = pvlib.shading.projected_solar_zenith_angle(
+    solar_zenith, solar_azimuth, axis_tilt, axis_azimuth
+)
+
+# Calculate the shaded fraction for the eastmost row
+eastmost_shaded_fraction = np.where(
+    psza < 0,
+    0,  # no shaded fraction in the morning
+    # shaded fraction in the evening
+    pvlib.shading.shaded_fraction1d(
+        solar_zenith,
+        solar_azimuth,
+        axis_azimuth,
+        shaded_tracker_rotation=rotation_angle,
+        axis_tilt=axis_tilt,
+        collector_width=collector_width,
+        pitch=pitch,
+        surface_to_axis_offset=surface_to_axis_offset,
+        cross_axis_slope=cross_axis_slope,
+        shading_tracker_rotation=rotation_angle,
+    ),
+)
+
+# Calculate the shaded fraction for the middle row
+middle_shaded_fraction = np.where(
+    psza < 0,
+    # shaded fraction in the morning
+    pvlib.shading.shaded_fraction1d(
+        solar_zenith,
+        solar_azimuth,
+        axis_azimuth,
+        shaded_tracker_rotation=rotation_angle,
+        axis_tilt=axis_tilt,
+        collector_width=collector_width,
+        pitch=pitch,
+        surface_to_axis_offset=surface_to_axis_offset,
+        cross_axis_slope=cross_axis_slope,
+        shading_tracker_rotation=rotation_angle,
+    ),
+    # shaded fraction in the evening
+    pvlib.shading.shaded_fraction1d(
+        solar_zenith,
+        solar_azimuth,
+        axis_azimuth,
+        shaded_tracker_rotation=rotation_angle,
+        axis_tilt=axis_tilt,
+        collector_width=collector_width,
+        pitch=pitch,
+        surface_to_axis_offset=surface_to_axis_offset,
+        cross_axis_slope=cross_axis_slope,
+        shading_tracker_rotation=rotation_angle,
+    ),
+)
+
+# Calculate the shaded fraction for the westmost row
+westmost_shaded_fraction = np.where(
+    psza < 0,
+    # shaded fraction in the morning
+    pvlib.shading.shaded_fraction1d(
+        solar_zenith,
+        solar_azimuth,
+        axis_azimuth,
+        shaded_tracker_rotation=rotation_angle,
+        axis_tilt=axis_tilt,
+        collector_width=collector_width,
+        pitch=pitch,
+        surface_to_axis_offset=surface_to_axis_offset,
+        cross_axis_slope=cross_axis_slope,
+        shading_tracker_rotation=rotation_angle,
+    ),
+    0,  # no shaded fraction in the evening
+)
+
+# %%
+# Plot the shaded fraction result per row
+plt.plot(times, eastmost_shaded_fraction, label="East-most", color="blue")
+plt.plot(
+    times,
+    middle_shaded_fraction,
+    label="Middle",
+    color="green",
+    linewidth=3,
+    linestyle="--",
+)
+plt.plot(times, westmost_shaded_fraction, label="West-most", color="red")
+plt.title(r"$shaded\_fraction1d$ of each row vs time")
+plt.xlabel("Time")
+plt.gca().xaxis.set_major_formatter(DateFormatter("%H:%M"))
+plt.ylabel("Shaded Fraction")
+plt.legend()
+plt.show()
+
+# %%
diff --git a/pvlib/shading.py b/pvlib/shading.py
index 932e23d869..d5efd77c45 100644
--- a/pvlib/shading.py
+++ b/pvlib/shading.py
@@ -499,6 +499,11 @@ def shaded_fraction1d(
     ...     axis_tilt=0, surface_to_axis_offset=0.10, cross_axis_slope=7)
     0.4399034444363955
 
+    You must switch the input/output depending on the
+    sign of the projected solar zenith angle.
+    See :py:func:`~pvlib.shading.projected_solar_zenith_angle` and the gallery
+    example :ref:`sphx_glr_gallery_plot_shaded_fraction1d_ns_hsat_example.py`
+
     See also
     --------
     pvlib.shading.projected_solar_zenith_angle

From 80ab494cfb9f12941c16304d67eeaee6a8286015 Mon Sep 17 00:00:00 2001
From: echedey-ls <80125792+echedey-ls@users.noreply.github.com>
Date: Tue, 23 Apr 2024 02:23:31 +0200
Subject: [PATCH 094/185] This was fixed in recent sphinx-gallery releases IIRC

---
 .../shading/plot_shaded_fraction1d_ns_hsat_example.py        | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/docs/examples/shading/plot_shaded_fraction1d_ns_hsat_example.py b/docs/examples/shading/plot_shaded_fraction1d_ns_hsat_example.py
index 10c2f89727..1a318a5256 100644
--- a/docs/examples/shading/plot_shaded_fraction1d_ns_hsat_example.py
+++ b/docs/examples/shading/plot_shaded_fraction1d_ns_hsat_example.py
@@ -1,6 +1,6 @@
 """
-:py:func:`pvlib.shading.shaded_fraction1d` N-S horizontal single-axis example
-==============================================================================
+shaded_fraction1d N-S horizontal single-axis example
+====================================================
 
 This example illustrates how to calculate the shaded fraction of three rows
 in an N-S HSAT configuration.
@@ -21,6 +21,7 @@
 # done to allow significant shade to be used as an example.
 #
 # Key functions used in this example are:
+#
 # 1. :py:func:`pvlib.tracking.singleaxis` to calculate the tracking angles.
 # 2. :py:func:`pvlib.shading.projected_solar_zenith_angle` to calculate the
 #    projected solar zenith angle.

From facde214601627cbdb8779acf8d66e273e7ee730 Mon Sep 17 00:00:00 2001
From: echedey-ls <80125792+echedey-ls@users.noreply.github.com>
Date: Tue, 23 Apr 2024 02:29:23 +0200
Subject: [PATCH 095/185] Extra empty line or admonition type unsupported

---
 pvlib/shading.py | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/pvlib/shading.py b/pvlib/shading.py
index d5efd77c45..d53ed79009 100644
--- a/pvlib/shading.py
+++ b/pvlib/shading.py
@@ -368,8 +368,7 @@ def shaded_fraction1d(
     If only the GCR is known, feed GCR into ``trackers_vertical_length`` and
     specify ``pitch=1``.
 
-    .. admonition::
-
+    .. warning::
         This function assumes the roles of the shaded and shading trackers are
         the same during all the day. If the trackers allow for different
         shading or shaded roles, e.g. a N-S single-axis tracker, you must

From 5a807b7a3761de40fe7a6c99e477b5b85c7315ec Mon Sep 17 00:00:00 2001
From: echedey-ls <80125792+echedey-ls@users.noreply.github.com>
Date: Tue, 23 Apr 2024 02:35:06 +0200
Subject: [PATCH 096/185] Fix example link (hopefully :pray:  )

---
 pvlib/shading.py | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/pvlib/shading.py b/pvlib/shading.py
index d53ed79009..5a8bfbc402 100644
--- a/pvlib/shading.py
+++ b/pvlib/shading.py
@@ -499,9 +499,9 @@ def shaded_fraction1d(
     0.4399034444363955
 
     You must switch the input/output depending on the
-    sign of the projected solar zenith angle.
-    See :py:func:`~pvlib.shading.projected_solar_zenith_angle` and the gallery
-    example :ref:`sphx_glr_gallery_plot_shaded_fraction1d_ns_hsat_example.py`
+    sign of the projected solar zenith angle. See
+    :py:func:`~pvlib.shading.projected_solar_zenith_angle` and the example
+    :ref:`sphx_glr_gallery_shading_plot_shaded_fraction1d_ns_hsat_example.py`
 
     See also
     --------

From 25a0f1915eb727bd09fc3b0e15c360858b8a4028 Mon Sep 17 00:00:00 2001
From: echedey-ls <80125792+echedey-ls@users.noreply.github.com>
Date: Tue, 23 Apr 2024 10:30:45 +0200
Subject: [PATCH 097/185] Update shading.py

---
 pvlib/shading.py | 3 ---
 1 file changed, 3 deletions(-)

diff --git a/pvlib/shading.py b/pvlib/shading.py
index 5a8bfbc402..829ee0b67b 100644
--- a/pvlib/shading.py
+++ b/pvlib/shading.py
@@ -365,9 +365,6 @@ def shaded_fraction1d(
     row and the one blocking the direct beam
     share the same rotation and azimuth values.
 
-    If only the GCR is known, feed GCR into ``trackers_vertical_length`` and
-    specify ``pitch=1``.
-
     .. warning::
         This function assumes the roles of the shaded and shading trackers are
         the same during all the day. If the trackers allow for different

From 8bdd4698ae5c575757b73c4d92d51b79586d1d6d Mon Sep 17 00:00:00 2001
From: echedey-ls <80125792+echedey-ls@users.noreply.github.com>
Date: Wed, 24 Apr 2024 18:32:07 +0200
Subject: [PATCH 098/185] Fix subsubsections?

---
 pvlib/shading.py | 112 ++++++++++++++++++++++++-----------------------
 1 file changed, 57 insertions(+), 55 deletions(-)

diff --git a/pvlib/shading.py b/pvlib/shading.py
index 829ee0b67b..443e73e52c 100644
--- a/pvlib/shading.py
+++ b/pvlib/shading.py
@@ -441,64 +441,66 @@ def shaded_fraction1d(
 
     Examples
     --------
-    Fixed-tilt south-facing array on flat terrain
-    ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-    Tilted tracker with a pitch of :math:`1.5m`, a collector width of
-    :math:`2m`, and tracker rotations of :math:`30^{\circ}`. In the morning.
-
-    >>> shaded_fraction1d(solar_zenith=80, solar_azimuth=104.5,
-    ...     axis_azimuth=90, shaded_tracker_rotation=30,
-    ...     shading_tracker_rotation=30, collector_width=2, pitch=1,
-    ...     axis_tilt=0, surface_to_axis_offset=0.05, cross_axis_slope=0)
-    0.6827437712114521
-
-    Fixed-tilt north-facing array on sloped terrain
-    ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-    Tilted tracker with a pitch of :math:`1m`, a collector width of
-    :math:`2.5m`, and tracker rotations of :math:`50^{\circ}` for the shaded
-    tracker and :math:`30^{\circ}` for the shading tracker. The rows are on a
-    :math:`10^{\circ}` slope, where their axis is on the most inclined
-    direction (zero cross-axis slope). Shaded in the morning.
-
-    >>> shaded_fraction1d(solar_zenith=65, solar_azimuth=75.5,
-    ...     axis_azimuth=270, shaded_tracker_rotation=50,
-    ...     shading_tracker_rotation=30, collector_width=2.5, pitch=1,
-    ...     axis_tilt=10, surface_to_axis_offset=0.05, cross_axis_slope=0)
-    0.6975923460352351
+
+    * **Fixed-tilt south-facing array on flat terrain**
+
+      Tilted tracker with a pitch of :math:`1.5m`, a collector width of
+      :math:`2m`, and tracker rotations of :math:`30^{\circ}`. In the morning.
+
+      >>> shaded_fraction1d(solar_zenith=80, solar_azimuth=104.5,
+      ...     axis_azimuth=90, shaded_tracker_rotation=30,
+      ...     shading_tracker_rotation=30, collector_width=2, pitch=1,
+      ...     axis_tilt=0, surface_to_axis_offset=0.05, cross_axis_slope=0)
+      0.6827437712114521
+
+    * **Fixed-tilt north-facing array on sloped terrain**
+
+      Tilted tracker with a pitch of :math:`1m`, a collector width of
+      :math:`2.5m`, and tracker rotations of :math:`50^{\circ}` for the shaded
+      tracker and :math:`30^{\circ}` for the shading tracker. The rows are on a
+      :math:`10^{\circ}` slope, where their axis is on the most inclined
+      direction (zero cross-axis slope). Shaded in the morning.
+      >>> shaded_fraction1d(solar_zenith=65, solar_azimuth=75.5,
+      ...     axis_azimuth=270, shaded_tracker_rotation=50,
+      ...     shading_tracker_rotation=30, collector_width=2.5, pitch=1,
+      ...     axis_tilt=10, surface_to_axis_offset=0.05, cross_axis_slope=0)
+      0.6975923460352351
 
     .. _ns_sat_case:
 
-    N-S single-axis tracker on sloped terrain
-    ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-    Horizontal trackers with a pitch of :math:`1m`, a collector width of
-    :math:`1.4m`, and tracker rotations of :math:`30^{\circ}` pointing east,
-    in the morning. Terrain slope is :math:`7^{\circ}` west-east (east-most
-    tracker is higher than the west-most tracker).
-
-    >>> shaded_fraction1d(solar_zenith=50, solar_azimuth=90, axis_azimuth=180,
-    ...     shaded_tracker_rotation=-30, collector_width=1.4, pitch=1,
-    ...     axis_tilt=0, surface_to_axis_offset=0.10, cross_axis_slope=7)
-    0.5828961460616938
-
-    Note the previous example only is valid for the shaded fraction of the
-    west-most tracker in the morning, and assuming it is the
-    shaded tracker during all the day is incorrect.
-    During the afternoon, it is the one casting the shadow onto the
-    east-most tracker.
-
-    To calculate the shaded fraction for the east-most
-    tracker, you must input the corresponding ``shaded_tracker_rotation``
-    in the afternoon.
-
-    >>> shaded_fraction1d(solar_zenith=50, solar_azimuth=270, axis_azimuth=180,
-    ...     shaded_tracker_rotation=30, collector_width=1.4, pitch=1,
-    ...     axis_tilt=0, surface_to_axis_offset=0.10, cross_axis_slope=7)
-    0.4399034444363955
-
-    You must switch the input/output depending on the
-    sign of the projected solar zenith angle. See
-    :py:func:`~pvlib.shading.projected_solar_zenith_angle` and the example
-    :ref:`sphx_glr_gallery_shading_plot_shaded_fraction1d_ns_hsat_example.py`
+    * **N-S single-axis tracker on sloped terrain**
+
+      Horizontal trackers with a pitch of :math:`1m`, a collector width of
+      :math:`1.4m`, and tracker rotations of :math:`30^{\circ}` pointing east,
+      in the morning. Terrain slope is :math:`7^{\circ}` west-east (east-most
+      tracker is higher than the west-most tracker).
+
+      >>> shaded_fraction1d(solar_zenith=50, solar_azimuth=90,
+      ...     axis_azimuth=180, shaded_tracker_rotation=-30,
+      ...     collector_width=1.4, pitch=1, axis_tilt=0,
+      ...     surface_to_axis_offset=0.10, cross_axis_slope=7)
+      0.5828961460616938
+
+      Note the previous example only is valid for the shaded fraction of the
+      west-most tracker in the morning, and assuming it is the
+      shaded tracker during all the day is incorrect.
+      During the afternoon, it is the one casting the shadow onto the
+      east-most tracker.
+
+      To calculate the shaded fraction for the east-most
+      tracker, you must input the corresponding ``shaded_tracker_rotation``
+      in the afternoon.
+
+      >>> shaded_fraction1d(solar_zenith=50, solar_azimuth=270,
+      ...     axis_azimuth=180, shaded_tracker_rotation=30,
+      ...     collector_width=1.4, pitch=1, axis_tilt=0,
+      ...     surface_to_axis_offset=0.10, cross_axis_slope=7)
+      0.4399034444363955
+
+      You must switch the input/output depending on the
+      sign of the projected solar zenith angle. See
+      :py:func:`~pvlib.shading.projected_solar_zenith_angle` and the example
+      :ref:`sphx_glr_gallery_shading_plot_shaded_fraction1d_ns_hsat_example.py`
 
     See also
     --------

From a2e8be777a46d338214c07fc63949c2926642902 Mon Sep 17 00:00:00 2001
From: echedey-ls <80125792+echedey-ls@users.noreply.github.com>
Date: Wed, 24 Apr 2024 18:55:11 +0200
Subject: [PATCH 099/185] Nah, bulleted list didn't work

---
 pvlib/shading.py | 110 +++++++++++++++++++++++------------------------
 1 file changed, 54 insertions(+), 56 deletions(-)

diff --git a/pvlib/shading.py b/pvlib/shading.py
index 443e73e52c..301cabb369 100644
--- a/pvlib/shading.py
+++ b/pvlib/shading.py
@@ -442,65 +442,63 @@ def shaded_fraction1d(
     Examples
     --------
 
-    * **Fixed-tilt south-facing array on flat terrain**
-
-      Tilted tracker with a pitch of :math:`1.5m`, a collector width of
-      :math:`2m`, and tracker rotations of :math:`30^{\circ}`. In the morning.
-
-      >>> shaded_fraction1d(solar_zenith=80, solar_azimuth=104.5,
-      ...     axis_azimuth=90, shaded_tracker_rotation=30,
-      ...     shading_tracker_rotation=30, collector_width=2, pitch=1,
-      ...     axis_tilt=0, surface_to_axis_offset=0.05, cross_axis_slope=0)
-      0.6827437712114521
-
-    * **Fixed-tilt north-facing array on sloped terrain**
-
-      Tilted tracker with a pitch of :math:`1m`, a collector width of
-      :math:`2.5m`, and tracker rotations of :math:`50^{\circ}` for the shaded
-      tracker and :math:`30^{\circ}` for the shading tracker. The rows are on a
-      :math:`10^{\circ}` slope, where their axis is on the most inclined
-      direction (zero cross-axis slope). Shaded in the morning.
-      >>> shaded_fraction1d(solar_zenith=65, solar_azimuth=75.5,
-      ...     axis_azimuth=270, shaded_tracker_rotation=50,
-      ...     shading_tracker_rotation=30, collector_width=2.5, pitch=1,
-      ...     axis_tilt=10, surface_to_axis_offset=0.05, cross_axis_slope=0)
-      0.6975923460352351
+    **Fixed-tilt south-facing array on flat terrain**
+
+    Tilted tracker with a pitch of :math:`1.5m`, a collector width of
+    :math:`2m`, and tracker rotations of :math:`30^{\circ}`. In the morning.
+
+    >>> shaded_fraction1d(solar_zenith=80, solar_azimuth=104.5,
+    ...     axis_azimuth=90, shaded_tracker_rotation=30,
+    ...     shading_tracker_rotation=30, collector_width=2, pitch=1,
+    ...     axis_tilt=0, surface_to_axis_offset=0.05, cross_axis_slope=0)
+    0.6827437712114521
+
+    **Fixed-tilt north-facing array on sloped terrain**
+
+    Tilted tracker with a pitch of :math:`1m`, a collector width of
+    :math:`2.5m`, and tracker rotations of :math:`50^{\circ}` for the shaded
+    tracker and :math:`30^{\circ}` for the shading tracker. The rows are on a
+    :math:`10^{\circ}` slope, where their axis is on the most inclined
+    direction (zero cross-axis slope). Shaded in the morning.
+    >>> shaded_fraction1d(solar_zenith=65, solar_azimuth=75.5,
+    ...     axis_azimuth=270, shaded_tracker_rotation=50,
+    ...     shading_tracker_rotation=30, collector_width=2.5, pitch=1,
+    ...     axis_tilt=10, surface_to_axis_offset=0.05, cross_axis_slope=0)
+    0.6975923460352351
 
     .. _ns_sat_case:
 
-    * **N-S single-axis tracker on sloped terrain**
-
-      Horizontal trackers with a pitch of :math:`1m`, a collector width of
-      :math:`1.4m`, and tracker rotations of :math:`30^{\circ}` pointing east,
-      in the morning. Terrain slope is :math:`7^{\circ}` west-east (east-most
-      tracker is higher than the west-most tracker).
-
-      >>> shaded_fraction1d(solar_zenith=50, solar_azimuth=90,
-      ...     axis_azimuth=180, shaded_tracker_rotation=-30,
-      ...     collector_width=1.4, pitch=1, axis_tilt=0,
-      ...     surface_to_axis_offset=0.10, cross_axis_slope=7)
-      0.5828961460616938
-
-      Note the previous example only is valid for the shaded fraction of the
-      west-most tracker in the morning, and assuming it is the
-      shaded tracker during all the day is incorrect.
-      During the afternoon, it is the one casting the shadow onto the
-      east-most tracker.
-
-      To calculate the shaded fraction for the east-most
-      tracker, you must input the corresponding ``shaded_tracker_rotation``
-      in the afternoon.
-
-      >>> shaded_fraction1d(solar_zenith=50, solar_azimuth=270,
-      ...     axis_azimuth=180, shaded_tracker_rotation=30,
-      ...     collector_width=1.4, pitch=1, axis_tilt=0,
-      ...     surface_to_axis_offset=0.10, cross_axis_slope=7)
-      0.4399034444363955
-
-      You must switch the input/output depending on the
-      sign of the projected solar zenith angle. See
-      :py:func:`~pvlib.shading.projected_solar_zenith_angle` and the example
-      :ref:`sphx_glr_gallery_shading_plot_shaded_fraction1d_ns_hsat_example.py`
+    **N-S single-axis tracker on sloped terrain**
+
+    Horizontal trackers with a pitch of :math:`1m`, a collector width of
+    :math:`1.4m`, and tracker rotations of :math:`30^{\circ}` pointing east,
+    in the morning. Terrain slope is :math:`7^{\circ}` west-east (east-most
+    tracker is higher than the west-most tracker).
+
+    >>> shaded_fraction1d(solar_zenith=50, solar_azimuth=90, axis_azimuth=180,
+    ...     shaded_tracker_rotation=-30, collector_width=1.4, pitch=1,
+    ...     axis_tilt=0, surface_to_axis_offset=0.10, cross_axis_slope=7)
+    0.5828961460616938
+
+    Note the previous example only is valid for the shaded fraction of the
+    west-most tracker in the morning, and assuming it is the
+    shaded tracker during all the day is incorrect.
+    During the afternoon, it is the one casting the shadow onto the
+    east-most tracker.
+
+    To calculate the shaded fraction for the east-most
+    tracker, you must input the corresponding ``shaded_tracker_rotation``
+    in the afternoon.
+
+    >>> shaded_fraction1d(solar_zenith=50, solar_azimuth=270, axis_azimuth=180,
+    ...     shaded_tracker_rotation=30, collector_width=1.4, pitch=1,
+    ...     axis_tilt=0, surface_to_axis_offset=0.10, cross_axis_slope=7)
+    0.4399034444363955
+
+    You must switch the input/output depending on the
+    sign of the projected solar zenith angle. See
+    :py:func:`~pvlib.shading.projected_solar_zenith_angle` and the example
+    :ref:`sphx_glr_gallery_shading_plot_shaded_fraction1d_ns_hsat_example.py`
 
     See also
     --------

From 9f1fa970a51f8004efdea0b5a383ba64112ce760 Mon Sep 17 00:00:00 2001
From: echedey-ls <80125792+echedey-ls@users.noreply.github.com>
Date: Wed, 24 Apr 2024 19:04:05 +0200
Subject: [PATCH 100/185] tilted -> tracker, only affects text

---
 pvlib/shading.py | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/pvlib/shading.py b/pvlib/shading.py
index 301cabb369..8a9ffd5036 100644
--- a/pvlib/shading.py
+++ b/pvlib/shading.py
@@ -444,8 +444,8 @@ def shaded_fraction1d(
 
     **Fixed-tilt south-facing array on flat terrain**
 
-    Tilted tracker with a pitch of :math:`1.5m`, a collector width of
-    :math:`2m`, and tracker rotations of :math:`30^{\circ}`. In the morning.
+    Tilted row with a pitch of :math:`1.5m`, a collector width of
+    :math:`2m`, and row rotations of :math:`30^{\circ}`. In the morning.
 
     >>> shaded_fraction1d(solar_zenith=80, solar_azimuth=104.5,
     ...     axis_azimuth=90, shaded_tracker_rotation=30,
@@ -455,9 +455,9 @@ def shaded_fraction1d(
 
     **Fixed-tilt north-facing array on sloped terrain**
 
-    Tilted tracker with a pitch of :math:`1m`, a collector width of
-    :math:`2.5m`, and tracker rotations of :math:`50^{\circ}` for the shaded
-    tracker and :math:`30^{\circ}` for the shading tracker. The rows are on a
+    Tilted row with a pitch of :math:`1m`, a collector width of
+    :math:`2.5m`, and row rotations of :math:`50^{\circ}` for the shaded
+    row and :math:`30^{\circ}` for the shading row. The rows are on a
     :math:`10^{\circ}` slope, where their axis is on the most inclined
     direction (zero cross-axis slope). Shaded in the morning.
     >>> shaded_fraction1d(solar_zenith=65, solar_azimuth=75.5,

From 37ab4962f573216ad03fd8d8de774181bfe93d1a Mon Sep 17 00:00:00 2001
From: echedey-ls <80125792+echedey-ls@users.noreply.github.com>
Date: Wed, 24 Apr 2024 19:06:56 +0200
Subject: [PATCH 101/185] Typos and unreasonable physical values

Co-Authored-By: Kevin Anderson <57452607+kandersolar@users.noreply.github.com>
---
 pvlib/shading.py | 13 +++++++------
 1 file changed, 7 insertions(+), 6 deletions(-)

diff --git a/pvlib/shading.py b/pvlib/shading.py
index 8a9ffd5036..9815696965 100644
--- a/pvlib/shading.py
+++ b/pvlib/shading.py
@@ -444,25 +444,26 @@ def shaded_fraction1d(
 
     **Fixed-tilt south-facing array on flat terrain**
 
-    Tilted row with a pitch of :math:`1.5m`, a collector width of
+    Tilted row with a pitch of :math:`3m`, a collector width of
     :math:`2m`, and row rotations of :math:`30^{\circ}`. In the morning.
 
     >>> shaded_fraction1d(solar_zenith=80, solar_azimuth=104.5,
     ...     axis_azimuth=90, shaded_tracker_rotation=30,
-    ...     shading_tracker_rotation=30, collector_width=2, pitch=1,
+    ...     shading_tracker_rotation=30, collector_width=2, pitch=3,
     ...     axis_tilt=0, surface_to_axis_offset=0.05, cross_axis_slope=0)
     0.6827437712114521
 
     **Fixed-tilt north-facing array on sloped terrain**
 
-    Tilted row with a pitch of :math:`1m`, a collector width of
+    Tilted row with a pitch of :math:`4m`, a collector width of
     :math:`2.5m`, and row rotations of :math:`50^{\circ}` for the shaded
     row and :math:`30^{\circ}` for the shading row. The rows are on a
     :math:`10^{\circ}` slope, where their axis is on the most inclined
     direction (zero cross-axis slope). Shaded in the morning.
+
     >>> shaded_fraction1d(solar_zenith=65, solar_azimuth=75.5,
     ...     axis_azimuth=270, shaded_tracker_rotation=50,
-    ...     shading_tracker_rotation=30, collector_width=2.5, pitch=1,
+    ...     shading_tracker_rotation=30, collector_width=2.5, pitch=4,
     ...     axis_tilt=10, surface_to_axis_offset=0.05, cross_axis_slope=0)
     0.6975923460352351
 
@@ -470,13 +471,13 @@ def shaded_fraction1d(
 
     **N-S single-axis tracker on sloped terrain**
 
-    Horizontal trackers with a pitch of :math:`1m`, a collector width of
+    Horizontal trackers with a pitch of :math:`3m`, a collector width of
     :math:`1.4m`, and tracker rotations of :math:`30^{\circ}` pointing east,
     in the morning. Terrain slope is :math:`7^{\circ}` west-east (east-most
     tracker is higher than the west-most tracker).
 
     >>> shaded_fraction1d(solar_zenith=50, solar_azimuth=90, axis_azimuth=180,
-    ...     shaded_tracker_rotation=-30, collector_width=1.4, pitch=1,
+    ...     shaded_tracker_rotation=-30, collector_width=1.4, pitch=3,
     ...     axis_tilt=0, surface_to_axis_offset=0.10, cross_axis_slope=7)
     0.5828961460616938
 

From 630358346203ffc52b3d3de70bae2a53012d35a8 Mon Sep 17 00:00:00 2001
From: echedey-ls <80125792+echedey-ls@users.noreply.github.com>
Date: Wed, 24 Apr 2024 19:11:05 +0200
Subject: [PATCH 102/185] See the Examples section below, not the unlinkable
 link

Co-Authored-By: Kevin Anderson <57452607+kandersolar@users.noreply.github.com>
---
 pvlib/shading.py | 4 +---
 1 file changed, 1 insertion(+), 3 deletions(-)

diff --git a/pvlib/shading.py b/pvlib/shading.py
index 9815696965..66c639aada 100644
--- a/pvlib/shading.py
+++ b/pvlib/shading.py
@@ -370,7 +370,7 @@ def shaded_fraction1d(
         the same during all the day. If the trackers allow for different
         shading or shaded roles, e.g. a N-S single-axis tracker, you must
         switch the inputs depending on the sign of the projected solar zenith
-        angle. See :ref:`ns_sat_case`.
+        angle. See the Examples section below.
 
     .. versionadded:: 0.10.5
 
@@ -467,8 +467,6 @@ def shaded_fraction1d(
     ...     axis_tilt=10, surface_to_axis_offset=0.05, cross_axis_slope=0)
     0.6975923460352351
 
-    .. _ns_sat_case:
-
     **N-S single-axis tracker on sloped terrain**
 
     Horizontal trackers with a pitch of :math:`3m`, a collector width of

From e785292834469f52b1d3fbda335c005abb251920 Mon Sep 17 00:00:00 2001
From: echedey-ls <80125792+echedey-ls@users.noreply.github.com>
Date: Wed, 24 Apr 2024 19:23:05 +0200
Subject: [PATCH 103/185] tracker -> row, param names, code and docs

Co-Authored-By: Kevin Anderson <57452607+kandersolar@users.noreply.github.com>
---
 pvlib/shading.py            | 62 +++++++++++++++++++------------------
 pvlib/tests/test_shading.py |  6 ++--
 2 files changed, 35 insertions(+), 33 deletions(-)

diff --git a/pvlib/shading.py b/pvlib/shading.py
index 66c639aada..5ed2c217ce 100644
--- a/pvlib/shading.py
+++ b/pvlib/shading.py
@@ -348,26 +348,26 @@ def shaded_fraction1d(
     solar_zenith,
     solar_azimuth,
     axis_azimuth,
-    shaded_tracker_rotation,
+    shaded_row_rotation,
     *,
     collector_width,
     pitch,
     axis_tilt=0,
     surface_to_axis_offset=0,
     cross_axis_slope=0,
-    shading_tracker_rotation=None,
+    shading_row_rotation=None,
 ):
     r"""
     Shaded fraction in the vertical dimension of tilted rows, or perpendicular
     to the axis of horizontal rows.
 
-    If ``shading_tracker_rotation`` isn't provided, assumes both the shaded
+    If ``shading_row_rotation`` isn't provided, assumes both the shaded
     row and the one blocking the direct beam
     share the same rotation and azimuth values.
 
     .. warning::
-        This function assumes the roles of the shaded and shading trackers are
-        the same during all the day. If the trackers allow for different
+        This function assumes the roles of the shaded and shading rows are
+        the same during all the day. If the rows allow for different
         shading or shaded roles, e.g. a N-S single-axis tracker, you must
         switch the inputs depending on the sign of the projected solar zenith
         angle. See the Examples section below.
@@ -382,14 +382,16 @@ def shaded_fraction1d(
         Solar position azimuth, in degrees.
     axis_azimuth : numeric
         In degrees. North=0º, South=180º, East=90º, West=270º.
-    shaded_tracker_rotation : numeric
-        Right-handed rotation of the tracker receiving the shade, with respect
+        This is the rotation axis of a tracker. Consider fixed-tilt arrays as
+        a particular case of a tracker.
+    shaded_row_rotation : numeric
+        Right-handed rotation of the row receiving the shade, with respect
         to ``axis_azimuth``. In degrees :math:`^{\circ}`.
     collector_width : numeric
-        Vertical length of a tilted tracker. The returned ``shaded_fraction``
+        Vertical length of a tilted row. The returned ``shaded_fraction``
         is the ratio of the shadow over this value.
     pitch : numeric
-        Axis-to-axis horizontal spacing of the trackers.
+        Axis-to-axis horizontal spacing of the row.
     axis_tilt : numeric, default 0
         Tilt of the rows axis from horizontal. In degrees :math:`^{\circ}`.
     surface_to_axis_offset : numeric, default 0
@@ -398,8 +400,8 @@ def shaded_fraction1d(
         Angle of the plane containing the rows' axes from
         horizontal. Right-handed rotation with respect to ``axis_azimuth``.
         In degrees :math:`^{\circ}`.
-    shading_tracker_rotation : numeric, optional
-        Right-handed rotation of the tracker casting the shadow, with respect
+    shading_row_rotation : numeric, optional
+        Right-handed rotation of the row casting the shadow, with respect
         to ``axis_azimuth``. In degrees :math:`^{\circ}`.
 
     Returns
@@ -416,7 +418,7 @@ def shaded_fraction1d(
     Parameters are defined as follow:
 
     .. figure:: ../../_images/Anderson_Jensen_2024_Fig3.png
-        :alt: Diagram showing the two trackers and the parameters of the model.
+        :alt: Diagram showing the two rows and the parameters of the model.
 
         Figure 3 of [1]_. See correspondence between this nomenclature and the
         function parameters in the table below.
@@ -424,9 +426,9 @@ def shaded_fraction1d(
     +------------------+----------------------------+---------------------+
     | Symbol           | Parameter                  | Units               |
     +==================+============================+=====================+
-    | :math:`\theta_1` |``shading_tracker_rotation``|                     |
+    | :math:`\theta_1` | ``shading_row_rotation``   |                     |
     +------------------+----------------------------+                     |
-    | :math:`\theta_2` | ``shaded_tracker_rotation``| Degrees             |
+    | :math:`\theta_2` | ``shaded_row_rotation``    | Degrees             |
     +------------------+----------------------------+ :math:`^{\circ}`    |
     | :math:`\beta_c`  | ``cross_axis_slope``       |                     |
     +------------------+----------------------------+---------------------+
@@ -448,9 +450,9 @@ def shaded_fraction1d(
     :math:`2m`, and row rotations of :math:`30^{\circ}`. In the morning.
 
     >>> shaded_fraction1d(solar_zenith=80, solar_azimuth=104.5,
-    ...     axis_azimuth=90, shaded_tracker_rotation=30,
-    ...     shading_tracker_rotation=30, collector_width=2, pitch=3,
-    ...     axis_tilt=0, surface_to_axis_offset=0.05, cross_axis_slope=0)
+    ...     axis_azimuth=90, shaded_row_rotation=30, shading_row_rotation=30,
+    ...     collector_width=2, pitch=3, axis_tilt=0,
+    ...     surface_to_axis_offset=0.05, cross_axis_slope=0)
     0.6827437712114521
 
     **Fixed-tilt north-facing array on sloped terrain**
@@ -462,9 +464,9 @@ def shaded_fraction1d(
     direction (zero cross-axis slope). Shaded in the morning.
 
     >>> shaded_fraction1d(solar_zenith=65, solar_azimuth=75.5,
-    ...     axis_azimuth=270, shaded_tracker_rotation=50,
-    ...     shading_tracker_rotation=30, collector_width=2.5, pitch=4,
-    ...     axis_tilt=10, surface_to_axis_offset=0.05, cross_axis_slope=0)
+    ...     axis_azimuth=270, shaded_row_rotation=50, shading_row_rotation=30,
+    ...     collector_width=2.5, pitch=4, axis_tilt=10,
+    ...     surface_to_axis_offset=0.05, cross_axis_slope=0)
     0.6975923460352351
 
     **N-S single-axis tracker on sloped terrain**
@@ -475,8 +477,8 @@ def shaded_fraction1d(
     tracker is higher than the west-most tracker).
 
     >>> shaded_fraction1d(solar_zenith=50, solar_azimuth=90, axis_azimuth=180,
-    ...     shaded_tracker_rotation=-30, collector_width=1.4, pitch=3,
-    ...     axis_tilt=0, surface_to_axis_offset=0.10, cross_axis_slope=7)
+    ...     shaded_row_rotation=-30, collector_width=1.4, pitch=3, axis_tilt=0,
+    ...     surface_to_axis_offset=0.10, cross_axis_slope=7)
     0.5828961460616938
 
     Note the previous example only is valid for the shaded fraction of the
@@ -486,12 +488,12 @@ def shaded_fraction1d(
     east-most tracker.
 
     To calculate the shaded fraction for the east-most
-    tracker, you must input the corresponding ``shaded_tracker_rotation``
+    tracker, you must input the corresponding ``shaded_row_rotation``
     in the afternoon.
 
     >>> shaded_fraction1d(solar_zenith=50, solar_azimuth=270, axis_azimuth=180,
-    ...     shaded_tracker_rotation=30, collector_width=1.4, pitch=1,
-    ...     axis_tilt=0, surface_to_axis_offset=0.10, cross_axis_slope=7)
+    ...     shaded_row_rotation=30, collector_width=1.4, pitch=3, axis_tilt=0,
+    ...     surface_to_axis_offset=0.10, cross_axis_slope=7)
     0.4399034444363955
 
     You must switch the input/output depending on the
@@ -511,9 +513,9 @@ def shaded_fraction1d(
     """
     # For nomenclature you may refer to [1].
 
-    # rotation of tracker casting the shadow defaults to shaded tracker's one
-    if shading_tracker_rotation is None:
-        shading_tracker_rotation = shaded_tracker_rotation
+    # rotation of row casting the shadow defaults to shaded row's one
+    if shading_row_rotation is None:
+        shading_row_rotation = shaded_row_rotation
 
     # projected solar zenith angle
     projected_solar_zenith = projected_solar_zenith_angle(
@@ -524,8 +526,8 @@ def shaded_fraction1d(
     )
 
     # calculate repeated elements
-    thetas_1_S_diff = shading_tracker_rotation - projected_solar_zenith
-    thetas_2_S_diff = shaded_tracker_rotation - projected_solar_zenith
+    thetas_1_S_diff = shading_row_rotation - projected_solar_zenith
+    thetas_2_S_diff = shaded_row_rotation - projected_solar_zenith
     thetaS_rotation_diff = projected_solar_zenith - cross_axis_slope
 
     cos_theta_2_S_diff_abs = np.abs(cosd(thetas_2_S_diff))
diff --git a/pvlib/tests/test_shading.py b/pvlib/tests/test_shading.py
index c96fa1c096..17ed27e7f9 100644
--- a/pvlib/tests/test_shading.py
+++ b/pvlib/tests/test_shading.py
@@ -263,7 +263,7 @@ def sf1d_premises_and_expected():
         / (test_data["x_L"] - test_data["x_R"])
     )
     test_data["pitch"] = test_data["x_L"] - test_data["x_R"]
-    # switch Left/Right trackers if needed to make the right one the shaded
+    # switch Left/Right rows if needed to make the right one the shaded
     where_switch = test_data["theta_s"] >= 0
     test_data["theta_L"], test_data["theta_R"] = np.where(
         where_switch,
@@ -272,8 +272,8 @@ def sf1d_premises_and_expected():
     )
     test_data.rename(
         columns={
-            "theta_L": "shading_tracker_rotation",
-            "theta_R": "shaded_tracker_rotation",
+            "theta_L": "shading_row_rotation",
+            "theta_R": "shaded_row_rotation",
             "z_0": "surface_to_axis_offset",
             "l": "collector_width",
             "theta_s": "solar_zenith",  # for the projected solar zenith angle

From 9b98d9e3246335b55186074a307080631eee2b97 Mon Sep 17 00:00:00 2001
From: echedey-ls <80125792+echedey-ls@users.noreply.github.com>
Date: Sat, 27 Apr 2024 01:06:24 +0200
Subject: [PATCH 104/185] Fix broken example :wrench:

Co-Authored-By: Kevin Anderson <57452607+kandersolar@users.noreply.github.com>
---
 .../plot_shaded_fraction1d_ns_hsat_example.py    | 16 ++++++++--------
 1 file changed, 8 insertions(+), 8 deletions(-)

diff --git a/docs/examples/shading/plot_shaded_fraction1d_ns_hsat_example.py b/docs/examples/shading/plot_shaded_fraction1d_ns_hsat_example.py
index 1a318a5256..cb2a2e0c0e 100644
--- a/docs/examples/shading/plot_shaded_fraction1d_ns_hsat_example.py
+++ b/docs/examples/shading/plot_shaded_fraction1d_ns_hsat_example.py
@@ -103,13 +103,13 @@
         solar_zenith,
         solar_azimuth,
         axis_azimuth,
-        shaded_tracker_rotation=rotation_angle,
+        shaded_row_rotation=rotation_angle,
         axis_tilt=axis_tilt,
         collector_width=collector_width,
         pitch=pitch,
         surface_to_axis_offset=surface_to_axis_offset,
         cross_axis_slope=cross_axis_slope,
-        shading_tracker_rotation=rotation_angle,
+        shading_row_rotation=rotation_angle,
     ),
 )
 
@@ -121,26 +121,26 @@
         solar_zenith,
         solar_azimuth,
         axis_azimuth,
-        shaded_tracker_rotation=rotation_angle,
+        shaded_row_rotation=rotation_angle,
         axis_tilt=axis_tilt,
         collector_width=collector_width,
         pitch=pitch,
         surface_to_axis_offset=surface_to_axis_offset,
         cross_axis_slope=cross_axis_slope,
-        shading_tracker_rotation=rotation_angle,
+        shading_row_rotation=rotation_angle,
     ),
     # shaded fraction in the evening
     pvlib.shading.shaded_fraction1d(
         solar_zenith,
         solar_azimuth,
         axis_azimuth,
-        shaded_tracker_rotation=rotation_angle,
+        shaded_row_rotation=rotation_angle,
         axis_tilt=axis_tilt,
         collector_width=collector_width,
         pitch=pitch,
         surface_to_axis_offset=surface_to_axis_offset,
         cross_axis_slope=cross_axis_slope,
-        shading_tracker_rotation=rotation_angle,
+        shading_row_rotation=rotation_angle,
     ),
 )
 
@@ -152,13 +152,13 @@
         solar_zenith,
         solar_azimuth,
         axis_azimuth,
-        shaded_tracker_rotation=rotation_angle,
+        shaded_row_rotation=rotation_angle,
         axis_tilt=axis_tilt,
         collector_width=collector_width,
         pitch=pitch,
         surface_to_axis_offset=surface_to_axis_offset,
         cross_axis_slope=cross_axis_slope,
-        shading_tracker_rotation=rotation_angle,
+        shading_row_rotation=rotation_angle,
     ),
     0,  # no shaded fraction in the evening
 )

From 3726e4de6816d9da8353fbcea7700639bd2ea727 Mon Sep 17 00:00:00 2001
From: Echedey Luis <80125792+echedey-ls@users.noreply.github.com>
Date: Thu, 23 May 2024 19:15:53 +0200
Subject: [PATCH 105/185] Apply suggestions from code review

Co-authored-by: Adam R. Jensen <39184289+AdamRJensen@users.noreply.github.com>
---
 .../plot_shaded_fraction1d_ns_hsat_example.py | 23 ++++++-------
 docs/sphinx/source/whatsnew/v0.10.5.rst       |  3 +-
 pvlib/shading.py                              | 32 +++++++++----------
 3 files changed, 30 insertions(+), 28 deletions(-)

diff --git a/docs/examples/shading/plot_shaded_fraction1d_ns_hsat_example.py b/docs/examples/shading/plot_shaded_fraction1d_ns_hsat_example.py
index cb2a2e0c0e..e468207363 100644
--- a/docs/examples/shading/plot_shaded_fraction1d_ns_hsat_example.py
+++ b/docs/examples/shading/plot_shaded_fraction1d_ns_hsat_example.py
@@ -1,24 +1,24 @@
 """
-shaded_fraction1d N-S horizontal single-axis example
+Shaded fraction of a horizontal single-axis tracker
 ====================================================
 
-This example illustrates how to calculate the shaded fraction of three rows
-in an N-S HSAT configuration.
+This example illustrates how to calculate the 1D shaded fraction of three rows
+in a North-South horizontal single axis tracker (HSAT) configuration.
 """
 
 # %%
 # :py:func:`pvlib.shading.shaded_fraction1d` exposes a useful method for the
 # calculation of the shaded fraction of the width of a solar collector. Here,
 # the width is defined as the dimension perpendicular to the axis of rotation.
-# This method for calculating the shaded fraction also applies to fixed-tilt
-# systems with little changes.
+# This method for calculating the shaded fraction only requires minor
+# modifications to be applicable for fixed-tilt systems.
 #
-# Reading its documentation is recommended to understand the parameters and
-# the method capabilities.
+# It is highly recommended to read the :py:func:`pvlib.shading.shaded_fraction1d` documentation
+# to understand the input parameters and the method's capabilities.
 #
 # Let's start by obtaining the true-tracking angles for each of the rows and
 # limiting the angles to the range of -50 to 50 degrees. This decision is
-# done to allow significant shade to be used as an example.
+# done to create an example scenario with significant shading.
 #
 # Key functions used in this example are:
 #
@@ -42,7 +42,7 @@
 altitude = pvlib.location.lookup_altitude(latitude, longitude)
 
 axis_tilt = 3  # degrees
-axis_azimuth = 180  # degrees
+axis_azimuth = 180  # degrees, N-S tracking axis
 collector_width = 3.2  # m
 pitch = 4.15  # m
 gcr = collector_width / pitch
@@ -77,7 +77,8 @@
 )["tracker_theta"]
 
 # %%
-# The next step is to calculate the shaded fraction. Special care must be taken
+# Once the tracker angles have been obtained, the next step is to calculate
+# the shaded fraction. Special care must be taken
 # to ensure that the shaded or shading tracker roles are correctly assigned
 # depending on the solar position.
 # This means we will have a result for each row, ``eastmost_shaded_fraction``,
@@ -164,7 +165,7 @@
 )
 
 # %%
-# Plot the shaded fraction result per row
+# Plot the shaded fraction result for each row:
 plt.plot(times, eastmost_shaded_fraction, label="East-most", color="blue")
 plt.plot(
     times,
diff --git a/docs/sphinx/source/whatsnew/v0.10.5.rst b/docs/sphinx/source/whatsnew/v0.10.5.rst
index 7258927038..1457e5780b 100644
--- a/docs/sphinx/source/whatsnew/v0.10.5.rst
+++ b/docs/sphinx/source/whatsnew/v0.10.5.rst
@@ -12,7 +12,8 @@ Deprecations
 Enhancements
 ~~~~~~~~~~~~
 * Added function :py:func:`pvlib.shading.shaded_fraction1d`, to calculate the
-  shade perpendicular to ``axis_azimuth``. (:issue:`1689`, :pull:`1725`, :pull:`1962`)
+  shade perpendicular to ``axis_azimuth``. The function is applicable to both
+  fixed-tilt and one-axis tracking systems. (:issue:`1689`, :pull:`1725`, :pull:`1962`)
 
 
 Bug fixes
diff --git a/pvlib/shading.py b/pvlib/shading.py
index 5ed2c217ce..85c9be2dee 100644
--- a/pvlib/shading.py
+++ b/pvlib/shading.py
@@ -361,29 +361,29 @@ def shaded_fraction1d(
     Shaded fraction in the vertical dimension of tilted rows, or perpendicular
     to the axis of horizontal rows.
 
-    If ``shading_row_rotation`` isn't provided, assumes both the shaded
-    row and the one blocking the direct beam
-    share the same rotation and azimuth values.
+    If ``shading_row_rotation`` isn't provided, it is assumed that
+    both the shaded row and the shading row (the one blocking the
+    direct beam) have the same rotation and azimuth values.
 
     .. warning::
-        This function assumes the roles of the shaded and shading rows are
-        the same during all the day. If the rows allow for different
-        shading or shaded roles, e.g. a N-S single-axis tracker, you must
-        switch the inputs depending on the sign of the projected solar zenith
+        The function assumes that the roles of the shaded and shading rows remain
+        the same during the day. In the case where the shading and shaded rows
+        change throughout the day, e.g. a N-S single-axis tracker, the inputs
+        must be switched depending on the sign of the projected solar zenith
         angle. See the Examples section below.
 
-    .. versionadded:: 0.10.5
+    .. versionadded:: 0.11.0
 
     Parameters
     ----------
     solar_zenith : numeric
-        Solar position zenith, in degrees.
+        Solar zenith angle, in degrees.
     solar_azimuth : numeric
-        Solar position azimuth, in degrees.
+        Solar azimuth angle, in degrees.
     axis_azimuth : numeric
-        In degrees. North=0º, South=180º, East=90º, West=270º.
-        This is the rotation axis of a tracker. Consider fixed-tilt arrays as
-        a particular case of a tracker.
+        Axis azimuth of the rotation axis of a tracker, in degrees.
+        Fixed-tilt arrays can be considered as a particular case of a tracker.
+        North=0º, South=180º, East=90º, West=270º.
     shaded_row_rotation : numeric
         Right-handed rotation of the row receiving the shade, with respect
         to ``axis_azimuth``. In degrees :math:`^{\circ}`.
@@ -396,6 +396,7 @@ def shaded_fraction1d(
         Tilt of the rows axis from horizontal. In degrees :math:`^{\circ}`.
     surface_to_axis_offset : numeric, default 0
         Distance between the rotating axis and the collector surface.
+        May be used to account for a torque tube offset.
     cross_axis_slope : numeric, default 0
         Angle of the plane containing the rows' axes from
         horizontal. Right-handed rotation with respect to ``axis_azimuth``.
@@ -408,12 +409,11 @@ def shaded_fraction1d(
     -------
     shaded_fraction : numeric
         The fraction of the collector width shaded by an adjacent row. A
-        value of 1 is completely shaded and zero is no shade.
+        value of 1 is completely shaded and 0 is no shade.
 
     Notes
     -----
-    All length parameters must have the same units to produce a reasonable
-    result.
+    All length parameters must have the same units.
 
     Parameters are defined as follow:
 

From 4e7e36f8bfe93eac3069eea09f4a58f682b343af Mon Sep 17 00:00:00 2001
From: echedey-ls <80125792+echedey-ls@users.noreply.github.com>
Date: Thu, 23 May 2024 19:20:49 +0200
Subject: [PATCH 106/185] "the row axis/axes" instead of ``axis_azimuth``

---
 pvlib/shading.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/pvlib/shading.py b/pvlib/shading.py
index 85c9be2dee..0648f6ad59 100644
--- a/pvlib/shading.py
+++ b/pvlib/shading.py
@@ -399,11 +399,11 @@ def shaded_fraction1d(
         May be used to account for a torque tube offset.
     cross_axis_slope : numeric, default 0
         Angle of the plane containing the rows' axes from
-        horizontal. Right-handed rotation with respect to ``axis_azimuth``.
+        horizontal. Right-handed rotation with respect to the rows axes.
         In degrees :math:`^{\circ}`.
     shading_row_rotation : numeric, optional
         Right-handed rotation of the row casting the shadow, with respect
-        to ``axis_azimuth``. In degrees :math:`^{\circ}`.
+        to the row axis. In degrees :math:`^{\circ}`.
 
     Returns
     -------

From 59465c8191868ba98536e3410f038d57a172233e Mon Sep 17 00:00:00 2001
From: echedey-ls <80125792+echedey-ls@users.noreply.github.com>
Date: Thu, 23 May 2024 19:25:18 +0200
Subject: [PATCH 107/185] Unnecessary math mode

Co-Authored-By: Adam R. Jensen <39184289+AdamRJensen@users.noreply.github.com>
---
 pvlib/shading.py | 18 +++++++++---------
 1 file changed, 9 insertions(+), 9 deletions(-)

diff --git a/pvlib/shading.py b/pvlib/shading.py
index 0648f6ad59..dea343170f 100644
--- a/pvlib/shading.py
+++ b/pvlib/shading.py
@@ -446,8 +446,8 @@ def shaded_fraction1d(
 
     **Fixed-tilt south-facing array on flat terrain**
 
-    Tilted row with a pitch of :math:`3m`, a collector width of
-    :math:`2m`, and row rotations of :math:`30^{\circ}`. In the morning.
+    Tilted row with a pitch of 3 m, a collector width of
+    2 m, and row rotations of 30°. In the morning.
 
     >>> shaded_fraction1d(solar_zenith=80, solar_azimuth=104.5,
     ...     axis_azimuth=90, shaded_row_rotation=30, shading_row_rotation=30,
@@ -457,10 +457,10 @@ def shaded_fraction1d(
 
     **Fixed-tilt north-facing array on sloped terrain**
 
-    Tilted row with a pitch of :math:`4m`, a collector width of
-    :math:`2.5m`, and row rotations of :math:`50^{\circ}` for the shaded
-    row and :math:`30^{\circ}` for the shading row. The rows are on a
-    :math:`10^{\circ}` slope, where their axis is on the most inclined
+    Tilted row with a pitch of 4 m, a collector width of
+    2.5 m, and row rotations of 50° for the shaded
+    row and 30° for the shading row. The rows are on a
+    10° slope, where their axis is on the most inclined
     direction (zero cross-axis slope). Shaded in the morning.
 
     >>> shaded_fraction1d(solar_zenith=65, solar_azimuth=75.5,
@@ -471,9 +471,9 @@ def shaded_fraction1d(
 
     **N-S single-axis tracker on sloped terrain**
 
-    Horizontal trackers with a pitch of :math:`3m`, a collector width of
-    :math:`1.4m`, and tracker rotations of :math:`30^{\circ}` pointing east,
-    in the morning. Terrain slope is :math:`7^{\circ}` west-east (east-most
+    Horizontal trackers with a pitch of 3 m, a collector width of
+    1.4 m, and tracker rotations of 30° pointing east,
+    in the morning. Terrain slope is 7° west-east (east-most
     tracker is higher than the west-most tracker).
 
     >>> shaded_fraction1d(solar_zenith=50, solar_azimuth=90, axis_azimuth=180,

From 9fa2bb44798cab2229f71f45fb2e7e41079fdb7a Mon Sep 17 00:00:00 2001
From: echedey-ls <80125792+echedey-ls@users.noreply.github.com>
Date: Thu, 23 May 2024 19:45:12 +0200
Subject: [PATCH 108/185] Example suggestions and text trimming

Co-Authored-By: Adam R. Jensen <39184289+AdamRJensen@users.noreply.github.com>
---
 .../plot_shaded_fraction1d_ns_hsat_example.py | 19 ++++++-------------
 pvlib/shading.py                              | 10 +++++-----
 2 files changed, 11 insertions(+), 18 deletions(-)

diff --git a/docs/examples/shading/plot_shaded_fraction1d_ns_hsat_example.py b/docs/examples/shading/plot_shaded_fraction1d_ns_hsat_example.py
index e468207363..5f43c8047e 100644
--- a/docs/examples/shading/plot_shaded_fraction1d_ns_hsat_example.py
+++ b/docs/examples/shading/plot_shaded_fraction1d_ns_hsat_example.py
@@ -13,8 +13,9 @@
 # This method for calculating the shaded fraction only requires minor
 # modifications to be applicable for fixed-tilt systems.
 #
-# It is highly recommended to read the :py:func:`pvlib.shading.shaded_fraction1d` documentation
-# to understand the input parameters and the method's capabilities.
+# It is highly recommended to read :py:func:`pvlib.shading.shaded_fraction1d`
+# documentation to understand the input parameters and the method's
+# capabilities.
 #
 # Let's start by obtaining the true-tracking angles for each of the rows and
 # limiting the angles to the range of -50 to 50 degrees. This decision is
@@ -41,7 +42,7 @@
 latitude, longitude = 28.51, -13.89
 altitude = pvlib.location.lookup_altitude(latitude, longitude)
 
-axis_tilt = 3  # degrees
+axis_tilt = 3  # degrees, positive is upwards in the axis_azimuth direction
 axis_azimuth = 180  # degrees, N-S tracking axis
 collector_width = 3.2  # m
 pitch = 4.15  # m
@@ -167,14 +168,8 @@
 # %%
 # Plot the shaded fraction result for each row:
 plt.plot(times, eastmost_shaded_fraction, label="East-most", color="blue")
-plt.plot(
-    times,
-    middle_shaded_fraction,
-    label="Middle",
-    color="green",
-    linewidth=3,
-    linestyle="--",
-)
+plt.plot(times, middle_shaded_fraction, label="Middle", color="green",
+         linewidth=3, linestyle="--")  # fmt: skip
 plt.plot(times, westmost_shaded_fraction, label="West-most", color="red")
 plt.title(r"$shaded\_fraction1d$ of each row vs time")
 plt.xlabel("Time")
@@ -182,5 +177,3 @@
 plt.ylabel("Shaded Fraction")
 plt.legend()
 plt.show()
-
-# %%
diff --git a/pvlib/shading.py b/pvlib/shading.py
index dea343170f..cbbf80a8f6 100644
--- a/pvlib/shading.py
+++ b/pvlib/shading.py
@@ -366,11 +366,11 @@ def shaded_fraction1d(
     direct beam) have the same rotation and azimuth values.
 
     .. warning::
-        The function assumes that the roles of the shaded and shading rows remain
-        the same during the day. In the case where the shading and shaded rows
-        change throughout the day, e.g. a N-S single-axis tracker, the inputs
-        must be switched depending on the sign of the projected solar zenith
-        angle. See the Examples section below.
+        The function assumes that the roles of the shaded and shading rows
+        remain the same during the day. In the case where the shading and
+        shaded rows change throughout the day, e.g. a N-S single-axis tracker,
+        the inputs must be switched depending on the sign of the projected
+        solar zenith angle. See the Examples section below.
 
     .. versionadded:: 0.11.0
 

From 0d521ee39bde628b9c9d7949cf555c1b86270803 Mon Sep 17 00:00:00 2001
From: echedey-ls <80125792+echedey-ls@users.noreply.github.com>
Date: Thu, 23 May 2024 19:47:28 +0200
Subject: [PATCH 109/185] whatsmes

---
 docs/sphinx/source/whatsnew/v0.10.5.rst | 15 ---------------
 docs/sphinx/source/whatsnew/v0.11.0.rst |  5 +++++
 2 files changed, 5 insertions(+), 15 deletions(-)

diff --git a/docs/sphinx/source/whatsnew/v0.10.5.rst b/docs/sphinx/source/whatsnew/v0.10.5.rst
index 46b26b88ad..00daed3a0f 100644
--- a/docs/sphinx/source/whatsnew/v0.10.5.rst
+++ b/docs/sphinx/source/whatsnew/v0.10.5.rst
@@ -1,19 +1,6 @@
 .. _whatsnew_01050:
 
 
-v0.10.5 (Anticipated June 2024)
--------------------------------
-
-
-Deprecations
-~~~~~~~~~~~~
-
-
-Enhancements
-~~~~~~~~~~~~
-* Added function :py:func:`pvlib.shading.shaded_fraction1d`, to calculate the
-  shade perpendicular to ``axis_azimuth``. The function is applicable to both
-  fixed-tilt and one-axis tracking systems. (:issue:`1689`, :pull:`1725`, :pull:`1962`)
 v0.10.5 (May 6, 2024)
 ---------------------
 
@@ -47,8 +34,6 @@ Requirements
 Contributors
 ~~~~~~~~~~~~
 * Cliff Hansen (:ghuser:`cwhanse`)
-* Mark Mikofski (:ghuser:`mikofski`)
-* Echedey Luis (:ghuser:`echedey-ls`)
 * :ghuser:`apct69`
 * Mark Mikofski (:ghuser:`mikofski`)
 * Echedey Luis (:ghuser:`echedey-ls`)
diff --git a/docs/sphinx/source/whatsnew/v0.11.0.rst b/docs/sphinx/source/whatsnew/v0.11.0.rst
index 142974ea78..8d3faa2571 100644
--- a/docs/sphinx/source/whatsnew/v0.11.0.rst
+++ b/docs/sphinx/source/whatsnew/v0.11.0.rst
@@ -15,6 +15,10 @@ Deprecations
 
 Enhancements
 ~~~~~~~~~~~~
+* Add function :py:func:`pvlib.shading.shaded_fraction1d`, to calculate the
+  shade perpendicular to ``axis_azimuth``. The function is applicable to both
+  fixed-tilt and one-axis tracking systems.
+  (:issue:`1689`, :pull:`1725`, :pull:`1962`)
 
 
 Bug fixes
@@ -36,3 +40,4 @@ Requirements
 Contributors
 ~~~~~~~~~~~~
 * Cliff Hansen (:ghuser:`cwhanse`)
+* Mark Mikofski (:ghuser:`mikofski`)

From f01bd6f469062f3245835b0238062f2451c62fb2 Mon Sep 17 00:00:00 2001
From: echedey-ls <80125792+echedey-ls@users.noreply.github.com>
Date: Fri, 24 May 2024 00:17:17 +0200
Subject: [PATCH 110/185] Add test to fix coverage issue

---
 pvlib/tests/test_shading.py | 20 ++++++++++++++++++++
 1 file changed, 20 insertions(+)

diff --git a/pvlib/tests/test_shading.py b/pvlib/tests/test_shading.py
index 17ed27e7f9..b8bf8929ae 100644
--- a/pvlib/tests/test_shading.py
+++ b/pvlib/tests/test_shading.py
@@ -307,3 +307,23 @@ def test_shaded_fraction1d(sf1d_premises_and_expected):
     sf_vec = shading.shaded_fraction1d(**premises)
     assert_allclose(sf_vec, expected_sf_array, atol=1e-6)
     assert isinstance(sf_vec, pd.Series)
+
+
+def test_shaded_fraction1d_unprovided_shading_row_rotation():
+    """Tests shaded_fraction1d without providing shading_row_rotation"""
+    test_data = pd.DataFrame(
+        columns=[
+            "shaded_row_rotation", "surface_to_axis_offset", "collector_width",
+            "solar_zenith", "cross_axis_slope", "pitch", "solar_azimuth",
+            "axis_azimuth", "expected_sf",
+        ],
+        data=[
+            (30, 0, 5.7735, 60, 0, 5, 90, 180, 0),
+            (30, 0, 5.7735, 79, 0, 5, 90, 180, 0.5),
+            (30, 0, 5.7735, 90, 0, 5, 90, 180, 1),
+        ],
+    )  # fmt: skip
+    expected_sf = test_data["expected_sf"]
+    premises = test_data.drop(columns=["expected_sf"])
+    sf = shading.shaded_fraction1d(**premises)
+    assert_allclose(sf, expected_sf, atol=1e-2)

From 28f8bb4f451a07008d5bcca4790b125a02fc6a05 Mon Sep 17 00:00:00 2001
From: echedey-ls <80125792+echedey-ls@users.noreply.github.com>
Date: Sun, 7 Apr 2024 03:21:01 +0200
Subject: [PATCH 111/185] Initial work

---
 .../shading/plot_martinez_shade_loss.py       | 52 +++++++++++++
 .../effects_on_pv_system_output/shading.rst   |  2 +-
 pvlib/shading.py                              | 74 +++++++++++++++++++
 pvlib/tests/test_shading.py                   |  6 ++
 4 files changed, 133 insertions(+), 1 deletion(-)
 create mode 100644 docs/examples/shading/plot_martinez_shade_loss.py

diff --git a/docs/examples/shading/plot_martinez_shade_loss.py b/docs/examples/shading/plot_martinez_shade_loss.py
new file mode 100644
index 0000000000..f9a9782610
--- /dev/null
+++ b/docs/examples/shading/plot_martinez_shade_loss.py
@@ -0,0 +1,52 @@
+"""
+Calculating power loss from partial module shading
+==================================================
+
+Example of modeling cell-to-cell mismatch loss from partial module shading.
+"""
+
+# %%
+# Even though the PV cell is the primary power generation unit, PV modeling is
+# often done at the module level for simplicity because module-level parameters
+# are much more available and it significantly reduces the computational scope
+# of the simulation.  However, module-level simulations are too coarse to be
+# able to model effects like cell to cell mismatch or partial shading.  This
+# example calculates cell-level IV curves and combines them to reconstruct
+# the module-level IV curve.  It uses this approach to find the maximum power
+# under various shading and irradiance conditions.
+#
+# The primary functions used here are:
+#
+# - :py:meth:`pvlib.pvsystem.calcparams_desoto` to estimate the single
+#   diode equation parameters at some specified operating conditions.
+# - :py:meth:`pvlib.singlediode.bishop88` to calculate the full cell IV curve,
+#   including the reverse bias region.
+#
+# .. note::
+#
+#     This example requires the reverse bias functionality added in pvlib 0.7.2
+#
+# .. warning::
+#
+#     Modeling partial module shading is complicated and depends significantly
+#     on the module's electrical topology.  This example makes some simplifying
+#     assumptions that are not generally applicable.  For instance, it assumes
+#     that shading only applies to beam irradiance (*i.e.* all cells receive
+#     the same amount of diffuse irradiance) and cell temperature is uniform
+#     and not affected by cell-level irradiance variation.
+
+from pvlib import pvsystem, singlediode
+import pandas as pd
+import numpy as np
+from scipy.interpolate import interp1d
+import matplotlib.pyplot as plt
+
+from scipy.constants import e as qe, k as kB
+
+
+# %%
+# Simulating a cell IV curve
+# --------------------------
+#
+# First, calculate IV curves for individual cells.  The process is as follows:
+#
diff --git a/docs/sphinx/source/reference/effects_on_pv_system_output/shading.rst b/docs/sphinx/source/reference/effects_on_pv_system_output/shading.rst
index 57cfe0b806..aea0721571 100644
--- a/docs/sphinx/source/reference/effects_on_pv_system_output/shading.rst
+++ b/docs/sphinx/source/reference/effects_on_pv_system_output/shading.rst
@@ -12,4 +12,4 @@ Shading
    shading.sky_diffuse_passias
    shading.projected_solar_zenith_angle
    shading.shaded_fraction1d
-   
+   shading.martinez_shade_factor
diff --git a/pvlib/shading.py b/pvlib/shading.py
index cbbf80a8f6..543e2fc1fb 100644
--- a/pvlib/shading.py
+++ b/pvlib/shading.py
@@ -553,3 +553,77 @@ def shaded_fraction1d(
     )
 
     return np.clip(t_asterisk, 0, 1)
+
+
+def martinez_shade_factor(shaded_fraction, N_shaded_blocks, N_total_blocks):
+    r"""
+    A shading correction factor for the power yield of non-monolithic Silicon
+    modules and arrays with an arbitrary number of bypass diodes.
+    shaded_fraction : numeric
+        Surface shaded fraction. Unitless.
+    shaded_blocks : numeric
+        Number of blocks affected by the shadow. Unitless integer.
+    total_blocks : numeric
+        Number of total blocks. Unitless integer.
+
+    Returns
+    -------
+    shading_correction_factor : numeric
+        Multiply unshaded power by this factor.
+
+    Notes
+    -----
+    The implemented equation is (6) from [1]_:
+
+    .. math::
+
+        (1 - F_{ES}) = (1 - F_{GS}) (1 - \frac{N_{SB}}{N_{TB} + 1})
+
+    Where :math:`(1 - F_{ES})` is the correction factor to be multiplied by
+    the unshaded irradiance, :math:`F_{GS}` is the shaded fraction,
+    :math:`N_{SB}` is the number of shaded blocks and :math:`N_{TB}` is the
+    number of total blocks.
+
+    Blocks terminology
+    ^^^^^^^^^^^^^^^^^^
+    [1]_ defines a *block* as a group of solar cells protected by a bypass
+    diode. Also, a *block* is shaded when at least one of its cells is shaded.
+
+    How many blocks and their layout depend on the module(s) used. Many
+    manufacturers don't specify this information explicitly. However, we can
+    infer these values from:
+     - the number of bypass diodes
+     - where and how many junction boxes are present on the back of the module
+     - whether or not the module is comprised of *half-cut cells*
+    The latter two are heavily correlated.
+
+    Examples
+    --------
+    Minimal example. For a complete example, see
+    :ref:`this example <sphx_glr_gallery_plot_martinez_shade_loss.py>`
+    >>> import numpy as np
+    >>> from pvlib import shading
+    >>> total_blocks = 3  # blocks along the vertical of the module
+    >>> Pwr_out_unshaded = 100  # kW
+    >>> shaded_fraction = shading.shaded_fraction1d(
+            TODO copy from linear loss PR
+        )
+    >>> shaded_blocks = np.ceil(total_blocks*shaded_fraction)
+    >>> loss_correction = shading.martinez_shade_factor()
+    >>> Pwr_out_shaded = Pwr_out_unshaded * loss_correction
+
+    See Also
+    --------
+    pvlib.shading.linear_shade_loss for monolithic thin film modules
+
+    References
+    ----------
+    .. [1] F. Martínez-Moreno, J. Muñoz, and E. Lorenzo, 'Experimental model
+        to estimate shading losses on PV arrays', Solar Energy Materials and
+        Solar Cells, vol. 94, no. 12, pp. 2298-2303, Dec. 2010,
+        :doi:`10.1016/j.solmat.2010.07.029`.
+    """  # Contributed by Echedey Luis, 2024
+    return (  # Eq. (6) of [1]
+        (1 - shaded_fraction)
+        * (1 - N_shaded_blocks / (1 + N_total_blocks))
+    )
diff --git a/pvlib/tests/test_shading.py b/pvlib/tests/test_shading.py
index b8bf8929ae..04208d4cab 100644
--- a/pvlib/tests/test_shading.py
+++ b/pvlib/tests/test_shading.py
@@ -327,3 +327,9 @@ def test_shaded_fraction1d_unprovided_shading_row_rotation():
     premises = test_data.drop(columns=["expected_sf"])
     sf = shading.shaded_fraction1d(**premises)
     assert_allclose(sf, expected_sf, atol=1e-2)
+
+
+def test_martinez_shade_factor():
+    """Tests pvlib.shading.martinez_shade_factor"""
+    # TODO
+    pass

From 6d1755e4665671949cb4c17b573b14d9079097ad Mon Sep 17 00:00:00 2001
From: echedey-ls <80125792+echedey-ls@users.noreply.github.com>
Date: Mon, 8 Apr 2024 00:19:46 +0200
Subject: [PATCH 112/185] Can't test with the paper data, wtf

---
 pvlib/tests/test_shading.py | 40 ++++++++++++++++++++++++++++++++++---
 1 file changed, 37 insertions(+), 3 deletions(-)

diff --git a/pvlib/tests/test_shading.py b/pvlib/tests/test_shading.py
index 04208d4cab..ea22a3d5cb 100644
--- a/pvlib/tests/test_shading.py
+++ b/pvlib/tests/test_shading.py
@@ -1,6 +1,7 @@
 import numpy as np
 import pandas as pd
 
+from numpy.testing import assert_allclose
 from pandas.testing import assert_series_equal
 from numpy.testing import assert_allclose, assert_approx_equal
 import pytest
@@ -329,7 +330,40 @@ def test_shaded_fraction1d_unprovided_shading_row_rotation():
     assert_allclose(sf, expected_sf, atol=1e-2)
 
 
-def test_martinez_shade_factor():
+def martinez_shade_factor_Table2():
+    """
+    Data provided in Table 2, [1] of martinez_shade_factor
+    Returns tuple with (input: pandas.DataFrame, output: pandas.Series)
+    Output is POWER LOSS, not POWER CORRECTION, so model result must be
+    subtracted from 1
+    """
+    test_data = pd.DataFrame(
+        columns=["F_GS-H", "F_GS-V", "N_shaded_blocks", "power_reduction"],
+        data=[
+            [1.00, 0.09, 24, 0.88],
+            [1.00, 0.18, 24, 0.89],
+            [1.00, 0.36, 24, 0.90],
+            [0.04, 0.64,  1, 0.08],
+            [0.17, 0.45,  3, 0.22],
+            [0.29, 0.27,  5, 0.33],
+            [0.50, 0.09,  8, 0.46],
+            [0.13, 1.00,  2, 0.21],
+            [0.25, 1.00,  4, 0.40],
+            [0.38, 1.00,  6, 0.56],
+            [0.50, 1.00,  8, 0.54],
+            [0.58, 0.82, 10, 0.74],
+            [0.75, 0.73, 12, 0.81],
+            [0.92, 0.64, 15, 0.89],
+        ]  # fmt: skip
+    )
+    test_data["N_total_blocks"] = 24  # total blocks is 24 for all cases
+    test_data["shaded_fraction"] = test_data["F_GS-H"] * test_data["F_GS-V"]
+    test_data.drop(columns=["F_GS-H", "F_GS-V"], inplace=True)
+    return (test_data.drop(columns="power_reduction"), test_data["power_reduction"])
+
+
+def test_martinez_shade_factor(martinez_shade_factor_Table2):
     """Tests pvlib.shading.martinez_shade_factor"""
-    # TODO
-    pass
+    premises, power_reduction_expected = martinez_shade_factor_Table2
+    power_loss_factor = 1 - shading.martinez_shade_factor(**premises)
+    assert_allclose(power_loss_factor, power_reduction_expected)

From 60030ca854592f36542027520ed215129b260077 Mon Sep 17 00:00:00 2001
From: echedey-ls <80125792+echedey-ls@users.noreply.github.com>
Date: Sun, 14 Apr 2024 00:12:38 +0200
Subject: [PATCH 113/185] Little things

---
 .../shading/plot_martinez_shade_loss.py       | 61 ++++++++-----------
 pvlib/shading.py                              | 33 +++++++---
 2 files changed, 50 insertions(+), 44 deletions(-)

diff --git a/docs/examples/shading/plot_martinez_shade_loss.py b/docs/examples/shading/plot_martinez_shade_loss.py
index f9a9782610..6483628a72 100644
--- a/docs/examples/shading/plot_martinez_shade_loss.py
+++ b/docs/examples/shading/plot_martinez_shade_loss.py
@@ -1,52 +1,39 @@
 """
-Calculating power loss from partial module shading
-==================================================
+Modelling power loss due to module shading in non-monolithic Si arrays
+======================================================================
 
-Example of modeling cell-to-cell mismatch loss from partial module shading.
+This example demonstrates how to model power loss due to row-to-row shading in
+a PV array comprised of non-monolithic silicon cells.
 """
 
 # %%
-# Even though the PV cell is the primary power generation unit, PV modeling is
-# often done at the module level for simplicity because module-level parameters
-# are much more available and it significantly reduces the computational scope
-# of the simulation.  However, module-level simulations are too coarse to be
-# able to model effects like cell to cell mismatch or partial shading.  This
-# example calculates cell-level IV curves and combines them to reconstruct
-# the module-level IV curve.  It uses this approach to find the maximum power
-# under various shading and irradiance conditions.
-#
-# The primary functions used here are:
-#
-# - :py:meth:`pvlib.pvsystem.calcparams_desoto` to estimate the single
-#   diode equation parameters at some specified operating conditions.
-# - :py:meth:`pvlib.singlediode.bishop88` to calculate the full cell IV curve,
-#   including the reverse bias region.
-#
-# .. note::
-#
-#     This example requires the reverse bias functionality added in pvlib 0.7.2
-#
-# .. warning::
-#
-#     Modeling partial module shading is complicated and depends significantly
-#     on the module's electrical topology.  This example makes some simplifying
-#     assumptions that are not generally applicable.  For instance, it assumes
-#     that shading only applies to beam irradiance (*i.e.* all cells receive
-#     the same amount of diffuse irradiance) and cell temperature is uniform
-#     and not affected by cell-level irradiance variation.
+# The example is based on the work of Martinez et al. [1]_.
+# The model is implemented in :py:func:`pvlib.shading.martinez_shade_loss`.
+# This model corrects the beam and circumsolar incident irradiance
+# based on the number of shaded *blocks*. A *block* is defined as a
+# group of cells that are protected by a bypass diode.
+# More information on the *blocks* can be found in the original paper [1]_ and
+# in the function documentation.
+#
+# The following key functions are used in this example:
+# 1. :py:func:`pvlib.shading.martinez_shade_loss` to calculate the adjustment
+# 2. :py:func:`pvlib.shading.shading_factor1d` to calculate the fraction of
+#    shaded surface and the number of shaded *blocks*, due to row-to-row
+#    shading
+# 
+# .. versionadded:: 0.10.5
+# .. sectionauthor:: Echedey Luis <echelual@gmail.com>
 
-from pvlib import pvsystem, singlediode
+from pvlib import shading
 import pandas as pd
 import numpy as np
 from scipy.interpolate import interp1d
 import matplotlib.pyplot as plt
 
-from scipy.constants import e as qe, k as kB
-
+# TODO: REBASE FROM SHADING_FACTOR1D
 
 # %%
-# Simulating a cell IV curve
+# yolo
 # --------------------------
 #
-# First, calculate IV curves for individual cells.  The process is as follows:
-#
+
diff --git a/pvlib/shading.py b/pvlib/shading.py
index 543e2fc1fb..6b08aa4d01 100644
--- a/pvlib/shading.py
+++ b/pvlib/shading.py
@@ -557,8 +557,14 @@ def shaded_fraction1d(
 
 def martinez_shade_factor(shaded_fraction, N_shaded_blocks, N_total_blocks):
     r"""
-    A shading correction factor for the power yield of non-monolithic Silicon
+    A shading correction factor for the direct and circumsolar incident
+    irradiance of non-monolithic Silicon
     modules and arrays with an arbitrary number of bypass diodes.
+
+    .. versionadded:: 0.10.5
+
+    Parameters
+    ----------
     shaded_fraction : numeric
         Surface shaded fraction. Unitless.
     shaded_blocks : numeric
@@ -569,7 +575,7 @@ def martinez_shade_factor(shaded_fraction, N_shaded_blocks, N_total_blocks):
     Returns
     -------
     shading_correction_factor : numeric
-        Multiply unshaded power by this factor.
+        Multiply direct and circumsolar irradiance by this factor.
 
     Notes
     -----
@@ -580,9 +586,9 @@ def martinez_shade_factor(shaded_fraction, N_shaded_blocks, N_total_blocks):
         (1 - F_{ES}) = (1 - F_{GS}) (1 - \frac{N_{SB}}{N_{TB} + 1})
 
     Where :math:`(1 - F_{ES})` is the correction factor to be multiplied by
-    the unshaded irradiance, :math:`F_{GS}` is the shaded fraction,
-    :math:`N_{SB}` is the number of shaded blocks and :math:`N_{TB}` is the
-    number of total blocks.
+    the direct and circumsolar irradiance, :math:`F_{GS}` is the shaded
+    fraction of the collector, :math:`N_{SB}` is the number of shaded blocks
+    and :math:`N_{TB}` is the number of total blocks.
 
     Blocks terminology
     ^^^^^^^^^^^^^^^^^^
@@ -597,6 +603,16 @@ def martinez_shade_factor(shaded_fraction, N_shaded_blocks, N_total_blocks):
      - whether or not the module is comprised of *half-cut cells*
     The latter two are heavily correlated.
 
+    For example:
+     - A module with 3 bypass diodes and 3 junction boxes is likely to have
+       3 blocks.
+     - A module with 1 bypass diode and 1 junction box is likely to have 1
+       block.
+     - A module with 3 bypass diodes and 1 junction box is likely to have 3
+       blocks.
+     - A module with 1 bypass diode and 3 junction boxes is likely to have 1
+       block.
+
     Examples
     --------
     Minimal example. For a complete example, see
@@ -606,7 +622,9 @@ def martinez_shade_factor(shaded_fraction, N_shaded_blocks, N_total_blocks):
     >>> total_blocks = 3  # blocks along the vertical of the module
     >>> Pwr_out_unshaded = 100  # kW
     >>> shaded_fraction = shading.shaded_fraction1d(
-            TODO copy from linear loss PR
+            80, 180, 90, 25,
+             collector_width=0.5, row_pitch=1, surface_to_axis_offset=0,
+             cross_axis_slope=5.711, shading_tracker_tilt=50)
         )
     >>> shaded_blocks = np.ceil(total_blocks*shaded_fraction)
     >>> loss_correction = shading.martinez_shade_factor()
@@ -614,7 +632,8 @@ def martinez_shade_factor(shaded_fraction, N_shaded_blocks, N_total_blocks):
 
     See Also
     --------
-    pvlib.shading.linear_shade_loss for monolithic thin film modules
+    shaded_fraction1d : to calculate 1-dimensional shaded fraction
+    linear_shade_loss
 
     References
     ----------

From 6dcb5173ddec820afe23c0640349741b47c3e2f8 Mon Sep 17 00:00:00 2001
From: echedey-ls <80125792+echedey-ls@users.noreply.github.com>
Date: Sun, 14 Apr 2024 01:50:00 +0200
Subject: [PATCH 114/185] Update plot_martinez_shade_loss.py

---
 docs/examples/shading/plot_martinez_shade_loss.py | 5 ++---
 1 file changed, 2 insertions(+), 3 deletions(-)

diff --git a/docs/examples/shading/plot_martinez_shade_loss.py b/docs/examples/shading/plot_martinez_shade_loss.py
index 6483628a72..3ff68c5716 100644
--- a/docs/examples/shading/plot_martinez_shade_loss.py
+++ b/docs/examples/shading/plot_martinez_shade_loss.py
@@ -20,9 +20,8 @@
 # 2. :py:func:`pvlib.shading.shading_factor1d` to calculate the fraction of
 #    shaded surface and the number of shaded *blocks*, due to row-to-row
 #    shading
-# 
-# .. versionadded:: 0.10.5
-# .. sectionauthor:: Echedey Luis <echelual@gmail.com>
+#
+# .. sectionauthor:: Echedey Luis <echelual (at) gmail.com>
 
 from pvlib import shading
 import pandas as pd

From 55b89bc321e4c42adad8324915298a9f9628f1de Mon Sep 17 00:00:00 2001
From: echedey-ls <80125792+echedey-ls@users.noreply.github.com>
Date: Wed, 17 Apr 2024 23:56:51 +0200
Subject: [PATCH 115/185] More improvements

---
 .../shading/plot_martinez_shade_loss.py       | 117 ++++++++++++++++--
 pvlib/shading.py                              |   3 +-
 2 files changed, 109 insertions(+), 11 deletions(-)

diff --git a/docs/examples/shading/plot_martinez_shade_loss.py b/docs/examples/shading/plot_martinez_shade_loss.py
index 3ff68c5716..fbd7870b34 100644
--- a/docs/examples/shading/plot_martinez_shade_loss.py
+++ b/docs/examples/shading/plot_martinez_shade_loss.py
@@ -7,32 +7,129 @@
 """
 
 # %%
-# The example is based on the work of Martinez et al. [1]_.
+# This example illustrates how to use the work of Martinez et al. [1]_.
 # The model is implemented in :py:func:`pvlib.shading.martinez_shade_loss`.
 # This model corrects the beam and circumsolar incident irradiance
 # based on the number of shaded *blocks*. A *block* is defined as a
 # group of cells that are protected by a bypass diode.
 # More information on the *blocks* can be found in the original paper [1]_ and
-# in the function documentation.
+# in :py:func:`pvlib.shading.martinez_shade_loss` documentation.
 #
 # The following key functions are used in this example:
 # 1. :py:func:`pvlib.shading.martinez_shade_loss` to calculate the adjustment
+#    factor for the direct irradiance component.
 # 2. :py:func:`pvlib.shading.shading_factor1d` to calculate the fraction of
-#    shaded surface and the number of shaded *blocks*, due to row-to-row
-#    shading
+#    shaded surface and consequently the number of shaded *blocks* due to
+#    row-to-row shading.
 #
 # .. sectionauthor:: Echedey Luis <echelual (at) gmail.com>
+#
+# References
+# ----------
+# .. [1] F. Martínez-Moreno, J. Muñoz, and E. Lorenzo, 'Experimental model
+#    to estimate shading losses on PV arrays', Solar Energy Materials and
+#    Solar Cells, vol. 94, no. 12, pp. 2298-2303, Dec. 2010,
+#    :doi:`10.1016/j.solmat.2010.07.029`.
+#
+# Problem description
+# -------------------
+# Let's consider a PV system with the following characteristics:
+# - Two north-south single-axis tracker with 6 modules each one.
+# - The rows have the same true-tracking tilt angles.
+# - Terrain slope is 7 degrees downward to the east.
+# - Row's axis are horizontal.
+# - The modules are comprised of silicon cells. We will compare these cases:
+#    - modules with one bypass diode
+#    - modules with three bypass diodes
+#    - half-cut cell modules with three bypass diodes on portrait and landscape
+#
+# Setting up the system
+# ----------------------
+# Let's start by defining the location and the time range for the analysis.
 
-from pvlib import shading
+import pvlib
 import pandas as pd
 import numpy as np
-from scipy.interpolate import interp1d
 import matplotlib.pyplot as plt
 
-# TODO: REBASE FROM SHADING_FACTOR1D
+from pathlib import Path
+
+pitch = 4  # meters
+width = 1.5  # meters
+gcr = width / pitch
+N_modules_per_row = 6
+axis_azimuth = 180  # N-S axis
+axis_tilt = 0  # flat because the axis is perpendicular to the slope
+cross_axis_tilt = -7  # 7 degrees downward to the east
+
+# Get TMY data & create location
+datapath = Path(pvlib.__path__[0], "data", "tmy_45.000_8.000_2005_2016.csv")
+pvgis_data, _, metadata, _ = pvlib.iotools.read_pvgis_tmy(
+    datapath, map_variables=True
+)
+locus = pvlib.location.Location(
+    metadata["latitude"], metadata["longitude"], altitude=metadata["elevation"]
+)
+
+# Coerce a year: function above returns typical months of different years
+pvgis_data.index = [ts.replace(year=2024) for ts in pvgis_data.index]
+# Select day to show
+weather_data = pvgis_data["2024-07-11"]
 
 # %%
-# yolo
-# --------------------------
-#
+# True-tracking algorithm
+# -----------------------
+# Since this model is about row-to-row shading, we will use the true-tracking
+# algorithm to calculate the trackers rotation. Back-tracking avoids shading
+# between rows, which is not what we want to analyze here.
 
+# Calculate solar position to get single-axis tracker rotation and irradiance
+solar_pos = locus.get_solarposition(weather_data.index)
+apparent_zenith, apparent_azimuth = (
+    solar_pos["apparent_zenith"],
+    solar_pos["azimuth"],
+)  # unpack references to data for better readability
+
+tracking_result = pvlib.tracking.singleaxis(
+    apparent_zenith=apparent_zenith,
+    apparent_azimuth=apparent_azimuth,
+    axis_tilt=axis_tilt,
+    axis_azimuth=axis_azimuth,
+    max_angle=(-90 + cross_axis_tilt, 90 + cross_axis_tilt),  # (min, max)
+    backtrack=False,
+    gcr=gcr,
+    cross_axis_tilt=cross_axis_tilt,
+)
+
+tracker_theta, aoi, surface_tilt, surface_azimuth = (
+    tracking_result["tracker_theta"],
+    tracking_result["aoi"],
+    tracking_result["surface_tilt"],
+    tracking_result["surface_azimuth"],
+)  # unpack references into explicit variables for better readability
+
+extra_rad = pvlib.irradiance.get_extra_radiation(weather_data.index)
+
+poa_sky_diffuse = pvlib.irradiance.haydavies(
+    surface_tilt,
+    surface_azimuth,
+    weather_data["dhi"],
+    weather_data["dni"],
+    extra_rad,
+    apparent_zenith,
+    apparent_azimuth,
+)
+
+poa_ground_diffuse = pvlib.irradiance.get_ground_diffuse(
+    surface_tilt, weather_data["ghi"], surface_type="grass"
+)
+
+# %%
+# Shaded fraction calculation
+# ---------------------------
+# The next step is to calculate the fraction of shaded surface. This is done
+# using the :py:func:`pvlib.shading.shading_factor1d` function. Using this
+# function is straightforward with the amount of information we already have.
+shaded_fraction = pvlib.shading.shading_factor1d(
+    surface_tilt, surface_azimuth, apparent_zenith, apparent_azimuth
+)
diff --git a/pvlib/shading.py b/pvlib/shading.py
index 6b08aa4d01..ac1ddc7d98 100644
--- a/pvlib/shading.py
+++ b/pvlib/shading.py
@@ -569,6 +569,7 @@ def martinez_shade_factor(shaded_fraction, N_shaded_blocks, N_total_blocks):
         Surface shaded fraction. Unitless.
     shaded_blocks : numeric
         Number of blocks affected by the shadow. Unitless integer.
+        If a floating point number is provided, it will be rounded up.
     total_blocks : numeric
         Number of total blocks. Unitless integer.
 
@@ -644,5 +645,5 @@ def martinez_shade_factor(shaded_fraction, N_shaded_blocks, N_total_blocks):
     """  # Contributed by Echedey Luis, 2024
     return (  # Eq. (6) of [1]
         (1 - shaded_fraction)
-        * (1 - N_shaded_blocks / (1 + N_total_blocks))
+        * (1 - np.ceil(N_shaded_blocks) / (1 + N_total_blocks))
     )

From fd4eded43834b0f34382db775d1335a984d317af Mon Sep 17 00:00:00 2001
From: echedey-ls <80125792+echedey-ls@users.noreply.github.com>
Date: Thu, 18 Apr 2024 00:01:39 +0200
Subject: [PATCH 116/185] Be4 rebase

---
 docs/examples/shading/plot_martinez_shade_loss.py | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/docs/examples/shading/plot_martinez_shade_loss.py b/docs/examples/shading/plot_martinez_shade_loss.py
index fbd7870b34..ffb006994b 100644
--- a/docs/examples/shading/plot_martinez_shade_loss.py
+++ b/docs/examples/shading/plot_martinez_shade_loss.py
@@ -128,8 +128,9 @@
 # Shaded fraction calculation
 # ---------------------------
 # The next step is to calculate the fraction of shaded surface. This is done
-# using the :py:func:`pvlib.shading.shading_factor1d` function. Using this
-# function is straightforward with the amount of information we already have.
+# using :py:func:`pvlib.shading.shading_factor1d`. Using this function is
+# straightforward with the amount of information we already have.
+
 shaded_fraction = pvlib.shading.shading_factor1d(
     surface_tilt, surface_azimuth, apparent_zenith, apparent_azimuth
 )

From b640c2481d95b0ef3b4432ab947b69a2cf753c1b Mon Sep 17 00:00:00 2001
From: echedey-ls <80125792+echedey-ls@users.noreply.github.com>
Date: Thu, 18 Apr 2024 00:12:37 +0200
Subject: [PATCH 117/185] Fix fixture

---
 pvlib/tests/test_shading.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/pvlib/tests/test_shading.py b/pvlib/tests/test_shading.py
index ea22a3d5cb..9beb90ca46 100644
--- a/pvlib/tests/test_shading.py
+++ b/pvlib/tests/test_shading.py
@@ -330,6 +330,7 @@ def test_shaded_fraction1d_unprovided_shading_row_rotation():
     assert_allclose(sf, expected_sf, atol=1e-2)
 
 
+@pytest.fixture
 def martinez_shade_factor_Table2():
     """
     Data provided in Table 2, [1] of martinez_shade_factor

From ba15ab18d9359f2eb856ff077446d1ab79601e61 Mon Sep 17 00:00:00 2001
From: echedey-ls <80125792+echedey-ls@users.noreply.github.com>
Date: Sun, 7 Apr 2024 03:21:01 +0200
Subject: [PATCH 118/185] Initial work

---
 docs/examples/shading/plot_martinez_shade_loss.py | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/docs/examples/shading/plot_martinez_shade_loss.py b/docs/examples/shading/plot_martinez_shade_loss.py
index ffb006994b..3b95a84126 100644
--- a/docs/examples/shading/plot_martinez_shade_loss.py
+++ b/docs/examples/shading/plot_martinez_shade_loss.py
@@ -18,7 +18,7 @@
 # The following key functions are used in this example:
 # 1. :py:func:`pvlib.shading.martinez_shade_loss` to calculate the adjustment
 #    factor for the direct irradiance component.
-# 2. :py:func:`pvlib.shading.shading_factor1d` to calculate the fraction of
+# 2. :py:func:`pvlib.shading.shaded_fraction1d` to calculate the fraction of
 #    shaded surface and consequently the number of shaded *blocks* due to
 #    row-to-row shading.
 #
@@ -128,9 +128,9 @@
 # Shaded fraction calculation
 # ---------------------------
 # The next step is to calculate the fraction of shaded surface. This is done
-# using :py:func:`pvlib.shading.shading_factor1d`. Using this function is
+# using :py:func:`pvlib.shading.shaded_fraction1d`. Using this function is
 # straightforward with the amount of information we already have.
 
-shaded_fraction = pvlib.shading.shading_factor1d(
+shaded_fraction = pvlib.shading.shaded_fraction1d(
     surface_tilt, surface_azimuth, apparent_zenith, apparent_azimuth
 )

From beee0f179e887da3b99419fc6f0c1e98d4cf1cd2 Mon Sep 17 00:00:00 2001
From: echedey-ls <80125792+echedey-ls@users.noreply.github.com>
Date: Thu, 18 Apr 2024 15:04:54 +0200
Subject: [PATCH 119/185] Fix tests

---
 pvlib/tests/test_shading.py | 70 +++++++++++++++++++++++--------------
 1 file changed, 44 insertions(+), 26 deletions(-)

diff --git a/pvlib/tests/test_shading.py b/pvlib/tests/test_shading.py
index 9beb90ca46..48e37312b8 100644
--- a/pvlib/tests/test_shading.py
+++ b/pvlib/tests/test_shading.py
@@ -333,38 +333,56 @@ def test_shaded_fraction1d_unprovided_shading_row_rotation():
 @pytest.fixture
 def martinez_shade_factor_Table2():
     """
-    Data provided in Table 2, [1] of martinez_shade_factor
+    Original data used in [1] (see shading.martinez_shade_factor) to validate
+    the model. Some of the data is provided from Table 2.
     Returns tuple with (input: pandas.DataFrame, output: pandas.Series)
-    Output is POWER LOSS, not POWER CORRECTION, so model result must be
-    subtracted from 1
+    Output is IRRADIANCE LOSS, not IRRADIANCE CORRECTION, so model result must
+    be subtracted from 1
     """
     test_data = pd.DataFrame(
-        columns=["F_GS-H", "F_GS-V", "N_shaded_blocks", "power_reduction"],
+        columns=[
+            "F_GS-H",
+            "F_GS-V",
+            "N_shaded_blocks",
+            "direct",
+            "diffuse",
+            "irrad_correction",
+        ],
         data=[
-            [1.00, 0.09, 24, 0.88],
-            [1.00, 0.18, 24, 0.89],
-            [1.00, 0.36, 24, 0.90],
-            [0.04, 0.64,  1, 0.08],
-            [0.17, 0.45,  3, 0.22],
-            [0.29, 0.27,  5, 0.33],
-            [0.50, 0.09,  8, 0.46],
-            [0.13, 1.00,  2, 0.21],
-            [0.25, 1.00,  4, 0.40],
-            [0.38, 1.00,  6, 0.56],
-            [0.50, 1.00,  8, 0.54],
-            [0.58, 0.82, 10, 0.74],
-            [0.75, 0.73, 12, 0.81],
-            [0.92, 0.64, 15, 0.89],
-        ]  # fmt: skip
-    )
-    test_data["N_total_blocks"] = 24  # total blocks is 24 for all cases
+            # F-H, F-V, Nsb, direct, diffuse, effective_irrad_correction
+            [1.00, 0.09, 16, 846.59, 59.42, 0.88],
+            [1.00, 0.18, 16, 841.85, 59.69, 0.89],
+            [1.00, 0.36, 16, 843.38, 59.22, 0.90],
+            [0.04, 0.64,  1, 851.90, 59.40, 0.08],
+            [0.17, 0.45,  3, 862.86, 58.40, 0.22],
+            [0.29, 0.27,  5, 864.14, 58.11, 0.33],
+            [0.50, 0.09,  8, 863.23, 58.31, 0.46],
+            [0.13, 1.00,  2, 870.14, 58.02, 0.21],
+            [0.25, 1.00,  4, 876.57, 57.98, 0.40],
+            [0.38, 1.00,  6, 866.86, 58.89, 0.56],
+            [0.50, 1.00,  8, 874.58, 58.44, 0.69],
+            [0.58, 0.82, 10, 876.80, 58.16, 0.74],
+            [0.75, 0.73, 12, 866.89, 58.73, 0.81],
+            [0.92, 0.64, 15, 861.48, 59.66, 0.89],
+        ]
+    )  # fmt: skip
+    test_data["N_total_blocks"] = 16  # total blocks is 16 for all cases
     test_data["shaded_fraction"] = test_data["F_GS-H"] * test_data["F_GS-V"]
-    test_data.drop(columns=["F_GS-H", "F_GS-V"], inplace=True)
-    return (test_data.drop(columns="power_reduction"), test_data["power_reduction"])
+    test_data = test_data.drop(columns=["F_GS-H", "F_GS-V"])
+    return (
+        test_data.drop(columns="irrad_correction"),
+        test_data["irrad_correction"],
+    )
 
 
 def test_martinez_shade_factor(martinez_shade_factor_Table2):
     """Tests pvlib.shading.martinez_shade_factor"""
-    premises, power_reduction_expected = martinez_shade_factor_Table2
-    power_loss_factor = 1 - shading.martinez_shade_factor(**premises)
-    assert_allclose(power_loss_factor, power_reduction_expected)
+    test_data, irrad_reduction_expected = martinez_shade_factor_Table2
+    correction_factor = shading.martinez_shade_factor(
+        **test_data.drop(columns=["direct", "diffuse"])
+    )
+    irrad_correction = 1 - (
+        (test_data["direct"] * correction_factor + test_data["diffuse"])
+        / (test_data["direct"] + test_data["diffuse"])
+    )
+    assert_allclose(irrad_correction, irrad_reduction_expected, atol=1e-2)

From 56a4f463cdb2f87934fd48f4b9014507aa1817a0 Mon Sep 17 00:00:00 2001
From: echedey-ls <80125792+echedey-ls@users.noreply.github.com>
Date: Thu, 18 Apr 2024 22:58:57 +0200
Subject: [PATCH 120/185] docstring

---
 pvlib/shading.py | 16 ++++++++--------
 1 file changed, 8 insertions(+), 8 deletions(-)

diff --git a/pvlib/shading.py b/pvlib/shading.py
index ac1ddc7d98..5d22b7d276 100644
--- a/pvlib/shading.py
+++ b/pvlib/shading.py
@@ -605,14 +605,13 @@ def martinez_shade_factor(shaded_fraction, N_shaded_blocks, N_total_blocks):
     The latter two are heavily correlated.
 
     For example:
-     - A module with 3 bypass diodes and 3 junction boxes is likely to have
-       3 blocks.
-     - A module with 1 bypass diode and 1 junction box is likely to have 1
-       block.
+     - A module with 1 bypass diode is likely to have 1 block.
      - A module with 3 bypass diodes and 1 junction box is likely to have 3
        blocks.
-     - A module with 1 bypass diode and 3 junction boxes is likely to have 1
-       block.
+     - A half-cut module with 3 junction boxes (split junction boxes) is likely
+       to have 3x2 blocks. The number of blocks along the longest side of the
+       module is 2 and along the shortest side is 3.
+     - A module without bypass diodes doesn't have blocks.
 
     Examples
     --------
@@ -621,7 +620,8 @@ def martinez_shade_factor(shaded_fraction, N_shaded_blocks, N_total_blocks):
     >>> import numpy as np
     >>> from pvlib import shading
     >>> total_blocks = 3  # blocks along the vertical of the module
-    >>> Pwr_out_unshaded = 100  # kW
+    >>> POA_direct = 600  # W
+    >>> POA_diffuse = 80  # W
     >>> shaded_fraction = shading.shaded_fraction1d(
             80, 180, 90, 25,
              collector_width=0.5, row_pitch=1, surface_to_axis_offset=0,
@@ -629,7 +629,7 @@ def martinez_shade_factor(shaded_fraction, N_shaded_blocks, N_total_blocks):
         )
     >>> shaded_blocks = np.ceil(total_blocks*shaded_fraction)
     >>> loss_correction = shading.martinez_shade_factor()
-    >>> Pwr_out_shaded = Pwr_out_unshaded * loss_correction
+    >>> POA_total = POA_direct * loss_correction + POA_diffuse
 
     See Also
     --------

From 7a57310720ba39e8f4d24ef919e8952caf8542fb Mon Sep 17 00:00:00 2001
From: echedey-ls <80125792+echedey-ls@users.noreply.github.com>
Date: Thu, 18 Apr 2024 23:42:52 +0200
Subject: [PATCH 121/185] whatsnew :pencil:

---
 docs/sphinx/source/whatsnew/v0.10.5.rst | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

diff --git a/docs/sphinx/source/whatsnew/v0.10.5.rst b/docs/sphinx/source/whatsnew/v0.10.5.rst
index 00daed3a0f..467867eff5 100644
--- a/docs/sphinx/source/whatsnew/v0.10.5.rst
+++ b/docs/sphinx/source/whatsnew/v0.10.5.rst
@@ -3,6 +3,21 @@
 
 v0.10.5 (May 6, 2024)
 ---------------------
+v0.10.5 (Anticipated June 2024)
+-------------------------------
+
+
+Deprecations
+~~~~~~~~~~~~
+
+
+Enhancements
+~~~~~~~~~~~~
+* Added function :py:func:`pvlib.shading.shaded_fraction1d`, to calculate the
+  shade perpendicular to ``axis_azimuth``. (:issue:`1689`, :pull:`1725`, :pull:`1962`)
+* Added function :py:func:`pvlib.shading.martinez_shade_factor` to calculate
+  shading losses by taking into account the amount of bypass diodes of a module.
+  (:issue:``, :pull:``)
 
 
 Bug fixes

From adf6dcc7b3dff8077a109c34234fdcc5db9cdc5a Mon Sep 17 00:00:00 2001
From: echedey-ls <80125792+echedey-ls@users.noreply.github.com>
Date: Thu, 18 Apr 2024 23:43:14 +0200
Subject: [PATCH 122/185] Minor thingies

---
 docs/examples/shading/plot_martinez_shade_loss.py | 14 +++++++-------
 1 file changed, 7 insertions(+), 7 deletions(-)

diff --git a/docs/examples/shading/plot_martinez_shade_loss.py b/docs/examples/shading/plot_martinez_shade_loss.py
index 3b95a84126..214440478c 100644
--- a/docs/examples/shading/plot_martinez_shade_loss.py
+++ b/docs/examples/shading/plot_martinez_shade_loss.py
@@ -7,16 +7,15 @@
 """
 
 # %%
-# This example illustrates how to use the work of Martinez et al. [1]_.
-# The model is implemented in :py:func:`pvlib.shading.martinez_shade_loss`.
-# This model corrects the beam and circumsolar incident irradiance
+# This example illustrates how to use the proposed by Martinez et al. [1]_.
+# The model corrects the beam and circumsolar incident irradiance
 # based on the number of shaded *blocks*. A *block* is defined as a
 # group of cells that are protected by a bypass diode.
 # More information on the *blocks* can be found in the original paper [1]_ and
-# in :py:func:`pvlib.shading.martinez_shade_loss` documentation.
+# in :py:func:`pvlib.shading.martinez_shade_factor` documentation.
 #
 # The following key functions are used in this example:
-# 1. :py:func:`pvlib.shading.martinez_shade_loss` to calculate the adjustment
+# 1. :py:func:`pvlib.shading.martinez_shade_factor` to calculate the adjustment
 #    factor for the direct irradiance component.
 # 2. :py:func:`pvlib.shading.shaded_fraction1d` to calculate the fraction of
 #    shaded surface and consequently the number of shaded *blocks* due to
@@ -45,7 +44,8 @@
 #
 # Setting up the system
 # ----------------------
-# Let's start by defining the location and the time range for the analysis.
+# Let's start by defining the system characteristics, location and the time
+# range for the analysis.
 
 import pvlib
 import pandas as pd
@@ -71,7 +71,7 @@
     metadata["latitude"], metadata["longitude"], altitude=metadata["elevation"]
 )
 
-# Coerce a year: function above returns typical months of different years
+# Coerce a year: function above returns typical months from different years
 pvgis_data.index = [ts.replace(year=2024) for ts in pvgis_data.index]
 # Select day to show
 weather_data = pvgis_data["2024-07-11"]

From ec717a90322e0b03fff3fa04a4a46dfda48c22cc Mon Sep 17 00:00:00 2001
From: echedey-ls <80125792+echedey-ls@users.noreply.github.com>
Date: Fri, 19 Apr 2024 00:25:10 +0200
Subject: [PATCH 123/185] Add figure, improve docs :100:

---
 ...entralized_and_split_PV_junction_boxes.jpg | Bin 0 -> 89736 bytes
 pvlib/shading.py                              |  23 ++++++++++++------
 2 files changed, 16 insertions(+), 7 deletions(-)
 create mode 100644 docs/sphinx/source/_images/Centralized_and_split_PV_junction_boxes.jpg

diff --git a/docs/sphinx/source/_images/Centralized_and_split_PV_junction_boxes.jpg b/docs/sphinx/source/_images/Centralized_and_split_PV_junction_boxes.jpg
new file mode 100644
index 0000000000000000000000000000000000000000..306cc32fb06bb56845ad8101efe9241a644a0710
GIT binary patch
literal 89736
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

literal 0
HcmV?d00001

diff --git a/pvlib/shading.py b/pvlib/shading.py
index 5d22b7d276..b392f500f2 100644
--- a/pvlib/shading.py
+++ b/pvlib/shading.py
@@ -605,13 +605,22 @@ def martinez_shade_factor(shaded_fraction, N_shaded_blocks, N_total_blocks):
     The latter two are heavily correlated.
 
     For example:
-     - A module with 1 bypass diode is likely to have 1 block.
-     - A module with 3 bypass diodes and 1 junction box is likely to have 3
-       blocks.
-     - A half-cut module with 3 junction boxes (split junction boxes) is likely
-       to have 3x2 blocks. The number of blocks along the longest side of the
-       module is 2 and along the shortest side is 3.
-     - A module without bypass diodes doesn't have blocks.
+     1. A module with 1 bypass diode is likely to have 1 block.
+     2. A module with 3 bypass diodes and 1 junction box is likely to have 3
+        blocks.
+     3. A half-cut module with 3 junction boxes (split junction boxes) is
+        likely to have 3x2 blocks. The number of blocks along the longest
+        side of the module is 2 and along the shortest side is 3.
+     4. A module without bypass diodes doesn't constitute a block, but may be
+        part of one.
+
+     .. figure:: _images/Centralized_and_split_PV_junction_boxes.jpg
+        :alt: Centralized and split PV junction boxes.
+
+        Left image: Centralized junction box with 3 bypass diodes (2.).
+        Right image: 3 (split-) junction boxes on a half-cut cell module (3.).
+        Source: César Domínguez, CC BY-SA 4.0
+        <https://creativecommons.org/licenses/by-sa/4.0>, Wikimedia Commons.
 
     Examples
     --------

From a357c1182fa721e7bb7079ae7490656266cf5dc1 Mon Sep 17 00:00:00 2001
From: Echedey Luis <80125792+echedey-ls@users.noreply.github.com>
Date: Wed, 1 May 2024 18:26:51 +0200
Subject: [PATCH 124/185] Fix silently ignoring file path in
 `pvsystem.retrieve_sam` when `name` is provided (#2020)

* My approach to the issue

* Deprecate previous parameters

* No reason to over-engineer, right?

* Update v0.10.5.rst

* Update pvsystem.py

* Improve error handling

* Add ppl involved

* kevin's suggestions
---
 docs/sphinx/source/whatsnew/v0.10.5.rst | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/docs/sphinx/source/whatsnew/v0.10.5.rst b/docs/sphinx/source/whatsnew/v0.10.5.rst
index 467867eff5..34ea2bc3ee 100644
--- a/docs/sphinx/source/whatsnew/v0.10.5.rst
+++ b/docs/sphinx/source/whatsnew/v0.10.5.rst
@@ -31,6 +31,13 @@ Bug fixes
 * Fixed :py:func:`pvlib.pvsystem.retrieve_sam` silently ignoring the ``path`` parameter
   when ``name`` was provided. Now an exception is raised requesting to only provide one
   of the two parameters. (:issue:`2018`, :pull:`2020`)
+* Fixed :py:func:`pvlib.pvsystem.retrieve_sam` silently ignoring the `path` parameter
+  when `name` was provided. Now an exception is raised requesting to only provide one
+  of the two parameters. (:issue:`2018`, :pull:`2020`)
+
+
+Testing
+~~~~~~~
 
 
 Documentation
@@ -57,3 +64,5 @@ Contributors
 * Scott Meredith (:ghuser:`smmeredith`)
 * Alexander Morgan (:ghuser:`alexandermorgan`)
 * Kevin Anderson (:ghuser:`kandersolar`)
+* :ghuser:`apct69`
+* Mark Mikofski (:ghuser:`mikofski`)

From de46cc07e7dd81b7b3d24abe91ae41fd02e107cc Mon Sep 17 00:00:00 2001
From: Cliff Hansen <cwhanse@sandia.gov>
Date: Thu, 2 May 2024 14:35:28 -0600
Subject: [PATCH 125/185] Fix Ixx equation in pvsystem.sapm (#2019)

* fix Ixx equation, use Aimp

* Update docs/sphinx/source/whatsnew/v0.10.5.rst

* lint

* lint

* get the spacing right

* more spacing

---------

Co-authored-by: Kevin Anderson <kevin.anderso@gmail.com>
---
 docs/sphinx/source/whatsnew/v0.10.5.rst | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/sphinx/source/whatsnew/v0.10.5.rst b/docs/sphinx/source/whatsnew/v0.10.5.rst
index 34ea2bc3ee..8b77834064 100644
--- a/docs/sphinx/source/whatsnew/v0.10.5.rst
+++ b/docs/sphinx/source/whatsnew/v0.10.5.rst
@@ -31,6 +31,7 @@ Bug fixes
 * Fixed :py:func:`pvlib.pvsystem.retrieve_sam` silently ignoring the ``path`` parameter
   when ``name`` was provided. Now an exception is raised requesting to only provide one
   of the two parameters. (:issue:`2018`, :pull:`2020`)
+* Corrected equation for Ixx0 in :py:func:`pvlib.pvsystem.sapm` (:issue:`2016`, :pull:`2019`)
 * Fixed :py:func:`pvlib.pvsystem.retrieve_sam` silently ignoring the `path` parameter
   when `name` was provided. Now an exception is raised requesting to only provide one
   of the two parameters. (:issue:`2018`, :pull:`2020`)

From 1d5a9e6a3e738664e326e600ad7298cb63ea2d1a Mon Sep 17 00:00:00 2001
From: Kevin Anderson <kevin.anderso@gmail.com>
Date: Fri, 3 May 2024 16:44:00 -0400
Subject: [PATCH 126/185] Increase python requirement to >= 3.8 (#2029)

* require python >=3.8

* update CI configurations

* whatsnew

* remove pre-3.8 cruft

* fix h5py/numpy versioning issue for py3.8-min

* update gallery examples for newer pandas

* update asv config for python 3.8

* fix asv config syntax error

* one more asv config edit
---
 docs/sphinx/source/whatsnew/v0.10.5.rst | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/sphinx/source/whatsnew/v0.10.5.rst b/docs/sphinx/source/whatsnew/v0.10.5.rst
index 8b77834064..f974e6b6ac 100644
--- a/docs/sphinx/source/whatsnew/v0.10.5.rst
+++ b/docs/sphinx/source/whatsnew/v0.10.5.rst
@@ -51,6 +51,7 @@ Documentation
 Requirements
 ~~~~~~~~~~~~
 * Minimum version of Python increased from 3.7 to 3.8. (:issue:`1975`, :pull:`2029`)
+* Python 3.8 or higher. (:issue:`1975`, :pull:`2029`)
 * Minimum version of scipy advanced from 1.5.0 to 1.6.0. (:pull:`2027`)
 
 

From cdb50ba74b42d8437c4072bc8e5e3859dbde2c75 Mon Sep 17 00:00:00 2001
From: Kevin Anderson <kevin.anderso@gmail.com>
Date: Mon, 6 May 2024 14:45:56 -0400
Subject: [PATCH 127/185] Finalize 0.10.5 (#2035)

* whatsnew cleanup

* add v0.11.0 file

* forgot to include myself in the contributors

* update release date

* Comments from review
---
 docs/sphinx/source/whatsnew/v0.10.5.rst | 12 ++++++++----
 docs/sphinx/source/whatsnew/v0.11.0.rst |  1 +
 2 files changed, 9 insertions(+), 4 deletions(-)

diff --git a/docs/sphinx/source/whatsnew/v0.10.5.rst b/docs/sphinx/source/whatsnew/v0.10.5.rst
index f974e6b6ac..1edcc82555 100644
--- a/docs/sphinx/source/whatsnew/v0.10.5.rst
+++ b/docs/sphinx/source/whatsnew/v0.10.5.rst
@@ -18,6 +18,8 @@ Enhancements
 * Added function :py:func:`pvlib.shading.martinez_shade_factor` to calculate
   shading losses by taking into account the amount of bypass diodes of a module.
   (:issue:``, :pull:``)
+v0.10.5 (May 6, 2024)
+---------------------
 
 
 Bug fixes
@@ -37,10 +39,6 @@ Bug fixes
   of the two parameters. (:issue:`2018`, :pull:`2020`)
 
 
-Testing
-~~~~~~~
-
-
 Documentation
 ~~~~~~~~~~~~~
 * Fix variable name typo at
@@ -68,3 +66,9 @@ Contributors
 * Kevin Anderson (:ghuser:`kandersolar`)
 * :ghuser:`apct69`
 * Mark Mikofski (:ghuser:`mikofski`)
+* Echedey Luis (:ghuser:`echedey-ls`)
+* Adam R. Jensen (:ghuser:`adamrjensen`)
+* Anton Driesse (:ghuser:`adriesse`)
+* Scott Meredith (:ghuser:`smmeredith`)
+* Alexander Morgan (:ghuser:`alexandermorgan`)
+* Kevin Anderson (:ghuser:`kandersolar`)
diff --git a/docs/sphinx/source/whatsnew/v0.11.0.rst b/docs/sphinx/source/whatsnew/v0.11.0.rst
index 8d3faa2571..cc956a986a 100644
--- a/docs/sphinx/source/whatsnew/v0.11.0.rst
+++ b/docs/sphinx/source/whatsnew/v0.11.0.rst
@@ -33,6 +33,7 @@ Documentation
 ~~~~~~~~~~~~~
 * Configure mathjax to left-align and indent equations in docstrings. (:pull:`2056`)
 
+
 Requirements
 ~~~~~~~~~~~~
 

From d697e764e2e84bb654f0bb9766c09013e83468b6 Mon Sep 17 00:00:00 2001
From: echedey-ls <80125792+echedey-ls@users.noreply.github.com>
Date: Thu, 23 May 2024 13:07:40 +0200
Subject: [PATCH 128/185] update whatsnews

---
 docs/sphinx/source/whatsnew/v0.11.0.rst | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/docs/sphinx/source/whatsnew/v0.11.0.rst b/docs/sphinx/source/whatsnew/v0.11.0.rst
index cc956a986a..098eb459c2 100644
--- a/docs/sphinx/source/whatsnew/v0.11.0.rst
+++ b/docs/sphinx/source/whatsnew/v0.11.0.rst
@@ -19,6 +19,11 @@ Enhancements
   shade perpendicular to ``axis_azimuth``. The function is applicable to both
   fixed-tilt and one-axis tracking systems.
   (:issue:`1689`, :pull:`1725`, :pull:`1962`)
+* Added function :py:func:`pvlib.shading.shaded_fraction1d`, to calculate the
+  shade perpendicular to row axis. (:issue:`1689`, :pull:`1725`, :pull:`1962`)
+* Added function :py:func:`pvlib.shading.martinez_shade_factor` to calculate
+  shading losses by taking into account the amount of bypass diodes of a module.
+  (:issue:``, :pull:``)
 
 
 Bug fixes
@@ -42,3 +47,4 @@ Contributors
 ~~~~~~~~~~~~
 * Cliff Hansen (:ghuser:`cwhanse`)
 * Mark Mikofski (:ghuser:`mikofski`)
+* Echedey Luis (:ghuser:`echedey-ls`)

From bc8598e757b2690f4675cffdf522f86387895371 Mon Sep 17 00:00:00 2001
From: echedey-ls <80125792+echedey-ls@users.noreply.github.com>
Date: Fri, 24 May 2024 00:20:59 +0200
Subject: [PATCH 129/185] Update test_shading.py

---
 pvlib/tests/test_shading.py | 1 -
 1 file changed, 1 deletion(-)

diff --git a/pvlib/tests/test_shading.py b/pvlib/tests/test_shading.py
index 48e37312b8..dc2b80926f 100644
--- a/pvlib/tests/test_shading.py
+++ b/pvlib/tests/test_shading.py
@@ -1,7 +1,6 @@
 import numpy as np
 import pandas as pd
 
-from numpy.testing import assert_allclose
 from pandas.testing import assert_series_equal
 from numpy.testing import assert_allclose, assert_approx_equal
 import pytest

From bc79bb8c3744f1da804ee11b5a63c8431d3de988 Mon Sep 17 00:00:00 2001
From: echedey-ls <80125792+echedey-ls@users.noreply.github.com>
Date: Tue, 28 May 2024 01:52:46 +0200
Subject: [PATCH 130/185] Example

---
 .../shading/plot_martinez_shade_loss.py       | 196 ++++++++++++++----
 .../_images/PV_module_layout_cesardd.jpg      | Bin 0 -> 307682 bytes
 2 files changed, 150 insertions(+), 46 deletions(-)
 create mode 100644 docs/sphinx/source/_images/PV_module_layout_cesardd.jpg

diff --git a/docs/examples/shading/plot_martinez_shade_loss.py b/docs/examples/shading/plot_martinez_shade_loss.py
index 214440478c..d60d6a0a0c 100644
--- a/docs/examples/shading/plot_martinez_shade_loss.py
+++ b/docs/examples/shading/plot_martinez_shade_loss.py
@@ -20,6 +20,8 @@
 # 2. :py:func:`pvlib.shading.shaded_fraction1d` to calculate the fraction of
 #    shaded surface and consequently the number of shaded *blocks* due to
 #    row-to-row shading.
+# 3. :py:func:`pvlib.tracking.singleaxis` to calculate the rotation angle of
+#    the trackers.
 #
 # .. sectionauthor:: Echedey Luis <echelual (at) gmail.com>
 #
@@ -34,9 +36,10 @@
 # -------------------
 # Let's consider a PV system with the following characteristics:
 # - Two north-south single-axis tracker with 6 modules each one.
-# - The rows have the same true-tracking tilt angles.
+# - The rows have the same true-tracking tilt angles. Let's consider
+#   true-tracking so shade is significant for this example.
 # - Terrain slope is 7 degrees downward to the east.
-# - Row's axis are horizontal.
+# - Rows' axes are horizontal.
 # - The modules are comprised of silicon cells. We will compare these cases:
 #    - modules with one bypass diode
 #    - modules with three bypass diodes
@@ -51,8 +54,7 @@
 import pandas as pd
 import numpy as np
 import matplotlib.pyplot as plt
-
-from pathlib import Path
+from matplotlib.dates import ConciseDateFormatter
 
 pitch = 4  # meters
 width = 1.5  # meters
@@ -62,37 +64,40 @@
 axis_tilt = 0  # flat because the axis is perpendicular to the slope
 cross_axis_tilt = -7  # 7 degrees downward to the east
 
-# Get TMY data & create location
-datapath = Path(pvlib.__path__[0], "data", "tmy_45.000_8.000_2005_2016.csv")
-pvgis_data, _, metadata, _ = pvlib.iotools.read_pvgis_tmy(
-    datapath, map_variables=True
-)
+latitude, longitude = 40.2712, -3.7277
 locus = pvlib.location.Location(
-    metadata["latitude"], metadata["longitude"], altitude=metadata["elevation"]
+    latitude,
+    longitude,
+    tz="Europe/Madrid",
+    altitude=pvlib.location.lookup_altitude(latitude, longitude),
 )
 
-# Coerce a year: function above returns typical months from different years
-pvgis_data.index = [ts.replace(year=2024) for ts in pvgis_data.index]
-# Select day to show
-weather_data = pvgis_data["2024-07-11"]
+times = pd.date_range("2001-04-11T03", "2001-04-11T07", periods=24).union(pd.date_range("2001-04-11T16", "2001-04-11T20", periods=24))
 
 # %%
-# True-tracking algorithm
-# -----------------------
+# True-tracking algorithm and shaded fraction
+# -------------------------------------------
 # Since this model is about row-to-row shading, we will use the true-tracking
-# algorithm to calculate the trackers rotation. Back-tracking avoids shading
-# between rows, which is not what we want to analyze here.
+# algorithm to calculate the trackers rotation. Back-tracking reduces the
+# shading between rows, but since this example is about shading, we will not
+# use it.
+#
+# Then, the next step is to calculate the fraction of shaded surface. This is
+# done using :py:func:`pvlib.shading.shaded_fraction1d`. Using this function is
+# straightforward with the variables we already have defined.
+# Then, we can calculate the number of shaded blocks by rounding up the shaded
+# fraction by the number of blocks along the shaded length.
 
 # Calculate solar position to get single-axis tracker rotation and irradiance
-solar_pos = locus.get_solarposition(weather_data.index)
-apparent_zenith, apparent_azimuth = (
+solar_pos = locus.get_solarposition(times)
+solar_apparent_zenith, solar_azimuth = (
     solar_pos["apparent_zenith"],
     solar_pos["azimuth"],
-)  # unpack references to data for better readability
+)  # unpack for better readability
 
 tracking_result = pvlib.tracking.singleaxis(
-    apparent_zenith=apparent_zenith,
-    apparent_azimuth=apparent_azimuth,
+    apparent_zenith=solar_apparent_zenith,
+    apparent_azimuth=solar_azimuth,
     axis_tilt=axis_tilt,
     axis_azimuth=axis_azimuth,
     max_angle=(-90 + cross_axis_tilt, 90 + cross_axis_tilt),  # (min, max)
@@ -106,31 +111,130 @@
     tracking_result["aoi"],
     tracking_result["surface_tilt"],
     tracking_result["surface_azimuth"],
-)  # unpack references into explicit variables for better readability
-
-extra_rad = pvlib.irradiance.get_extra_radiation(weather_data.index)
-
-poa_sky_diffuse = pvlib.irradiance.haydavies(
-    surface_tilt,
-    surface_azimuth,
-    weather_data["dhi"],
-    weather_data["dni"],
-    extra_rad,
-    apparent_zenith,
-    apparent_azimuth,
-)
+)  # unpack for better readability
+
+# Calculate the tracking angles
+rotation_angle = pvlib.tracking.singleaxis(
+    solar_apparent_zenith,
+    solar_azimuth,
+    axis_tilt,
+    axis_azimuth,
+    max_angle=(-45, 45),  # (min, max) degrees
+    backtrack=False,
+    gcr=gcr,
+    cross_axis_tilt=cross_axis_tilt,
+)["tracker_theta"]
 
-poa_ground_diffuse = pvlib.irradiance.get_ground_diffuse(
-    surface_tilt, weather_data["ghi"], surface_type="grass"
+# Calculate the shade fraction
+shaded_fraction = pvlib.shading.shaded_fraction1d(
+    solar_apparent_zenith,
+    solar_azimuth,
+    axis_azimuth,
+    axis_tilt=axis_tilt,
+    shaded_row_rotation=rotation_angle,
+    shading_row_rotation=rotation_angle,
+    collector_width=width,
+    pitch=pitch,
+    cross_axis_slope=cross_axis_tilt,
 )
 
 # %%
-# Shaded fraction calculation
-# ---------------------------
-# The next step is to calculate the fraction of shaded surface. This is done
-# using :py:func:`pvlib.shading.shaded_fraction1d`. Using this function is
-# straightforward with the amount of information we already have.
+# Number of shaded blocks
+# -----------------------
+# The number of shaded blocks depends on the module configuration and number
+# of bypass diodes. For example,
+# modules with one bypass diode will behave like one block.
+# On the other hand, modules with three bypass diodes will have three blocks,
+# except for the half-cut cell modules, which will have six blocks; 2x3 blocks
+# where the two rows are along the longest side of the module.
+# We can argue that the dimensions of the system changes when you switch from
+# portrait to landscape, but for this example, we will consider it the same.
+#
+# The number of shaded blocks is calculated by rounding up the shaded fraction
+# by the number of blocks along the shaded length. So let's define the number
+# of blocks for each module configuration:
+# - 1 bypass diode: 1 block
+# - 3 bypass diodes: 3 blocks (in portrait; in landscape, it would be 1)
+# - 3 bypass diodes half-cut cells:
+#   - 2 blocks in portrait
+#   - 3 blocks in landscape
+#
+# .. figure:: ../../_images/PV_module_layout_cesardd.jpg
+#    :align: center
+#    :width: 75%
+#    :alt: Normal and half-cut cells module layouts
+#
+#    Left: common module layout. Right: half-cut cells module layout.
+#    Each module has three bypass diodes. On the left, they connect cell
+#    columns 1-2, 2-3 & 3-4. On the right, they connect cell rows 1-2, 3-4 &
+#    5-6.
+#    *Source: César Domínguez. CC BY-SA 4.0*
+#
+# In the image above, each orange U-like circuit section is a block.
+# By symmetry, the yellow inverted-U's of the subcircuit are also blocks.
+# For this reason, the half-cut cell modules have 6 blocks in total: two along
+# the longest side and three along the shortest side.
+
+blocks_per_module = {
+    "1 bypass diode": 1,
+    "3 bypass diodes": 3,
+    "3 bypass diodes half-cut, portrait": 2,
+    "3 bypass diodes half-cut, landscape": 3,
+}
+
+# Calculate the number of shaded blocks during the day
+shaded_blocks_per_module = {
+    k: np.ceil(blocks_N * shaded_fraction)
+    for k, blocks_N in blocks_per_module.items()
+}
 
-shaded_fraction = pvlib.shading.shaded_fraction1d(
-    surface_tilt, surface_azimuth, apparent_zenith, apparent_azimuth
-)
+# %%
+# Results
+# -------
+# Now that we have the number of shaded blocks for each module configuration,
+# we can apply the model and estimate the power loss due to shading.
+#
+# Note this model is not linear with the shaded blocks ratio, so there is a
+# difference between applying it to just a module or a whole row.
+
+shade_factor_per_module = {
+    k: pvlib.shading.martinez_shade_factor(
+        shaded_fraction, module_shaded_blocks, blocks_per_module[k]
+    )
+    for k, module_shaded_blocks in shaded_blocks_per_module.items()
+}
+
+shade_factor_per_row = {
+    k: pvlib.shading.martinez_shade_factor(
+        shaded_fraction,
+        module_shaded_blocks * N_modules_per_row,
+        blocks_per_module[k] * N_modules_per_row,
+    )
+    for k, module_shaded_blocks in shaded_blocks_per_module.items()
+}
+
+fig, (ax1, ax2) = plt.subplots(2, 1, sharex=True)
+fig.suptitle("Martinez power correction factor due to shading")
+for k, shade_factor in shade_factor_per_module.items():
+    linestyle = "--" if k == "3 bypass diodes half-cut, landscape" else "-"
+    ax1.plot(times, shade_factor, label=k, linestyle=linestyle)
+ax1.legend()
+ax1.grid()
+ax1.set_xlabel("Time")
+ax1.xaxis.set_major_formatter(ConciseDateFormatter("%H:%M", tz="Europe/Madrid"))
+ax1.set_ylabel("Power correction factor")
+ax1.set_title("Per module")
+
+for k, shade_factor in shade_factor_per_row.items():
+    linestyle = "--" if k == "3 bypass diodes half-cut, landscape" else "-"
+    ax2.plot(times, shade_factor, label=k, linestyle=linestyle)
+ax2.legend()
+ax2.grid()
+ax2.set_xlabel("Time")
+ax2.xaxis.set_major_formatter(ConciseDateFormatter("%H:%M", tz="Europe/Madrid"))
+ax2.set_ylabel("Power correction factor")
+ax2.set_title("Per row")
+fig.tight_layout()
+fig.show()
+
+# %%
diff --git a/docs/sphinx/source/_images/PV_module_layout_cesardd.jpg b/docs/sphinx/source/_images/PV_module_layout_cesardd.jpg
new file mode 100644
index 0000000000000000000000000000000000000000..385fe8dcbb9bb301a0f68b570bb31a6ab12ca8d1
GIT binary patch
literal 307682
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%0DT<q2BQ28)1ENbI(E9v?GwfW
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
QtGk&2teIb{U9D373lbe5B>(^b

literal 0
HcmV?d00001


From 74e1e4418dc11507224e43bffe911290a7c00bd1 Mon Sep 17 00:00:00 2001
From: echedey-ls <80125792+echedey-ls@users.noreply.github.com>
Date: Tue, 28 May 2024 02:02:59 +0200
Subject: [PATCH 131/185] Fix whatsmes

---
 docs/sphinx/source/whatsnew/v0.10.5.rst | 30 -------------------------
 docs/sphinx/source/whatsnew/v0.11.0.rst |  9 +-------
 pvlib/shading.py                        |  2 +-
 3 files changed, 2 insertions(+), 39 deletions(-)

diff --git a/docs/sphinx/source/whatsnew/v0.10.5.rst b/docs/sphinx/source/whatsnew/v0.10.5.rst
index 1edcc82555..00daed3a0f 100644
--- a/docs/sphinx/source/whatsnew/v0.10.5.rst
+++ b/docs/sphinx/source/whatsnew/v0.10.5.rst
@@ -3,23 +3,6 @@
 
 v0.10.5 (May 6, 2024)
 ---------------------
-v0.10.5 (Anticipated June 2024)
--------------------------------
-
-
-Deprecations
-~~~~~~~~~~~~
-
-
-Enhancements
-~~~~~~~~~~~~
-* Added function :py:func:`pvlib.shading.shaded_fraction1d`, to calculate the
-  shade perpendicular to ``axis_azimuth``. (:issue:`1689`, :pull:`1725`, :pull:`1962`)
-* Added function :py:func:`pvlib.shading.martinez_shade_factor` to calculate
-  shading losses by taking into account the amount of bypass diodes of a module.
-  (:issue:``, :pull:``)
-v0.10.5 (May 6, 2024)
----------------------
 
 
 Bug fixes
@@ -33,10 +16,6 @@ Bug fixes
 * Fixed :py:func:`pvlib.pvsystem.retrieve_sam` silently ignoring the ``path`` parameter
   when ``name`` was provided. Now an exception is raised requesting to only provide one
   of the two parameters. (:issue:`2018`, :pull:`2020`)
-* Corrected equation for Ixx0 in :py:func:`pvlib.pvsystem.sapm` (:issue:`2016`, :pull:`2019`)
-* Fixed :py:func:`pvlib.pvsystem.retrieve_sam` silently ignoring the `path` parameter
-  when `name` was provided. Now an exception is raised requesting to only provide one
-  of the two parameters. (:issue:`2018`, :pull:`2020`)
 
 
 Documentation
@@ -49,7 +28,6 @@ Documentation
 Requirements
 ~~~~~~~~~~~~
 * Minimum version of Python increased from 3.7 to 3.8. (:issue:`1975`, :pull:`2029`)
-* Python 3.8 or higher. (:issue:`1975`, :pull:`2029`)
 * Minimum version of scipy advanced from 1.5.0 to 1.6.0. (:pull:`2027`)
 
 
@@ -64,11 +42,3 @@ Contributors
 * Scott Meredith (:ghuser:`smmeredith`)
 * Alexander Morgan (:ghuser:`alexandermorgan`)
 * Kevin Anderson (:ghuser:`kandersolar`)
-* :ghuser:`apct69`
-* Mark Mikofski (:ghuser:`mikofski`)
-* Echedey Luis (:ghuser:`echedey-ls`)
-* Adam R. Jensen (:ghuser:`adamrjensen`)
-* Anton Driesse (:ghuser:`adriesse`)
-* Scott Meredith (:ghuser:`smmeredith`)
-* Alexander Morgan (:ghuser:`alexandermorgan`)
-* Kevin Anderson (:ghuser:`kandersolar`)
diff --git a/docs/sphinx/source/whatsnew/v0.11.0.rst b/docs/sphinx/source/whatsnew/v0.11.0.rst
index 94025d5e6f..e50be83624 100644
--- a/docs/sphinx/source/whatsnew/v0.11.0.rst
+++ b/docs/sphinx/source/whatsnew/v0.11.0.rst
@@ -17,15 +17,9 @@ Deprecations
 
 Enhancements
 ~~~~~~~~~~~~
-* Add function :py:func:`pvlib.shading.shaded_fraction1d`, to calculate the
-  shade perpendicular to ``axis_azimuth``. The function is applicable to both
-  fixed-tilt and one-axis tracking systems.
-  (:issue:`1689`, :pull:`1725`, :pull:`1962`)
-* Added function :py:func:`pvlib.shading.shaded_fraction1d`, to calculate the
-  shade perpendicular to row axis. (:issue:`1689`, :pull:`1725`, :pull:`1962`)
 * Added function :py:func:`pvlib.shading.martinez_shade_factor` to calculate
   shading losses by taking into account the amount of bypass diodes of a module.
-  (:issue:``, :pull:``)
+  (:issue:`2063`, :pull:`2070`)
 
 
 Bug fixes
@@ -49,5 +43,4 @@ Contributors
 ~~~~~~~~~~~~
 * Cliff Hansen (:ghuser:`cwhanse`)
 * Mark Mikofski (:ghuser:`mikofski`)
-* Echedey Luis (:ghuser:`echedey-ls`)
 * Siddharth Kaul (:ghuser:`k10blogger`)
diff --git a/pvlib/shading.py b/pvlib/shading.py
index b392f500f2..c36b036f5a 100644
--- a/pvlib/shading.py
+++ b/pvlib/shading.py
@@ -561,7 +561,7 @@ def martinez_shade_factor(shaded_fraction, N_shaded_blocks, N_total_blocks):
     irradiance of non-monolithic Silicon
     modules and arrays with an arbitrary number of bypass diodes.
 
-    .. versionadded:: 0.10.5
+    .. versionadded:: 0.11.0
 
     Parameters
     ----------

From 76eb1ca775cd3c2d919505858a1aa7c761e22c24 Mon Sep 17 00:00:00 2001
From: echedey-ls <80125792+echedey-ls@users.noreply.github.com>
Date: Tue, 28 May 2024 02:07:40 +0200
Subject: [PATCH 132/185] Update v0.11.0.rst

---
 docs/sphinx/source/whatsnew/v0.11.0.rst | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/docs/sphinx/source/whatsnew/v0.11.0.rst b/docs/sphinx/source/whatsnew/v0.11.0.rst
index e50be83624..e2fd2dbe75 100644
--- a/docs/sphinx/source/whatsnew/v0.11.0.rst
+++ b/docs/sphinx/source/whatsnew/v0.11.0.rst
@@ -17,6 +17,10 @@ Deprecations
 
 Enhancements
 ~~~~~~~~~~~~
+* Add function :py:func:`pvlib.shading.shaded_fraction1d`, to calculate the
+  shade perpendicular to ``axis_azimuth``. The function is applicable to both
+  fixed-tilt and one-axis tracking systems.
+  (:issue:`1689`, :pull:`1725`, :pull:`1962`)
 * Added function :py:func:`pvlib.shading.martinez_shade_factor` to calculate
   shading losses by taking into account the amount of bypass diodes of a module.
   (:issue:`2063`, :pull:`2070`)
@@ -34,7 +38,6 @@ Documentation
 ~~~~~~~~~~~~~
 * Configure mathjax to left-align and indent equations in docstrings. (:pull:`2056`)
 
-
 Requirements
 ~~~~~~~~~~~~
 

From 6db8f7c07695e3a4c3c782f593989ab45f563e50 Mon Sep 17 00:00:00 2001
From: echedey-ls <80125792+echedey-ls@users.noreply.github.com>
Date: Tue, 28 May 2024 02:07:45 +0200
Subject: [PATCH 133/185] other img

---
 docs/examples/shading/plot_martinez_shade_loss.py   |  12 +++++++++++-
 ...ralized_and_split_PV_junction_boxes_cesardd.jpg} | Bin
 2 files changed, 11 insertions(+), 1 deletion(-)
 rename docs/sphinx/source/_images/{Centralized_and_split_PV_junction_boxes.jpg => Centralized_and_split_PV_junction_boxes_cesardd.jpg} (100%)

diff --git a/docs/examples/shading/plot_martinez_shade_loss.py b/docs/examples/shading/plot_martinez_shade_loss.py
index d60d6a0a0c..d94052d4c7 100644
--- a/docs/examples/shading/plot_martinez_shade_loss.py
+++ b/docs/examples/shading/plot_martinez_shade_loss.py
@@ -170,7 +170,17 @@
 #    5-6.
 #    *Source: César Domínguez. CC BY-SA 4.0*
 #
-# In the image above, each orange U-like circuit section is a block.
+# .. figure:: ../../_images/Centralized_and_split_PV_junction_boxes_cesardd.jpg
+#    :align: center
+#    :width: 75%
+#    :alt: Centralized and split PV junction boxes
+#
+#    Left: centralized junction box, common in non-half-cut cell modules.
+#    Right: split junction box, common in half-cut cell modules.
+#    Clarification of the bypass diodes connection and blocks.
+#    *Source: César Domínguez. CC BY-SA 4.0*
+#
+# In the upper image, each orange U-like circuit section is a block.
 # By symmetry, the yellow inverted-U's of the subcircuit are also blocks.
 # For this reason, the half-cut cell modules have 6 blocks in total: two along
 # the longest side and three along the shortest side.
diff --git a/docs/sphinx/source/_images/Centralized_and_split_PV_junction_boxes.jpg b/docs/sphinx/source/_images/Centralized_and_split_PV_junction_boxes_cesardd.jpg
similarity index 100%
rename from docs/sphinx/source/_images/Centralized_and_split_PV_junction_boxes.jpg
rename to docs/sphinx/source/_images/Centralized_and_split_PV_junction_boxes_cesardd.jpg

From 8db5e55c7ca858d609a62b1d030f25418afabb1a Mon Sep 17 00:00:00 2001
From: echedey-ls <80125792+echedey-ls@users.noreply.github.com>
Date: Tue, 28 May 2024 02:10:38 +0200
Subject: [PATCH 134/185] lintarrrrrr :sob:

---
 docs/examples/shading/plot_martinez_shade_loss.py | 12 +++++++++---
 1 file changed, 9 insertions(+), 3 deletions(-)

diff --git a/docs/examples/shading/plot_martinez_shade_loss.py b/docs/examples/shading/plot_martinez_shade_loss.py
index d94052d4c7..8b5f3011b4 100644
--- a/docs/examples/shading/plot_martinez_shade_loss.py
+++ b/docs/examples/shading/plot_martinez_shade_loss.py
@@ -72,7 +72,9 @@
     altitude=pvlib.location.lookup_altitude(latitude, longitude),
 )
 
-times = pd.date_range("2001-04-11T03", "2001-04-11T07", periods=24).union(pd.date_range("2001-04-11T16", "2001-04-11T20", periods=24))
+times = pd.date_range("2001-04-11T03", "2001-04-11T07", periods=24).union(
+    pd.date_range("2001-04-11T16", "2001-04-11T20", periods=24)
+)
 
 # %%
 # True-tracking algorithm and shaded fraction
@@ -231,7 +233,9 @@
 ax1.legend()
 ax1.grid()
 ax1.set_xlabel("Time")
-ax1.xaxis.set_major_formatter(ConciseDateFormatter("%H:%M", tz="Europe/Madrid"))
+ax1.xaxis.set_major_formatter(
+    ConciseDateFormatter("%H:%M", tz="Europe/Madrid")
+)
 ax1.set_ylabel("Power correction factor")
 ax1.set_title("Per module")
 
@@ -241,7 +245,9 @@
 ax2.legend()
 ax2.grid()
 ax2.set_xlabel("Time")
-ax2.xaxis.set_major_formatter(ConciseDateFormatter("%H:%M", tz="Europe/Madrid"))
+ax2.xaxis.set_major_formatter(
+    ConciseDateFormatter("%H:%M", tz="Europe/Madrid")
+)
 ax2.set_ylabel("Power correction factor")
 ax2.set_title("Per row")
 fig.tight_layout()

From b4d255b771652ae26b3bbc7353eb56af56845ea6 Mon Sep 17 00:00:00 2001
From: echedey-ls <80125792+echedey-ls@users.noreply.github.com>
Date: Tue, 28 May 2024 02:37:50 +0200
Subject: [PATCH 135/185] docs

---
 docs/examples/shading/plot_martinez_shade_loss.py |  4 ++--
 pvlib/shading.py                                  | 15 +++++++--------
 2 files changed, 9 insertions(+), 10 deletions(-)

diff --git a/docs/examples/shading/plot_martinez_shade_loss.py b/docs/examples/shading/plot_martinez_shade_loss.py
index 8b5f3011b4..1b57064df3 100644
--- a/docs/examples/shading/plot_martinez_shade_loss.py
+++ b/docs/examples/shading/plot_martinez_shade_loss.py
@@ -170,7 +170,7 @@
 #    Each module has three bypass diodes. On the left, they connect cell
 #    columns 1-2, 2-3 & 3-4. On the right, they connect cell rows 1-2, 3-4 &
 #    5-6.
-#    *Source: César Domínguez. CC BY-SA 4.0*
+#    *Source: César Domínguez. CC BY-SA 4.0, Wikimedia Commons*
 #
 # .. figure:: ../../_images/Centralized_and_split_PV_junction_boxes_cesardd.jpg
 #    :align: center
@@ -180,7 +180,7 @@
 #    Left: centralized junction box, common in non-half-cut cell modules.
 #    Right: split junction box, common in half-cut cell modules.
 #    Clarification of the bypass diodes connection and blocks.
-#    *Source: César Domínguez. CC BY-SA 4.0*
+#    *Source: César Domínguez. CC BY-SA 4.0, Wikimedia Commons*
 #
 # In the upper image, each orange U-like circuit section is a block.
 # By symmetry, the yellow inverted-U's of the subcircuit are also blocks.
diff --git a/pvlib/shading.py b/pvlib/shading.py
index c36b036f5a..412db9d297 100644
--- a/pvlib/shading.py
+++ b/pvlib/shading.py
@@ -605,7 +605,7 @@ def martinez_shade_factor(shaded_fraction, N_shaded_blocks, N_total_blocks):
     The latter two are heavily correlated.
 
     For example:
-     1. A module with 1 bypass diode is likely to have 1 block.
+     1. A module with 1 bypass diode behaves as 1 block.
      2. A module with 3 bypass diodes and 1 junction box is likely to have 3
         blocks.
      3. A half-cut module with 3 junction boxes (split junction boxes) is
@@ -614,13 +614,12 @@ def martinez_shade_factor(shaded_fraction, N_shaded_blocks, N_total_blocks):
      4. A module without bypass diodes doesn't constitute a block, but may be
         part of one.
 
-     .. figure:: _images/Centralized_and_split_PV_junction_boxes.jpg
+     .. figure:: _images/Centralized_and_split_PV_junction_boxes_cesardd.jpg
         :alt: Centralized and split PV junction boxes.
 
         Left image: Centralized junction box with 3 bypass diodes (2.).
         Right image: 3 (split-) junction boxes on a half-cut cell module (3.).
-        Source: César Domínguez, CC BY-SA 4.0
-        <https://creativecommons.org/licenses/by-sa/4.0>, Wikimedia Commons.
+        Source: César Domínguez, CC BY-SA 4.0, Wikimedia Commons.
 
     Examples
     --------
@@ -632,10 +631,10 @@ def martinez_shade_factor(shaded_fraction, N_shaded_blocks, N_total_blocks):
     >>> POA_direct = 600  # W
     >>> POA_diffuse = 80  # W
     >>> shaded_fraction = shading.shaded_fraction1d(
-            80, 180, 90, 25,
-             collector_width=0.5, row_pitch=1, surface_to_axis_offset=0,
-             cross_axis_slope=5.711, shading_tracker_tilt=50)
-        )
+    >>>     80, 180, 90, 25,
+    >>>      collector_width=0.5, row_pitch=1, surface_to_axis_offset=0,
+    >>>      cross_axis_slope=5.711, shading_tracker_tilt=50)
+    >>> )
     >>> shaded_blocks = np.ceil(total_blocks*shaded_fraction)
     >>> loss_correction = shading.martinez_shade_factor()
     >>> POA_total = POA_direct * loss_correction + POA_diffuse

From 5e0677c917d30a323bda1a68c4c653ed149b9dca Mon Sep 17 00:00:00 2001
From: echedey-ls <80125792+echedey-ls@users.noreply.github.com>
Date: Tue, 28 May 2024 02:50:48 +0200
Subject: [PATCH 136/185] docs refurbishment

---
 .../shading/plot_martinez_shade_loss.py       | 26 ++++++++----
 pvlib/shading.py                              | 42 ++++++++++---------
 2 files changed, 41 insertions(+), 27 deletions(-)

diff --git a/docs/examples/shading/plot_martinez_shade_loss.py b/docs/examples/shading/plot_martinez_shade_loss.py
index 1b57064df3..7d46b2fa27 100644
--- a/docs/examples/shading/plot_martinez_shade_loss.py
+++ b/docs/examples/shading/plot_martinez_shade_loss.py
@@ -8,15 +8,16 @@
 
 # %%
 # This example illustrates how to use the proposed by Martinez et al. [1]_.
-# The model corrects the beam and circumsolar incident irradiance
-# based on the number of shaded *blocks*. A *block* is defined as a
-# group of cells that are protected by a bypass diode.
-# More information on the *blocks* can be found in the original paper [1]_ and
-# in :py:func:`pvlib.shading.martinez_shade_factor` documentation.
+# The model adjusts the output power of a PV module based on the number of
+# shaded *blocks*. A *block* is defined as a group of cells protected by a
+# bypass diode. More information on the *blocks* can be found in the original
+# paper [1]_ and in :py:func:`pvlib.shading.martinez_shade_factor`
+# documentation.
 #
 # The following key functions are used in this example:
+#
 # 1. :py:func:`pvlib.shading.martinez_shade_factor` to calculate the adjustment
-#    factor for the direct irradiance component.
+#    factor for the output power.
 # 2. :py:func:`pvlib.shading.shaded_fraction1d` to calculate the fraction of
 #    shaded surface and consequently the number of shaded *blocks* due to
 #    row-to-row shading.
@@ -35,12 +36,13 @@
 # Problem description
 # -------------------
 # Let's consider a PV system with the following characteristics:
+#
 # - Two north-south single-axis tracker with 6 modules each one.
 # - The rows have the same true-tracking tilt angles. Let's consider
 #   true-tracking so shade is significant for this example.
 # - Terrain slope is 7 degrees downward to the east.
 # - Rows' axes are horizontal.
-# - The modules are comprised of silicon cells. We will compare these cases:
+# - The modules are comprised of multiple cells. We will compare these cases:
 #    - modules with one bypass diode
 #    - modules with three bypass diodes
 #    - half-cut cell modules with three bypass diodes on portrait and landscape
@@ -155,6 +157,7 @@
 # The number of shaded blocks is calculated by rounding up the shaded fraction
 # by the number of blocks along the shaded length. So let's define the number
 # of blocks for each module configuration:
+#
 # - 1 bypass diode: 1 block
 # - 3 bypass diodes: 3 blocks (in portrait; in landscape, it would be 1)
 # - 3 bypass diodes half-cut cells:
@@ -182,7 +185,7 @@
 #    Clarification of the bypass diodes connection and blocks.
 #    *Source: César Domínguez. CC BY-SA 4.0, Wikimedia Commons*
 #
-# In the upper image, each orange U-like circuit section is a block.
+# In the upper image, each orange U-shaped section of the string is a block.
 # By symmetry, the yellow inverted-U's of the subcircuit are also blocks.
 # For this reason, the half-cut cell modules have 6 blocks in total: two along
 # the longest side and three along the shortest side.
@@ -254,3 +257,10 @@
 fig.show()
 
 # %%
+# Note how the half-cut cell module in portrait behaves worse that the
+# normal module with three bypass diodes. This is because the number of shaded
+# blocks is less along the shaded length.
+# This is the reason why half-cut cell modules are preferred in portrait
+# orientation.
+
+# %%
diff --git a/pvlib/shading.py b/pvlib/shading.py
index 412db9d297..0ddb963a3b 100644
--- a/pvlib/shading.py
+++ b/pvlib/shading.py
@@ -599,32 +599,37 @@ def martinez_shade_factor(shaded_fraction, N_shaded_blocks, N_total_blocks):
     How many blocks and their layout depend on the module(s) used. Many
     manufacturers don't specify this information explicitly. However, we can
     infer these values from:
-     - the number of bypass diodes
-     - where and how many junction boxes are present on the back of the module
-     - whether or not the module is comprised of *half-cut cells*
+
+    - the number of bypass diodes
+    - where and how many junction boxes are present on the back of the module
+    - whether or not the module is comprised of *half-cut cells*
+
     The latter two are heavily correlated.
 
     For example:
-     1. A module with 1 bypass diode behaves as 1 block.
-     2. A module with 3 bypass diodes and 1 junction box is likely to have 3
-        blocks.
-     3. A half-cut module with 3 junction boxes (split junction boxes) is
-        likely to have 3x2 blocks. The number of blocks along the longest
-        side of the module is 2 and along the shortest side is 3.
-     4. A module without bypass diodes doesn't constitute a block, but may be
-        part of one.
-
-     .. figure:: _images/Centralized_and_split_PV_junction_boxes_cesardd.jpg
-        :alt: Centralized and split PV junction boxes.
-
-        Left image: Centralized junction box with 3 bypass diodes (2.).
-        Right image: 3 (split-) junction boxes on a half-cut cell module (3.).
-        Source: César Domínguez, CC BY-SA 4.0, Wikimedia Commons.
+
+    1. A module with 1 bypass diode behaves as 1 block.
+    2. A module with 3 bypass diodes and 1 junction box is likely to have 3
+       blocks.
+    3. A half-cut module with 3 junction boxes (split junction boxes) is
+       likely to have 3x2 blocks. The number of blocks along the longest
+       side of the module is 2 and along the shortest side is 3.
+    4. A module without bypass diodes doesn't constitute a block, but may be
+       part of one.
+
+    .. figure:: _images/Centralized_and_split_PV_junction_boxes_cesardd.jpg
+       :alt: Centralized and split PV junction boxes.
+
+       Left image: Centralized junction box with 3 bypass diodes (2.).
+       Right image: 3 (split-) junction boxes on a half-cut cell module (3.).
+       *Source: César Domínguez, CC BY-SA 4.0, Wikimedia Commons.*
 
     Examples
     --------
     Minimal example. For a complete example, see
     :ref:`this example <sphx_glr_gallery_plot_martinez_shade_loss.py>`
+    from the gallery.
+
     >>> import numpy as np
     >>> from pvlib import shading
     >>> total_blocks = 3  # blocks along the vertical of the module
@@ -642,7 +647,6 @@ def martinez_shade_factor(shaded_fraction, N_shaded_blocks, N_total_blocks):
     See Also
     --------
     shaded_fraction1d : to calculate 1-dimensional shaded fraction
-    linear_shade_loss
 
     References
     ----------

From 2e52cf9b089845b882b60e2938e0d03f5406a5ef Mon Sep 17 00:00:00 2001
From: echedey-ls <80125792+echedey-ls@users.noreply.github.com>
Date: Tue, 28 May 2024 09:36:36 +0200
Subject: [PATCH 137/185] Update plot_martinez_shade_loss.py

---
 docs/examples/shading/plot_martinez_shade_loss.py | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/docs/examples/shading/plot_martinez_shade_loss.py b/docs/examples/shading/plot_martinez_shade_loss.py
index 7d46b2fa27..c901c0d65a 100644
--- a/docs/examples/shading/plot_martinez_shade_loss.py
+++ b/docs/examples/shading/plot_martinez_shade_loss.py
@@ -1,9 +1,9 @@
 """
-Modelling power loss due to module shading in non-monolithic Si arrays
-======================================================================
+Modelling power loss due to module shading in non-monolithic modules
+====================================================================
 
 This example demonstrates how to model power loss due to row-to-row shading in
-a PV array comprised of non-monolithic silicon cells.
+a PV array comprised of non-monolithic modules.
 """
 
 # %%

From 847ae5c2637e6a348d9f3c82cfa049811f2667d1 Mon Sep 17 00:00:00 2001
From: echedey-ls <80125792+echedey-ls@users.noreply.github.com>
Date: Mon, 3 Jun 2024 01:51:56 +0200
Subject: [PATCH 138/185] Fix parameter names

---
 pvlib/shading.py            |  4 ++--
 pvlib/tests/test_shading.py | 16 ++++++++--------
 2 files changed, 10 insertions(+), 10 deletions(-)

diff --git a/pvlib/shading.py b/pvlib/shading.py
index 0ddb963a3b..e240c7ed1f 100644
--- a/pvlib/shading.py
+++ b/pvlib/shading.py
@@ -555,7 +555,7 @@ def shaded_fraction1d(
     return np.clip(t_asterisk, 0, 1)
 
 
-def martinez_shade_factor(shaded_fraction, N_shaded_blocks, N_total_blocks):
+def martinez_shade_factor(shaded_fraction, shaded_blocks, total_blocks):
     r"""
     A shading correction factor for the direct and circumsolar incident
     irradiance of non-monolithic Silicon
@@ -657,5 +657,5 @@ def martinez_shade_factor(shaded_fraction, N_shaded_blocks, N_total_blocks):
     """  # Contributed by Echedey Luis, 2024
     return (  # Eq. (6) of [1]
         (1 - shaded_fraction)
-        * (1 - np.ceil(N_shaded_blocks) / (1 + N_total_blocks))
+        * (1 - np.ceil(shaded_blocks) / (1 + total_blocks))
     )
diff --git a/pvlib/tests/test_shading.py b/pvlib/tests/test_shading.py
index dc2b80926f..a56527d9fc 100644
--- a/pvlib/tests/test_shading.py
+++ b/pvlib/tests/test_shading.py
@@ -342,13 +342,13 @@ def martinez_shade_factor_Table2():
         columns=[
             "F_GS-H",
             "F_GS-V",
-            "N_shaded_blocks",
+            "shaded_blocks",
             "direct",
             "diffuse",
-            "irrad_correction",
+            "pwr_correction",
         ],
         data=[
-            # F-H, F-V, Nsb, direct, diffuse, effective_irrad_correction
+            # F-H, F-V, Nsb, direct, diffuse, pwr_correction
             [1.00, 0.09, 16, 846.59, 59.42, 0.88],
             [1.00, 0.18, 16, 841.85, 59.69, 0.89],
             [1.00, 0.36, 16, 843.38, 59.22, 0.90],
@@ -365,12 +365,12 @@ def martinez_shade_factor_Table2():
             [0.92, 0.64, 15, 861.48, 59.66, 0.89],
         ]
     )  # fmt: skip
-    test_data["N_total_blocks"] = 16  # total blocks is 16 for all cases
+    test_data["total_blocks"] = 16  # total blocks is 16 for all cases
     test_data["shaded_fraction"] = test_data["F_GS-H"] * test_data["F_GS-V"]
     test_data = test_data.drop(columns=["F_GS-H", "F_GS-V"])
     return (
-        test_data.drop(columns="irrad_correction"),
-        test_data["irrad_correction"],
+        test_data.drop(columns="pwr_correction"),
+        test_data["pwr_correction"],
     )
 
 
@@ -380,8 +380,8 @@ def test_martinez_shade_factor(martinez_shade_factor_Table2):
     correction_factor = shading.martinez_shade_factor(
         **test_data.drop(columns=["direct", "diffuse"])
     )
-    irrad_correction = 1 - (
+    pwr_correction = 1 - (
         (test_data["direct"] * correction_factor + test_data["diffuse"])
         / (test_data["direct"] + test_data["diffuse"])
     )
-    assert_allclose(irrad_correction, irrad_reduction_expected, atol=1e-2)
+    assert_allclose(pwr_correction, irrad_reduction_expected, atol=1e-2)

From 19734dcb31d37dc8a8783cb488872f1c41870f7a Mon Sep 17 00:00:00 2001
From: echedey-ls <80125792+echedey-ls@users.noreply.github.com>
Date: Mon, 3 Jun 2024 01:55:31 +0200
Subject: [PATCH 139/185] More explicit 2D shaded fraction

Co-Authored-By: Kevin Anderson <57452607+kandersolar@users.noreply.github.com>
---
 pvlib/shading.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/pvlib/shading.py b/pvlib/shading.py
index e240c7ed1f..cc36cc7fbd 100644
--- a/pvlib/shading.py
+++ b/pvlib/shading.py
@@ -566,7 +566,7 @@ def martinez_shade_factor(shaded_fraction, shaded_blocks, total_blocks):
     Parameters
     ----------
     shaded_fraction : numeric
-        Surface shaded fraction. Unitless.
+        Surface shaded fraction, with respect to the whole area (2D). Unitless.
     shaded_blocks : numeric
         Number of blocks affected by the shadow. Unitless integer.
         If a floating point number is provided, it will be rounded up.

From da32fd3325f334d2881969f079b319fcb2aaca6b Mon Sep 17 00:00:00 2001
From: echedey-ls <80125792+echedey-ls@users.noreply.github.com>
Date: Mon, 3 Jun 2024 01:57:13 +0200
Subject: [PATCH 140/185] Explicitier explicit

Co-Authored-By: Kevin Anderson <57452607+kandersolar@users.noreply.github.com>
---
 pvlib/shading.py | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/pvlib/shading.py b/pvlib/shading.py
index cc36cc7fbd..d763e63a3b 100644
--- a/pvlib/shading.py
+++ b/pvlib/shading.py
@@ -566,7 +566,9 @@ def martinez_shade_factor(shaded_fraction, shaded_blocks, total_blocks):
     Parameters
     ----------
     shaded_fraction : numeric
-        Surface shaded fraction, with respect to the whole area (2D). Unitless.
+        Surface shaded fraction, with respect to the whole area (2D). Note that
+        some functions may only return a 1D shaded fraction, e.g.,
+        :py:func:`pvlib.shading.shaded_fraction1d`. Unitless.
     shaded_blocks : numeric
         Number of blocks affected by the shadow. Unitless integer.
         If a floating point number is provided, it will be rounded up.

From cc7ce5d803d737ee8bedca55bb24755e1dbcb404 Mon Sep 17 00:00:00 2001
From: echedey-ls <80125792+echedey-ls@users.noreply.github.com>
Date: Mon, 3 Jun 2024 02:02:36 +0200
Subject: [PATCH 141/185] Update shading.py

Co-Authored-By: Kevin Anderson <57452607+kandersolar@users.noreply.github.com>
---
 pvlib/shading.py | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/pvlib/shading.py b/pvlib/shading.py
index d763e63a3b..ab0a9b0411 100644
--- a/pvlib/shading.py
+++ b/pvlib/shading.py
@@ -629,8 +629,7 @@ def martinez_shade_factor(shaded_fraction, shaded_blocks, total_blocks):
     Examples
     --------
     Minimal example. For a complete example, see
-    :ref:`this example <sphx_glr_gallery_plot_martinez_shade_loss.py>`
-    from the gallery.
+    `this gallery example <sphx_glr_gallery_plot_martinez_shade_loss.py>`_.
 
     >>> import numpy as np
     >>> from pvlib import shading

From 15ec5c4b4e2555e739a4d9afbe354e35bbfe5fbf Mon Sep 17 00:00:00 2001
From: echedey-ls <80125792+echedey-ls@users.noreply.github.com>
Date: Mon, 3 Jun 2024 02:11:50 +0200
Subject: [PATCH 142/185] Only if life was VCS to revert my errors so easily

Co-Authored-By: Kevin Anderson <57452607+kandersolar@users.noreply.github.com>
---
 pvlib/tests/test_shading.py | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/pvlib/tests/test_shading.py b/pvlib/tests/test_shading.py
index a56527d9fc..43ad168dc5 100644
--- a/pvlib/tests/test_shading.py
+++ b/pvlib/tests/test_shading.py
@@ -345,10 +345,10 @@ def martinez_shade_factor_Table2():
             "shaded_blocks",
             "direct",
             "diffuse",
-            "pwr_correction",
+            "irrad_correction",
         ],
         data=[
-            # F-H, F-V, Nsb, direct, diffuse, pwr_correction
+            # F-H, F-V, Nsb, direct, diffuse, irrad_correction
             [1.00, 0.09, 16, 846.59, 59.42, 0.88],
             [1.00, 0.18, 16, 841.85, 59.69, 0.89],
             [1.00, 0.36, 16, 843.38, 59.22, 0.90],
@@ -369,8 +369,8 @@ def martinez_shade_factor_Table2():
     test_data["shaded_fraction"] = test_data["F_GS-H"] * test_data["F_GS-V"]
     test_data = test_data.drop(columns=["F_GS-H", "F_GS-V"])
     return (
-        test_data.drop(columns="pwr_correction"),
-        test_data["pwr_correction"],
+        test_data.drop(columns="irrad_correction"),
+        test_data["irrad_correction"],
     )
 
 
@@ -380,8 +380,8 @@ def test_martinez_shade_factor(martinez_shade_factor_Table2):
     correction_factor = shading.martinez_shade_factor(
         **test_data.drop(columns=["direct", "diffuse"])
     )
-    pwr_correction = 1 - (
+    irrad_correction = 1 - (
         (test_data["direct"] * correction_factor + test_data["diffuse"])
         / (test_data["direct"] + test_data["diffuse"])
     )
-    assert_allclose(pwr_correction, irrad_reduction_expected, atol=1e-2)
+    assert_allclose(irrad_correction, irrad_reduction_expected, atol=1e-2)

From 610fd97a9dfe6a6a0d07a00326776379b26965f1 Mon Sep 17 00:00:00 2001
From: echedey-ls <80125792+echedey-ls@users.noreply.github.com>
Date: Mon, 3 Jun 2024 02:12:25 +0200
Subject: [PATCH 143/185] Nix image in docstring

Co-Authored-By: Kevin Anderson <57452607+kandersolar@users.noreply.github.com>
---
 pvlib/shading.py | 7 -------
 1 file changed, 7 deletions(-)

diff --git a/pvlib/shading.py b/pvlib/shading.py
index ab0a9b0411..bd537bd55c 100644
--- a/pvlib/shading.py
+++ b/pvlib/shading.py
@@ -619,13 +619,6 @@ def martinez_shade_factor(shaded_fraction, shaded_blocks, total_blocks):
     4. A module without bypass diodes doesn't constitute a block, but may be
        part of one.
 
-    .. figure:: _images/Centralized_and_split_PV_junction_boxes_cesardd.jpg
-       :alt: Centralized and split PV junction boxes.
-
-       Left image: Centralized junction box with 3 bypass diodes (2.).
-       Right image: 3 (split-) junction boxes on a half-cut cell module (3.).
-       *Source: César Domínguez, CC BY-SA 4.0, Wikimedia Commons.*
-
     Examples
     --------
     Minimal example. For a complete example, see

From d6430bb0e4693218586d6ff0ed9c40459c28e4c1 Mon Sep 17 00:00:00 2001
From: echedey-ls <80125792+echedey-ls@users.noreply.github.com>
Date: Mon, 3 Jun 2024 02:18:41 +0200
Subject: [PATCH 144/185] Clear-up irrdiance loss, not pwr loss - yet again

Co-Authored-By: Kevin Anderson <57452607+kandersolar@users.noreply.github.com>
---
 docs/examples/shading/plot_martinez_shade_loss.py | 13 +++++++------
 1 file changed, 7 insertions(+), 6 deletions(-)

diff --git a/docs/examples/shading/plot_martinez_shade_loss.py b/docs/examples/shading/plot_martinez_shade_loss.py
index c901c0d65a..e630f0683b 100644
--- a/docs/examples/shading/plot_martinez_shade_loss.py
+++ b/docs/examples/shading/plot_martinez_shade_loss.py
@@ -1,15 +1,16 @@
 """
-Modelling power loss due to module shading in non-monolithic modules
-====================================================================
+Modelling irradiance loss due to module shading in non-monolithic modules
+=========================================================================
 
-This example demonstrates how to model power loss due to row-to-row shading in
-a PV array comprised of non-monolithic modules.
+Demonstrates how to model direct irradiance loss due to shading in PV modules
+with bypass diodes.
 """
 
 # %%
 # This example illustrates how to use the proposed by Martinez et al. [1]_.
-# The model adjusts the output power of a PV module based on the number of
-# shaded *blocks*. A *block* is defined as a group of cells protected by a
+# The model adjusts the incident direct and circumsolar beam irradiance of a
+# PV module based on the number
+# of shaded *blocks*. A *block* is defined as a group of cells protected by a
 # bypass diode. More information on the *blocks* can be found in the original
 # paper [1]_ and in :py:func:`pvlib.shading.martinez_shade_factor`
 # documentation.

From 161f828763a7430e681e5f86559ece049071cc2b Mon Sep 17 00:00:00 2001
From: echedey-ls <80125792+echedey-ls@users.noreply.github.com>
Date: Mon, 3 Jun 2024 02:19:44 +0200
Subject: [PATCH 145/185] rewording

Co-Authored-By: Kevin Anderson <57452607+kandersolar@users.noreply.github.com>
---
 docs/examples/shading/plot_martinez_shade_loss.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/examples/shading/plot_martinez_shade_loss.py b/docs/examples/shading/plot_martinez_shade_loss.py
index e630f0683b..d0a0654bcc 100644
--- a/docs/examples/shading/plot_martinez_shade_loss.py
+++ b/docs/examples/shading/plot_martinez_shade_loss.py
@@ -160,7 +160,7 @@
 # of blocks for each module configuration:
 #
 # - 1 bypass diode: 1 block
-# - 3 bypass diodes: 3 blocks (in portrait; in landscape, it would be 1)
+# - 3 bypass diodes: 3 blocks in landscape; 1 in portrait
 # - 3 bypass diodes half-cut cells:
 #   - 2 blocks in portrait
 #   - 3 blocks in landscape

From bccd3da3476688f65150b9a7cea371c73b3499e6 Mon Sep 17 00:00:00 2001
From: echedey-ls <80125792+echedey-ls@users.noreply.github.com>
Date: Mon, 3 Jun 2024 02:47:56 +0200
Subject: [PATCH 146/185] Remove figure of junction boxes in example

Co-Authored-By: Kevin Anderson <57452607+kandersolar@users.noreply.github.com>
---
 docs/examples/shading/plot_martinez_shade_loss.py | 10 ----------
 1 file changed, 10 deletions(-)

diff --git a/docs/examples/shading/plot_martinez_shade_loss.py b/docs/examples/shading/plot_martinez_shade_loss.py
index d0a0654bcc..4e07076c05 100644
--- a/docs/examples/shading/plot_martinez_shade_loss.py
+++ b/docs/examples/shading/plot_martinez_shade_loss.py
@@ -176,16 +176,6 @@
 #    5-6.
 #    *Source: César Domínguez. CC BY-SA 4.0, Wikimedia Commons*
 #
-# .. figure:: ../../_images/Centralized_and_split_PV_junction_boxes_cesardd.jpg
-#    :align: center
-#    :width: 75%
-#    :alt: Centralized and split PV junction boxes
-#
-#    Left: centralized junction box, common in non-half-cut cell modules.
-#    Right: split junction box, common in half-cut cell modules.
-#    Clarification of the bypass diodes connection and blocks.
-#    *Source: César Domínguez. CC BY-SA 4.0, Wikimedia Commons*
-#
 # In the upper image, each orange U-shaped section of the string is a block.
 # By symmetry, the yellow inverted-U's of the subcircuit are also blocks.
 # For this reason, the half-cut cell modules have 6 blocks in total: two along

From 0f2fb31dd768d51674c7af6f65738cd97663e280 Mon Sep 17 00:00:00 2001
From: echedey-ls <80125792+echedey-ls@users.noreply.github.com>
Date: Mon, 3 Jun 2024 02:48:07 +0200
Subject: [PATCH 147/185] Duplicated singleaxis call

Co-Authored-By: Kevin Anderson <57452607+kandersolar@users.noreply.github.com>
---
 .../examples/shading/plot_martinez_shade_loss.py | 16 ++--------------
 1 file changed, 2 insertions(+), 14 deletions(-)

diff --git a/docs/examples/shading/plot_martinez_shade_loss.py b/docs/examples/shading/plot_martinez_shade_loss.py
index 4e07076c05..6f944fc38c 100644
--- a/docs/examples/shading/plot_martinez_shade_loss.py
+++ b/docs/examples/shading/plot_martinez_shade_loss.py
@@ -118,26 +118,14 @@
     tracking_result["surface_azimuth"],
 )  # unpack for better readability
 
-# Calculate the tracking angles
-rotation_angle = pvlib.tracking.singleaxis(
-    solar_apparent_zenith,
-    solar_azimuth,
-    axis_tilt,
-    axis_azimuth,
-    max_angle=(-45, 45),  # (min, max) degrees
-    backtrack=False,
-    gcr=gcr,
-    cross_axis_tilt=cross_axis_tilt,
-)["tracker_theta"]
-
 # Calculate the shade fraction
 shaded_fraction = pvlib.shading.shaded_fraction1d(
     solar_apparent_zenith,
     solar_azimuth,
     axis_azimuth,
     axis_tilt=axis_tilt,
-    shaded_row_rotation=rotation_angle,
-    shading_row_rotation=rotation_angle,
+    shaded_row_rotation=tracker_theta,
+    shading_row_rotation=tracker_theta,
     collector_width=width,
     pitch=pitch,
     cross_axis_slope=cross_axis_tilt,

From 48be1c8a59de6184101e76f14f56ed83adf6a97c Mon Sep 17 00:00:00 2001
From: echedey-ls <80125792+echedey-ls@users.noreply.github.com>
Date: Mon, 3 Jun 2024 02:53:38 +0200
Subject: [PATCH 148/185] When did I change this?

Co-Authored-By: Kevin Anderson <57452607+kandersolar@users.noreply.github.com>
---
 docs/examples/shading/plot_martinez_shade_loss.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/examples/shading/plot_martinez_shade_loss.py b/docs/examples/shading/plot_martinez_shade_loss.py
index 6f944fc38c..709accdd87 100644
--- a/docs/examples/shading/plot_martinez_shade_loss.py
+++ b/docs/examples/shading/plot_martinez_shade_loss.py
@@ -75,7 +75,7 @@
     altitude=pvlib.location.lookup_altitude(latitude, longitude),
 )
 
-times = pd.date_range("2001-04-11T03", "2001-04-11T07", periods=24).union(
+times = pd.date_range("2001-04-11T04", "2001-04-11T08", periods=24).union(
     pd.date_range("2001-04-11T16", "2001-04-11T20", periods=24)
 )
 

From 6f2ed3910b8436ffc0c5864374dca56bfcc9879f Mon Sep 17 00:00:00 2001
From: echedey-ls <80125792+echedey-ls@users.noreply.github.com>
Date: Mon, 3 Jun 2024 02:58:15 +0200
Subject: [PATCH 149/185] Rename function

Co-Authored-By: Kevin Anderson <57452607+kandersolar@users.noreply.github.com>
---
 docs/examples/shading/plot_martinez_shade_loss.py    |  8 ++++----
 .../effects_on_pv_system_output/shading.rst          |  2 +-
 docs/sphinx/source/whatsnew/v0.11.0.rst              |  2 +-
 pvlib/shading.py                                     |  4 ++--
 pvlib/tests/test_shading.py                          | 12 ++++++------
 5 files changed, 14 insertions(+), 14 deletions(-)

diff --git a/docs/examples/shading/plot_martinez_shade_loss.py b/docs/examples/shading/plot_martinez_shade_loss.py
index 709accdd87..e809482da6 100644
--- a/docs/examples/shading/plot_martinez_shade_loss.py
+++ b/docs/examples/shading/plot_martinez_shade_loss.py
@@ -12,12 +12,12 @@
 # PV module based on the number
 # of shaded *blocks*. A *block* is defined as a group of cells protected by a
 # bypass diode. More information on the *blocks* can be found in the original
-# paper [1]_ and in :py:func:`pvlib.shading.martinez_shade_factor`
+# paper [1]_ and in :py:func:`pvlib.shading.direct_martinez`
 # documentation.
 #
 # The following key functions are used in this example:
 #
-# 1. :py:func:`pvlib.shading.martinez_shade_factor` to calculate the adjustment
+# 1. :py:func:`pvlib.shading.direct_martinez` to calculate the adjustment
 #    factor for the output power.
 # 2. :py:func:`pvlib.shading.shaded_fraction1d` to calculate the fraction of
 #    shaded surface and consequently the number of shaded *blocks* due to
@@ -192,14 +192,14 @@
 # difference between applying it to just a module or a whole row.
 
 shade_factor_per_module = {
-    k: pvlib.shading.martinez_shade_factor(
+    k: pvlib.shading.direct_martinez(
         shaded_fraction, module_shaded_blocks, blocks_per_module[k]
     )
     for k, module_shaded_blocks in shaded_blocks_per_module.items()
 }
 
 shade_factor_per_row = {
-    k: pvlib.shading.martinez_shade_factor(
+    k: pvlib.shading.direct_martinez(
         shaded_fraction,
         module_shaded_blocks * N_modules_per_row,
         blocks_per_module[k] * N_modules_per_row,
diff --git a/docs/sphinx/source/reference/effects_on_pv_system_output/shading.rst b/docs/sphinx/source/reference/effects_on_pv_system_output/shading.rst
index aea0721571..2d0b94547f 100644
--- a/docs/sphinx/source/reference/effects_on_pv_system_output/shading.rst
+++ b/docs/sphinx/source/reference/effects_on_pv_system_output/shading.rst
@@ -12,4 +12,4 @@ Shading
    shading.sky_diffuse_passias
    shading.projected_solar_zenith_angle
    shading.shaded_fraction1d
-   shading.martinez_shade_factor
+   shading.direct_martinez
diff --git a/docs/sphinx/source/whatsnew/v0.11.0.rst b/docs/sphinx/source/whatsnew/v0.11.0.rst
index e2fd2dbe75..290d1c6f02 100644
--- a/docs/sphinx/source/whatsnew/v0.11.0.rst
+++ b/docs/sphinx/source/whatsnew/v0.11.0.rst
@@ -21,7 +21,7 @@ Enhancements
   shade perpendicular to ``axis_azimuth``. The function is applicable to both
   fixed-tilt and one-axis tracking systems.
   (:issue:`1689`, :pull:`1725`, :pull:`1962`)
-* Added function :py:func:`pvlib.shading.martinez_shade_factor` to calculate
+* Added function :py:func:`pvlib.shading.direct_martinez` to calculate
   shading losses by taking into account the amount of bypass diodes of a module.
   (:issue:`2063`, :pull:`2070`)
 
diff --git a/pvlib/shading.py b/pvlib/shading.py
index bd537bd55c..373155de85 100644
--- a/pvlib/shading.py
+++ b/pvlib/shading.py
@@ -555,7 +555,7 @@ def shaded_fraction1d(
     return np.clip(t_asterisk, 0, 1)
 
 
-def martinez_shade_factor(shaded_fraction, shaded_blocks, total_blocks):
+def direct_martinez(shaded_fraction, shaded_blocks, total_blocks):
     r"""
     A shading correction factor for the direct and circumsolar incident
     irradiance of non-monolithic Silicon
@@ -635,7 +635,7 @@ def martinez_shade_factor(shaded_fraction, shaded_blocks, total_blocks):
     >>>      cross_axis_slope=5.711, shading_tracker_tilt=50)
     >>> )
     >>> shaded_blocks = np.ceil(total_blocks*shaded_fraction)
-    >>> loss_correction = shading.martinez_shade_factor()
+    >>> loss_correction = shading.direct_martinez()
     >>> POA_total = POA_direct * loss_correction + POA_diffuse
 
     See Also
diff --git a/pvlib/tests/test_shading.py b/pvlib/tests/test_shading.py
index 43ad168dc5..18b8f310f6 100644
--- a/pvlib/tests/test_shading.py
+++ b/pvlib/tests/test_shading.py
@@ -330,9 +330,9 @@ def test_shaded_fraction1d_unprovided_shading_row_rotation():
 
 
 @pytest.fixture
-def martinez_shade_factor_Table2():
+def direct_martinez_Table2():
     """
-    Original data used in [1] (see shading.martinez_shade_factor) to validate
+    Original data used in [1] (see shading.direct_martinez) to validate
     the model. Some of the data is provided from Table 2.
     Returns tuple with (input: pandas.DataFrame, output: pandas.Series)
     Output is IRRADIANCE LOSS, not IRRADIANCE CORRECTION, so model result must
@@ -374,10 +374,10 @@ def martinez_shade_factor_Table2():
     )
 
 
-def test_martinez_shade_factor(martinez_shade_factor_Table2):
-    """Tests pvlib.shading.martinez_shade_factor"""
-    test_data, irrad_reduction_expected = martinez_shade_factor_Table2
-    correction_factor = shading.martinez_shade_factor(
+def test_direct_martinez(direct_martinez_Table2):
+    """Tests pvlib.shading.direct_martinez"""
+    test_data, irrad_reduction_expected = direct_martinez_Table2
+    correction_factor = shading.direct_martinez(
         **test_data.drop(columns=["direct", "diffuse"])
     )
     irrad_correction = 1 - (

From 9d5c9189f96a9df8e9fcf72b6ed45c2f52b96bd6 Mon Sep 17 00:00:00 2001
From: echedey-ls <80125792+echedey-ls@users.noreply.github.com>
Date: Mon, 3 Jun 2024 10:12:56 +0200
Subject: [PATCH 150/185] Make times just one statement

Co-Authored-By: Kevin Anderson <57452607+kandersolar@users.noreply.github.com>
---
 docs/examples/shading/plot_martinez_shade_loss.py | 4 +---
 1 file changed, 1 insertion(+), 3 deletions(-)

diff --git a/docs/examples/shading/plot_martinez_shade_loss.py b/docs/examples/shading/plot_martinez_shade_loss.py
index e809482da6..aee49d774a 100644
--- a/docs/examples/shading/plot_martinez_shade_loss.py
+++ b/docs/examples/shading/plot_martinez_shade_loss.py
@@ -75,9 +75,7 @@
     altitude=pvlib.location.lookup_altitude(latitude, longitude),
 )
 
-times = pd.date_range("2001-04-11T04", "2001-04-11T08", periods=24).union(
-    pd.date_range("2001-04-11T16", "2001-04-11T20", periods=24)
-)
+times = pd.date_range("2001-04-11T04", "2001-04-11T20", freq="10min")
 
 # %%
 # True-tracking algorithm and shaded fraction

From c54020a909ac53ca5eb6a423cb79a0e6c2f69353 Mon Sep 17 00:00:00 2001
From: echedey-ls <80125792+echedey-ls@users.noreply.github.com>
Date: Mon, 3 Jun 2024 10:18:18 +0200
Subject: [PATCH 151/185] Fix uncomplete example in docstring

Co-Authored-By: Kevin Anderson <57452607+kandersolar@users.noreply.github.com>
---
 pvlib/shading.py | 7 +++----
 1 file changed, 3 insertions(+), 4 deletions(-)

diff --git a/pvlib/shading.py b/pvlib/shading.py
index 373155de85..cb5080eb40 100644
--- a/pvlib/shading.py
+++ b/pvlib/shading.py
@@ -631,11 +631,10 @@ def direct_martinez(shaded_fraction, shaded_blocks, total_blocks):
     >>> POA_diffuse = 80  # W
     >>> shaded_fraction = shading.shaded_fraction1d(
     >>>     80, 180, 90, 25,
-    >>>      collector_width=0.5, row_pitch=1, surface_to_axis_offset=0,
-    >>>      cross_axis_slope=5.711, shading_tracker_tilt=50)
-    >>> )
+    >>>      collector_width=0.5, pitch=1, surface_to_axis_offset=0,
+    >>>      cross_axis_slope=5.711, shading_row_rotation=50)
     >>> shaded_blocks = np.ceil(total_blocks*shaded_fraction)
-    >>> loss_correction = shading.direct_martinez()
+    >>> loss_correction = shading.direct_martinez(shaded_fraction, shaded_blocks, total_blocks)
     >>> POA_total = POA_direct * loss_correction + POA_diffuse
 
     See Also

From 6116c640e9df51cb761da8416206c24b1869da17 Mon Sep 17 00:00:00 2001
From: echedey-ls <80125792+echedey-ls@users.noreply.github.com>
Date: Mon, 3 Jun 2024 10:19:45 +0200
Subject: [PATCH 152/185] flake is a snowflake :snowflake:

Co-Authored-By: Kevin Anderson <57452607+kandersolar@users.noreply.github.com>
---
 pvlib/shading.py | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/pvlib/shading.py b/pvlib/shading.py
index cb5080eb40..13633ef49b 100644
--- a/pvlib/shading.py
+++ b/pvlib/shading.py
@@ -631,10 +631,11 @@ def direct_martinez(shaded_fraction, shaded_blocks, total_blocks):
     >>> POA_diffuse = 80  # W
     >>> shaded_fraction = shading.shaded_fraction1d(
     >>>     80, 180, 90, 25,
-    >>>      collector_width=0.5, pitch=1, surface_to_axis_offset=0,
-    >>>      cross_axis_slope=5.711, shading_row_rotation=50)
+    >>>     collector_width=0.5, pitch=1, surface_to_axis_offset=0,
+    >>>     cross_axis_slope=5.711, shading_row_rotation=50)
     >>> shaded_blocks = np.ceil(total_blocks*shaded_fraction)
-    >>> loss_correction = shading.direct_martinez(shaded_fraction, shaded_blocks, total_blocks)
+    >>> loss_correction = shading.direct_martinez(
+    >>>     shaded_fraction, shaded_blocks, total_blocks)
     >>> POA_total = POA_direct * loss_correction + POA_diffuse
 
     See Also

From b20b9cc78b3c33072bdf83bf94c7e539a409ac8f Mon Sep 17 00:00:00 2001
From: echedey-ls <80125792+echedey-ls@users.noreply.github.com>
Date: Mon, 3 Jun 2024 10:20:52 +0200
Subject: [PATCH 153/185] Delete
 Centralized_and_split_PV_junction_boxes_cesardd.jpg

Co-Authored-By: Kevin Anderson <57452607+kandersolar@users.noreply.github.com>
---
 ...ized_and_split_PV_junction_boxes_cesardd.jpg | Bin 89736 -> 0 bytes
 1 file changed, 0 insertions(+), 0 deletions(-)
 delete mode 100644 docs/sphinx/source/_images/Centralized_and_split_PV_junction_boxes_cesardd.jpg

diff --git a/docs/sphinx/source/_images/Centralized_and_split_PV_junction_boxes_cesardd.jpg b/docs/sphinx/source/_images/Centralized_and_split_PV_junction_boxes_cesardd.jpg
deleted file mode 100644
index 306cc32fb06bb56845ad8101efe9241a644a0710..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 89736
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


From 9b84ed55c21dbb87356fec028879cfc769546b95 Mon Sep 17 00:00:00 2001
From: echedey-ls <80125792+echedey-ls@users.noreply.github.com>
Date: Mon, 3 Jun 2024 19:17:31 +0200
Subject: [PATCH 154/185] Remove example description

Co-Authored-By: Cliff Hansen <5393711+cwhanse@users.noreply.github.com>
---
 docs/examples/shading/plot_martinez_shade_loss.py | 3 ---
 1 file changed, 3 deletions(-)

diff --git a/docs/examples/shading/plot_martinez_shade_loss.py b/docs/examples/shading/plot_martinez_shade_loss.py
index aee49d774a..c7f5505e4e 100644
--- a/docs/examples/shading/plot_martinez_shade_loss.py
+++ b/docs/examples/shading/plot_martinez_shade_loss.py
@@ -1,9 +1,6 @@
 """
 Modelling irradiance loss due to module shading in non-monolithic modules
 =========================================================================
-
-Demonstrates how to model direct irradiance loss due to shading in PV modules
-with bypass diodes.
 """
 
 # %%

From b20c53531e3238facb01d05c45e8fef8dca9eefc Mon Sep 17 00:00:00 2001
From: echedey-ls <80125792+echedey-ls@users.noreply.github.com>
Date: Mon, 3 Jun 2024 19:17:46 +0200
Subject: [PATCH 155/185] Change example title

Co-Authored-By: Cliff Hansen <5393711+cwhanse@users.noreply.github.com>
---
 docs/examples/shading/plot_martinez_shade_loss.py | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/docs/examples/shading/plot_martinez_shade_loss.py b/docs/examples/shading/plot_martinez_shade_loss.py
index c7f5505e4e..5eb5d1b3f6 100644
--- a/docs/examples/shading/plot_martinez_shade_loss.py
+++ b/docs/examples/shading/plot_martinez_shade_loss.py
@@ -1,7 +1,7 @@
 """
-Modelling irradiance loss due to module shading in non-monolithic modules
-=========================================================================
-"""
+Modelling irradiance loss due to of direct irradiance in modules with bypass diodes
+===================================================================================
+"""  # noqa: E501
 
 # %%
 # This example illustrates how to use the proposed by Martinez et al. [1]_.

From 820ffbf3be4a0de54742dce902ef7cdf62cad814 Mon Sep 17 00:00:00 2001
From: echedey-ls <80125792+echedey-ls@users.noreply.github.com>
Date: Mon, 3 Jun 2024 19:18:01 +0200
Subject: [PATCH 156/185] Ints for number of blocks

Co-Authored-By: Cliff Hansen <5393711+cwhanse@users.noreply.github.com>
---
 pvlib/shading.py | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/pvlib/shading.py b/pvlib/shading.py
index 13633ef49b..18304fd7aa 100644
--- a/pvlib/shading.py
+++ b/pvlib/shading.py
@@ -570,10 +570,10 @@ def direct_martinez(shaded_fraction, shaded_blocks, total_blocks):
         some functions may only return a 1D shaded fraction, e.g.,
         :py:func:`pvlib.shading.shaded_fraction1d`. Unitless.
     shaded_blocks : numeric
-        Number of blocks affected by the shadow. Unitless integer.
+        Number of blocks affected by the shadow. Unitless.
         If a floating point number is provided, it will be rounded up.
-    total_blocks : numeric
-        Number of total blocks. Unitless integer.
+    total_blocks : int
+        Number of total blocks. Unitless.
 
     Returns
     -------

From 46df5449ad7b59f1789cb655a16f4248ce6ac1ca Mon Sep 17 00:00:00 2001
From: echedey-ls <80125792+echedey-ls@users.noreply.github.com>
Date: Mon, 3 Jun 2024 19:18:17 +0200
Subject: [PATCH 157/185] Rephrasing of shaded fraction 2D

Co-Authored-By: Cliff Hansen <5393711+cwhanse@users.noreply.github.com>
---
 pvlib/shading.py | 4 +---
 1 file changed, 1 insertion(+), 3 deletions(-)

diff --git a/pvlib/shading.py b/pvlib/shading.py
index 18304fd7aa..a3c8ccf7cc 100644
--- a/pvlib/shading.py
+++ b/pvlib/shading.py
@@ -566,9 +566,7 @@ def direct_martinez(shaded_fraction, shaded_blocks, total_blocks):
     Parameters
     ----------
     shaded_fraction : numeric
-        Surface shaded fraction, with respect to the whole area (2D). Note that
-        some functions may only return a 1D shaded fraction, e.g.,
-        :py:func:`pvlib.shading.shaded_fraction1d`. Unitless.
+        Fraction of module surface area that is shaded. Unitless.
     shaded_blocks : numeric
         Number of blocks affected by the shadow. Unitless.
         If a floating point number is provided, it will be rounded up.

From d7a5cad606b67f7997e89ec5f47a1c0fef714c20 Mon Sep 17 00:00:00 2001
From: echedey-ls <80125792+echedey-ls@users.noreply.github.com>
Date: Wed, 12 Jun 2024 11:02:40 +0200
Subject: [PATCH 158/185] typo

---
 docs/examples/shading/plot_martinez_shade_loss.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/examples/shading/plot_martinez_shade_loss.py b/docs/examples/shading/plot_martinez_shade_loss.py
index 5eb5d1b3f6..2460182049 100644
--- a/docs/examples/shading/plot_martinez_shade_loss.py
+++ b/docs/examples/shading/plot_martinez_shade_loss.py
@@ -155,7 +155,7 @@
 #
 #    Left: common module layout. Right: half-cut cells module layout.
 #    Each module has three bypass diodes. On the left, they connect cell
-#    columns 1-2, 2-3 & 3-4. On the right, they connect cell rows 1-2, 3-4 &
+#    columns 1-2, 2-3 & 3-4. On the right, they connect cell columns 1-2, 3-4 &
 #    5-6.
 #    *Source: César Domínguez. CC BY-SA 4.0, Wikimedia Commons*
 #

From 6e030aacb388a9696ac47781d171b5d6384f4bad Mon Sep 17 00:00:00 2001
From: echedey-ls <80125792+echedey-ls@users.noreply.github.com>
Date: Wed, 12 Jun 2024 11:14:03 +0200
Subject: [PATCH 159/185] Code review from Ioannis

Co-Authored-By: Ioannis Sifnaios <88548539+IoannisSifnaios@users.noreply.github.com>
---
 .../shading/plot_martinez_shade_loss.py       | 53 ++++++++++---------
 pvlib/shading.py                              | 13 +++--
 2 files changed, 36 insertions(+), 30 deletions(-)

diff --git a/docs/examples/shading/plot_martinez_shade_loss.py b/docs/examples/shading/plot_martinez_shade_loss.py
index 2460182049..58940fbb57 100644
--- a/docs/examples/shading/plot_martinez_shade_loss.py
+++ b/docs/examples/shading/plot_martinez_shade_loss.py
@@ -1,21 +1,21 @@
 """
-Modelling irradiance loss due to of direct irradiance in modules with bypass diodes
-===================================================================================
+Modelling shading losses in modules with bypass diodes
+======================================================
 """  # noqa: E501
 
 # %%
-# This example illustrates how to use the proposed by Martinez et al. [1]_.
-# The model adjusts the incident direct and circumsolar beam irradiance of a
-# PV module based on the number
+# This example illustrates how to use the model proposed by Martinez et al.
+# [1]_. The model adjusts the incident direct and circumsolar beam irradiance
+# of a PV module based on the number
 # of shaded *blocks*. A *block* is defined as a group of cells protected by a
-# bypass diode. More information on the *blocks* can be found in the original
-# paper [1]_ and in :py:func:`pvlib.shading.direct_martinez`
+# bypass diode. More information on *blocks* can be found in the original
+# paper [1]_ and in the :py:func:`pvlib.shading.direct_martinez`
 # documentation.
 #
 # The following key functions are used in this example:
 #
 # 1. :py:func:`pvlib.shading.direct_martinez` to calculate the adjustment
-#    factor for the output power.
+#    factor for incident beam and circumsolar irradiance.
 # 2. :py:func:`pvlib.shading.shaded_fraction1d` to calculate the fraction of
 #    shaded surface and consequently the number of shaded *blocks* due to
 #    row-to-row shading.
@@ -24,19 +24,13 @@
 #
 # .. sectionauthor:: Echedey Luis <echelual (at) gmail.com>
 #
-# References
-# ----------
-# .. [1] F. Martínez-Moreno, J. Muñoz, and E. Lorenzo, 'Experimental model
-#    to estimate shading losses on PV arrays', Solar Energy Materials and
-#    Solar Cells, vol. 94, no. 12, pp. 2298-2303, Dec. 2010,
-#    :doi:`10.1016/j.solmat.2010.07.029`.
-#
 # Problem description
 # -------------------
 # Let's consider a PV system with the following characteristics:
 #
-# - Two north-south single-axis tracker with 6 modules each one.
-# - The rows have the same true-tracking tilt angles. Let's consider
+# - Two north-south single-axis trackers, each one having 6 modules.
+# - The rows have the same true-tracking tilt angles. True tracking
+#   is chosen in this example, so shading is significant.
 #   true-tracking so shade is significant for this example.
 # - Terrain slope is 7 degrees downward to the east.
 # - Rows' axes are horizontal.
@@ -58,7 +52,7 @@
 
 pitch = 4  # meters
 width = 1.5  # meters
-gcr = width / pitch
+gcr = width / pitch  # ground coverage ratio
 N_modules_per_row = 6
 axis_azimuth = 180  # N-S axis
 axis_tilt = 0  # flat because the axis is perpendicular to the slope
@@ -135,7 +129,7 @@
 # On the other hand, modules with three bypass diodes will have three blocks,
 # except for the half-cut cell modules, which will have six blocks; 2x3 blocks
 # where the two rows are along the longest side of the module.
-# We can argue that the dimensions of the system changes when you switch from
+# We can argue that the dimensions of the system change when you switch from
 # portrait to landscape, but for this example, we will consider it the same.
 #
 # The number of shaded blocks is calculated by rounding up the shaded fraction
@@ -159,7 +153,7 @@
 #    5-6.
 #    *Source: César Domínguez. CC BY-SA 4.0, Wikimedia Commons*
 #
-# In the upper image, each orange U-shaped section of the string is a block.
+# In the image above, each orange U-shaped string section is a block.
 # By symmetry, the yellow inverted-U's of the subcircuit are also blocks.
 # For this reason, the half-cut cell modules have 6 blocks in total: two along
 # the longest side and three along the shortest side.
@@ -181,10 +175,11 @@
 # Results
 # -------
 # Now that we have the number of shaded blocks for each module configuration,
-# we can apply the model and estimate the power loss due to shading.
+# we can apply the model and estimate the direct irradiance loss due to
+# shading.
 #
-# Note this model is not linear with the shaded blocks ratio, so there is a
-# difference between applying it to just a module or a whole row.
+# Note that this model is not linear with the shaded blocks ratio, so there is
+# a difference between applying it to just a module or a whole row.
 
 shade_factor_per_module = {
     k: pvlib.shading.direct_martinez(
@@ -203,7 +198,7 @@
 }
 
 fig, (ax1, ax2) = plt.subplots(2, 1, sharex=True)
-fig.suptitle("Martinez power correction factor due to shading")
+fig.suptitle("Martinez irradiance correction factor due to shading")
 for k, shade_factor in shade_factor_per_module.items():
     linestyle = "--" if k == "3 bypass diodes half-cut, landscape" else "-"
     ax1.plot(times, shade_factor, label=k, linestyle=linestyle)
@@ -213,7 +208,7 @@
 ax1.xaxis.set_major_formatter(
     ConciseDateFormatter("%H:%M", tz="Europe/Madrid")
 )
-ax1.set_ylabel("Power correction factor")
+ax1.set_ylabel(r"$POA_{direct}$ correction factor")
 ax1.set_title("Per module")
 
 for k, shade_factor in shade_factor_per_row.items():
@@ -225,7 +220,7 @@
 ax2.xaxis.set_major_formatter(
     ConciseDateFormatter("%H:%M", tz="Europe/Madrid")
 )
-ax2.set_ylabel("Power correction factor")
+ax2.set_ylabel(r"$POA_{direct}$ correction factor")
 ax2.set_title("Per row")
 fig.tight_layout()
 fig.show()
@@ -238,3 +233,9 @@
 # orientation.
 
 # %%
+# References
+# ----------
+# .. [1] F. Martínez-Moreno, J. Muñoz, and E. Lorenzo, 'Experimental model
+#    to estimate shading losses on PV arrays', Solar Energy Materials and
+#    Solar Cells, vol. 94, no. 12, pp. 2298-2303, Dec. 2010,
+#    :doi:`10.1016/j.solmat.2010.07.029`.
diff --git a/pvlib/shading.py b/pvlib/shading.py
index a3c8ccf7cc..deaf6427d0 100644
--- a/pvlib/shading.py
+++ b/pvlib/shading.py
@@ -596,9 +596,9 @@ def direct_martinez(shaded_fraction, shaded_blocks, total_blocks):
     [1]_ defines a *block* as a group of solar cells protected by a bypass
     diode. Also, a *block* is shaded when at least one of its cells is shaded.
 
-    How many blocks and their layout depend on the module(s) used. Many
-    manufacturers don't specify this information explicitly. However, we can
-    infer these values from:
+    The total number of blocks and their layout depend on the module(s) used.
+    Many manufacturers don't specify this information explicitly.
+    However, we can infer these values from:
 
     - the number of bypass diodes
     - where and how many junction boxes are present on the back of the module
@@ -627,13 +627,18 @@ def direct_martinez(shaded_fraction, shaded_blocks, total_blocks):
     >>> total_blocks = 3  # blocks along the vertical of the module
     >>> POA_direct = 600  # W
     >>> POA_diffuse = 80  # W
+    >>> # calculation of the shaded fraction for the collector
     >>> shaded_fraction = shading.shaded_fraction1d(
-    >>>     80, 180, 90, 25,
+    >>>     solar_zenith=80, solar_azimuth=180,
+    >>>     axis_azimuth=90, shaded_row_rotation=25,
     >>>     collector_width=0.5, pitch=1, surface_to_axis_offset=0,
     >>>     cross_axis_slope=5.711, shading_row_rotation=50)
+    >>> # calculation of the number of shaded blocks
     >>> shaded_blocks = np.ceil(total_blocks*shaded_fraction)
+    >>> # apply the Martinez correction to the calculated shading
     >>> loss_correction = shading.direct_martinez(
     >>>     shaded_fraction, shaded_blocks, total_blocks)
+    >>> # calculation of the POA for the corrected direct irradiance
     >>> POA_total = POA_direct * loss_correction + POA_diffuse
 
     See Also

From b0b4e7cae70cc04c736db9ec4dae9bc00fd75cc0 Mon Sep 17 00:00:00 2001
From: echedey-ls <80125792+echedey-ls@users.noreply.github.com>
Date: Wed, 12 Jun 2024 11:15:38 +0200
Subject: [PATCH 160/185] no more noqa e501

---
 docs/examples/shading/plot_martinez_shade_loss.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/examples/shading/plot_martinez_shade_loss.py b/docs/examples/shading/plot_martinez_shade_loss.py
index 58940fbb57..bf4e265709 100644
--- a/docs/examples/shading/plot_martinez_shade_loss.py
+++ b/docs/examples/shading/plot_martinez_shade_loss.py
@@ -1,7 +1,7 @@
 """
 Modelling shading losses in modules with bypass diodes
 ======================================================
-"""  # noqa: E501
+"""
 
 # %%
 # This example illustrates how to use the model proposed by Martinez et al.

From dee5d4939efbfa4dc3da2b051e8f5a46647b3389 Mon Sep 17 00:00:00 2001
From: echedey-ls <80125792+echedey-ls@users.noreply.github.com>
Date: Wed, 12 Jun 2024 11:58:00 +0200
Subject: [PATCH 161/185] Will this work to hide code?

---
 docs/examples/shading/plot_martinez_shade_loss.py | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/docs/examples/shading/plot_martinez_shade_loss.py b/docs/examples/shading/plot_martinez_shade_loss.py
index bf4e265709..d68a4616b3 100644
--- a/docs/examples/shading/plot_martinez_shade_loss.py
+++ b/docs/examples/shading/plot_martinez_shade_loss.py
@@ -197,6 +197,12 @@
     for k, module_shaded_blocks in shaded_blocks_per_module.items()
 }
 
+# %%
+# .. raw:: html
+#
+#    <details>
+#    <summary><a>See plot code</a></summary>
+
 fig, (ax1, ax2) = plt.subplots(2, 1, sharex=True)
 fig.suptitle("Martinez irradiance correction factor due to shading")
 for k, shade_factor in shade_factor_per_module.items():
@@ -225,6 +231,11 @@
 fig.tight_layout()
 fig.show()
 
+# %%
+# .. raw:: html
+#
+#    </details>
+
 # %%
 # Note how the half-cut cell module in portrait behaves worse that the
 # normal module with three bypass diodes. This is because the number of shaded

From 14fe99394020b6e0e05aaf629506efb7b6b90e69 Mon Sep 17 00:00:00 2001
From: echedey-ls <80125792+echedey-ls@users.noreply.github.com>
Date: Wed, 12 Jun 2024 12:10:06 +0200
Subject: [PATCH 162/185] Update plot_martinez_shade_loss.py

Co-Authored-By: Ioannis Sifnaios <88548539+IoannisSifnaios@users.noreply.github.com>
---
 docs/examples/shading/plot_martinez_shade_loss.py | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/docs/examples/shading/plot_martinez_shade_loss.py b/docs/examples/shading/plot_martinez_shade_loss.py
index d68a4616b3..e4e8f325b1 100644
--- a/docs/examples/shading/plot_martinez_shade_loss.py
+++ b/docs/examples/shading/plot_martinez_shade_loss.py
@@ -229,13 +229,14 @@
 ax2.set_ylabel(r"$POA_{direct}$ correction factor")
 ax2.set_title("Per row")
 fig.tight_layout()
-fig.show()
 
 # %%
 # .. raw:: html
 #
 #    </details>
 
+fig.show()
+
 # %%
 # Note how the half-cut cell module in portrait behaves worse that the
 # normal module with three bypass diodes. This is because the number of shaded

From 94c2d23e4802c04a8aa0ab64f99dba675daf0bf2 Mon Sep 17 00:00:00 2001
From: echedey-ls <80125792+echedey-ls@users.noreply.github.com>
Date: Wed, 12 Jun 2024 12:17:29 +0200
Subject: [PATCH 163/185] play time with the matplotlib statements

Co-Authored-By: Ioannis Sifnaios <88548539+IoannisSifnaios@users.noreply.github.com>
---
 docs/examples/shading/plot_martinez_shade_loss.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/examples/shading/plot_martinez_shade_loss.py b/docs/examples/shading/plot_martinez_shade_loss.py
index e4e8f325b1..e98b54f5bc 100644
--- a/docs/examples/shading/plot_martinez_shade_loss.py
+++ b/docs/examples/shading/plot_martinez_shade_loss.py
@@ -228,13 +228,13 @@
 )
 ax2.set_ylabel(r"$POA_{direct}$ correction factor")
 ax2.set_title("Per row")
-fig.tight_layout()
 
 # %%
 # .. raw:: html
 #
 #    </details>
 
+fig.tight_layout()
 fig.show()
 
 # %%

From e70090fed40e93afb477b3ac9539d071a25c9403 Mon Sep 17 00:00:00 2001
From: echedey-ls <80125792+echedey-ls@users.noreply.github.com>
Date: Wed, 12 Jun 2024 15:09:36 +0200
Subject: [PATCH 164/185] This fixes it (I believe :pray: )

CC @IoannisSifnaios

Co-Authored-By: Ioannis Sifnaios <88548539+IoannisSifnaios@users.noreply.github.com>
---
 docs/examples/shading/plot_martinez_shade_loss.py | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/docs/examples/shading/plot_martinez_shade_loss.py b/docs/examples/shading/plot_martinez_shade_loss.py
index e98b54f5bc..944bce2edc 100644
--- a/docs/examples/shading/plot_martinez_shade_loss.py
+++ b/docs/examples/shading/plot_martinez_shade_loss.py
@@ -203,6 +203,7 @@
 #    <details>
 #    <summary><a>See plot code</a></summary>
 
+plt.ioff()
 fig, (ax1, ax2) = plt.subplots(2, 1, sharex=True)
 fig.suptitle("Martinez irradiance correction factor due to shading")
 for k, shade_factor in shade_factor_per_module.items():
@@ -228,14 +229,15 @@
 )
 ax2.set_ylabel(r"$POA_{direct}$ correction factor")
 ax2.set_title("Per row")
+fig.tight_layout()
 
 # %%
 # .. raw:: html
 #
 #    </details>
 
-fig.tight_layout()
-fig.show()
+plt.ion()
+fig
 
 # %%
 # Note how the half-cut cell module in portrait behaves worse that the

From 69e6771057fbbd387fa80e2646bd99d02eed52cb Mon Sep 17 00:00:00 2001
From: echedey-ls <80125792+echedey-ls@users.noreply.github.com>
Date: Wed, 12 Jun 2024 15:20:34 +0200
Subject: [PATCH 165/185] Update plot_martinez_shade_loss.py

Co-Authored-By: Ioannis Sifnaios <88548539+IoannisSifnaios@users.noreply.github.com>
---
 docs/examples/shading/plot_martinez_shade_loss.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/examples/shading/plot_martinez_shade_loss.py b/docs/examples/shading/plot_martinez_shade_loss.py
index 944bce2edc..3007497f8a 100644
--- a/docs/examples/shading/plot_martinez_shade_loss.py
+++ b/docs/examples/shading/plot_martinez_shade_loss.py
@@ -237,7 +237,7 @@
 #    </details>
 
 plt.ion()
-fig
+display(fig)
 
 # %%
 # Note how the half-cut cell module in portrait behaves worse that the

From dc4fbc02fc3ed2ec88f417823ab03631bc332419 Mon Sep 17 00:00:00 2001
From: echedey-ls <80125792+echedey-ls@users.noreply.github.com>
Date: Wed, 12 Jun 2024 15:56:16 +0200
Subject: [PATCH 166/185] Nah, let's see how this does

Co-Authored-By: Ioannis Sifnaios <88548539+IoannisSifnaios@users.noreply.github.com>
---
 docs/examples/shading/plot_martinez_shade_loss.py | 5 ++---
 1 file changed, 2 insertions(+), 3 deletions(-)

diff --git a/docs/examples/shading/plot_martinez_shade_loss.py b/docs/examples/shading/plot_martinez_shade_loss.py
index 3007497f8a..496dc7568e 100644
--- a/docs/examples/shading/plot_martinez_shade_loss.py
+++ b/docs/examples/shading/plot_martinez_shade_loss.py
@@ -229,15 +229,14 @@
 )
 ax2.set_ylabel(r"$POA_{direct}$ correction factor")
 ax2.set_title("Per row")
-fig.tight_layout()
+_ = fig.tight_layout()
 
 # %%
 # .. raw:: html
 #
 #    </details>
 
-plt.ion()
-display(fig)
+fig
 
 # %%
 # Note how the half-cut cell module in portrait behaves worse that the

From b071ba40615ef42a711199c5c4d1b697f7045c07 Mon Sep 17 00:00:00 2001
From: echedey-ls <80125792+echedey-ls@users.noreply.github.com>
Date: Wed, 12 Jun 2024 16:05:01 +0200
Subject: [PATCH 167/185] Revert attempt to colapse code

It doesn't work because sphinx-gallery closes the figure at the end of the cell
https://github.com/sphinx-gallery/sphinx-gallery/issues/240

CC @IoannisSifnaios

Co-Authored-By: Ioannis Sifnaios <88548539+IoannisSifnaios@users.noreply.github.com>
---
 .../shading/plot_martinez_shade_loss.py         | 17 ++++-------------
 1 file changed, 4 insertions(+), 13 deletions(-)

diff --git a/docs/examples/shading/plot_martinez_shade_loss.py b/docs/examples/shading/plot_martinez_shade_loss.py
index 496dc7568e..da34f5dd24 100644
--- a/docs/examples/shading/plot_martinez_shade_loss.py
+++ b/docs/examples/shading/plot_martinez_shade_loss.py
@@ -198,12 +198,9 @@
 }
 
 # %%
-# .. raw:: html
-#
-#    <details>
-#    <summary><a>See plot code</a></summary>
+# Plotting the results
+# ^^^^^^^^^^^^^^^^^^^^
 
-plt.ioff()
 fig, (ax1, ax2) = plt.subplots(2, 1, sharex=True)
 fig.suptitle("Martinez irradiance correction factor due to shading")
 for k, shade_factor in shade_factor_per_module.items():
@@ -229,14 +226,8 @@
 )
 ax2.set_ylabel(r"$POA_{direct}$ correction factor")
 ax2.set_title("Per row")
-_ = fig.tight_layout()
-
-# %%
-# .. raw:: html
-#
-#    </details>
-
-fig
+fig.tight_layout()
+fig.show()
 
 # %%
 # Note how the half-cut cell module in portrait behaves worse that the

From 192a0395572709d36ab37b0ce6a1c0e0fae7e741 Mon Sep 17 00:00:00 2001
From: echedey-ls <80125792+echedey-ls@users.noreply.github.com>
Date: Sat, 15 Jun 2024 20:36:18 +0200
Subject: [PATCH 168/185] Power losses model

Co-Authored-By: Kevin Anderson <57452607+kandersolar@users.noreply.github.com>
Co-Authored-By: Cliff Hansen <5393711+cwhanse@users.noreply.github.com>
Co-Authored-By: Ioannis Sifnaios <88548539+IoannisSifnaios@users.noreply.github.com>
---
 .../shading/plot_martinez_shade_loss.py       | 70 +++++++++++++------
 pvlib/shading.py                              | 58 +++++++++++----
 pvlib/tests/test_shading.py                   | 64 ++++++++---------
 3 files changed, 122 insertions(+), 70 deletions(-)

diff --git a/docs/examples/shading/plot_martinez_shade_loss.py b/docs/examples/shading/plot_martinez_shade_loss.py
index da34f5dd24..978e68f6e8 100644
--- a/docs/examples/shading/plot_martinez_shade_loss.py
+++ b/docs/examples/shading/plot_martinez_shade_loss.py
@@ -5,17 +5,17 @@
 
 # %%
 # This example illustrates how to use the model proposed by Martinez et al.
-# [1]_. The model adjusts the incident direct and circumsolar beam irradiance
-# of a PV module based on the number
-# of shaded *blocks*. A *block* is defined as a group of cells protected by a
-# bypass diode. More information on *blocks* can be found in the original
-# paper [1]_ and in the :py:func:`pvlib.shading.direct_martinez`
-# documentation.
+# [1]_. The model proposes a power output losses factor by adjusting
+# the incident direct and circumsolar beam irradiance fraction of a PV module
+# based on the number of shaded *blocks*. A *block* is defined as a group of
+# cells protected by a bypass diode. More information on *blocks* can be found
+# in the original paper [1]_ and in the
+# :py:func:`pvlib.shading.direct_martinez` documentation.
 #
 # The following key functions are used in this example:
 #
-# 1. :py:func:`pvlib.shading.direct_martinez` to calculate the adjustment
-#    factor for incident beam and circumsolar irradiance.
+# 1. :py:func:`pvlib.shading.direct_martinez` to calculate the power output
+#    losses fraction due to shading.
 # 2. :py:func:`pvlib.shading.shaded_fraction1d` to calculate the fraction of
 #    shaded surface and consequently the number of shaded *blocks* due to
 #    row-to-row shading.
@@ -120,6 +120,27 @@
     cross_axis_slope=cross_axis_tilt,
 )
 
+clearsky = locus.get_clearsky(
+    times, solar_position=solar_pos, model="ineichen"
+)
+dhi, dni = (
+    clearsky["dhi"],
+    clearsky["dni"],
+)
+dni_extra = pvlib.irradiance.get_extra_radiation(times)
+airmass = pvlib.atmosphere.get_relative_airmass(solar_apparent_zenith)
+sky_diffuse = pvlib.irradiance.perez_driesse(
+    surface_tilt, surface_azimuth, dhi, dni,
+    solar_apparent_zenith, solar_azimuth, dni_extra, airmass,
+)  # fmt: skip
+poa_components = pvlib.irradiance.poa_components(
+    aoi, dni, sky_diffuse, poa_ground_diffuse=0
+)  # ignore ground diffuse for brevity
+poa_global, poa_direct_and_circumsolar = (
+    poa_components["poa_global"],
+    poa_components["poa_direct"],
+)
+
 # %%
 # Number of shaded blocks
 # -----------------------
@@ -175,21 +196,26 @@
 # Results
 # -------
 # Now that we have the number of shaded blocks for each module configuration,
-# we can apply the model and estimate the direct irradiance loss due to
-# shading.
+# we can apply the model and estimate the power loss due to shading.
 #
 # Note that this model is not linear with the shaded blocks ratio, so there is
 # a difference between applying it to just a module or a whole row.
 
-shade_factor_per_module = {
+shade_losses_per_module = {
     k: pvlib.shading.direct_martinez(
-        shaded_fraction, module_shaded_blocks, blocks_per_module[k]
+        poa_global,
+        poa_direct_and_circumsolar,
+        shaded_fraction,
+        module_shaded_blocks,
+        blocks_per_module[k],
     )
     for k, module_shaded_blocks in shaded_blocks_per_module.items()
 }
 
-shade_factor_per_row = {
+shade_losses_per_row = {
     k: pvlib.shading.direct_martinez(
+        poa_global,
+        poa_direct_and_circumsolar,
         shaded_fraction,
         module_shaded_blocks * N_modules_per_row,
         blocks_per_module[k] * N_modules_per_row,
@@ -202,29 +228,29 @@
 # ^^^^^^^^^^^^^^^^^^^^
 
 fig, (ax1, ax2) = plt.subplots(2, 1, sharex=True)
-fig.suptitle("Martinez irradiance correction factor due to shading")
-for k, shade_factor in shade_factor_per_module.items():
+fig.suptitle("Martinez power losses due to shading")
+for k, shade_losses in shade_losses_per_module.items():
     linestyle = "--" if k == "3 bypass diodes half-cut, landscape" else "-"
-    ax1.plot(times, shade_factor, label=k, linestyle=linestyle)
-ax1.legend()
+    ax1.plot(times, shade_losses, label=k, linestyle=linestyle)
+ax1.legend(loc="upper center")
 ax1.grid()
 ax1.set_xlabel("Time")
 ax1.xaxis.set_major_formatter(
     ConciseDateFormatter("%H:%M", tz="Europe/Madrid")
 )
-ax1.set_ylabel(r"$POA_{direct}$ correction factor")
+ax1.set_ylabel(r"$P_{out}$ losses")
 ax1.set_title("Per module")
 
-for k, shade_factor in shade_factor_per_row.items():
+for k, shade_losses in shade_losses_per_row.items():
     linestyle = "--" if k == "3 bypass diodes half-cut, landscape" else "-"
-    ax2.plot(times, shade_factor, label=k, linestyle=linestyle)
-ax2.legend()
+    ax2.plot(times, shade_losses, label=k, linestyle=linestyle)
+ax2.legend(loc="upper center")
 ax2.grid()
 ax2.set_xlabel("Time")
 ax2.xaxis.set_major_formatter(
     ConciseDateFormatter("%H:%M", tz="Europe/Madrid")
 )
-ax2.set_ylabel(r"$POA_{direct}$ correction factor")
+ax2.set_ylabel(r"$P_{out}$ losses")
 ax2.set_title("Per row")
 fig.tight_layout()
 fig.show()
diff --git a/pvlib/shading.py b/pvlib/shading.py
index deaf6427d0..feb9baf21e 100644
--- a/pvlib/shading.py
+++ b/pvlib/shading.py
@@ -555,12 +555,21 @@ def shaded_fraction1d(
     return np.clip(t_asterisk, 0, 1)
 
 
-def direct_martinez(shaded_fraction, shaded_blocks, total_blocks):
+def direct_martinez(
+    poa_global,
+    poa_direct_and_circumsolar,
+    shaded_fraction,
+    shaded_blocks,
+    total_blocks,
+):
     r"""
-    A shading correction factor for the direct and circumsolar incident
-    irradiance of non-monolithic Silicon
+    A shading losses power factor for non-monolithic Silicon
     modules and arrays with an arbitrary number of bypass diodes.
 
+    This experimental model cancels a fraction of the direct and circumsolar
+    irradiance based on the number of *blocks* affected by the shadow.
+    More on blocks in the *Notes* section and in [1]_.
+
     .. versionadded:: 0.11.0
 
     Parameters
@@ -575,22 +584,34 @@ def direct_martinez(shaded_fraction, shaded_blocks, total_blocks):
 
     Returns
     -------
-    shading_correction_factor : numeric
-        Multiply direct and circumsolar irradiance by this factor.
+    shading_losses : numeric
+        Multiply unshaded output power by 1 minus this value.
 
     Notes
     -----
-    The implemented equation is (6) from [1]_:
+    The implemented equations are (6) and (8) from [1]_:
 
     .. math::
 
         (1 - F_{ES}) = (1 - F_{GS}) (1 - \frac{N_{SB}}{N_{TB} + 1})
+        \quad \text{(6)}
 
-    Where :math:`(1 - F_{ES})` is the correction factor to be multiplied by
+        (1 - \frac{P_{S}}{P_{NS}}) = \left(1 -
+        \frac{\left[(B + D^{CIR})(1 - F_{ES}) + D^{ISO} + R\right]}{G}\right)
+        \quad \text{(8)}
+
+    In (6), :math:`(1 - F_{ES})` is the correction factor to be multiplied by
     the direct and circumsolar irradiance, :math:`F_{GS}` is the shaded
     fraction of the collector, :math:`N_{SB}` is the number of shaded blocks
     and :math:`N_{TB}` is the number of total blocks.
 
+    In (8), :math:`(1 - \frac{P_{S}}{P_{NS}})` is the power losses factor,
+    :math:`P_{S}` is the power output of the shaded module,
+    :math:`P_{NS}` is the power output of the non-shaded module,
+    :math:`B + D^{CIR}` is the beam and circumsolar irradiance,
+    :math:`D^{ISO} + R` is the sum of diffuse and albedo irradiances and
+    :math:`G` is the global irradiance.
+
     Blocks terminology
     ^^^^^^^^^^^^^^^^^^
     [1]_ defines a *block* as a group of solar cells protected by a bypass
@@ -625,8 +646,9 @@ def direct_martinez(shaded_fraction, shaded_blocks, total_blocks):
     >>> import numpy as np
     >>> from pvlib import shading
     >>> total_blocks = 3  # blocks along the vertical of the module
-    >>> POA_direct = 600  # W
-    >>> POA_diffuse = 80  # W
+    >>> POA_direct_and_circumsolar, POA_diffuse = 600, 80  # W/m²
+    >>> POA_global = POA_direct_and_circumsolar + POA_diffuse
+    >>> P_out_unshaded = 3000  # W
     >>> # calculation of the shaded fraction for the collector
     >>> shaded_fraction = shading.shaded_fraction1d(
     >>>     solar_zenith=80, solar_azimuth=180,
@@ -635,11 +657,11 @@ def direct_martinez(shaded_fraction, shaded_blocks, total_blocks):
     >>>     cross_axis_slope=5.711, shading_row_rotation=50)
     >>> # calculation of the number of shaded blocks
     >>> shaded_blocks = np.ceil(total_blocks*shaded_fraction)
-    >>> # apply the Martinez correction to the calculated shading
-    >>> loss_correction = shading.direct_martinez(
+    >>> # apply the Martinez power losses to the calculated shading
+    >>> power_loss = shading.direct_martinez(
+    >>>     POA_global, POA_direct_and_circumsolar,
     >>>     shaded_fraction, shaded_blocks, total_blocks)
-    >>> # calculation of the POA for the corrected direct irradiance
-    >>> POA_total = POA_direct * loss_correction + POA_diffuse
+    >>> P_out_corrected = P_out_unshaded * (1 - power_loss)
 
     See Also
     --------
@@ -652,7 +674,15 @@ def direct_martinez(shaded_fraction, shaded_blocks, total_blocks):
         Solar Cells, vol. 94, no. 12, pp. 2298-2303, Dec. 2010,
         :doi:`10.1016/j.solmat.2010.07.029`.
     """  # Contributed by Echedey Luis, 2024
-    return (  # Eq. (6) of [1]
+    beam_factor = (  # Eq. (6) of [1]
         (1 - shaded_fraction)
         * (1 - np.ceil(shaded_blocks) / (1 + total_blocks))
     )
+    return (  # Eq. (8) of [1]
+        1
+        - (
+            poa_direct_and_circumsolar * beam_factor
+            + (poa_global - poa_direct_and_circumsolar)  # diffuse and albedo
+        )
+        / poa_global
+    )
diff --git a/pvlib/tests/test_shading.py b/pvlib/tests/test_shading.py
index 18b8f310f6..b93434142b 100644
--- a/pvlib/tests/test_shading.py
+++ b/pvlib/tests/test_shading.py
@@ -332,56 +332,52 @@ def test_shaded_fraction1d_unprovided_shading_row_rotation():
 @pytest.fixture
 def direct_martinez_Table2():
     """
-    Original data used in [1] (see shading.direct_martinez) to validate
-    the model. Some of the data is provided from Table 2.
+    Original data used in [1] (see pvlib.shading.direct_martinez) to validate
+    the model. Some of the data is provided in Table 2.
     Returns tuple with (input: pandas.DataFrame, output: pandas.Series)
-    Output is IRRADIANCE LOSS, not IRRADIANCE CORRECTION, so model result must
-    be subtracted from 1
+    Output is power loss: 1 - (P_shaded / P_unshaded)
     """
     test_data = pd.DataFrame(
         columns=[
             "F_GS-H",
             "F_GS-V",
             "shaded_blocks",
-            "direct",
-            "diffuse",
-            "irrad_correction",
+            "poa_direct_and_circumsolar",
+            "poa_diffuse",
+            "power_loss_model",
         ],
         data=[
-            # F-H, F-V, Nsb, direct, diffuse, irrad_correction
-            [1.00, 0.09, 16, 846.59, 59.42, 0.88],
-            [1.00, 0.18, 16, 841.85, 59.69, 0.89],
-            [1.00, 0.36, 16, 843.38, 59.22, 0.90],
-            [0.04, 0.64,  1, 851.90, 59.40, 0.08],
-            [0.17, 0.45,  3, 862.86, 58.40, 0.22],
-            [0.29, 0.27,  5, 864.14, 58.11, 0.33],
-            [0.50, 0.09,  8, 863.23, 58.31, 0.46],
-            [0.13, 1.00,  2, 870.14, 58.02, 0.21],
-            [0.25, 1.00,  4, 876.57, 57.98, 0.40],
-            [0.38, 1.00,  6, 866.86, 58.89, 0.56],
-            [0.50, 1.00,  8, 874.58, 58.44, 0.69],
-            [0.58, 0.82, 10, 876.80, 58.16, 0.74],
-            [0.75, 0.73, 12, 866.89, 58.73, 0.81],
-            [0.92, 0.64, 15, 861.48, 59.66, 0.89],
+            # F-H, F-V, Nsb, direct, diffuse, power_loss
+            [1.00, 0.09, 16, 846.59, 59.42, 0.8844],
+            [1.00, 0.18, 16, 841.85, 59.69, 0.8888],
+            [1.00, 0.36, 16, 843.38, 59.22, 0.8994],
+            [0.04, 0.64,  1, 851.90, 59.40, 0.0783],
+            [0.17, 0.45,  3, 862.86, 58.40, 0.2237],
+            [0.29, 0.27,  5, 864.14, 58.11, 0.3282],
+            [0.50, 0.09,  8, 863.23, 58.31, 0.4634],
+            [0.13, 1.00,  2, 870.14, 58.02, 0.2137],
+            [0.25, 1.00,  4, 876.57, 57.98, 0.4000],
+            [0.38, 1.00,  6, 866.86, 58.89, 0.5577],
+            [0.50, 1.00,  8, 874.58, 58.44, 0.6892],
+            [0.58, 0.82, 10, 876.80, 58.16, 0.7359],
+            [0.75, 0.73, 12, 866.89, 58.73, 0.8113],
+            [0.92, 0.64, 15, 861.48, 59.66, 0.8894],
         ]
     )  # fmt: skip
     test_data["total_blocks"] = 16  # total blocks is 16 for all cases
     test_data["shaded_fraction"] = test_data["F_GS-H"] * test_data["F_GS-V"]
-    test_data = test_data.drop(columns=["F_GS-H", "F_GS-V"])
+    test_data["poa_global"] = (
+        test_data["poa_direct_and_circumsolar"] + test_data["poa_diffuse"]
+    )
+    test_data = test_data.drop(columns=["F_GS-H", "F_GS-V", "poa_diffuse"])
     return (
-        test_data.drop(columns="irrad_correction"),
-        test_data["irrad_correction"],
+        test_data.drop(columns="power_loss_model"),
+        test_data["power_loss_model"],
     )
 
 
 def test_direct_martinez(direct_martinez_Table2):
     """Tests pvlib.shading.direct_martinez"""
-    test_data, irrad_reduction_expected = direct_martinez_Table2
-    correction_factor = shading.direct_martinez(
-        **test_data.drop(columns=["direct", "diffuse"])
-    )
-    irrad_correction = 1 - (
-        (test_data["direct"] * correction_factor + test_data["diffuse"])
-        / (test_data["direct"] + test_data["diffuse"])
-    )
-    assert_allclose(irrad_correction, irrad_reduction_expected, atol=1e-2)
+    test_data, power_losses_expected = direct_martinez_Table2
+    power_losses = shading.direct_martinez(**test_data)
+    assert_allclose(power_losses, power_losses_expected, atol=5e-3)

From 91862f591312a7a6544d988d020e6f064c9a3329 Mon Sep 17 00:00:00 2001
From: echedey-ls <80125792+echedey-ls@users.noreply.github.com>
Date: Sat, 15 Jun 2024 20:44:07 +0200
Subject: [PATCH 169/185] equations rendering

---
 pvlib/shading.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/pvlib/shading.py b/pvlib/shading.py
index feb9baf21e..4cda6a7b6f 100644
--- a/pvlib/shading.py
+++ b/pvlib/shading.py
@@ -593,10 +593,10 @@ def direct_martinez(
 
     .. math::
 
-        (1 - F_{ES}) = (1 - F_{GS}) (1 - \frac{N_{SB}}{N_{TB} + 1})
+        (1 - F_{ES}) = (1 - F_{GS}) \left(1 - \frac{N_{SB}}{N_{TB} + 1}\right)
         \quad \text{(6)}
 
-        (1 - \frac{P_{S}}{P_{NS}}) = \left(1 -
+        \left(1 - \frac{P_{S}}{P_{NS}}\right) = \left(1 -
         \frac{\left[(B + D^{CIR})(1 - F_{ES}) + D^{ISO} + R\right]}{G}\right)
         \quad \text{(8)}
 

From 48a90043b57bf64b579fb82cb6430ee5adb6012a Mon Sep 17 00:00:00 2001
From: echedey-ls <80125792+echedey-ls@users.noreply.github.com>
Date: Mon, 17 Jun 2024 23:15:22 +0200
Subject: [PATCH 170/185] Change `poa_direct_and_circumsolar` to `poa_direct`

Co-Authored-By: Kevin Anderson <57452607+kandersolar@users.noreply.github.com>
---
 .../shading/plot_martinez_shade_loss.py       | 22 +++++++++----------
 pvlib/shading.py                              | 10 ++++++---
 pvlib/tests/test_shading.py                   |  4 ++--
 3 files changed, 20 insertions(+), 16 deletions(-)

diff --git a/docs/examples/shading/plot_martinez_shade_loss.py b/docs/examples/shading/plot_martinez_shade_loss.py
index 978e68f6e8..c21248068e 100644
--- a/docs/examples/shading/plot_martinez_shade_loss.py
+++ b/docs/examples/shading/plot_martinez_shade_loss.py
@@ -136,7 +136,7 @@
 poa_components = pvlib.irradiance.poa_components(
     aoi, dni, sky_diffuse, poa_ground_diffuse=0
 )  # ignore ground diffuse for brevity
-poa_global, poa_direct_and_circumsolar = (
+poa_global, poa_direct = (
     poa_components["poa_global"],
     poa_components["poa_direct"],
 )
@@ -203,22 +203,22 @@
 
 shade_losses_per_module = {
     k: pvlib.shading.direct_martinez(
-        poa_global,
-        poa_direct_and_circumsolar,
-        shaded_fraction,
-        module_shaded_blocks,
-        blocks_per_module[k],
+        poa_global=poa_global,
+        poa_direct=poa_direct,
+        shaded_fraction=shaded_fraction,
+        shaded_blocks=module_shaded_blocks,
+        total_blocks=blocks_per_module[k],
     )
     for k, module_shaded_blocks in shaded_blocks_per_module.items()
 }
 
 shade_losses_per_row = {
     k: pvlib.shading.direct_martinez(
-        poa_global,
-        poa_direct_and_circumsolar,
-        shaded_fraction,
-        module_shaded_blocks * N_modules_per_row,
-        blocks_per_module[k] * N_modules_per_row,
+        poa_global=poa_global,
+        poa_direct=poa_direct,
+        shaded_fraction=shaded_fraction,
+        shaded_blocks=module_shaded_blocks * N_modules_per_row,
+        total_blocks=blocks_per_module[k] * N_modules_per_row,
     )
     for k, module_shaded_blocks in shaded_blocks_per_module.items()
 }
diff --git a/pvlib/shading.py b/pvlib/shading.py
index 4cda6a7b6f..71c5f53721 100644
--- a/pvlib/shading.py
+++ b/pvlib/shading.py
@@ -557,7 +557,7 @@ def shaded_fraction1d(
 
 def direct_martinez(
     poa_global,
-    poa_direct_and_circumsolar,
+    poa_direct,
     shaded_fraction,
     shaded_blocks,
     total_blocks,
@@ -574,6 +574,10 @@ def direct_martinez(
 
     Parameters
     ----------
+    poa_global : numeric
+        Plane of array global irradiance. [W/m²].
+    poa_direct : numeric
+        Plane of array direct and circumsolar irradiance. [W/m²].
     shaded_fraction : numeric
         Fraction of module surface area that is shaded. Unitless.
     shaded_blocks : numeric
@@ -681,8 +685,8 @@ def direct_martinez(
     return (  # Eq. (8) of [1]
         1
         - (
-            poa_direct_and_circumsolar * beam_factor
-            + (poa_global - poa_direct_and_circumsolar)  # diffuse and albedo
+            poa_direct * beam_factor
+            + (poa_global - poa_direct)  # diffuse and albedo
         )
         / poa_global
     )
diff --git a/pvlib/tests/test_shading.py b/pvlib/tests/test_shading.py
index b93434142b..2f36f34708 100644
--- a/pvlib/tests/test_shading.py
+++ b/pvlib/tests/test_shading.py
@@ -342,7 +342,7 @@ def direct_martinez_Table2():
             "F_GS-H",
             "F_GS-V",
             "shaded_blocks",
-            "poa_direct_and_circumsolar",
+            "poa_direct",
             "poa_diffuse",
             "power_loss_model",
         ],
@@ -367,7 +367,7 @@ def direct_martinez_Table2():
     test_data["total_blocks"] = 16  # total blocks is 16 for all cases
     test_data["shaded_fraction"] = test_data["F_GS-H"] * test_data["F_GS-V"]
     test_data["poa_global"] = (
-        test_data["poa_direct_and_circumsolar"] + test_data["poa_diffuse"]
+        test_data["poa_direct"] + test_data["poa_diffuse"]
     )
     test_data = test_data.drop(columns=["F_GS-H", "F_GS-V", "poa_diffuse"])
     return (

From 9da4834508228bfa0f013aa4de6b37122666a376 Mon Sep 17 00:00:00 2001
From: echedey-ls <80125792+echedey-ls@users.noreply.github.com>
Date: Tue, 18 Jun 2024 21:55:22 +0200
Subject: [PATCH 171/185] Example link

Co-Authored-By: Kevin Anderson <57452607+kandersolar@users.noreply.github.com>
---
 pvlib/shading.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/pvlib/shading.py b/pvlib/shading.py
index 71c5f53721..a4cf8be4c8 100644
--- a/pvlib/shading.py
+++ b/pvlib/shading.py
@@ -645,7 +645,7 @@ def direct_martinez(
     Examples
     --------
     Minimal example. For a complete example, see
-    `this gallery example <sphx_glr_gallery_plot_martinez_shade_loss.py>`_.
+    :ref:`this gallery example <sphx_glr_gallery_plot_martinez_shade_loss.py>`.
 
     >>> import numpy as np
     >>> from pvlib import shading

From 6ef91b84ec194693f0981a13a890f7a4e70600ba Mon Sep 17 00:00:00 2001
From: echedey-ls <80125792+echedey-ls@users.noreply.github.com>
Date: Tue, 18 Jun 2024 21:56:09 +0200
Subject: [PATCH 172/185] `power_loss` -> `loss_fraction`

Co-Authored-By: Kevin Anderson <57452607+kandersolar@users.noreply.github.com>
---
 pvlib/shading.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/pvlib/shading.py b/pvlib/shading.py
index a4cf8be4c8..9e0f231a5f 100644
--- a/pvlib/shading.py
+++ b/pvlib/shading.py
@@ -662,10 +662,10 @@ def direct_martinez(
     >>> # calculation of the number of shaded blocks
     >>> shaded_blocks = np.ceil(total_blocks*shaded_fraction)
     >>> # apply the Martinez power losses to the calculated shading
-    >>> power_loss = shading.direct_martinez(
+    >>> loss_fraction = shading.direct_martinez(
     >>>     POA_global, POA_direct_and_circumsolar,
     >>>     shaded_fraction, shaded_blocks, total_blocks)
-    >>> P_out_corrected = P_out_unshaded * (1 - power_loss)
+    >>> P_out_corrected = P_out_unshaded * (1 - loss_fraction)
 
     See Also
     --------

From 37d4ca084df15824690cb62d830b0560c336cdd7 Mon Sep 17 00:00:00 2001
From: echedey-ls <80125792+echedey-ls@users.noreply.github.com>
Date: Tue, 18 Jun 2024 21:58:13 +0200
Subject: [PATCH 173/185] Typo when applying Ioannis suggestion

Co-Authored-By: Kevin Anderson <57452607+kandersolar@users.noreply.github.com>
Co-Authored-By: Ioannis Sifnaios <88548539+IoannisSifnaios@users.noreply.github.com>
---
 docs/examples/shading/plot_martinez_shade_loss.py | 1 -
 1 file changed, 1 deletion(-)

diff --git a/docs/examples/shading/plot_martinez_shade_loss.py b/docs/examples/shading/plot_martinez_shade_loss.py
index c21248068e..eec8ff67eb 100644
--- a/docs/examples/shading/plot_martinez_shade_loss.py
+++ b/docs/examples/shading/plot_martinez_shade_loss.py
@@ -31,7 +31,6 @@
 # - Two north-south single-axis trackers, each one having 6 modules.
 # - The rows have the same true-tracking tilt angles. True tracking
 #   is chosen in this example, so shading is significant.
-#   true-tracking so shade is significant for this example.
 # - Terrain slope is 7 degrees downward to the east.
 # - Rows' axes are horizontal.
 # - The modules are comprised of multiple cells. We will compare these cases:

From 329fe23d3b6cbe681c97a368d18566a4b7dd4ed9 Mon Sep 17 00:00:00 2001
From: echedey-ls <80125792+echedey-ls@users.noreply.github.com>
Date: Tue, 18 Jun 2024 22:00:30 +0200
Subject: [PATCH 174/185] Re-arrange POA to its own section in example

Co-Authored-By: Kevin Anderson <57452607+kandersolar@users.noreply.github.com>
---
 .../shading/plot_martinez_shade_loss.py       | 48 +++++++++++--------
 1 file changed, 27 insertions(+), 21 deletions(-)

diff --git a/docs/examples/shading/plot_martinez_shade_loss.py b/docs/examples/shading/plot_martinez_shade_loss.py
index eec8ff67eb..6d2579393e 100644
--- a/docs/examples/shading/plot_martinez_shade_loss.py
+++ b/docs/examples/shading/plot_martinez_shade_loss.py
@@ -119,27 +119,6 @@
     cross_axis_slope=cross_axis_tilt,
 )
 
-clearsky = locus.get_clearsky(
-    times, solar_position=solar_pos, model="ineichen"
-)
-dhi, dni = (
-    clearsky["dhi"],
-    clearsky["dni"],
-)
-dni_extra = pvlib.irradiance.get_extra_radiation(times)
-airmass = pvlib.atmosphere.get_relative_airmass(solar_apparent_zenith)
-sky_diffuse = pvlib.irradiance.perez_driesse(
-    surface_tilt, surface_azimuth, dhi, dni,
-    solar_apparent_zenith, solar_azimuth, dni_extra, airmass,
-)  # fmt: skip
-poa_components = pvlib.irradiance.poa_components(
-    aoi, dni, sky_diffuse, poa_ground_diffuse=0
-)  # ignore ground diffuse for brevity
-poa_global, poa_direct = (
-    poa_components["poa_global"],
-    poa_components["poa_direct"],
-)
-
 # %%
 # Number of shaded blocks
 # -----------------------
@@ -191,6 +170,33 @@
     for k, blocks_N in blocks_per_module.items()
 }
 
+# %%
+# Plane of array irradiance example data
+# --------------------------------------
+# To calculate the power output losses due to shading, we need the plane of
+# array irradiance. For this example, we will use synthetic data:
+
+clearsky = locus.get_clearsky(
+    times, solar_position=solar_pos, model="ineichen"
+)
+dhi, dni = (
+    clearsky["dhi"],
+    clearsky["dni"],
+)
+dni_extra = pvlib.irradiance.get_extra_radiation(times)
+airmass = pvlib.atmosphere.get_relative_airmass(solar_apparent_zenith)
+sky_diffuse = pvlib.irradiance.perez_driesse(
+    surface_tilt, surface_azimuth, dhi, dni,
+    solar_apparent_zenith, solar_azimuth, dni_extra, airmass,
+)  # fmt: skip
+poa_components = pvlib.irradiance.poa_components(
+    aoi, dni, sky_diffuse, poa_ground_diffuse=0
+)  # ignore ground diffuse for brevity
+poa_global, poa_direct = (
+    poa_components["poa_global"],
+    poa_components["poa_direct"],
+)
+
 # %%
 # Results
 # -------

From cf9acec4937bf90701478a2f90d85abd5df1efac Mon Sep 17 00:00:00 2001
From: echedey-ls <80125792+echedey-ls@users.noreply.github.com>
Date: Tue, 18 Jun 2024 22:03:11 +0200
Subject: [PATCH 175/185] Mis-redaction in normal/half-cut modules comparison

Co-Authored-By: Kevin Anderson <57452607+kandersolar@users.noreply.github.com>
---
 docs/examples/shading/plot_martinez_shade_loss.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/docs/examples/shading/plot_martinez_shade_loss.py b/docs/examples/shading/plot_martinez_shade_loss.py
index 6d2579393e..d9ab8c3728 100644
--- a/docs/examples/shading/plot_martinez_shade_loss.py
+++ b/docs/examples/shading/plot_martinez_shade_loss.py
@@ -261,9 +261,9 @@
 fig.show()
 
 # %%
-# Note how the half-cut cell module in portrait behaves worse that the
+# Note how the half-cut cell module in portrait performs better than the
 # normal module with three bypass diodes. This is because the number of shaded
-# blocks is less along the shaded length.
+# blocks is less along the shaded length is higher in the half-cut module.
 # This is the reason why half-cut cell modules are preferred in portrait
 # orientation.
 

From 8180654d3557c91df5dcf71e3c6b3e74d722c8a7 Mon Sep 17 00:00:00 2001
From: echedey-ls <80125792+echedey-ls@users.noreply.github.com>
Date: Tue, 18 Jun 2024 22:15:26 +0200
Subject: [PATCH 176/185] Add edge cases

Co-Authored-By: Kevin Anderson <57452607+kandersolar@users.noreply.github.com>
---
 pvlib/tests/test_shading.py | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/pvlib/tests/test_shading.py b/pvlib/tests/test_shading.py
index 2f36f34708..f83f2db47b 100644
--- a/pvlib/tests/test_shading.py
+++ b/pvlib/tests/test_shading.py
@@ -348,6 +348,7 @@ def direct_martinez_Table2():
         ],
         data=[
             # F-H, F-V, Nsb, direct, diffuse, power_loss
+            # original data sourced from researchers
             [1.00, 0.09, 16, 846.59, 59.42, 0.8844],
             [1.00, 0.18, 16, 841.85, 59.69, 0.8888],
             [1.00, 0.36, 16, 843.38, 59.22, 0.8994],
@@ -362,6 +363,13 @@ def direct_martinez_Table2():
             [0.58, 0.82, 10, 876.80, 58.16, 0.7359],
             [0.75, 0.73, 12, 866.89, 58.73, 0.8113],
             [0.92, 0.64, 15, 861.48, 59.66, 0.8894],
+            # custom edge cases
+            [0.00, 0.00,  0, 800.00, 50.00, 0.0000],
+            [1.00, 1.00, 16, 900.00, 00.00, 1.0000],
+            [0.00, 1.00, 16, 000.00, 00.00, np.nan],
+            [1.00, 0.00,  0, 000.00, 00.00, np.nan],
+            [1.00, 0.00,  0, -50.00, 50.00, np.nan],  # zero poa_global
+            [1.00, 0.00,  0, 50.00, -50.00, np.nan],  # zero poa_global
         ]
     )  # fmt: skip
     test_data["total_blocks"] = 16  # total blocks is 16 for all cases

From 874c0a46d5b1d728ebb2d1553a8de31f9efc3911 Mon Sep 17 00:00:00 2001
From: echedey-ls <80125792+echedey-ls@users.noreply.github.com>
Date: Tue, 18 Jun 2024 22:31:32 +0200
Subject: [PATCH 177/185] Link yet again

Co-Authored-By: Kevin Anderson <57452607+kandersolar@users.noreply.github.com>
---
 pvlib/shading.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/pvlib/shading.py b/pvlib/shading.py
index 9e0f231a5f..479d680441 100644
--- a/pvlib/shading.py
+++ b/pvlib/shading.py
@@ -645,7 +645,7 @@ def direct_martinez(
     Examples
     --------
     Minimal example. For a complete example, see
-    :ref:`this gallery example <sphx_glr_gallery_plot_martinez_shade_loss.py>`.
+    :ref:`sphx_glr_gallery_plot_martinez_shade_loss.py`.
 
     >>> import numpy as np
     >>> from pvlib import shading

From 46cedd879219b88d3605bcf0b98fe786979da089 Mon Sep 17 00:00:00 2001
From: echedey-ls <80125792+echedey-ls@users.noreply.github.com>
Date: Tue, 18 Jun 2024 23:17:29 +0200
Subject: [PATCH 178/185] Fix link for sure

Co-Authored-By: Kevin Anderson <57452607+kandersolar@users.noreply.github.com>
---
 pvlib/shading.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/pvlib/shading.py b/pvlib/shading.py
index 479d680441..b9695a854e 100644
--- a/pvlib/shading.py
+++ b/pvlib/shading.py
@@ -645,7 +645,7 @@ def direct_martinez(
     Examples
     --------
     Minimal example. For a complete example, see
-    :ref:`sphx_glr_gallery_plot_martinez_shade_loss.py`.
+    :ref:`sphx_glr_gallery_shading_plot_martinez_shade_loss.py`.
 
     >>> import numpy as np
     >>> from pvlib import shading

From 954b05fc93da53fd1a11bec8029c74a1eacf36ab Mon Sep 17 00:00:00 2001
From: echedey-ls <80125792+echedey-ls@users.noreply.github.com>
Date: Tue, 18 Jun 2024 23:47:19 +0200
Subject: [PATCH 179/185] Remove critical error from docs build

---
 pvlib/shading.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/pvlib/shading.py b/pvlib/shading.py
index b9695a854e..00ff37b775 100644
--- a/pvlib/shading.py
+++ b/pvlib/shading.py
@@ -616,8 +616,8 @@ def direct_martinez(
     :math:`D^{ISO} + R` is the sum of diffuse and albedo irradiances and
     :math:`G` is the global irradiance.
 
-    Blocks terminology
-    ^^^^^^^^^^^^^^^^^^
+    **Blocks terminology:**
+
     [1]_ defines a *block* as a group of solar cells protected by a bypass
     diode. Also, a *block* is shaded when at least one of its cells is shaded.
 

From 00f1eff0ce7c589aba13b2b8d953edf6c804e385 Mon Sep 17 00:00:00 2001
From: Echedey Luis <80125792+echedey-ls@users.noreply.github.com>
Date: Wed, 19 Jun 2024 00:52:57 +0200
Subject: [PATCH 180/185] Apply suggestions from code review (Cliff)

Co-authored-by: Cliff Hansen <cwhanse@sandia.gov>
---
 pvlib/shading.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/pvlib/shading.py b/pvlib/shading.py
index 00ff37b775..87395237e7 100644
--- a/pvlib/shading.py
+++ b/pvlib/shading.py
@@ -589,7 +589,7 @@ def direct_martinez(
     Returns
     -------
     shading_losses : numeric
-        Multiply unshaded output power by 1 minus this value.
+        Fraction of DC power lost due to shading. [unitless]
 
     Notes
     -----
@@ -609,7 +609,7 @@ def direct_martinez(
     fraction of the collector, :math:`N_{SB}` is the number of shaded blocks
     and :math:`N_{TB}` is the number of total blocks.
 
-    In (8), :math:`(1 - \frac{P_{S}}{P_{NS}})` is the power losses factor,
+    In (8), :math:`\frac{P_{S}}{P_{NS}}` is the fraction of DC power lost due to shading,
     :math:`P_{S}` is the power output of the shaded module,
     :math:`P_{NS}` is the power output of the non-shaded module,
     :math:`B + D^{CIR}` is the beam and circumsolar irradiance,

From ec3931f7ee830102462fa85df79f009c6d3d038c Mon Sep 17 00:00:00 2001
From: echedey-ls <80125792+echedey-ls@users.noreply.github.com>
Date: Wed, 19 Jun 2024 00:58:18 +0200
Subject: [PATCH 181/185] Linter

---
 pvlib/shading.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/pvlib/shading.py b/pvlib/shading.py
index 87395237e7..ba1f81032f 100644
--- a/pvlib/shading.py
+++ b/pvlib/shading.py
@@ -609,8 +609,8 @@ def direct_martinez(
     fraction of the collector, :math:`N_{SB}` is the number of shaded blocks
     and :math:`N_{TB}` is the number of total blocks.
 
-    In (8), :math:`\frac{P_{S}}{P_{NS}}` is the fraction of DC power lost due to shading,
-    :math:`P_{S}` is the power output of the shaded module,
+    In (8), :math:`\frac{P_{S}}{P_{NS}}` is the fraction of DC power lost due
+    to shading, :math:`P_{S}` is the power output of the shaded module,
     :math:`P_{NS}` is the power output of the non-shaded module,
     :math:`B + D^{CIR}` is the beam and circumsolar irradiance,
     :math:`D^{ISO} + R` is the sum of diffuse and albedo irradiances and

From 8ed87b6afed371bd6074abddc10b9ef8cf3d7ff2 Mon Sep 17 00:00:00 2001
From: Echedey Luis <80125792+echedey-ls@users.noreply.github.com>
Date: Thu, 20 Jun 2024 20:13:01 +0200
Subject: [PATCH 182/185] Apply suggestions from Adam

Co-authored-by: Adam R. Jensen <39184289+AdamRJensen@users.noreply.github.com>
---
 .../shading/plot_martinez_shade_loss.py       | 20 ++++++++-----------
 pvlib/shading.py                              |  8 ++++----
 2 files changed, 12 insertions(+), 16 deletions(-)

diff --git a/docs/examples/shading/plot_martinez_shade_loss.py b/docs/examples/shading/plot_martinez_shade_loss.py
index d9ab8c3728..625be33bc8 100644
--- a/docs/examples/shading/plot_martinez_shade_loss.py
+++ b/docs/examples/shading/plot_martinez_shade_loss.py
@@ -4,8 +4,8 @@
 """
 
 # %%
-# This example illustrates how to use the model proposed by Martinez et al.
-# [1]_. The model proposes a power output losses factor by adjusting
+# This example illustrates how to use the loss model proposed by Martinez et
+# al. [1]_. The model proposes a power output losses factor by adjusting
 # the incident direct and circumsolar beam irradiance fraction of a PV module
 # based on the number of shaded *blocks*. A *block* is defined as a group of
 # cells protected by a bypass diode. More information on *blocks* can be found
@@ -32,11 +32,11 @@
 # - The rows have the same true-tracking tilt angles. True tracking
 #   is chosen in this example, so shading is significant.
 # - Terrain slope is 7 degrees downward to the east.
-# - Rows' axes are horizontal.
+# - Row axes are horizontal.
 # - The modules are comprised of multiple cells. We will compare these cases:
 #    - modules with one bypass diode
 #    - modules with three bypass diodes
-#    - half-cut cell modules with three bypass diodes on portrait and landscape
+#    - half-cut cell modules with three bypass diodes in portrait and landscape
 #
 # Setting up the system
 # ----------------------
@@ -71,8 +71,8 @@
 # True-tracking algorithm and shaded fraction
 # -------------------------------------------
 # Since this model is about row-to-row shading, we will use the true-tracking
-# algorithm to calculate the trackers rotation. Back-tracking reduces the
-# shading between rows, but since this example is about shading, we will not
+# algorithm to calculate the trackers rotation. Back-tracking eliminates
+# shading between rows, and since this example is about shading, we will not
 # use it.
 #
 # Then, the next step is to calculate the fraction of shaded surface. This is
@@ -179,18 +179,14 @@
 clearsky = locus.get_clearsky(
     times, solar_position=solar_pos, model="ineichen"
 )
-dhi, dni = (
-    clearsky["dhi"],
-    clearsky["dni"],
-)
 dni_extra = pvlib.irradiance.get_extra_radiation(times)
 airmass = pvlib.atmosphere.get_relative_airmass(solar_apparent_zenith)
 sky_diffuse = pvlib.irradiance.perez_driesse(
-    surface_tilt, surface_azimuth, dhi, dni,
+    surface_tilt, surface_azimuth, clearsky["dhi"], clearsky["dni"],
     solar_apparent_zenith, solar_azimuth, dni_extra, airmass,
 )  # fmt: skip
 poa_components = pvlib.irradiance.poa_components(
-    aoi, dni, sky_diffuse, poa_ground_diffuse=0
+    aoi, clearsky["dni"], sky_diffuse, poa_ground_diffuse=0
 )  # ignore ground diffuse for brevity
 poa_global, poa_direct = (
     poa_components["poa_global"],
diff --git a/pvlib/shading.py b/pvlib/shading.py
index ba1f81032f..248b201b5e 100644
--- a/pvlib/shading.py
+++ b/pvlib/shading.py
@@ -563,7 +563,7 @@ def direct_martinez(
     total_blocks,
 ):
     r"""
-    A shading losses power factor for non-monolithic Silicon
+    A shading loss power factor for non-monolithic silicon
     modules and arrays with an arbitrary number of bypass diodes.
 
     This experimental model cancels a fraction of the direct and circumsolar
@@ -579,7 +579,7 @@ def direct_martinez(
     poa_direct : numeric
         Plane of array direct and circumsolar irradiance. [W/m²].
     shaded_fraction : numeric
-        Fraction of module surface area that is shaded. Unitless.
+        Fraction of module surface area that is shaded. [Unitless].
     shaded_blocks : numeric
         Number of blocks affected by the shadow. Unitless.
         If a floating point number is provided, it will be rounded up.
@@ -618,12 +618,12 @@ def direct_martinez(
 
     **Blocks terminology:**
 
-    [1]_ defines a *block* as a group of solar cells protected by a bypass
+    A *block* is defined in [1]_ as a group of solar cells protected by a bypass
     diode. Also, a *block* is shaded when at least one of its cells is shaded.
 
     The total number of blocks and their layout depend on the module(s) used.
     Many manufacturers don't specify this information explicitly.
-    However, we can infer these values from:
+    However, these values can be inferred from:
 
     - the number of bypass diodes
     - where and how many junction boxes are present on the back of the module

From 95769bf43e5d1646a7b7a51bc850462e2b63089b Mon Sep 17 00:00:00 2001
From: echedey-ls <80125792+echedey-ls@users.noreply.github.com>
Date: Thu, 20 Jun 2024 20:24:37 +0200
Subject: [PATCH 183/185] Rewording from code review

Co-Authored-By: Adam R. Jensen <39184289+AdamRJensen@users.noreply.github.com>
---
 pvlib/shading.py | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/pvlib/shading.py b/pvlib/shading.py
index 248b201b5e..1fd934b604 100644
--- a/pvlib/shading.py
+++ b/pvlib/shading.py
@@ -566,7 +566,7 @@ def direct_martinez(
     A shading loss power factor for non-monolithic silicon
     modules and arrays with an arbitrary number of bypass diodes.
 
-    This experimental model cancels a fraction of the direct and circumsolar
+    This experimental model zeroes a fraction of the direct and circumsolar
     irradiance based on the number of *blocks* affected by the shadow.
     More on blocks in the *Notes* section and in [1]_.
 
@@ -618,8 +618,9 @@ def direct_martinez(
 
     **Blocks terminology:**
 
-    A *block* is defined in [1]_ as a group of solar cells protected by a bypass
-    diode. Also, a *block* is shaded when at least one of its cells is shaded.
+    A *block* is defined in [1]_ as a group of solar cells protected by a
+    bypass diode. Also, a *block* is shaded when at least one of its
+    cells is partially shaded.
 
     The total number of blocks and their layout depend on the module(s) used.
     Many manufacturers don't specify this information explicitly.

From 8841020b0da3b506956c17f737cb2c8614044171 Mon Sep 17 00:00:00 2001
From: echedey-ls <80125792+echedey-ls@users.noreply.github.com>
Date: Thu, 20 Jun 2024 20:31:58 +0200
Subject: [PATCH 184/185] More unitless

Co-Authored-By: Adam R. Jensen <39184289+AdamRJensen@users.noreply.github.com>
---
 pvlib/shading.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/pvlib/shading.py b/pvlib/shading.py
index 1fd934b604..7533604b6f 100644
--- a/pvlib/shading.py
+++ b/pvlib/shading.py
@@ -581,7 +581,7 @@ def direct_martinez(
     shaded_fraction : numeric
         Fraction of module surface area that is shaded. [Unitless].
     shaded_blocks : numeric
-        Number of blocks affected by the shadow. Unitless.
+        Number of blocks affected by the shadow. [Unitless].
         If a floating point number is provided, it will be rounded up.
     total_blocks : int
         Number of total blocks. Unitless.
@@ -589,7 +589,7 @@ def direct_martinez(
     Returns
     -------
     shading_losses : numeric
-        Fraction of DC power lost due to shading. [unitless]
+        Fraction of DC power lost due to shading. [Unitless]
 
     Notes
     -----

From 9483fdaab6a3e5c40f30e837e2283236b2e77d43 Mon Sep 17 00:00:00 2001
From: Echedey Luis <80125792+echedey-ls@users.noreply.github.com>
Date: Thu, 20 Jun 2024 21:32:57 +0200
Subject: [PATCH 185/185] Apply suggestions from Cliff

Co-authored-by: Cliff Hansen <cwhanse@sandia.gov>
---
 pvlib/shading.py | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/pvlib/shading.py b/pvlib/shading.py
index 7533604b6f..12040e91be 100644
--- a/pvlib/shading.py
+++ b/pvlib/shading.py
@@ -566,8 +566,9 @@ def direct_martinez(
     A shading loss power factor for non-monolithic silicon
     modules and arrays with an arbitrary number of bypass diodes.
 
-    This experimental model zeroes a fraction of the direct and circumsolar
-    irradiance based on the number of *blocks* affected by the shadow.
+    This experimental model reduces the direct and circumsolar
+    irradiance reaching the module's cells based on the number of *blocks*
+    affected by the shadow.
     More on blocks in the *Notes* section and in [1]_.
 
     .. versionadded:: 0.11.0