EVOLUTION-MANAGER
Edit File: get.edge.ids.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: Find the edge ids based on the incident vertices of the edges</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 get.edge.ids {igraph}"><tr><td>get.edge.ids {igraph}</td><td style="text-align: right;">R Documentation</td></tr></table> <h2>Find the edge ids based on the incident vertices of the edges</h2> <h3>Description</h3> <p>Find the edges in an igraph graph that have the specified end points. This function handles multi-graph (graphs with multiple edges) and can consider or ignore the edge directions in directed graphs. </p> <h3>Usage</h3> <pre> get.edge.ids(graph, vp, directed = TRUE, error = FALSE, multi = FALSE) </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>vp</code></td> <td> <p>The incident vertices, given as vertex ids or symbolic vertex names. They are interpreted pairwise, i.e. the first and second are used for the first edge, the third and fourth for the second, etc.</p> </td></tr> <tr valign="top"><td><code>directed</code></td> <td> <p>Logical scalar, whether to consider edge directions in directed graphs. This argument is ignored for undirected graphs.</p> </td></tr> <tr valign="top"><td><code>error</code></td> <td> <p>Logical scalar, whether to report an error if an edge is not found in the graph. If <code>FALSE</code>, then no error is reported, and zero is returned for the non-existant edge(s).</p> </td></tr> <tr valign="top"><td><code>multi</code></td> <td> <p>Logical scalar, whether to handle multiple edges properly. If <code>FALSE</code>, and a pair of vertices are given twice (or more), then always the same edge id is reported back for them. If <code>TRUE</code>, then the edge ids of multiple edges are correctly reported.</p> </td></tr> </table> <h3>Details</h3> <p>igraph vertex ids are natural numbers, starting from one, up to the number of vertices in the graph. Similarly, edges are also numbered from one, up to the number of edges. </p> <p>This function allows finding the edges of the graph, via their incident vertices. </p> <h3>Value</h3> <p>A numeric vector of edge ids, one for each pair of input vertices. If there is no edge in the input graph for a given pair of vertices, then zero is reported. (If the <code>error</code> argument is <code>FALSE</code>.) </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>Other structural queries: <code><a href="sub-.igraph.html">[.igraph</a>()</code>, <code><a href="sub-sub-.igraph.html">[[.igraph</a>()</code>, <code><a href="adjacent_vertices.html">adjacent_vertices</a>()</code>, <code><a href="are_adjacent.html">are_adjacent</a>()</code>, <code><a href="ends.html">ends</a>()</code>, <code><a href="gorder.html">gorder</a>()</code>, <code><a href="gsize.html">gsize</a>()</code>, <code><a href="head_of.html">head_of</a>()</code>, <code><a href="incident_edges.html">incident_edges</a>()</code>, <code><a href="incident.html">incident</a>()</code>, <code><a href="is_directed.html">is_directed</a>()</code>, <code><a href="neighbors.html">neighbors</a>()</code>, <code><a href="tail_of.html">tail_of</a>()</code> </p> <h3>Examples</h3> <pre> g <- make_ring(10) ei <- get.edge.ids(g, c(1,2, 4,5)) E(g)[ei] ## non-existant edge get.edge.ids(g, c(2,1, 1,4, 5,4)) ## multiple edges ## multi = FALSE, a single edge id is returned, ## as many times as corresponding pairs in the vertex series. g <- make_graph(rep(c(1,2), 5)) eis <- get.edge.ids(g, c(1,2, 1,2), multi=FALSE) eis E(g)[eis] ## multi = TRUE, as many different edges, if any, ## are returned as pairs in the vertex series. eim <- get.edge.ids(g, c(1,2, 1,2, 1,2), multi=TRUE) eim E(g)[eim] </pre> <hr /><div style="text-align: center;">[Package <em>igraph</em> version 1.3.5 <a href="00Index.html">Index</a>]</div> </body></html>