DOC acorr is now in numpydoc format

NelleV · NelleV · commit 21aa6e40ff7c · 2013-07-05T12:22:26.000+02:00
diff --git a/lib/matplotlib/axes/_axes.py b/lib/matplotlib/axes/_axes.py
@@ -1531,63 +1531,61 @@ def semilogy(self, *args, **kwargs):
     @docstring.dedent_interpd
     def acorr(self, x, **kwargs):
         """
-        Plot the autocorrelation of *x*.
+        Plot the autocorrelation of `x`.
 
-        Call signature::
-
-            acorr(x, normed=True, detrend=mlab.detrend_none, usevlines=True,
-                  maxlags=10, **kwargs)
-
-        If *normed* = *True*, normalize the data by the autocorrelation at
-        0-th lag.  *x* is detrended by the *detrend* callable (default no
-        normalization).
-
-        Data are plotted as ``plot(lags, c, **kwargs)``
-
-        Return value is a tuple (*lags*, *c*, *line*) where:
+        Parameters
+        ----------
 
-          - *lags* are a length 2*maxlags+1 lag vector
+        x : sequence of scalar
 
-          - *c* is the 2*maxlags+1 auto correlation vector
+        hold : boolean, optional, default: True
 
-          - *line* is a :class:`~matplotlib.lines.Line2D` instance
-            returned by :meth:`plot`
+        detrend : callable, optional, default: `mlab.detrend_none`
+            x is detrended by the `detrend` callable. Default is no
+            normalization.
 
-        The default *linestyle* is None and the default *marker* is
-        ``'o'``, though these can be overridden with keyword args.
-        The cross correlation is performed with
-        :func:`numpy.correlate` with *mode* = 2.
+        normed : boolean, optional, default: True
+            if True, normalize the data by the autocorrelation at the 0-th
+            lag.
 
-        If *usevlines* is *True*, :meth:`~matplotlib.axes.Axes.vlines`
-        rather than :meth:`~matplotlib.axes.Axes.plot` is used to draw
-        vertical lines from the origin to the acorr.  Otherwise, the
-        plot style is determined by the kwargs, which are
-        :class:`~matplotlib.lines.Line2D` properties.
+        usevlines : boolean, optional, default: True
+            if True, Axes.vlines is used to plot the vertical lines from the origin
+            to the acorr. Otherwise, Axes.plot is used.
 
-        *maxlags* is a positive integer detailing the number of lags
-        to show.  The default value of *None* will return all
-        ``(2*len(x)-1)`` lags.
+        maxlags : integer, optional, default: 10 
+            number of lags to show. If None, will return all 2 * len(x) - 1
+            lags.
 
-        The return value is a tuple (*lags*, *c*, *linecol*, *b*)
-        where
+        Returns
+        -------
+        (lags, c, line, b) : where:
 
-          - *linecol* is the
-            :class:`~matplotlib.collections.LineCollection`
+          - `lags` are a length 2`maxlags+1 lag vector.
+          - `c` is the 2`maxlags+1 auto correlation vectorI
+          - `line` is a `~matplotlib.lines.Line2D` instance returned by
+            `plot`.
+          - `b` is the x-axis.
 
-          - *b* is the *x*-axis.
+        Other parameters
+        -----------------
+        linestyle : `~matplotlib.lines.Line2D` properties, optional, default: None
+            Only used if usevlines is False.
 
-        .. seealso::
+        marker : string, optional, default: 'o'
 
-            :meth:`~matplotlib.axes.Axes.plot` or
-            :meth:`~matplotlib.axes.Axes.vlines`
-            For documentation on valid kwargs.
+        Notes
+        -----
+        The cross correlation is performed with :func:`numpy.correlate` with
+        `mode` = 2.
 
-        **Example:**
+        Examples
+        --------
 
-        :func:`~matplotlib.pyplot.xcorr` is top graph, and
-        :func:`~matplotlib.pyplot.acorr` is bottom graph.
+        `~matplotlib.pyplot.xcorr` is top graph, and
+        `~matplotlib.pyplot.acorr` is bottom graph.
 
         .. plot:: mpl_examples/pylab_examples/xcorr_demo.py
+
         """
         return self.xcorr(x, x, **kwargs)
 
@@ -1597,54 +1595,52 @@ def xcorr(self, x, y, normed=True, detrend=mlab.detrend_none,
         """
         Plot the cross correlation between *x* and *y*.
 
-        Call signature::
-
-            xcorr(self, x, y, normed=True, detrend=mlab.detrend_none,
-              usevlines=True, maxlags=10, **kwargs)
-
-        If *normed* = *True*, normalize the data by the cross
-        correlation at 0-th lag.  *x* and y are detrended by the
-        *detrend* callable (default no normalization).  *x* and *y*
-        must be equal length.
-
-        Data are plotted as ``plot(lags, c, **kwargs)``
-
-        Return value is a tuple (*lags*, *c*, *line*) where:
+        Parameters
+        ----------
 
-          - *lags* are a length ``2*maxlags+1`` lag vector
+        x : sequence of scalars of length n
+        
+        y : sequence of scalars of length n
 
-          - *c* is the ``2*maxlags+1`` auto correlation vector
+        hold : boolean, optional, default: True
 
-          - *line* is a :class:`~matplotlib.lines.Line2D` instance
-             returned by :func:`~matplotlib.pyplot.plot`.
+        detrend : callable, optional, default: `mlab.detrend_none`
+            x is detrended by the `detrend` callable. Default is no
+            normalization.
 
-        The default *linestyle* is *None* and the default *marker* is
-        'o', though these can be overridden with keyword args.  The
-        cross correlation is performed with :func:`numpy.correlate`
-        with *mode* = 2.
+        normed : boolean, optional, default: True
+            if True, normalize the data by the autocorrelation at the 0-th
+            lag.
 
-        If *usevlines* is *True*:
+        usevlines : boolean, optional, default: True
+            if True, Axes.vlines is used to plot the vertical lines from the origin
+            to the acorr. Otherwise, Axes.plot is used.
 
-           :func:`~matplotlib.pyplot.vlines`
-           rather than :func:`~matplotlib.pyplot.plot` is used to draw
-           vertical lines from the origin to the xcorr.  Otherwise the
-           plotstyle is determined by the kwargs, which are
-           :class:`~matplotlib.lines.Line2D` properties.
+        maxlags : integer, optional, default: 10 
+            number of lags to show. If None, will return all 2 * len(x) - 1
+            lags.
 
-           The return value is a tuple (*lags*, *c*, *linecol*, *b*)
-           where *linecol* is the
-           :class:`matplotlib.collections.LineCollection` instance and
-           *b* is the *x*-axis.
+        Returns
+        -------
+        (lags, c, line, b) : where:
 
-        *maxlags* is a positive integer detailing the number of lags to show.
-        The default value of *None* will return all ``(2*len(x)-1)`` lags.
+          - `lags` are a length 2`maxlags+1 lag vector.
+          - `c` is the 2`maxlags+1 auto correlation vectorI
+          - `line` is a `~matplotlib.lines.Line2D` instance returned by
+            `plot`.
+          - `b` is the x-axis (none, if plot is used).
 
-        **Example:**
+        Other parameters
+        -----------------
+        linestyle : `~matplotlib.lines.Line2D` properties, optional, default: None
+            Only used if usevlines is False.
 
-        :func:`~matplotlib.pyplot.xcorr` is top graph, and
-        :func:`~matplotlib.pyplot.acorr` is bottom graph.
+        marker : string, optional, default: 'o'
 
-        .. plot:: mpl_examples/pylab_examples/xcorr_demo.py
+        Notes
+        -----
+        The cross correlation is performed with :func:`numpy.correlate` with
+        `mode` = 2.
         """
 
         Nx = len(x)
