Skip to content

Latest commit

 

History

History
149 lines (128 loc) · 6.98 KB

v0.9.6.rst

File metadata and controls

149 lines (128 loc) · 6.98 KB
Raw

v0.9.6 (Anticipated June 2023)

Breaking Changes

  • After being deprecated for over a year, the :pypvlib.forecast module is now removed entirely. (1766)
  • Modified the surface_azimuth parameter in :pypvlib.iotools.get_pvgis_hourly to conform to the pvlib azimuth convention (counterclockwise from north). Previously 0 degrees represented south. (1724, 1739)
  • For consistency with the rest of pvlib, the pw parameters are renamed to precipitable_water in :pypvlib.spectrum.spectral_factor_firstsolar. (1768)
  • For consistency with the rest of pvlib, the tilt parameter is renamed to surface_tilt in :pypvlib.soiling.hsu. (1717, 1738)
  • Several undocumented functions in :pypvlib.iotools.midc, :pypvlib.iotools.srml, and :pypvlib.iotools.surfrad are now private. (1756, 1769)
  • The following, originally deprecated in whatsnew_0900, is now removed: (1770)
    • The :pypvlib.tracking.SingleAxisTracker class
    • The various model-specific :py~pvlib.pvsystem.PVSystem inverter and cell temperature methods
    • Attribute "pass-through" from :py~pvlib.modelchain.ModelChain to :py~pvlib.modelchain.ModelChainResult
    • Attribute "pass-through" from :py~pvlib.pvsystem.PVSystem to :py~pvlib.pvsystem.Array
    • The eta_m parameter in :pypvlib.temperature.pvsyst_cell

Deprecations

  • Functions for calculating spectral modifiers have been moved to :pypvlib.spectrum: :pypvlib.atmosphere.first_solar_spectral_correction is deprecated and replaced by :py~pvlib.spectrum.spectral_factor_firstsolar, and :pypvlib.pvsystem.sapm_spectral_loss is deprecated and replaced by :py~pvlib.spectrum.spectral_factor_sapm. (1628)
  • Removed the get_ecmwf_macc and read_ecmwf_macc iotools functions as the MACC dataset has been removed by ECMWF (data period 2003-2012). Instead, ECMWF recommends to use CAMS global reanalysis (EAC4) from the Atmosphere Data Store (ADS). See also :pypvlib.iotools.get_cams. (1691, 1654)
  • The recolumn parameter in :pypvlib.iotools.read_tmy3, which maps TMY3 column names to nonstandard alternatives, is now deprecated. We encourage using map_variables (which produces standard pvlib names) instead. (1517, 1623)
  • :pypvlib.iotools.read_srml_month_from_solardat is deprecated and replaced by :pypvlib.iotools.get_srml. (1779)

Enhancements

  • Exposes several functions useful for bifacial and shading calculations (1666):
    • :pypvlib.bifacial.utils.vf_row_sky_2d
    • :pypvlib.bifacial.utils.vf_row_sky_2d_integ
    • :pypvlib.bifacial.utils.vf_row_ground_2d
    • :pypvlib.bifacial.utils.vf_row_ground_2d_integ
    • :pypvlib.bifacial.utils.vf_ground_sky_2d
    • :pypvlib.bifacial.utils.vf_ground_sky_2d_integ
    • :pypvlib.shading.ground_angle
  • Added a function :pypvlib.spectrum.spectral_factor_caballero to estimate spectral mismatch modifiers from atmospheric conditions. (1296)
  • Added a new irradiance decomposition model :pypvlib.irradiance.louche. (1705)
  • Add optional encoding parameter to :pypvlib.iotools.read_tmy3. (1732, 1737)
  • Added function to retrieve horizon data from PVGIS :pypvlib.iotools.get_pvgis_horizon. (1290, 1395)
  • Added map_variables argument to the :pypvlib.iotools.read_tmy3 in order to offer the option of mapping column names to standard pvlib names. (1517, 1623)
  • Update the URL used in the :pypvlib.iotools.get_cams function. The new URL supports load-balancing and redirects to the fastest server. (1688, 1740)
  • :pypvlib.iotools.get_psm3 now has a url parameter to give the user the option of controlling what NSRDB endpoint is used. (1736)
  • :pypvlib.iotools.get_psm3 now uses the new NSRDB 3.2.2 endpoint for hourly and half-hourly single-year datasets. (1591, 1736)
  • The default solar position algorithm (NREL SPA) is now 50-100% faster. (1748)
  • Added functions to retrieve daily precipitation, temperature, and snowfall data from the NOAA's ACIS service: :py~pvlib.iotools.get_acis_prism, :py~pvlib.iotools.get_acis_nrcc, :py~pvlib.iotools.get_acis_mpe, :py~pvlib.iotools.get_acis_station_data, and :py~pvlib.iotools.get_acis_available_stations. (1293, 1767)

Bug fixes

  • Corrects an error in view factor calculations which are part of :pypvlib.bifacial.infinite_sheds.get_irradiance. The error affects rear surface irradiance by a few W/m2. As part of the correction, average view factors are now computed by exact formulas rather than by numerical integration. (1665, 1666)
  • data can no longer be left unspecified in :pypvlib.modelchain.ModelChain.run_model_from_effective_irradiance. (1713, 1720)
  • d2mutau and NsVbi were hardcoded in :pypvlib.pvsystem.max_power_point instead of passing through the arguments to the function. (1733)
  • :pypvlib.iam.physical no longer returns NaN when n=1 and aoi>90. This bug was introduced in v0.9.5. (1706, 1707)

Testing

  • Migrated to mamba-org/setup-micromamba. (1746, 1758)

Documentation

  • Updated the description of the interval parameter in :pypvlib.iotools.get_psm3. (1702, 1712)
  • Fixed outdated nbviewer links. (1721, 1726)

Benchmarking

Requirements

  • With the removal of :pypvlib.forecast, the following packages are no longer listed as (optional) dependencies: netCDF4, cftime, and siphon. (1766)

Contributors

  • Mark Mikofski (mikofski)
  • Cliff Hansen (cwhanse)
  • Lakshya Garg (Lakshyadevelops)
  • Adam R. Jensen (adamrjensen)
  • Ben Pierce (bgpierc)
  • Joseph Palakapilly (JPalakapillyKWH)
  • Cliff Hansen (cwhanse)
  • Anton Driesse (adriesse)
  • Will Holmgren (wholmgren)
  • Mark Mikofski (mikofski)
  • Karel De Brabandere (kdebrab)
  • Josh Stein (jsstein)
  • Kevin Anderson (kandersolar)
  • Siddharth Kaul (k10blogger)
  • Kshitiz Gupta (kshitiz305)
  • Stefan de Lange (langestefan)
  • Jose Antonio Caballero (Jacc0027)
  • Andy Lam (@andylam598)
  • ooprathamm
  • Kevin Anderson (kandersolar)
  • Devon Watt (d-watt)