Support for PV systems with multiple arrays

ci/requirements-py36-min.yml

@@ -13,6 +13,7 @@ dependencies:
     - pytz
     - requests
     - pip:
+        - dataclasses
         - numpy==1.12.0
         - pandas==0.22.0
         - scipy==1.2.0

ci/requirements-py36.yml

@@ -27,5 +27,6 @@ dependencies:
     - siphon  # conda-forge
     - statsmodels
     - pip:
+        - dataclasses
         - nrel-pysam>=2.0
         - pvfactors==1.4.1

docs/sphinx/source/api.rst

@@ -20,9 +20,10 @@ corresponding procedural code.
 
    location.Location
    pvsystem.PVSystem
+   pvsystem.Array
    tracking.SingleAxisTracker
    modelchain.ModelChain
-
+   modelchain.ModelChainResult
 
 Solar Position
 ==============
@@ -583,6 +584,12 @@ Functions to assist with setting up ModelChains to run
    modelchain.ModelChain.prepare_inputs
    modelchain.ModelChain.prepare_inputs_from_poa
 
+Results
+-------
+
+Output from the running the ModelChain is stored in the
+:py:attr:`modelchain.ModelChain.results` attribute. For more
+information see :py:class:`modelchain.ModelChainResult`.
 
 Attributes
 ----------

docs/sphinx/source/conf.py

@@ -388,6 +388,10 @@ def get_linenos(obj):
         lines, start = inspect.getsourcelines(obj)
     except TypeError:  # obj is an attribute or None
         return None, None
+    except OSError:  # obj listing cannot be found
+        # This happens for methods that are not explicitly defined
+        # such as the __init__ method for a dataclass
+        return None, None
     else:
         return start, start + len(lines) - 1
 

docs/sphinx/source/forecasts.rst

@@ -471,7 +471,7 @@ Here's the forecast plane of array irradiance...
 
 .. ipython:: python
 
-    mc.total_irrad.plot();
+    mc.results.total_irrad.plot();
     @savefig poa_irrad.png width=6in
     plt.ylabel('Plane of array irradiance ($W/m^2$)');
     plt.legend(loc='best');
@@ -482,7 +482,7 @@ Here's the forecast plane of array irradiance...
 
 .. ipython:: python
 
-    mc.cell_temperature.plot();
+    mc.results.cell_temperature.plot();
     @savefig pv_temps.png width=6in
     plt.ylabel('Cell Temperature (C)');
     @suppress
@@ -492,7 +492,7 @@ Here's the forecast plane of array irradiance...
 
 .. ipython:: python
 
-    mc.ac.fillna(0).plot();
+    mc.results.ac.fillna(0).plot();
     plt.ylim(0, None);
     @savefig ac_power.png width=6in
     plt.ylabel('AC Power (W)');

docs/sphinx/source/introtutorial.rst

@@ -165,7 +165,7 @@ by examining the parameters defined for the module.
         # model results (ac, dc) and intermediates (aoi, temps, etc.)
         # assigned as mc object attributes
         mc.run_model(weather)
-        annual_energy = mc.ac.sum()
+        annual_energy = mc.results.ac.sum()
         energies[name] = annual_energy
 
     energies = pd.Series(energies)