change racking_model default to none, formatting

Author: RDaxini

pvlib/pvsystem.py

@@ -17,7 +17,7 @@
 from abc import ABC, abstractmethod
 from typing import Optional, Union
 
-from pvlib._deprecation import deprecated, warn_deprecated
+from pvlib._deprecation import deprecated
 
 import pvlib  # used to avoid albedo name collision in the Array class
 from pvlib import (atmosphere, iam, inverter, irradiance,
@@ -104,7 +104,7 @@ class PVSystem:
     ----------
     arrays : Array or iterable of Array, optional
         An Array or list of arrays that are part of the system. If not
-        specified a single array is created from the other parameters (e.g.
+        specified, a single array is created from the other parameters (e.g.
         `surface_tilt`, `surface_azimuth`). If specified as a list, the list
         must contain at least one Array;
         if length of arrays is 0 a ValueError is raised. If `arrays` is
@@ -127,7 +127,7 @@ class PVSystem:
         (e.g. surface facing up = 0, surface facing horizon = 90)
 
     surface_azimuth: float or array-like, default 180
-        Azimuth angle of the module surface.
+        Azimuth angle of the module surface in decimal degrees.
         North=0, East=90, South=180, West=270.
 
     albedo : float, optional
@@ -142,19 +142,20 @@ class PVSystem:
 
     module : string, optional
         The model name of the modules.
-        May be used to look up the module_parameters dictionary
+        May be used to look up the ``module_parameters`` dictionary
         via some other method.
 
-    module_type : string, default 'glass_polymer'
-         Describes the module's construction. Valid strings are 'glass_polymer'
-         and 'glass_glass'. Used for cell and module temperature calculations.
+    module_type : string, default `glass_polymer`
+         Describes the module's construction. Valid strings are `glass_polymer`
+         and `glass_glass`. Used for cell and module temperature calculations.
 
     module_parameters : dict or Series, optional
         Module parameters as defined by the SAPM, CEC, or other.
 
     temperature_model_parameters : dict or Series, optional
         Temperature model parameters as required by one of the models in
-        pvlib.temperature (excluding poa_global, temp_air and wind_speed).
+        py:func:`pvlib.temperature` (excluding ``poa_global``, ``temp_air`` and
+                                     ``wind_speed``).
 
     modules_per_string: int or float, default 1
         See system topology discussion above.
@@ -170,8 +171,9 @@ class PVSystem:
     inverter_parameters : dict or Series, optional
         Inverter parameters as defined by the SAPM, CEC, or other.
 
-    racking_model : string, default 'open_rack'
-        Valid strings are 'open_rack', 'close_mount', and 'insulated_back'.
+    racking_model : string, default None
+        Valid strings are ``open_rack``, ``close_mount``, and
+        ``insulated_back``.
         Used to identify a parameter set for the SAPM cell temperature model.
 
     losses_parameters : dict or Series, optional
@@ -1373,7 +1375,7 @@ class FixedMount(AbstractMount):
         Azimuth angle of the module surface. North=0, East=90, South=180,
         West=270. [degrees]
 
-    racking_model : str, optional
+    racking_model : str, optional, default None
         Valid strings are 'open_rack', 'close_mount', and 'insulated_back'.
         Used to identify a parameter set for the SAPM cell temperature model.
 
@@ -1450,7 +1452,7 @@ class SingleAxisTrackerMount(AbstractMount):
         :func:`~pvlib.tracking.calc_cross_axis_tilt` to calculate
         `cross_axis_tilt`. [degrees]
 
-    racking_model : str, optional
+    racking_model : str, optional, default None
         Valid strings are 'open_rack', 'close_mount', and 'insulated_back'.
         Used to identify a parameter set for the SAPM cell temperature model.