[DOC] add TEMPERATURE_MODEL_PARAMETERS to api.rst (#1036)

* add TEMPERATURE_MODEL_PARAMETERS to api.rst

* apply suggested changes to temp model params docstring

Co-authored-by: Cliff Hansen <[email protected]>

* fix stickler, typos in example

Co-authored-by: Cliff Hansen <[email protected]>

Author: mikofski

docs/sphinx/source/api.rst

@@ -238,6 +238,14 @@ PV temperature models
    temperature.pvsyst_cell
    temperature.faiman
 
+Temperature Model Parameters
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+.. currentmodule:: pvlib.temperature
+.. autodata:: TEMPERATURE_MODEL_PARAMETERS
+   :annotation:
+
+.. currentmodule:: pvlib
+
 Single diode models
 -------------------
 

pvlib/temperature.py

@@ -16,6 +16,23 @@
     'pvsyst': {'freestanding': {'u_c': 29.0, 'u_v': 0},
                'insulated': {'u_c': 15.0, 'u_v': 0}}
 }
+"""Dictionary of temperature parameters organized by model.
+
+There are keys for each model at the top level. Currently there are two models,
+``'sapm'`` for the Sandia Array Performance Model, and ``'pvsyst'``. Each model
+has a dictionary of configurations; a value is itself a dictionary containing
+model parameters. Retrieve parameters by indexing the model and configuration
+by name. Note: the keys are lower-cased and case sensitive.
+
+Example
+-------
+Retrieve the open rack glass-polymer configuration for SAPM::
+
+    from pvlib.temperature import TEMPERATURE_MODEL_PARAMETERS
+    temperature_model_parameters = (
+        TEMPERATURE_MODEL_PARAMETERS['sapm']['open_rack_glass_polymer'])
+    # {'a': -3.56, 'b': -0.075, 'deltaT': 3}
+"""
 
 
 def _temperature_model_params(model, parameter_set):
@@ -87,7 +104,7 @@ def sapm_cell(poa_global, temp_air, wind_speed, a, b, deltaT,
     ambient air temperature :math:`T_{a}` (C). Model parameters depend both on
     the module construction and its mounting. Parameter sets are provided in
     [1]_ for representative modules and mounting, and are coded for convenience
-    in ``pvlib.temperature.TEMPERATURE_MODEL_PARAMETERS``.
+    in :data:`~pvlib.temperature.TEMPERATURE_MODEL_PARAMETERS`.
 
     +---------------+----------------+-------+---------+---------------------+
     | Module        | Mounting       | a     | b       | :math:`\Delta T [C]`|
@@ -168,7 +185,7 @@ def sapm_module(poa_global, temp_air, wind_speed, a, b):
     :math:`T_{C}`. Model parameters depend both on the module construction and
     its mounting. Parameter sets are provided in [1]_ for representative
     modules and mounting, and are coded for convenience in
-    ``temperature.TEMPERATURE_MODEL_PARAMETERS``.
+    :data:`~pvlib.temperature.TEMPERATURE_MODEL_PARAMETERS`.
 
     +---------------+----------------+-------+---------+---------------------+
     | Module        | Mounting       | a     | b       | :math:`\Delta T [C]`|
@@ -238,7 +255,7 @@ def sapm_cell_from_module(module_temperature, poa_global, deltaT,
     Model parameters depend both on the module construction and its mounting.
     Parameter sets are provided in [1]_ for representative modules and
     mounting, and are coded for convenience in
-    ``pvlib.temperature.TEMPERATURE_MODEL_PARAMETERS``.
+    :data:`~pvlib.temperature.TEMPERATURE_MODEL_PARAMETERS`.
 
     +---------------+----------------+-------+---------+---------------------+
     | Module        | Mounting       | a     | b       | :math:`\Delta T [C]`|
@@ -323,8 +340,8 @@ def pvsyst_cell(poa_global, temp_air, wind_speed=1.0, u_c=29.0, u_v=0.0,
     the module construction and its mounting. Parameters are provided in
     [1]_ for open (freestanding) and close (insulated) mounting configurations,
     , and are coded for convenience in
-    ``temperature.TEMPERATURE_MODEL_PARAMETERS``. The heat loss factors
-    provided represent the combined effect of convection, radiation and
+    :data:`~pvlib.temperature.TEMPERATURE_MODEL_PARAMETERS`. The heat loss
+    factors provided represent the combined effect of convection, radiation and
     conduction, and their values are experimentally determined.
 
     +--------------+---------------+---------------+