R: Create small multiples based on edge attributes

facet_edges {ggraph} | R Documentation

## Create small multiples based on edge attributes

### Description

This function is equivalent to `facet_wrap` but only facets edges. Nodes are repeated in every panel.

### Usage

    facet_edges(facets, nrow = NULL, ncol = NULL, scales = "fixed",
      shrink = TRUE, labeller = "label_value", as.table = TRUE,
      switch = NULL, drop = TRUE, dir = "h", strip.position = "top")

### Arguments

`facets` | Either a formula or character vector. Use either a one sided formula, `~a + b`, or a character vector, `c("a", "b")`.
`nrow` | Number of rows and columns.
`ncol` | Number of rows and columns.
`scales` | should Scales be fixed (`"fixed"`, the default), free (`"free"`), or free in one dimension (`"free_x"`, `"free_y"`).
`shrink` | If `TRUE`, will shrink scales to fit output of statistics, not raw data. If `FALSE`, will be range of raw data before statistical summary.
`labeller` | A function that takes one data frame of labels and returns a list or data frame of character vectors. Each input column corresponds to one factor. Thus there will be more than one with formulae of the type `~cyl + am`. Each output column gets displayed as one separate line in the strip label. This function should inherit from the "labeller" S3 class for compatibility with `labeller()`. See `label_value` for more details and pointers to other options.
`as.table` | If `TRUE`, the default, the facets are laid out like a table with highest values at the bottom-right. If `FALSE`, the facets are laid out like a plot with the highest value at the top-right.
`switch` | By default, the labels are displayed on the top and right of the plot. If `"x"`, the top labels will be displayed to the bottom. If `"y"`, the right-hand side labels will be displayed to the left. Can also be set to `"both"`.
`drop` | If `TRUE`, the default, all factor levels not used in the data will automatically be dropped. If `FALSE`, all factor levels will be shown, regardless of whether or not they appear in the data.
`dir` | Direction: either "h" for horizontal, the default, or "v", for vertical.
`strip.position` | By default, the labels are displayed on the top of the plot. Using `strip.position` it is possible to place the labels on either of the four sides by setting `strip.position = c("top", "bottom", "left", "right")`

### See Also

Other ggraph-facets: `facet_graph`, `facet_nodes`

### Examples

    library(igraph)
    gr <- graph_from_data_frame(highschool)

    ggraph(gr) +
        geom_edge_link() +
        geom_node_point() +
        facet_edges(~year)

[Package ggraph version 1.0.0 Index]