Little changes to docs and var names

Author: echedey-ls

docs/tutorials/spectral_mismatch_modifiers.ipynb

@@ -110,7 +110,7 @@
     "aoi = pvlib.irradiance.aoi(surface_tilt, surface_azimuth,\n",
     "                           solar_pos['apparent_zenith'], solar_pos['azimuth'])\n",
     "\n",
-    "# Let's consider this the irradiances without modifiers\n",
+    "# Let's consider this the irradiances without spectral modifiers\n",
     "# We can calculate the mismatch before and then create a \"poa_irrad\" var for\n",
     "# modified irradiances, but we are also doing this to compare later.\n",
     "# 'spectrum.martin_ruiz_spectral_modifier' result is designed to make it\n",
@@ -159,17 +159,17 @@
     "# First, let's find the airmass and the clearness index\n",
     "# Little caution: default values for this model were fitted obtaining the airmass through the kasten1966 method, not used by default\n",
     "airmass = site.get_airmass(solar_position=solar_pos, model='kasten1966')\n",
-    "clearness = pvlib.irradiance.clearness_index(ghi=weather_data['ghi'],\n",
+    "clearness_index = pvlib.irradiance.clearness_index(ghi=weather_data['ghi'],\n",
     "                                             solar_zenith=solar_pos['zenith'],\n",
     "                                             extra_radiation=extra_rad)\n",
     "# Check module is m-Si (monocrystalline silicon)\n",
     "print('Module type is: ' + cec_module['Technology'])\n",
     "\n",
-    "# Get the mismatch modifiers\n",
-    "modifiers = \\\n",
-    "    pvlib.spectrum.martin_ruiz_spectral_modifier(clearness,\n",
-    "                                                airmass['airmass_absolute'],\n",
-    "                                                cell_type='monosi')"
+    "# Get the spectral mismatch modifiers\n",
+    "spectral_modifiers = \\\n",
+    "    pvlib.spectrum.martin_ruiz_spectral_modifier(clearness_index,\n",
+    "                                                 airmass['airmass_absolute'],\n",
+    "                                                 cell_type='monosi')"
    ]
   },
   {
@@ -190,7 +190,7 @@
    "metadata": {},
    "outputs": [],
    "source": [
-    "poa_irrad_modified = poa_irrad * modifiers\n",
+    "poa_irrad_modified = poa_irrad * spectral_modifiers\n",
     "# We need global modified irradiance for the output power calculation\n",
     "poa_irrad_modified = \\\n",
     "    pvlib.irradiance.poa_components(aoi,\n",

pvlib/spectrum/mismatch.py

@@ -241,10 +241,9 @@ def integrate(e):
 def martin_ruiz_spectral_modifier(clearness_index, airmass_absolute,
                                   cell_type=None, model_parameters=None):
     r"""
-    Calculate mismatch modifiers for POA direct, sky diffuse and ground diffuse
-    irradiances due to material's spectral response to spectrum characterised
-    by the clearness index and the absolute airmass, with respect to the
-    standard spectrum.
+    Calculate spectral mismatch modifiers for POA direct, sky diffuse and
+    ground diffuse irradiances using the clearness index and the absolute
+    airmass.
 
     .. warning::
         Included model parameters for ``monosi``, ``polysi`` and ``asi`` were