Merge branch 'master' into gtidirint

pvlib · cwhanse · Aug 27, 2018 · Aug 31, 2017 · Aug 31, 2017 · Aug 31, 2017
commit ae6031681ffcdd85c5aa4c442739a8d681fbcc85
diff --git a/docs/sphinx/source/whatsnew/v0.6.0.rst b/docs/sphinx/source/whatsnew/v0.6.0.rst
@@ -21,6 +21,93 @@ Enhancements
 * Implement first_solar_spectral_loss in modelchain.py (:issue:`359`)
 * Clarify arguments Egref and dEgdT for calcparams_desoto (:issue:`462`)
 * Add gti_dirint function. (:issue:`396`)
+* pvlib python is changing a handful of function names. In general, functions
+  that can calculate a quantity using multiple algorithms now start
+  with the prefix ``get_``. For example, ``relativeairmass`` can calculate
+  airmass using one of many ``model`` arguments. Its name has been changed
+  to ``get_relative_airmass`
8000
`. The old function names remain in this
+  release, but will emit a ``PVLibDeprecationWarning`` when called. The
+  old functions will be removed in the 0.7 release. Functions composed
+  of multiple words jammed together have been renamed with underscores
+  separating the words (see above).
+  Each change is detailed below. (:issue:`427`)
+* Deprecated relativeairmass. relativeairmass will be removed in 0.7.
+  Use the new get_relative_airmass instead. (:issue:`427`)
+* Deprecated absoluteairmass. absoluteairmass will be removed in 0.7.
+  Use the new get_absolute_airmass instead. (:issue:`427`)
+* Deprecated irradiance.globalinplane. globalinplane will be removed in 0.7.
+  Use the new irradiance.poa_components instead. (:issue:`427`)
+* Added irradiance.poa_components. Function is the same as the now-deprecated
+  irradiance.globalinplane, but adds 'poa_sky_diffuse' and
+  'poa_ground_diffuse' to the output. (:issue:`427`)
+* Deprecated irradiance.extraradiation. Use irradiance.get_extra_radiation
+  instead. irradiance.extraradiation will be removed in 0.7. (:issue:`427`)
+* Deprecated irradiance.grounddiffuse. Use irradiance.get_ground_diffuse
+  instead. irradiance.grounddiffuse will be removed in 0.7. (:issue:`427`)
+* Added irradiance.get_poa_sky_diffuse. (:issue:`427`)
+* Deprecated irradiance.total_irrad. Use irradiance.get_total_poa_irradiance
+  instead. irradiance.total_irrad will be removed in 0.7. (:issue:`427`)
+* Removed 'klutcher' from get_sky_diffuse/total_irrad. This misspelling was
+  deprecated long ago but never removed. (:issue:`97`)
+* pvsystem.calcparams_desoto now requires arguments for each module model
+  parameter. (:issue:`462`)
+* Add losses_parameters attribute to PVSystem objects and remove the kwargs
+  support from PVSystem.pvwatts_losses. Enables custom losses specification
+  in ModelChain calculations. (:issue:`484`)
+* removed irradiance parameter from ModelChain.run_model and ModelChain.prepare_inputs
+* Add ``perez_enhancement`` keyword argument to clearsky.ineichen to control
+  whether or not the "perez enhancement factor" is applied. The enhancement
+  factor was always applied until now. Now it is turned off by default. The
+  enhancement factor can yield unphysical results, especially for latitudes
+  closer to the poles and especially in the winter months. It may yield
+  improved results under other conditions. (:issue:`435`)
+
+
+Enhancements
+~~~~~~~~~~~~
+* Add sea surface albedo in ``irradiance.py`` (:issue:`458`)
+* Implement :meth:`~pvlib.modelchain.ModelChain.first_solar_spectral_loss`
+  in ``modelchain.py`` (:issue:`359`)
+* Clarify arguments ``Egref`` and ``dEgdT`` for
+  :func:`~pvlib.pvsystem.calcparams_desoto` (:issue:`462`)
+* Add pvsystem.calcparams_pvsyst to compute values for the single diode equation
+  using the PVsyst v6 model (:issue:'470')
+* Extend :func:`~pvlib.pvsystem.singlediode` with an additional keyword argument
+  ``method`` in ``('lambertw', 'newton', 'brentq')``, default is ``'lambertw'``,
+  to select a method to solve the single diode equation for points on the IV
+  curve. Selecting either ``'brentq'`` or ``'newton'`` as the method uses
+  :func:`~pvlib.singlediode.bishop88` with the corresponding method.
+  (:issue:`410`)
+* Implement new methods ``'brentq'`` and ``'newton'`` for solving the single
+  diode equation for points on the IV curve. ``'brentq'`` uses a bisection
+  method (Brent, 1973) that may be slow but guarantees a solution. ``'newton'``
+  uses the Newton-Raphson method and may be faster but is not guaranteed to
+  converge. However, ``'newton'`` should be safe for well-behaved IV curves.
+  (:issue:`408`)
+* Implement :func:`~pvlib.singlediode.bishop88` for explicit calculation
+  of arbitrary IV curve points using diode voltage instead of cell voltage. If
+  ``method`` is either ``'newton'`` or ``'brentq'`` and ``ivcurve_pnts`` in
+  :func:`~pvlib.pvsystem.singlediode` is provided, the IV curve points will be
+  log spaced instead of linear.
+* Implement :func:`~pvlib.singlediode.estimate_voc` to estimate open
+  circuit voltage by assuming :math:`R_{sh} \to \infty` and :math:`R_s=0` as an
+  upper bound in bisection method for :func:`~pvlib.pvsystem.singlediode` when
+  method is either ``'newton'`` or ``'brentq'``.
+* Add :func:`~pvlib.pvsystem.max_power_point` method to compute the max power
+  point using the new ``'brentq'`` method.
+* Add new module ``pvlib.singlediode`` with low-level functions for
+  solving the single diode equation such as:
+  :func:`~pvlib.singlediode.bishop88`,
+  :func:`~pvlib.singlediode.estimate_voc`,
+  :func:`~pvlib.singlediode.bishop88_i_from_v`,
+  :func:`~pvlib.singlediode.bishop88_v_from_i`, and
+  :func:`~pvlib.singlediode.bishop88_mpp`.
+* Add PVSyst thin-film recombination losses for CdTe and a:Si (:issue:`163`)
+* Python 3.7 officially supported. (:issue:`496`)
+* Improve performance of solarposition.ephemeris. (:issue:`512`)
+* Improve performance of Location.get_airmass. Most noticeable when
+  solar position is supplied, time index length is less than 10000, and
+  method is looped over. (:issue:`502`)
 
 
 Bug fixes

diff --git a/pvlib/irradiance.py b/pvlib/irradiance.py
@@ -1235,7 +1235,7 @@ def disc(ghi, zenith, datetime_or_doy, pressure=101325, min_cos_zenith=0.065,
     """
 
     # this is the I0 calculation from the reference
-    I0 = extraradiation(datetime_or_doy, 1370, 'spencer')
+    I0 = get_extra_radiation(datetime_or_doy, 1370, 'spencer')
     cos_zenith = np.maximum(min_cos_zenith, np.cos(np.radians(zenith)))
     I0h = I0 * cos_zenith