clean up tutorial and docstringexamples

Author: phobson

docs/tutorial/closer_look_at_viz.ipynb

@@ -552,7 +552,7 @@
    "source": [
     ".. note::\n",
     "   The ``probplot`` function can take two additional aesthetic parameters:\n",
-    "   `color` and `label`. If provided `color` will override the marker face color\n",
+    "   `color` and `label`. If provided, `color` will override the marker face color\n",
     "   and line color options of the `scatter_kws` and `line_kws` parameters, respectively.\n",
     "   Similarly, the label of the scatter series will be overridden by the explicit parameter.\n",
     "   It is not recommended that `color` and `label` are used. They exist primarily for \n",
@@ -605,7 +605,7 @@
     "        Used for Gumble distributions.\n",
     "        \n",
     "These are controlled via the `pp_kws` parameter in `probplot`\n",
-    "and are discussed in much more detail in the next tutorial`.\n"
+    "and are discussed in much more detail in the next tutorial.\n"
    ]
   },
   {

probscale/probscale.py

@@ -84,8 +84,8 @@ class ProbScale(ScaleBase):
 
         >>> from matplotlib import pyplot
         >>> import probscale
-        >>> fig, ax = pyplot.subplots()
-        >>> ax.set_ylim(bottom=0.2, top=99.8)
+        >>> fig, ax = pyplot.subplots(figsize=(4, 7))
+        >>> ax.set_ylim(bottom=0.5, top=99.5)
         >>> ax.set_yscale('prob')
 
     """

probscale/viz.py

@@ -114,20 +114,6 @@ def probplot(data, ax=None, plottype='prob', dist=None, probax='x',
         ...          line_kws=dict(linestyle='-', linewidth=2),
         ...          scatter_kws=dict(marker='s', alpha=0.5))
 
-
-
-    Quantile plot with a custom distribution
-
-    .. plot::
-        :context: close-figs
-
-        >>> norm = stats.norm(5, 1.25)
-        >>> fig = probplot(data, ax=ax, plottype='qq', dist=norm,
-        ...          probax='x', problabel='Theoretical Quantiles',
-        ...          datalabel='Observed values', bestfit=True,
-        ...          line_kws=dict(linestyle=':', linewidth=2),
-        ...          scatter_kws=dict(marker='^', alpha=0.5))
-
     """
 
     if dist is None:
@@ -237,32 +223,32 @@ def plot_pos(data, postype=None, alpha=None, beta=None):
     values can also be access via the ``postype`` parameter. Available
     ``postype`` values (alpha, beta) are:
 
-        "type 4" (alpha=0, beta=1)
+       "type 4" (alpha=0, beta=1)
             Linear interpolation of the empirical CDF.
-        "type 5" or "hazen" (alpha=0.5, beta=0.5)
+       "type 5" or "hazen" (alpha=0.5, beta=0.5)
             Piecewise linear interpolation.
-        "type 6" or "weibull" (alpha=0, beta=0)
+       "type 6" or "weibull" (alpha=0, beta=0)
             Weibull plotting positions. Unbiased exceedance probability
             for all distributions. Recommended for hydrologic
             applications.
-        "type 7" (alpha=1, beta=1)
+       "type 7" (alpha=1, beta=1)
             The default values in R. Not recommended with probability
             scales as the min and max data points get plotting positions
             of 0 and 1, respectively, and therefore cannot be shown.
-        "type 8" (alpha=1/3, beta=1/3)
+       "type 8" (alpha=1/3, beta=1/3)
             Approximately median-unbiased.
-        "type 9" or "blom" (alpha=0.375, beta=0.375)
+       "type 9" or "blom" (alpha=0.375, beta=0.375)
             Approximately unbiased positions if the data are normally
             distributed.
-        "median" (alpha=0.3175, beta=0.3175)
+       "median" (alpha=0.3175, beta=0.3175)
             Median exceedance probabilities for all distributions
             (used in ``scipy.stats.probplot``).
-        "apl" or "pwm" (alpha=0.35, beta=0.35)
+       "apl" or "pwm" (alpha=0.35, beta=0.35)
             Used with probability-weighted moments.
-        "cunnane" (alpha=0.4, beta=0.4)
+       "cunnane" (alpha=0.4, beta=0.4)
             Nearly unbiased quantiles for normally distributed data.
             This is the default value.
-        "gringorten" (alpha=0.44, beta=0.44)
+       "gringorten" (alpha=0.44, beta=0.44)
             Used for Gumble distributions.
 
     Parameters