update tutorial building workflow

Author: phobson

docs/tutorial/Makefile

@@ -140,7 +140,7 @@
     "Additionally, we'll compute the plotting positions two different but commone ways for each plot.\n",
     "\n",
     "First, in blue circles, we'll show the data with Weibull (α=0, β=0) plotting positions.\n",
-    "Weibull plotting positions are commonly use in my field, water resources engineering.\n",
+    "Weibull plotting positions are commonly use in fields such as hydrology and water resources engineering.\n",
     "\n",
     "In green squares, we'll use Cunnane (α=0.4, β=0.4) plotting positions.\n",
     "Cunnane plotting positions are good for normally distributed data and are the default values."
@@ -280,9 +280,9 @@
  "metadata": {
   "anaconda-cloud": {},
   "kernelspec": {
-   "display_name": "Python [default]",
+   "display_name": "probscale",
    "language": "python",
-   "name": "python3"
+   "name": "probscale"
   },
   "language_info": {
    "codemirror_mode": {

docs/tutorial/closer_look_at_plot_pos.ipynb

@@ -708,9 +708,9 @@
  "metadata": {
   "anaconda-cloud": {},
   "kernelspec": {
-   "display_name": "Python [default]",
+   "display_name": "probscale",
    "language": "python",
-   "name": "python3"
+   "name": "probscale"
   },
   "language_info": {
    "codemirror_mode": {

docs/tutorial/closer_look_at_viz.ipynb

@@ -379,9 +379,9 @@
  "metadata": {
   "anaconda-cloud": {},
   "kernelspec": {
-   "display_name": "Python [default]",
+   "display_name": "probscale",
    "language": "python",
-   "name": "python3"
+   "name": "probscale"
   },
   "language_info": {
    "codemirror_mode": {

docs/tutorial/getting_started.ipynb

@@ -0,0 +1,62 @@
+import os
+import glob
+
+import nbformat
+from nbconvert import RSTExporter, preprocessors
+
+
+def cache(nbfile):
+    basename, _ = os.path.splitext(nbfile)
+    bakfile = basename + '.bak'
+    with open(nbfile, 'r') as nb, open(bakfile, 'w') as bak:
+        bak.write(nb.read())
+    return bakfile
+
+
+def process(nbfile, processor):
+    meta = {'metadata': {'path': '.'}}
+    with open(nbfile, 'r') as nbf:
+        nbook = nbformat.read(nbf, as_version=4)
+
+    runner = processor(timeout=600, kernel_name='probscale')
+    runner.preprocess(nbook, meta)
+
+    with open(nbfile, 'w') as nbf:
+        nbformat.write(nbook, nbf)
+
+
+def convert(nbfile):
+    basename, _ = os.path.splitext(nbfile)
+    img_folder = basename + '_files'
+    os.makedirs(img_folder, exist_ok=True)
+    print("\tconverting " + nbfile)
+
+    with open(nbfile, 'r') as nb:
+        nbdata = nbformat.reads(nb.read(), as_version=4)
+
+    rst = RSTExporter()
+    body_raw, images = rst.from_notebook_node(nbdata)
+    body_final = body_raw.replace('.. image:: ', '.. image:: {}/'.format(img_folder))
+
+    with open(basename + '.rst', 'w') as rst_out:
+        rst_out.write(body_final)
+
+    for img_name, img_data in images['outputs'].items():
+        img_path = os.path.join(img_folder, img_name)
+        with open(img_path, 'wb') as img:
+            print('\twriting' + img_path)
+            img.write(img_data)
+
+
+if __name__ == '__main__':
+    for nbfile in glob.glob('*.ipynb'):
+        bak = cache(nbfile)
+        success = False
+        try:
+            process(nbfile, preprocessors.ExecutePreprocessor)
+            convert(nbfile)
+            success = True
+        finally:
+            process(nbfile, preprocessors.ClearOutputPreprocessor)
+        if success:
+            os.remove(bak)

docs/tutorial/make.py

@@ -421,12 +421,8 @@ def fit_line(x, y, xhat=None, fitprobs=None, fitlogs=None, dist=None,
         ``lambda x: dist.ppf(x / 100.)``.
         For a log transform, ``lambda x: numpy.log(x)``.
         Take care to not pass the same value to both ``fitlogs`` and
-<<<<<<< 801b29f5fb36417255ee93a7fe704cc1360cb89c
         ``figprobs`` as both transforms will be applied.
 
-=======
-        ``fitprobs`` as both transforms will be applied.
->>>>>>> fix minor doc typos
     dist : distribution, optional
         A fully-spec'd scipy.stats distribution-like object
         such that ``dist.ppf`` and ``dist.cdf`` can be called. If not