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_standard_spectrum` to retrieve a
+# standard spectrum.
+
+am15 = pvlib.spectrum.get_standard_spectrum(reference="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('Wavelength (nm)')
+plt.ylabel('Irradiance (W/m²/nm)')
+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_standard_spectrum
    spectrum.calc_spectral_mismatch_field
    spectrum.spectral_factor_caballero
    spectrum.spectral_factor_firstsolar

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

@@ -15,6 +15,9 @@ Deprecations
 
 Enhancements
 ~~~~~~~~~~~~
+* Added extraterrestrial and direct spectra of the ASTM G173-03 standard with
+  the new function :py:func:`pvlib.spectrum.get_standard_spectrum`.
+  (:issue:`1963`, :pull:`2039`)
 
 
 Bug fixes