Merge pull request #85 from phobson/update-readme2

actually update the readme

README.md

@@ -33,27 +33,49 @@ pip install -e .
 Simply importing `probscale` lets you use probability scales in your matplotlib figures:
 
 ```python
-import matplotlib.pyplot as plt
-import probscale
-
-fig, ax = plt.subplots(figsize=(8, 4))
-ax.set_ylim(1e-2, 1e2)
-ax.set_yscale('log')
-
-ax.set_xlim(0.5, 99.5)
-ax.set_xscale('prob')
+from matplotlib import pyplot
+from scipy import stats
+import probscale  # nothing else needed
+
+beta = stats.beta(a=3, b=4)
+weibull = stats.weibull_min(c=5)
+scales = [
+    {"scale": {"value": "linear"}, "label": "Linear (built-in)"},
+    {"scale": {"value": "log", "base": 10}, "label": "Log. Base 10 (built-in)"},
+    {"scale": {"value": "log", "base": 2}, "label": "Log. Base 2 (built-in)"},
+    {"scale": {"value": "logit"}, "label": "Logit (built-in)"},
+    {"scale": {"value": "prob"}, "label": "Standard Normal Probability (this package)"},
+    {
+        "scale": {"value": "prob", "dist": weibull},
+        "label": "Weibull probability scale, c=5 (this package)",
+    },
+    {
+        "scale": {"value": "prob", "dist": beta},
+        "label": "Beta probability scale, α=3 & β=4 (this package)",
+    },
+]
+
+N = len(scales)
+fig, axes = pyplot.subplots(nrows=N, figsize=(9, N - 1), constrained_layout=True)
+for scale, ax in zip(scales, axes.flat):
+    ax.set_xscale(**scale["scale"])
+    ax.text(0.0, 0.1, scale["label"] + " →", transform=ax.transAxes)
+    ax.set_xlim(left=0.5, right=99.5)
+    ax.set_yticks([])
+    ax.spines.left.set_visible(False)
+    ax.spines.right.set_visible(False)
+    ax.spines.top.set_visible(False)
+
+outpath = Path(__file__).parent.joinpath("../img/example.png").resolve()
+fig.savefig(outpath, dpi=300)
 ```
 
 ![Alt text](docs/img/example.png "Example axes")
 
 ## Testing
 
-Testing is generally done via the ``pytest`` and ``numpy.testing`` modules.
-The best way to run the tests is in an interactive python session:
+Testing is generally done via ``pytest``.
 
-```python
-import matplotlib
-matplotlib.use('agg')
-from probscale import tests
-tests.test()
+```shell
+python -m pytest --mpl --doctest-glob="probscale/*.py"
 ```