1.4.5.3 代码文档

代码都有很好的文档，你可以在Python会话中用特定命令很快的访问：

In [3]:

  1. import pylab as pl
  2. help(pl.plot)
  1. Help on function plot in module matplotlib.pyplot:
  3. plot(*args, **kwargs)
  4.     Plot lines and/or markers to the
  5.     :class:`~matplotlib.axes.Axes`.  *args* is a variable length
  6.     argument, allowing for multiple *x*, *y* pairs with an
  7.     optional format string.  For example, each of the following is
  8.     legal::
  10.         plot(x, y)        # plot x and y using default line style and color
  11.         plot(x, y, 'bo')  # plot x and y using blue circle markers
  12.         plot(y)           # plot y using x as index array 0..N-1
  13.         plot(y, 'r+')     # ditto, but with red plusses
  15.     If *x* and/or *y* is 2-dimensional, then the corresponding columns
  16.     will be plotted.
  18.     An arbitrary number of *x*, *y*, *fmt* groups can be
  19.     specified, as in::
  21.         a.plot(x1, y1, 'g^', x2, y2, 'g-')
  23.     Return value is a list of lines that were added.
  25.     By default, each line is assigned a different color specified by a
  26.     'color cycle'.  To change this behavior, you can edit the
  27.     axes.color_cycle rcParam.
  29.     The following format string characters are accepted to control
  30.     the line style or marker:
  32.     ================    ===============================
  33.     character           description
  34.     ================    ===============================
  35.     ``'-'``             solid line style
  36.     ``'--'``            dashed line style
  37.     ``'-.'``            dash-dot line style
  38.     ``':'``             dotted line style
  39.     ``'.'``             point marker
  40.     ``','``             pixel marker
  41.     ``'o'``             circle marker
  42.     ``'v'``             triangle_down marker
  43.     ``'^'``             triangle_up marker
  44.     ``'<'``             triangle_left marker
  45.     ``'>'``             triangle_right marker
  46.     ``'1'``             tri_down marker
  47.     ``'2'``             tri_up marker
  48.     ``'3'``             tri_left marker
  49.     ``'4'``             tri_right marker
  50.     ``'s'``             square marker
  51.     ``'p'``             pentagon marker
  52.     ``'*'``             star marker
  53.     ``'h'``             hexagon1 marker
  54.     ``'H'``             hexagon2 marker
  55.     ``'+'``             plus marker
  56.     ``'x'``             x marker
  57.     ``'D'``             diamond marker
  58.     ``'d'``             thin_diamond marker
  59.     ``'|'``             vline marker
  60.     ``'_'``             hline marker
  61.     ================    ===============================
  63.     The following color abbreviations are supported:
  65.     ==========  ========
  66.     character   color
  67.     ==========  ========
  68.     'b'         blue
  69.     'g'         green
  70.     'r'         red
  71.     'c'         cyan
  72.     'm'         magenta
  73.     'y'         yellow
  74.     'k'         black
  75.     'w'         white
  76.     ==========  ========
  78.     In addition, you can specify colors in many weird and
  79.     wonderful ways, including full names (``'green'``), hex
  80.     strings (``'#008000'``), RGB or RGBA tuples (``(0,1,0,1)``) or
  81.     grayscale intensities as a string (``'0.8'``).  Of these, the
  82.     string specifications can be used in place of a ``fmt`` group,
  83.     but the tuple forms can be used only as ``kwargs``.
  85.     Line styles and colors are combined in a single format string, as in
  86.     ``'bo'`` for blue circles.
  88.     The *kwargs* can be used to set line properties (any property that has
  89.     a ``set_*`` method).  You can use this to set a line label (for auto
  90.     legends), linewidth, anitialising, marker face color, etc.  Here is an
  91.     example::
  93.         plot([1,2,3], [1,2,3], 'go-', label='line 1', linewidth=2)
  94.         plot([1,2,3], [1,4,9], 'rs',  label='line 2')
  95.         axis([0, 4, 0, 10])
  96.         legend()
  98.     If you make multiple lines with one plot command, the kwargs
  99.     apply to all those lines, e.g.::
  101.         plot(x1, y1, x2, y2, antialised=False)
  103.     Neither line will be antialiased.
  105.     You do not need to use format strings, which are just
  106.     abbreviations.  All of the line properties can be controlled
  107.     by keyword arguments.  For example, you can set the color,
  108.     marker, linestyle, and markercolor with::
  110.         plot(x, y, color='green', linestyle='dashed', marker='o',
  111.              markerfacecolor='blue', markersize=12).
  113.     See :class:`~matplotlib.lines.Line2D` for details.
  115.     The kwargs are :class:`~matplotlib.lines.Line2D` properties:
  117.       agg_filter: unknown
  118.       alpha: float (0.0 transparent through 1.0 opaque)         
  119.       animated: [True | False]         
  120.       antialiased or aa: [True | False]         
  121.       axes: an :class:`~matplotlib.axes.Axes` instance         
  122.       clip_box: a :class:`matplotlib.transforms.Bbox` instance         
  123.       clip_on: [True | False]         
  124.       clip_path: [ (:class:`~matplotlib.path.Path`,         :class:`~matplotlib.transforms.Transform`) |         :class:`~matplotlib.patches.Patch` | None ]         
  125.       color or c: any matplotlib color         
  126.       contains: a callable function         
  127.       dash_capstyle: ['butt' | 'round' | 'projecting']         
  128.       dash_joinstyle: ['miter' | 'round' | 'bevel']         
  129.       dashes: sequence of on/off ink in points         
  130.       drawstyle: ['default' | 'steps' | 'steps-pre' | 'steps-mid' |                   'steps-post']         
  131.       figure: a :class:`matplotlib.figure.Figure` instance         
  132.       fillstyle: ['full' | 'left' | 'right' | 'bottom' | 'top' | 'none']         
  133.       gid: an id string         
  134.       label: string or anything printable with '%s' conversion.         
  135.       linestyle or ls: [``'-'`` | ``'--'`` | ``'-.'`` | ``':'`` | ``'None'`` |                   ``' '`` | ``''``]
  136.       linewidth or lw: float value in points         
  137.       lod: [True | False]         
  138.       marker: unknown
  139.       markeredgecolor or mec: any matplotlib color         
  140.       markeredgewidth or mew: float value in points         
  141.       markerfacecolor or mfc: any matplotlib color         
  142.       markerfacecoloralt or mfcalt: any matplotlib color         
  143.       markersize or ms: float         
  144.       markevery: unknown
  145.       path_effects: unknown
  146.       picker: float distance in points or callable pick function         ``fn(artist, event)``         
  147.       pickradius: float distance in points         
  148.       rasterized: [True | False | None]         
  149.       sketch_params: unknown
  150.       snap: unknown
  151.       solid_capstyle: ['butt' | 'round' |  'projecting']         
  152.       solid_joinstyle: ['miter' | 'round' | 'bevel']         
  153.       transform: a :class:`matplotlib.transforms.Transform` instance         
  154.       url: a url string         
  155.       visible: [True | False]         
  156.       xdata: 1D array         
  157.       ydata: 1D array         
  158.       zorder: any number         
  160.     kwargs *scalex* and *scaley*, if defined, are passed on to
  161.     :meth:`~matplotlib.axes.Axes.autoscale_view` to determine
  162.     whether the *x* and *y* axes are autoscaled; the default is
  163.     *True*.
  165.     Additional kwargs: hold = [True|False] overrides default hold state