GraphMFPT: Compute mean first-passage time-based distance matrix

Description Usage Arguments Details Value Author(s) References See Also Examples


Using the mean first-passage time method, compute the distances between vertex pairs in an undirected graph, with or without edge weights.


GraphMFPT(g, v=V(g), edge.attr.weight=NULL, average.distances=TRUE)



igraph object, the graph to work on.


igraph object or numeric vector, the vertices from which each distance is calculated.


String, the name of the edge attribute to be used as weights along the edges. Greater weights indicate a stronger interaction between the two genes (this is the opposite to edge distances, where smaller distances indicate stronger interactions). If NULL then each edge is assumed to have a weight of 1.


Logical, if TRUE then the distance from vertex A to B and the distance from vertex B to A are averaged to give a single distance. Otherwise, two different distances may be returned.


The mean first-passage time from vertex A to vertex B is defined as the expected number of steps taken on a random walk emanating from vertex A until the first arrival at vertex B. This provides a method of measuring the distance between pairs of vertices that does not simply take into account the distance along the shortest path, but rather incorporates how well the two vertices are connected across multiple paths.

The mean first-passage time from vertex A to vertex B is not necessarily the same as the mean first-passage time from vertex B to vertex A. If a symmetric distance matrix is required, reciprocal distances can be averaged to give a single value for each vertex pair.

If a vertex pair is unconnected, then the distance between the vertices is Inf.

The distance from vertex A to vertex A is always 0.


Numeric matrix, containing the mean first-passage time-derived vertex pair distance between each vertex in v and every vertex in g.


Alex J. Cornish


White, S. and Smyth, P. (2003). Algorithms for Estimating Relative Importance in Networks. Technical Report UCI-ICS 04-25.

See Also

GraphDiffusion, shortest.paths


# create a  and compute the mean first-passage time-based vertex pair distance matrix
g <-, p.or.m=0.5, directed=FALSE)
plot(g, layout=layout.fruchterman.reingold)

Search within the SANTA package
Search all R packages, documentation and source code

Questions? Problems? Suggestions? or email at

Please suggest features or report bugs with the GitHub issue tracker.

All documentation is copyright its authors; we didn't write any of that.