Merge pull request Unidata#34 from dopplershift/docs

Full documentation (Fixes Unidata#19)

docs/source/api/io.rst

@@ -8,4 +8,4 @@ File Formats (I/O)
 
 .. automodule:: metpy.io
    :members:
-   :undoc-members:
+   :special-members: __init__

docs/source/examples/generated/Simple_Sounding.rst

@@ -8,6 +8,9 @@ Simple Sounding
     
     from metpy.calc import get_wind_components
     from metpy.plots import SkewT
+    
+    # Change default to be better for skew-T
+    plt.rcParams['figure.figsize'] = (9, 9)
 
 .. code:: python
 
@@ -18,9 +21,8 @@ Simple Sounding
 
 .. code:: python
 
-    # Create a new figure. The dimensions here give a good aspect ratio
-    fig = plt.figure(figsize=(9, 9))
-    skew = SkewT(fig)
+    # Create a skewT using matplotlib's default figure size
+    skew = SkewT()
     
     # Plot the data using normal plotting functions, in this case using
     # log scaling in Y, as dictated by the typical meteorological plot

examples/scripts/Simple_Sounding.py

@@ -5,14 +5,16 @@
 from metpy.calc import get_wind_components
 from metpy.plots import SkewT
 
+# Change default to be better for skew-T
+plt.rcParams['figure.figsize'] = (9, 9)
+
 # Parse the data
 p, T, Td, direc, spd = np.loadtxt('../testdata/sounding_data.txt',
         usecols=(0, 2, 3, 6, 7), unpack=True)
 u, v = get_wind_components(spd, direc)
 
-# Create a new figure. The dimensions here give a good aspect ratio
-fig = plt.figure(figsize=(9, 9))
-skew = SkewT(fig)
+# Create a skewT using matplotlib's default figure size
+skew = SkewT()
 
 # Plot the data using normal plotting functions, in this case using
 # log scaling in Y, as dictated by the typical meteorological plot