# -*- coding: utf-8 -*-
"""
Resonance Raman
==========

A Resonance Raman plot.
"""

import WrightTools as wt
from WrightTools import datasets

p = datasets.BrunoldrRaman.LDS821_514nm_80mW
data = wt.data.from_BrunoldrRaman(p)
trash_pixels = 56
data = data.split(0, 843.0)[1]

data.convert('wn', verbose=False)

artist = wt.artists.mpl_1D(data)
d = artist.plot()

examples/rRaman.py
# -*- coding: utf-8 -*-
"""
Resonance Raman
===============

A Resonance Raman plot.
"""

import WrightTools as wt
from WrightTools import datasets

p = datasets.BrunoldrRaman.LDS821_514nm_80mW
data = wt.data.from_BrunoldrRaman(p)
trash_pixels = 56
data = data.split(0, 843.0)[1]

data.convert('wn', verbose=False)

artist = wt.artists.mpl_1D(data)
d = artist.plot()

examples/rRaman.py
diff --git a/docs/datasets.rst b/docs/datasets.rst
index e2abf796d..a842101c8 100644
--- a/docs/datasets.rst
+++ b/docs/datasets.rst
@@ -9,19 +9,24 @@ They're also a lot of fun!
 
 The following table contains every dataset distributed within WrightTools.
 
-========================================  ============================  ===================  ================================  ==============
-dataset                                   axis names                    shape                reference                         gallery links
-----------------------------------------  ----------------------------  -------------------  --------------------------------  --------------
-``COLORS.v0p2_d1_d2_diagonal``            ``['d1', 'd2']``              ``(21, 21)``         doi:10.1021/jp412058u
-``COLORS.v0p2_d1_d2_off_diagonal``        ``['d1', 'd2']``              ``(21, 21)``         doi:10.1021/jp412058u
-``COLORS.v2p1_MoS2_TrEE_movie``           ``['w2', 'w1', 'd2']``        ``(41, 41, 23)``     doi:10.1021/acsnano.5b05198
-``JASCO.PbSe_batch_1``                    ``['wm']``                    ``(1801,)``          doi:10.1021/jp207273x
-``JASCO.PbSe_batch_4_2012_02_21``         ``['wm']``                    ``(1251,)``          doi:10.1021/jp412058u
-``JASCO.PbSe_batch_4_2012_03_15``         ``['wm']``                    ``(1251,)``          doi:10.1021/jp412058u
-``KENT.LDS821_TRSF``                      ``['w2', 'w1']``              ``(71, 71)``         doi:10.1021/jp409377a
-``KENT.PbSe_2D_delay_A``                  ``['d2', 'd1']``              ``(20, 30)``         doi:10.1021/jp207273x
-``KENT.PbSe_2D_delay_B``                  ``['d2', 'd1']``              ``(20, 20)``         doi:10.1021/jp207273x
-``PyCMDS.wm_w2_w1_000``                   ``['wm', 'w2', 'w1']``        ``(35, 11, 11)``
-``PyCMDS.wm_w2_w1_001``                   ``['wm', 'w2', 'w1']``        ``(29, 11, 11)``
-``BrunoldrRaman.LDS821_514nm_80mW``       ``['wm']``                    ``(1340,)``
-========================================  ============================  ===================  ================================  ==============
+=================================================  ============================  ===================  ==============
+dataset                                            axis names                    shape                gallery links
+=================================================  ============================  ===================  ==============
+``COLORS.v0p2_d1_d2_diagonal`` [#kohler2014]_      ``['d1', 'd2']``              ``(21, 21)``        
+``COLORS.v0p2_d1_d2_off_diagonal`` [#kohler2014]_  ``['d1', 'd2']``              ``(21, 21)``       
+``COLORS.v2p1_MoS2_TrEE_movie`` [#czech2015]_      ``['w2', 'w1', 'd2']``        ``(41, 41, 23)``  
+``JASCO.PbSe_batch_1`` [#yurs2011]_                ``['wm']``                    ``(1801,)``      
+``JASCO.PbSe_batch_4_2012_02_21`` [#kohler2014]_   ``['wm']``                    ``(1251,)``     
+``JASCO.PbSe_batch_4_2012_03_15`` [#kohler2014]_   ``['wm']``                    ``(1251,)``    
+``KENT.LDS821_TRSF`` [#boyle2013]_                 ``['w2', 'w1']``              ``(71, 71)``         
+``KENT.PbSe_2D_delay_A`` [#yurs2011]_              ``['d2', 'd1']``              ``(20, 30)``         
+``KENT.PbSe_2D_delay_B`` [#yurs2011]_              ``['d2', 'd1']``              ``(20, 20)``         
+``PyCMDS.wm_w2_w1_000``                            ``['wm', 'w2', 'w1']``        ``(35, 11, 11)``
+``PyCMDS.wm_w2_w1_001``                            ``['wm', 'w2', 'w1']``        ``(29, 11, 11)``
+``BrunoldrRaman.LDS821_514nm_80mW``                ``['wm']``                    ``(1340,)``
+=================================================  ============================  ===================  ==============
+
+.. [#kohler2014] `doi:10.1021/jp412058u <http://dx.doi.org/10.1021/jp412058u>`_
+.. [#czech2015] `doi:10.1021/acsnano.5b05198 <http://dx.doi.org/10.1021/acsnano.5b05198>`_
+.. [#yurs2011] `doi:10.1021/jp207273x <http://dx.doi.org/10.1021/jp207273x>`_
+.. [#boyle2013] `doi:10.1021/jp409377a <http://dx.doi.org/10.1021/jp409377a>`_
diff --git a/examples/rRaman.py b/examples/rRaman.py
index 8efbd4149..7a91d22f0 100644
--- a/examples/rRaman.py
+++ b/examples/rRaman.py
@@ -1,7 +1,7 @@
 # -*- coding: utf-8 -*-
 """
 Resonance Raman
-==========
+===============
 
 A Resonance Raman plot.
 """

Contours in mpl_2D seem to have shape problem. 
I'm running the following script
```
import WrightTools as wt

p = '000.data'
d = wt.data.from_PyCMDS(p)
d.signal_ratio.clip(zmin=-4, zmax=4)
d.signal_ratio.znull = 0
d.signal_ratio.signed = True
d.signal_ratio._update()

art = wt.artists.mpl_2D(d)
art.plot(channel='signal_ratio', contours=9)
```
using the dataset found in `'Google Drive/MX2/CMDS/2017-08-07/p-CMDS-p/0ps 51 [w2, w1]'`. I get the following error.
```
Traceback (most recent call last):

  File "<ipython-input-98-92c093c4abb1>", line 1, in <module>
    runfile('/Users/darienmorrow/Google Drive/MX2/CMDS/2017-08-07/p-CMDS-p/0ps 51 [w2, w1]/workup.py', wdir='/Users/darienmorrow/Google Drive/MX2/CMDS/2017-08-07/p-CMDS-p/0ps 51 [w2, w1]')

  File "/Users/darienmorrow/anaconda/lib/python3.6/site-packages/spyder/utils/site/sitecustomize.py", line 866, in runfile
    execfile(filename, namespace)

  File "/Users/darienmorrow/anaconda/lib/python3.6/site-packages/spyder/utils/site/sitecustomize.py", line 102, in execfile
    exec(compile(f.read(), filename, 'exec'), namespace)

  File "/Users/darienmorrow/Google Drive/MX2/CMDS/2017-08-07/p-CMDS-p/0ps 51 [w2, w1]/workup.py", line 15, in <module>
    art.plot(channel='signal_ratio', contours=9, contours_local=False)

  File "/Users/darienmorrow/source/WrightTools/WrightTools/artists.py", line 1858, in plot
    subplot_main.contour(X, Y, zi, contours_levels, colors='k')

  File "/Users/darienmorrow/anaconda/lib/python3.6/site-packages/matplotlib/__init__.py", line 1892, in inner
    return func(ax, *args, **kwargs)

  File "/Users/darienmorrow/anaconda/lib/python3.6/site-packages/matplotlib/axes/_axes.py", line 5819, in contour
    contours = mcontour.QuadContourSet(self, *args, **kwargs)

  File "/Users/darienmorrow/anaconda/lib/python3.6/site-packages/matplotlib/contour.py", line 864, in __init__
    self._process_args(*args, **kwargs)

  File "/Users/darienmorrow/anaconda/lib/python3.6/site-packages/matplotlib/contour.py", line 1429, in _process_args
    x, y, z = self._contour_args(args, kwargs)

  File "/Users/darienmorrow/anaconda/lib/python3.6/site-packages/matplotlib/contour.py", line 1508, in _contour_args
    x, y, z = self._check_xyz(args[:3], kwargs)

  File "/Users/darienmorrow/anaconda/lib/python3.6/site-packages/matplotlib/contour.py", line 1566, in _check_xyz
    "{0} instead of {1}.".format(x.shape, z.shape))

TypeError: Shape of x does not match that of z: found (52, 52) instead of (51, 51).
```

