updated formatting of docstring

Author: kurt-rhee

pvlib/transformer.py

@@ -17,12 +17,38 @@ def simple_efficiency(
 
     The equation used in this function can be derived from [1]_.
 
+
+    Parameters
+    ----------
+    input_power : numeric
+        The real power input to the transformer. [W]
+
+    no_load_loss : numeric
+        The constant losses experienced by a transformer, even
+        when the transformer is not under load. Fraction of transformer rating,
+        value from 0 to 1. [unitless]
+
+    load_loss:  numeric
+        The load dependent losses experienced by the transformer.
+        Fraction of transformer rating, value from 0 to 1. [unitless]
+
+    transformer_rating: numeric
+        The nominal output power of the transformer. [VA]
+
+    Returns
+    -------
+    output_power : numeric
+        Real power output. [W]
+
+    Notes
+    -------
     First, assume that the load loss is proportional to the square of output
     power.
 
         .. math::
-        L_{load}(P_{out}) = L_{load}(P_{out}) * P^2_{out}
-        L_{load}(P_{out}) = L_{full, load} * P^2_{out}
+
+           L_{load}(P_{out}) = L_{load}(P_{out}) * P^2_{out}
+           L_{load}(P_{out}) = L_{full, load} * P^2_{out}
 
     Total loss is the variable load loss, plus a constant no-load loss:
 
@@ -41,7 +67,7 @@ def simple_efficiency(
 
     Now use quadratic formula to solve for $P_{out}$ as a function of $P_in$.
 
-        ..math::
+        .. math::
 
            P_{out} = \frac{-b +- \sqrt{b^2 - 4ac}}{2a}
            a = L_{full, load}
@@ -50,7 +76,7 @@ def simple_efficiency(
 
     Therefore:
 
-        ..math::
+        .. math::
 
            P_{out} = \frac{-1 +- \sqrt{1 - 4*L_{full, load}*L_{no, load} -
            P_{in}}}{2*L_{no, load} - P_{in}}
@@ -59,29 +85,6 @@ def simple_efficiency(
     positive.
 
 
-    Parameters
-    ----------
-    input_power : numeric
-        The real power input to the transformer. [W]
-
-    no_load_loss : numeric
-        The constant losses experienced by a transformer, even
-        when the transformer is not under load. Fraction of transformer rating,
-        value from 0 to 1. [unitless]
-
-    load_loss:  numeric
-        The load dependent losses experienced by the transformer.
-        Fraction of transformer rating, value from 0 to 1. [unitless]
-
-    transformer_rating: numeric
-        The nominal output power of the transformer. [VA]
-
-    Returns
-    -------
-    output_power : numeric
-        Real power output. [W]
-
-
     References
     ----------
     .. [1] Central Station Engineers of the Westinghouse Electric Corporation,