This issue is used to track past, present, and future deprecations and make the required follow-ups. Maintainers may update this issue whenever a feature is deprecated, renamed, or removed.

If you have found a deprecated feature that is not here, please report it via a new issue or the mailing list.

Upcoming changes

• Not scheduled (soon or next version)

  • Removal of function pvlib.modelchain.get_orientation
    • Will be deprecated in v0.13.1
    • Deprecate modelchain.get_orientation #2495
  • Removal of pvlib.bifacial.pvfactors_timeseries
    - Use pvlib.bifacial.pvfactors.pvfactors_timeseries instead.
    - Deprecated in v0.9.1
    - ENH: infinite sheds #717
  • Removal of dictionary alias pvlib.irradiance.SURFACE_ALBEDOS.
    • Use pvlib.albedo.SURFACE_ALBEDOS instead.
    • Deprecated in v0.11.0
    • Move albedo dictionary from pvlib.irradiance to pvlib.albedo #2095
    • iotools parse functions deprecated in v.0.13.0
      - parse_cams Deprecate parse_psm3 and parse_cams #2458
      - parse_psm3 Deprecate parse_psm3 and parse_cams #2458
      - parse_bsrn Deprecate parse_bsrn #2466
      - parse_epw Deprecate parse_epw #2467

• v0.14.0

  • Renamed parameter names dni_clearsky and clearsky_dni in favour of dni_clear
    • Affects pvlib.irradiance.dirindex() and pvlib.irradiance.dni()
    • Deprecated in v0.11.2
    • Standardise variable name for clearsky GHI and DNI, add to glossary #2272
  • Renamed parameter name ghi_clearsky to ghi_clear
    • Affects pvlib.irradiance.dirindex() and pvlib.irradiance.clearsky_index()
    • Deprecated in v0.11.2
    • Standardise variable name for clearsky GHI and DNI, add to glossary #2272

Past changes

• v0.12.0

  • Removal of parameter recolumn of pvlib.iotools.read_tmy3()
    • Deprecated in v0.10.0
    • [DEPRECATION]: pvlib.iotools.read_tmy3 deprecated recolumn parameter removal scheduled for v0.11.0, still there #2324
  • Removal of function pvsystem.sapm_spectral_loss()
    • Deprecated in v0.10.0
    • Deprecated pvsystem.sapm_spectral_loss not removed #2243
  • Removal of function alias pvlib.atmosphere.first_solar_spectral_correction().
    • Use pvlib.spectrum.spectral_factor_firstsolar() instead.
    • Deprecated in v0.10.0
    • Deprecated pvlib.atmosphere.first_solar_spectral_correction not scheduled for removal #2130
  • Removal of function pvlib.spectrum.get_am15g()
    • Use pvlib.spectrum.get_reference_spectra(standard="ASTM G173-03")["global"] instead
    • Deprecated in v0.11.0

• v0.11.0

  • Removal of function pvlib.modelchain.basic_chain()
    • Remove deprecated basic_chain method #1862
  • Removal of function pvlib.irradiance.poa_horizontal_ratio()
    • pvlib.irradiance.poa_horizontal_ratio should be removed #1697
  • Replacement of function pvlib.iotools.read_srml_month_from_solardat() by pvlib.iotools.get_srml()
    • Deprecated in v0.10.0
    • Add get_srml iotools function; deprecate read_srml_month_from_solardat  #1779
  • Removal of parameter ivcurve_pnts of pvlib.pvsystem.singlediode()