Implement ANTS-2D bifacial irradiance model

docs/examples/agrivoltaics/plot_agrivoltaics_ground_irradiance.py

@@ -136,17 +136,21 @@
 # (i.e., receives DNI).
 
 vf_ground_sky = pvlib.bifacial.utils.vf_ground_sky_2d_integ(
-    surface_tilt=tracking_orientations['surface_tilt'],
+    tracker_rotation=tracking_orientations['tracker_theta'],
     gcr=gcr,
     height=height,
     pitch=pitch,
 )
 
-unshaded_ground_fraction = pvlib.bifacial.utils._unshaded_ground_fraction(
-    surface_tilt=tracking_orientations['surface_tilt'],
-    surface_azimuth=tracking_orientations['surface_azimuth'],
+phi = pvlib.shading.projected_solar_zenith_angle(
     solar_zenith=solpos['apparent_zenith'],
     solar_azimuth=solpos['azimuth'],
+    axis_tilt=0,
+    axis_azimuth=axis_azimuth,
+)
+unshaded_ground_fraction = pvlib.bifacial.utils._unshaded_ground_fraction(
+    tracker_rotation=tracking_orientations['tracker_theta'],
+    phi=phi,
     gcr=gcr,
 )
 

docs/sphinx/source/reference/bifacial.rst

@@ -11,6 +11,7 @@ Functions for calculating front and back surface irradiance
    bifacial.pvfactors.pvfactors_timeseries
    bifacial.infinite_sheds.get_irradiance
    bifacial.infinite_sheds.get_irradiance_poa
+   bifacial.ants2d.get_irradiance
 
 Loss models that are specific to bifacial PV systems
 

docs/sphinx/source/user_guide/modeling_topics/bifacial.rst

@@ -114,6 +114,19 @@ as additional ``dni`` for transposition and shading purposes.
 This model is influenced by the 2D model published by Marion, *et al.* in [2].
 
 
+ANTS-2D
+-------
+
+The ANTS-2D model is a 2-D model similar to the Infinite Sheds and pvfactors
+models.  However, it has additional inputs to allow modeling of arrays on
+sloped terrain and ground surfaces with nonuniform albedo.  It partitions the
+module and ground surfaces into a user-specified number of segments to better
+capture irradiance nonuniformity effects.  It is also computationally efficient
+relative to models of comparable capability like pvfactors.  Finally, it can
+compute and return irradiance components at the ground level, which may be
+useful for agriPV modeling.
+
+
 References
 ----------
 .. [1] Mikofski, M., Darawali, R., Hamer, M., Neubert, A., and Newmiller,

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

@@ -10,17 +10,38 @@ Breaking Changes
 
 Deprecations
 ~~~~~~~~~~~~
+* Parameters ``npoints`` and ``vectorize`` in the following functions
+  are now unnecessary and are deprecated (:pull:`2740`):
+
+  - :py:func:`pvlib.bifacial.infinite_sheds.get_irradiance`
+  - :py:func:`pvlib.bifacial.infinite_sheds.get_irradiance_poa`
+  - :py:func:`pvlib.bifacial.utils.vf_ground_sky_2d_integ`
+
+* Parameter ``surface_tilt`` is deprecated and renamed to ``tracker_rotation``
+  in :py:func:`pvlib.bifacial.utils.vf_ground_sky_2d_integ` (:pull:`2740`).
 
 
 Bug fixes
 ~~~~~~~~~
+* Fix asymmetry in how ``max_rows`` is interpreted in
+  :py:func:`~pvlib.bifacial.utils.vf_ground_sky_2d`. The difference
+  should be negligible for typical simulations. (:issue:`1867`, :pull:`2740`)
 * Corrects a bug in :py:func:`pvlib.temperature.fuentes`. If inputs were
   data type integer, users can expect modeled cell temperature values to
   increase slightly.
   (:issue:`2608`, :pull:`2745`)
+
 
 Enhancements
 ~~~~~~~~~~~~
+* Implement the ANTS-2D bifacial irradiance model in
+  :py:func:`pvlib.bifacial.ants2d.get_irradiance`. (:pull:`2740`)
+* Add parameters ``g0`` and ``g1`` to allow segmented ground surfaces in
+  :py:func:`~pvlib.bifacial.utils.vf_ground_sky_2d_integ` and
+  :py:func:`~pvlib.bifacial.utils.vf_row_ground_2d_integ`. (:pull:`2740`)
+* Accelerate :py:func:`~pvlib.bifacial.utils.vf_ground_sky_2d_integ` by one or
+  two orders of magnitude. This also makes :py:mod:`pvlib.bifacial.infinite_sheds` faster.
+  (:pull:`2740`)
 
 
 Documentation

pvlib/bifacial/__init__.py

@@ -3,7 +3,9 @@
 """
 
 from pvlib._deprecation import deprecated
-from pvlib.bifacial import pvfactors, infinite_sheds, utils  # noqa: F401
+from pvlib.bifacial import (  # noqa: F401
+    ants2d, infinite_sheds, pvfactors, utils
+)
 from .loss_models import power_mismatch_deline  # noqa: F401
 
 pvfactors_timeseries = deprecated(