EVOLUTION-MANAGER
Edit File: layout_nicely.html
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"><html xmlns="http://www.w3.org/1999/xhtml"><head><title>R: Choose an appropriate graph layout algorithm automatically</title> <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> <link rel="stylesheet" type="text/css" href="R.css" /> </head><body> <table width="100%" summary="page for layout_nicely {igraph}"><tr><td>layout_nicely {igraph}</td><td style="text-align: right;">R Documentation</td></tr></table> <h2>Choose an appropriate graph layout algorithm automatically</h2> <h3>Description</h3> <p>This function tries to choose an appropriate graph layout algorithm for the graph, automatically, based on a simple algorithm. See details below. </p> <h3>Usage</h3> <pre> layout_nicely(graph, dim = 2, ...) nicely(...) </pre> <h3>Arguments</h3> <table summary="R argblock"> <tr valign="top"><td><code>graph</code></td> <td> <p>The input graph</p> </td></tr> <tr valign="top"><td><code>dim</code></td> <td> <p>Dimensions, should be 2 or 3.</p> </td></tr> <tr valign="top"><td><code>...</code></td> <td> <p>For <code>layout_nicely</code> the extra arguments are passed to the real layout function. For <code>nicely</code> all argument are passed to <code>layout_nicely</code>.</p> </td></tr> </table> <h3>Details</h3> <p><code>layout_nicely</code> tries to choose an appropriate layout function for the supplied graph, and uses that to generate the layout. The current implementation works like this: </p> <ol> <li><p> If the graph has a graph attribute called ‘layout’, then this is used. If this attribute is an R function, then it is called, with the graph and any other extra arguments. </p> </li> <li><p> Otherwise, if the graph has vertex attributes called ‘x’ and ‘y’, then these are used as coordinates. If the graph has an additional ‘z’ vertex attribute, that is also used. </p> </li> <li><p> Otherwise, if the graph is connected and has less than 1000 vertices, the Fruchterman-Reingold layout is used, by calling <code>layout_with_fr</code>. </p> </li> <li><p> Otherwise the DrL layout is used, <code>layout_with_drl</code> is called. </p> </li></ol> <p>In layout algorithm implementations, an argument named ‘weights’ is typically used to specify the weights of the edges if the layout algorithm supports them. In this case, omitting ‘weights’ or setting it to <code>NULL</code> will make igraph use the 'weight' edge attribute from the graph if it is present. However, most layout algorithms do not support non-positive weights, so <code>layout_nicely</code> would fail if you simply called it on your graph without specifying explicit weights and the weights happened to include non-positive numbers. We strive to ensure that <code>layout_nicely</code> works out-of-the-box for most graphs, so the rule is that if you omit ‘weights’ or set it to <code>NULL</code> and <code>layout_nicely</code> would end up calling <code>layout_with_fr</code> or <code>layout_with_drl</code>, we do not forward the weights to these functions and issue a warning about this. You can use <code>weights = NA</code> to silence the warning. </p> <h3>Value</h3> <p>A numeric matrix with two or three columns. </p> <h3>Author(s)</h3> <p>Gabor Csardi <a href="mailto:csardi.gabor@gmail.com">csardi.gabor@gmail.com</a> </p> <h3>See Also</h3> <p><code><a href="plot.igraph.html">plot.igraph</a></code> </p> <p>Other graph layouts: <code><a href="add_layout_.html">add_layout_</a>()</code>, <code><a href="component_wise.html">component_wise</a>()</code>, <code><a href="layout_as_bipartite.html">layout_as_bipartite</a>()</code>, <code><a href="layout_as_star.html">layout_as_star</a>()</code>, <code><a href="layout_as_tree.html">layout_as_tree</a>()</code>, <code><a href="layout_in_circle.html">layout_in_circle</a>()</code>, <code><a href="layout_on_grid.html">layout_on_grid</a>()</code>, <code><a href="layout_on_sphere.html">layout_on_sphere</a>()</code>, <code><a href="layout_randomly.html">layout_randomly</a>()</code>, <code><a href="layout_with_dh.html">layout_with_dh</a>()</code>, <code><a href="layout_with_fr.html">layout_with_fr</a>()</code>, <code><a href="layout_with_gem.html">layout_with_gem</a>()</code>, <code><a href="layout_with_graphopt.html">layout_with_graphopt</a>()</code>, <code><a href="layout_with_kk.html">layout_with_kk</a>()</code>, <code><a href="layout_with_lgl.html">layout_with_lgl</a>()</code>, <code><a href="layout_with_mds.html">layout_with_mds</a>()</code>, <code><a href="layout_with_sugiyama.html">layout_with_sugiyama</a>()</code>, <code><a href="layout_.html">layout_</a>()</code>, <code><a href="merge_coords.html">merge_coords</a>()</code>, <code><a href="norm_coords.html">norm_coords</a>()</code>, <code><a href="normalize.html">normalize</a>()</code> </p> <hr /><div style="text-align: center;">[Package <em>igraph</em> version 1.3.5 <a href="00Index.html">Index</a>]</div> </body></html>