<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>draw_networkx — NetworkX 1.8.1 documentation</title>
<link rel="stylesheet" href="../../_static/networkx.css" type="text/css" />
<link rel="stylesheet" href="../../_static/pygments.css" type="text/css" />
<script type="text/javascript">
var DOCUMENTATION_OPTIONS = {
URL_ROOT: '../../',
VERSION: '1.8.1',
COLLAPSE_INDEX: false,
FILE_SUFFIX: '.html',
HAS_SOURCE: false
};
</script>
<script type="text/javascript" src="../../_static/jquery.js"></script>
<script type="text/javascript" src="../../_static/underscore.js"></script>
<script type="text/javascript" src="../../_static/doctools.js"></script>
<link rel="search" type="application/opensearchdescription+xml"
title="Search within NetworkX 1.8.1 documentation"
href="../../_static/opensearch.xml"/>
<link rel="top" title="NetworkX 1.8.1 documentation" href="../../index.html" />
<link rel="up" title="Drawing" href="../drawing.html" />
<link rel="next" title="draw_networkx_nodes" href="networkx.drawing.nx_pylab.draw_networkx_nodes.html" />
<link rel="prev" title="draw" href="networkx.drawing.nx_pylab.draw.html" />
</head>
<body>
<div style="color: black;background-color: white; font-size: 3.2em; text-align: left; padding: 15px 10px 10px 15px">
NetworkX
</div>
<div class="related">
<h3>Navigation</h3>
<ul>
<li class="right" style="margin-right: 10px">
<a href="../../genindex.html" title="General Index"
accesskey="I">index</a></li>
<li class="right" >
<a href="../../py-modindex.html" title="Python Module Index"
>modules</a> |</li>
<li class="right" >
<a href="networkx.drawing.nx_pylab.draw_networkx_nodes.html" title="draw_networkx_nodes"
accesskey="N">next</a> |</li>
<li class="right" >
<a href="networkx.drawing.nx_pylab.draw.html" title="draw"
accesskey="P">previous</a> |</li>
<li><a href="http://networkx.github.com/">NetworkX Home </a> | </li>
<li><a href="http://networkx.github.com/documentation.html">Documentation </a>| </li>
<li><a href="http://networkx.github.com/download.html">Download </a> | </li>
<li><a href="http://github.com/networkx">Developer (Github)</a></li>
<li><a href="../index.html" >Reference</a> »</li>
<li><a href="../pdf_reference.html" >Reference</a> »</li>
<li><a href="../drawing.html" accesskey="U">Drawing</a> »</li>
</ul>
</div>
<div class="sphinxsidebar">
<div class="sphinxsidebarwrapper">
<h4>Previous topic</h4>
<p class="topless"><a href="networkx.drawing.nx_pylab.draw.html"
title="previous chapter">draw</a></p>
<h4>Next topic</h4>
<p class="topless"><a href="networkx.drawing.nx_pylab.draw_networkx_nodes.html"
title="next chapter">draw_networkx_nodes</a></p>
<div id="searchbox" style="display: none">
<h3>Quick search</h3>
<form class="search" action="../../search.html" method="get">
<input type="text" name="q" />
<input type="submit" value="Go" />
<input type="hidden" name="check_keywords" value="yes" />
<input type="hidden" name="area" value="default" />
</form>
<p class="searchtip" style="font-size: 90%">
Enter search terms or a module, class or function name.
</p>
</div>
<script type="text/javascript">$('#searchbox').show(0);</script>
</div>
</div>
<div class="document">
<div class="documentwrapper">
<div class="bodywrapper">
<div class="body">
<div class="section" id="draw-networkx">
<h1>draw_networkx<a class="headerlink" href="#draw-networkx" title="Permalink to this headline">¶</a></h1>
<dl class="function">
<dt id="networkx.drawing.nx_pylab.draw_networkx">
<tt class="descname">draw_networkx</tt><big>(</big><em>G</em>, <em>pos=None</em>, <em>with_labels=True</em>, <em>**kwds</em><big>)</big><a class="reference internal" href="../../_modules/networkx/drawing/nx_pylab.html#draw_networkx"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#networkx.drawing.nx_pylab.draw_networkx" title="Permalink to this definition">¶</a></dt>
<dd><p>Draw the graph G using Matplotlib.</p>
<p>Draw the graph with Matplotlib with options for node positions,
labeling, titles, and many other drawing features.
See draw() for simple drawing without labels or axes.</p>
<table class="docutils field-list" frame="void" rules="none">
<col class="field-name" />
<col class="field-body" />
<tbody valign="top">
<tr class="field-odd field"><th class="field-name">Parameters :</th><td class="field-body"><p class="first"><strong>G</strong> : graph</p>
<blockquote>
<div><p>A networkx graph</p>
</div></blockquote>
<p><strong>pos</strong> : dictionary, optional</p>
<blockquote>
<div><p>A dictionary with nodes as keys and positions as values.
If not specified a spring layout positioning will be computed.
See networkx.layout for functions that compute node positions.</p>
</div></blockquote>
<p><strong>with_labels</strong> : bool, optional (default=True)</p>
<blockquote>
<div><p>Set to True to draw labels on the nodes.</p>
</div></blockquote>
<p><strong>ax</strong> : Matplotlib Axes object, optional</p>
<blockquote>
<div><p>Draw the graph in the specified Matplotlib axes.</p>
</div></blockquote>
<p><strong>nodelist</strong> : list, optional (default G.nodes())</p>
<blockquote>
<div><p>Draw only specified nodes</p>
</div></blockquote>
<p><strong>edgelist</strong> : list, optional (default=G.edges())</p>
<blockquote>
<div><p>Draw only specified edges</p>
</div></blockquote>
<p><strong>node_size</strong> : scalar or array, optional (default=300)</p>
<blockquote>
<div><p>Size of nodes. If an array is specified it must be the
same length as nodelist.</p>
</div></blockquote>
<p><strong>node_color</strong> : color string, or array of floats, (default=’r’)</p>
<blockquote>
<div><p>Node color. Can be a single color format string,
or a sequence of colors with the same length as nodelist.
If numeric values are specified they will be mapped to
colors using the cmap and vmin,vmax parameters. See
matplotlib.scatter for more details.</p>
</div></blockquote>
<p><strong>node_shape</strong> : string, optional (default=’o’)</p>
<blockquote>
<div><p>The shape of the node. Specification is as matplotlib.scatter
marker, one of ‘so^>v<dph8’.</p>
</div></blockquote>
<p><strong>alpha</strong> : float, optional (default=1.0)</p>
<blockquote>
<div><p>The node transparency</p>
</div></blockquote>
<p><strong>cmap</strong> : Matplotlib colormap, optional (default=None)</p>
<blockquote>
<div><p>Colormap for mapping intensities of nodes</p>
</div></blockquote>
<p><strong>vmin,vmax</strong> : float, optional (default=None)</p>
<blockquote>
<div><p>Minimum and maximum for node colormap scaling</p>
</div></blockquote>
<p><strong>linewidths</strong> : [None | scalar | sequence]</p>
<blockquote>
<div><p>Line width of symbol border (default =1.0)</p>
</div></blockquote>
<p><strong>width</strong> : float, optional (default=1.0)</p>
<blockquote>
<div><p>Line width of edges</p>
</div></blockquote>
<p><strong>edge_color</strong> : color string, or array of floats (default=’r’)</p>
<blockquote>
<div><p>Edge color. Can be a single color format string,
or a sequence of colors with the same length as edgelist.
If numeric values are specified they will be mapped to
colors using the edge_cmap and edge_vmin,edge_vmax parameters.</p>
</div></blockquote>
<p><strong>edge_ cmap</strong> : Matplotlib colormap, optional (default=None)</p>
<blockquote>
<div><p>Colormap for mapping intensities of edges</p>
</div></blockquote>
<p><strong>edge_vmin,edge_vmax</strong> : floats, optional (default=None)</p>
<blockquote>
<div><p>Minimum and maximum for edge colormap scaling</p>
</div></blockquote>
<p><strong>style</strong> : string, optional (default=’solid’)</p>
<blockquote>
<div><p>Edge line style (solid|dashed|dotted,dashdot)</p>
</div></blockquote>
<p><strong>labels</strong> : dictionary, optional (default=None)</p>
<blockquote>
<div><p>Node labels in a dictionary keyed by node of text labels</p>
</div></blockquote>
<p><strong>font_size</strong> : int, optional (default=12)</p>
<blockquote>
<div><p>Font size for text labels</p>
</div></blockquote>
<p><strong>font_color</strong> : string, optional (default=’k’ black)</p>
<blockquote>
<div><p>Font color string</p>
</div></blockquote>
<p><strong>font_weight</strong> : string, optional (default=’normal’)</p>
<blockquote>
<div><p>Font weight</p>
</div></blockquote>
<p><strong>font_family</strong> : string, optional (default=’sans-serif’)</p>
<blockquote>
<div><p>Font family</p>
</div></blockquote>
<p><strong>label</strong> : string, optional</p>
<blockquote class="last">
<div><p>Label for graph legend</p>
</div></blockquote>
</td>
</tr>
</tbody>
</table>
<div class="admonition-see-also admonition seealso">
<p class="first admonition-title">See also</p>
<p class="last"><a class="reference internal" href="networkx.drawing.nx_pylab.draw.html#networkx.drawing.nx_pylab.draw" title="networkx.drawing.nx_pylab.draw"><tt class="xref py py-obj docutils literal"><span class="pre">draw</span></tt></a>, <a class="reference internal" href="networkx.drawing.nx_pylab.draw_networkx_nodes.html#networkx.drawing.nx_pylab.draw_networkx_nodes" title="networkx.drawing.nx_pylab.draw_networkx_nodes"><tt class="xref py py-obj docutils literal"><span class="pre">draw_networkx_nodes</span></tt></a>, <a class="reference internal" href="networkx.drawing.nx_pylab.draw_networkx_edges.html#networkx.drawing.nx_pylab.draw_networkx_edges" title="networkx.drawing.nx_pylab.draw_networkx_edges"><tt class="xref py py-obj docutils literal"><span class="pre">draw_networkx_edges</span></tt></a>, <a class="reference internal" href="networkx.drawing.nx_pylab.draw_networkx_labels.html#networkx.drawing.nx_pylab.draw_networkx_labels" title="networkx.drawing.nx_pylab.draw_networkx_labels"><tt class="xref py py-obj docutils literal"><span class="pre">draw_networkx_labels</span></tt></a>, <a class="reference internal" href="networkx.drawing.nx_pylab.draw_networkx_edge_labels.html#networkx.drawing.nx_pylab.draw_networkx_edge_labels" title="networkx.drawing.nx_pylab.draw_networkx_edge_labels"><tt class="xref py py-obj docutils literal"><span class="pre">draw_networkx_edge_labels</span></tt></a></p>
</div>
<p class="rubric">Examples</p>
<div class="highlight-python"><div class="highlight"><pre><span class="gp">>>> </span><span class="n">G</span><span class="o">=</span><span class="n">nx</span><span class="o">.</span><span class="n">dodecahedral_graph</span><span class="p">()</span>
<span class="gp">>>> </span><span class="n">nx</span><span class="o">.</span><span class="n">draw</span><span class="p">(</span><span class="n">G</span><span class="p">)</span>
<span class="gp">>>> </span><span class="n">nx</span><span class="o">.</span><span class="n">draw</span><span class="p">(</span><span class="n">G</span><span class="p">,</span><span class="n">pos</span><span class="o">=</span><span class="n">nx</span><span class="o">.</span><span class="n">spring_layout</span><span class="p">(</span><span class="n">G</span><span class="p">))</span> <span class="c"># use spring layout</span>
</pre></div>
</div>
<div class="highlight-python"><div class="highlight"><pre><span class="gp">>>> </span><span class="kn">import</span> <span class="nn">matplotlib.pyplot</span> <span class="kn">as</span> <span class="nn">plt</span>
<span class="gp">>>> </span><span class="n">limits</span><span class="o">=</span><span class="n">plt</span><span class="o">.</span><span class="n">axis</span><span class="p">(</span><span class="s">'off'</span><span class="p">)</span> <span class="c"># turn of axis</span>
</pre></div>
</div>
<p>Also see the NetworkX drawing examples at
<a class="reference external" href="http://networkx.lanl.gov/gallery.html">http://networkx.lanl.gov/gallery.html</a></p>
</dd></dl>
</div>
</div>
</div>
</div>
<div class="clearer"></div>
</div>
<div class="related">
<h3>Navigation</h3>
<ul>
<li class="right" style="margin-right: 10px">
<a href="../../genindex.html" title="General Index"
>index</a></li>
<li class="right" >
<a href="../../py-modindex.html" title="Python Module Index"
>modules</a> |</li>
<li class="right" >
<a href="networkx.drawing.nx_pylab.draw_networkx_nodes.html" title="draw_networkx_nodes"
>next</a> |</li>
<li class="right" >
<a href="networkx.drawing.nx_pylab.draw.html" title="draw"
>previous</a> |</li>
<li><a href="http://networkx.github.com/">NetworkX Home </a> | </li>
<li><a href="http://networkx.github.com/documentation.html">Documentation </a>| </li>
<li><a href="http://networkx.github.com/download.html">Download </a> | </li>
<li><a href="http://github.com/networkx">Developer (Github)</a></li>
<li><a href="../index.html" >Reference</a> »</li>
<li><a href="../pdf_reference.html" >Reference</a> »</li>
<li><a href="../drawing.html" >Drawing</a> »</li>
</ul>
</div>
<div class="footer">
© Copyright 2013, NetworkX Developers.
Last updated on Oct 23, 2013.
Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.1.3.
</div>
</body>
</html>
