# permute

From igraph v1.0.0
by Gabor Csardi

##### Permute the vertices of a graph

Create a new graph, by permuting vertex ids.

- Keywords
- graphs

##### Usage

`permute(graph, permutation)`

##### Arguments

- graph
- The input graph, it can directed or undirected.
- permutation
- A numeric vector giving the permutation to apply. The
first element is the new id of vertex 1, etc. Every number between one and
`vcount(graph)`

must appear exactly once.

##### Details

This function creates a new graph from the input graph by permuting its
vertices according to the specified mapping. Call this function with the
output of `canonical_permutation`

to create the canonical form
of a graph.

`permute`

keeps all graph, vertex and edge attributes of the graph.

##### Value

- A new graph object.

##### See Also

##### Examples

```
# Random permutation of a random graph
g <- sample_gnm(20, 50)
g2 <- permute(g, sample(vcount(g)))
graph.isomorphic(g, g2)
# Permutation keeps all attributes
g$name <- "Random graph, Gnm, 20, 50"
V(g)$name <- letters[1:vcount(g)]
E(g)$weight <- sample(1:5, ecount(g), replace=TRUE)
g2 <- permute(g, sample(vcount(g)))
graph.isomorphic(g, g2)
g2$name
V(g2)$name
E(g2)$weight
all(sort(E(g2)$weight) == sort(E(g)$weight))
```

*Documentation reproduced from package igraph, version 1.0.0, License: GPL (>= 2)*

### Community examples

Looks like there are no examples yet.