Port notebooks to a gallery

docs/examples/README.rst

@@ -3,4 +3,4 @@
 Example Gallery
 ===============
 
-This gallery shows examples of pvlib functionality.  Community contributions are welcome!
+This gallery shows examples of pvlib functionality. Community contributions are welcome!

docs/sphinx/source/conf.py

@@ -355,10 +355,14 @@ def setup(app):
 
 # settings for sphinx-gallery
 sphinx_gallery_conf = {
-    'examples_dirs': ['../../examples'],  # location of gallery scripts
-    'gallery_dirs': ['gallery'],  # location of generated output
+    'examples_dirs': [  # location of gallery scripts
+        '../../examples',
+        '../../tutorials'],
+    'gallery_dirs': [  # location of generated output
+        'gallery_examples',
+        'gallery_tutorials'],
     # sphinx-gallery only shows plots from plot_*.py files by default:
-    # 'filename_pattern': '*.py',
+    'filename_pattern': r'.*\.py',
 
     # directory where function/class granular galleries are stored
     'backreferences_dir': 'reference/generated/gallery_backreferences',

docs/sphinx/source/index.rst

@@ -103,7 +103,8 @@ Contents
    :maxdepth: 1
 
    user_guide/index
-   gallery/index
+   gallery_examples/index
+   gallery_tutorials/index
    reference/index
    whatsnew
    contributing

docs/tutorials/README.rst

@@ -0,0 +1,8 @@
+.. _tutorials_gallery:
+
+Tutorials
+=========
+
+This gallery shows tutorials about pvlib.
+
+Community contributions are welcome!

docs/tutorials/atmosphere.py

@@ -0,0 +1,64 @@
+"""
+``atmosphere.py`` tutorial
+==========================
+"""
+
+# %%
+# This tutorial needs your help to make it better!
+#
+# This tutorial requires pvlib > 0.6.0.
+#
+# Authors:
+#
+# - Will Holmgren (@wholmgren), University of Arizona. 2015, March 2016,
+#   August 2018.
+
+
+import datetime
+
+import matplotlib.pyplot as plt
+import pandas as pd
+
+from pvlib import solarposition, atmosphere
+from pvlib.location import Location
+
+# %%
+
+tus = Location(32.2, -111, 'US/Arizona', 700, 'Tucson')
+print(tus)
+
+times = pd.date_range(start=datetime.datetime(2014, 6, 24),
+                      end=datetime.datetime(2014, 6, 25),
+                      freq='1Min', tz=tus.tz)
+
+solpos = solarposition.get_solarposition(times, tus.latitude, tus.longitude)
+print(solpos.head())
+solpos.plot()
+
+# %%
+
+atmosphere.get_relative_airmass(solpos['zenith']) \
+    .plot(label='kastenyoung1989, zenith')
+atmosphere.get_relative_airmass(solpos['apparent_zenith']) \
+    .plot(label='kastenyoung1989, app. zenith')
+atmosphere.get_relative_airmass(solpos['zenith'], model='young1994') \
+    .plot(label='young1994, zenith')
+atmosphere.get_relative_airmass(solpos['zenith'], model='simple') \
+    .plot(label='simple, zenith')
+plt.legend()
+plt.ylabel('Airmass')
+plt.ylim(0, 100)
+
+# %%
+
+plt.plot(solpos['zenith'],
+         atmosphere.get_relative_airmass(solpos['zenith'], model='simple'),
+         label='simple')
+plt.plot(solpos['zenith'],
+         atmosphere.get_relative_airmass(solpos['apparent_zenith']),
+         label='default')
+plt.xlim(0, 100)
+plt.ylim(0, 100)
+plt.xlabel('Zenith angle (deg)')
+plt.ylabel('Airmass')
+plt.legend()