EVOLUTION-MANAGER
Edit File: igraph_options.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: Parameters for the igraph package</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 igraph_options {igraph}"><tr><td>igraph_options {igraph}</td><td style="text-align: right;">R Documentation</td></tr></table> <h2>Parameters for the igraph package</h2> <h3>Description</h3> <p>igraph has some parameters which (usually) affect the behavior of many functions. These can be set for the whole session via <code>igraph_options</code>. </p> <h3>Usage</h3> <pre> igraph_options(...) igraph_opt(x, default = NULL) </pre> <h3>Arguments</h3> <table summary="R argblock"> <tr valign="top"><td><code>...</code></td> <td> <p>A list may be given as the only argument, or any number of arguments may be in the <code>name=value</code> form, or no argument at all may be given. See the Value and Details sections for explanation.</p> </td></tr> <tr valign="top"><td><code>x</code></td> <td> <p>A character string holding an option name.</p> </td></tr> <tr valign="top"><td><code>default</code></td> <td> <p>If the specified option is not set in the options list, this value is returned. This facilitates retrieving an option and checking whether it is set and setting it separately if not.</p> </td></tr> </table> <h3>Details</h3> <p>The parameter values set via a call to the <code>igraph_options</code> function will remain in effect for the rest of the session, affecting the subsequent behaviour of the other functions of the <code>igraph</code> package for which the given parameters are relevant. </p> <p>This offers the possibility of customizing the functioning of the <code>igraph</code> package, for instance by insertions of appropriate calls to <code>igraph_options</code> in a load hook for package <span class="pkg">igraph</span>. </p> <p>The currently used parameters in alphabetical order: </p> <dl> <dt>add.params</dt><dd><p>Logical scalar, whether to add model parameter to the graphs that are created by the various graph constructors. By default it is <code>TRUE</code>.</p> </dd> <dt>add.vertex.names</dt><dd><p>Logical scalar, whether to add vertex names to node level indices, like degree, betweenness scores, etc. By default it is <code>TRUE</code>.</p> </dd> <dt>annotate.plot</dt><dd><p>Logical scalar, whether to annotate igraph plots with the graph's name (<code>name</code> graph attribute, if present) as <code>main</code>, and with the number of vertices and edges as <code>xlab</code>. Defaults to <code>FALSE</code>.</p> </dd> <dt>dend.plot.type</dt><dd><p>The plotting function to use when plotting community structure dendrograms via <code><a href="plot_dendrogram.communities.html">plot_dendrogram</a></code></p> </dd></dl> <p>. Possible values are ‘auto’ (the default), ‘phylo’, ‘hclust’ and ‘dendrogram’. See <code><a href="plot_dendrogram.communities.html">plot_dendrogram</a></code> for details. </p> <dl> <dt>edge.attr.comb</dt><dd><p>Specifies what to do with the edge attributes if the graph is modified. The default value is <code>list(weight="sum", name="concat", "ignore")</code>. See <code><a href="igraph-attribute-combination.html">attribute.combination</a></code> for details on this.</p> </dd> <dt>print.edge.attributes</dt><dd><p>Logical constant, whether to print edge attributes when printing graphs. Defaults to <code>FALSE</code>.</p> </dd> <dt>print.full</dt><dd><p>Logical scalar, whether <code><a href="print.igraph.html">print.igraph</a></code> should show the graph structure as well, or only a summary of the graph.</p> </dd> <dt>print.graph.attributes</dt><dd><p>Logical constant, whether to print graph attributes when printing graphs. Defaults to <code>FALSE</code>.</p> </dd> <dt>print.vertex.attributes</dt><dd><p>Logical constant, whether to print vertex attributes when printing graphs. Defaults to <code>FALSE</code>.</p> </dd> <dt>return.vs.es</dt><dd><p>Whether functions that return a set or sequence of vertices/edges should return formal vertex/edge sequence objects. This option was introduced in igraph version 1.0.0 and defaults to TRUE. If your package requires the old behavior, you can set it to FALSE in the <code>.onLoad</code> function of your package, without affecting other packages.</p> </dd> <dt>sparsematrices</dt><dd><p>Whether to use the <code>Matrix</code> package for (sparse) matrices. It is recommended, if the user works with larger graphs.</p> </dd> <dt>verbose</dt><dd><p>Logical constant, whether igraph functions should talk more than minimal. Eg. if <code>TRUE</code> then some functions will use progress bars while computing. Defaults to <code>FALSE</code>.</p> </dd> <dt>vertex.attr.comb</dt><dd><p>Specifies what to do with the vertex attributes if the graph is modified. The default value is <code>list(name="concat", "ignore")</code> See <code><a href="igraph-attribute-combination.html">attribute.combination</a></code> for details on this.</p> </dd> </dl> <h3>Value</h3> <p><code>igraph_options</code> returns a list with the old values of the updated parameters, invisibly. Without any arguments, it returns the values of all options. </p> <p>For <code>igraph_opt</code>, the current value set for option <code>x</code>, or <code>NULL</code> if the option is unset. </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>igraph_options</code> is similar to <code><a href="../../base/html/options.html">options</a></code> and <code>igraph_opt</code> is similar to <code><a href="../../base/html/options.html">getOption</a></code>. </p> <p>Other igraph options: <code><a href="with_igraph_opt.html">with_igraph_opt</a>()</code> </p> <h3>Examples</h3> <pre> oldval <- igraph_opt("verbose") igraph_options(verbose = TRUE) layout_with_kk(make_ring(10)) igraph_options(verbose = oldval) oldval <- igraph_options(verbose = TRUE, sparsematrices = FALSE) make_ring(10)[] igraph_options(oldval) igraph_opt("verbose") </pre> <hr /><div style="text-align: center;">[Package <em>igraph</em> version 1.3.5 <a href="00Index.html">Index</a>]</div> </body></html>