pvlib · mikofski · Feb 22, 2022 · May 10, 2019 · May 16, 2019 · May 16, 2019
diff --git a/docs/sphinx/source/reference/bifacial.rst b/docs/sphinx/source/reference/bifacial.rst
@@ -3,9 +3,11 @@
 Bifacial
 ========
 
-Methods for calculating back surface irradiance
+Functions for calculating front and back surface irradiance
 
 .. autosummary::
    :toctree: generated/
 
-   bifacial.pvfactors_timeseries
+   bifacial.pvfactors.pvfactors_timeseries
+   bifacial.infinite_sheds.get_irradiance
+   bifacial.infinite_sheds.get_irradiance_poa
diff --git a/docs/sphinx/source/whatsnew/v0.9.1.rst b/docs/sphinx/source/whatsnew/v0.9.1.rst
@@ -8,9 +8,14 @@ Breaking changes
 
 Deprecations
 ~~~~~~~~~~~~
+* Moved :py:func:`pvlib.bifacial.pvfactors_timeseries` to
+ :py:func:`pvlib.bifacial.pvfactors.pvfactors_timeseries`.
+ :py:module:`pvlib.bifacial` is now a sub-package. (:pull:`717`)
 
 Enhancements
 ~~~~~~~~~~~~
+* Added `pvlib.bifacial.infinite_sheds`, containing a model for irradiance
+  on front and back surfaces of bifacial arrays. (:pull:`717`)
 * Added :py:func:`pvlib.temperature.prilliman` for modeling cell temperature
   at short time steps (:issue:`1081`, :pull:`1391`)
 

diff --git a/pvlib/bifacial/__init__.py b/pvlib/bifacial/__init__.py
@@ -0,0 +1,13 @@
+"""
+The ``bifacial`` module contains functions to model irradiance for bifacial
+modules.
+
+"""
+from pvlib._deprecation import deprecated
+from pvlib.bifacial import pvfactors, infinite_sheds, utils   # noqa: F401
+
+pvfactors_timeseries = deprecated(
+    since='0.9.1',
+    name='pvlib.bifacial.pvfactors_timeseries',
+    alternative='pvlib.bifacial.pvfactors.pvfactors_timeseries'
+)(pvfactors.pvfactors_timeseries)