Add extraterrestrial and direct spectra of ASTM G173-03 standard spectrum (AM1.5)

docs/examples/spectrum/plot_standard_ASTM_G173-03.py

@@ -0,0 +1,31 @@
+"""
+ASTM G173-03 Standard Spectrum
+==============================
+
+This example demonstrates how to read the data from the ASTM G173-03 standard
+spectrum bundled with pvlib and plot each of the components.
+
+The ASTM G173-03 standard provides reference solar spectral irradiance data.
+"""
+
+import matplotlib.pyplot as plt
+import pvlib
+
+
+# %%
+# Use :py:func:`pvlib.spectrum.get_reference_spectra` to read a spectra dataset
+# bundled with pvlib.
+
+am15 = pvlib.spectrum.get_reference_spectra(standard="ASTM G173-03")
+
+# Plot
+plt.plot(am15.index, am15["extraterrestrial"], label="Extraterrestrial")
+plt.plot(am15.index, am15["global"], label="Global")
+plt.plot(am15.index, am15["direct"], label="Direct")
+plt.xlabel(r"Wavelength $[nm]$")
+plt.ylabel(r"Irradiance $\left[\frac{W}{m^2 nm}\right]$")
+plt.title("ASTM G173-03 Solar Spectral Irradiance")
+plt.legend()
+plt.grid(True)
+plt.tight_layout()
+plt.show()

docs/sphinx/source/reference/effects_on_pv_system_output/spectrum.rst

@@ -9,6 +9,7 @@ Spectrum
    spectrum.spectrl2
    spectrum.get_example_spectral_response
    spectrum.get_am15g
+   spectrum.get_reference_spectra
    spectrum.calc_spectral_mismatch_field
    spectrum.spectral_factor_caballero
    spectrum.spectral_factor_firstsolar

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

@@ -20,6 +20,10 @@ Breaking changes
 
 Deprecations
 ~~~~~~~~~~~~
+* Function :py:func:`pvlib.spectrum.get_am15g` has been deprecated in favor
+  of the new function :py:func:`pvlib.spectrum.get_reference_spectra`. Use
+  ``pvlib.spectrum.get_reference_spectra(standard="ASTM G173-03")["global"]``
+  instead. (:pull:`2039`)
 
 
 Enhancements
@@ -38,6 +42,9 @@ Enhancements
 * Add function :py:func:`pvlib.spectrum.spectral_factor_pvspec`, which calculates the
   spectral mismatch factor as a function of absolute airmass and clearsky index
   using the PVSPEC model. (:issue:`1950`, :issue:`2065`, :pull:`2072`)
+* Added extraterrestrial and direct spectra of the ASTM G173-03 standard with
+  the new function :py:func:`pvlib.spectrum.get_reference_spectra`.
+  (:issue:`1963`, :pull:`2039`)
 
 Bug fixes
 ~~~~~~~~~