Add notes on system-wide parameters to PVSystem method docstrings

Author: wfvining

pvlib/pvsystem.py

@@ -344,6 +344,14 @@ def get_irradiance(self, solar_zenith, solar_azimuth, dni, ghi, dhi,
         kwargs
             Extra parameters passed to :func:`irradiance.get_total_irradiance`.
 
+        Notes
+        -----
+        Each of `dni`, `ghi`, and `dni` parameters may be passed as a tuple
+        to provide different irradiance for each array in the system. If not
+        passed as a tuple then the same value is used for input to each Array.
+        If passed as a tuple the length must be the same as the number of
+        Arrays.
+
         Returns
         -------
         poa_irradiance : DataFrame or tuple of DataFrame
@@ -567,6 +575,14 @@ def sapm_celltemp(self, poa_global, temp_air, wind_speed):
         -------
         numeric or tuple of numeric
             values in degrees C.
+
+        Notes
+        -----
+        The `temp_air` and `wind_speed` parameters may be passed as tuples
+        to provide different values for each Array in the system. If not
+        passed as a tuple then the same value is used for input to each Array.
+        If passed as a tuple the length must be the same as the number of
+        Arrays.
         """
         poa_global = self._validate_per_array(poa_global)
         temp_air = self._validate_per_array(temp_air, system_wide=True)
@@ -680,6 +696,14 @@ def pvsyst_celltemp(self, poa_global, temp_air, wind_speed=1.0):
         -------
         numeric or tuple of numeric
             values in degrees C.
+
+        Notes
+        -----
+        The `temp_air` and `wind_speed` parameters may be passed as tuples
+        to provide different values for each Array in the system. If not
+        passed as a tuple then the same value is used for input to each Array.
+        If passed as a tuple the length must be the same as the number of
+        Arrays.
         """
         poa_global = self._validate_per_array(poa_global)
         temp_air = self._validate_per_array(temp_air, system_wide=True)
@@ -720,6 +744,14 @@ def faiman_celltemp(self, poa_global, temp_air, wind_speed=1.0):
         -------
         numeric or tuple of numeric
             values in degrees C.
+
+        Notes
+        -----
+        The `temp_air` and `wind_speed` parameters may be passed as tuples
+        to provide different values for each Array in the system. If not
+        passed as a tuple then the same value is used for input to each Array.
+        If passed as a tuple the length must be the same as the number of
+        Arrays.
         """
         poa_global = self._validate_per_array(poa_global)
         temp_air = self._validate_per_array(temp_air, system_wide=True)
@@ -763,6 +795,14 @@ def fuentes_celltemp(self, poa_global, temp_air, wind_speed):
         transposition. This method defaults to using ``self.surface_tilt``, but
         if you want to match the PVWatts behavior, you can override it by
         including a ``surface_tilt`` value in ``temperature_model_parameters``.
+
+        Notes
+        -----
+        The `temp_air` and `wind_speed` parameters may be passed as tuples
+        to provide different values for each Array in the system. If not
+        passed as a tuple then the same value is used for input to each Array.
+        If passed as a tuple the length must be the same as the number of
+        Arrays.
         """
         # default to using the Array attribute, but allow user to
         # override with a custom surface_tilt value