1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
|
#' Draw edges as glyphs
#'
#' This geom draws edges as tiles with their x-position defined by the
#' x-position of the start node, and the y-position defined by the y-position of
#' the end node. As such it will result in a matrix layout when used in
#' conjunction with [layout_tbl_graph_matrix()]
#'
#' @inheritSection geom_edge_link Edge aesthetic name expansion
#'
#' @section Aesthetics:
#' `geom_edge_tile` understands the following
#' aesthetics. Bold aesthetics are automatically set, but can be overridden.
#'
#' - **x**
#' - **y**
#' - edge_fill
#' - edge_colour
#' - edge_size
#' - edge_alpha
#' - filter
#'
#' @inheritParams ggplot2::geom_tile
#'
#' @param mapping Set of aesthetic mappings created by [ggplot2::aes()]
#' or [ggplot2::aes_()]. By default x, y, xend, yend, group and
#' circular are mapped to x, y, xend, yend, edge.id and circular in the edge
#' data.
#'
#' @param data The return of a call to `get_edges()` or a data.frame
#' giving edges in correct format (see details for for guidance on the format).
#' See [get_edges()] for more details on edge extraction.
#'
#' @param mirror Logical. Should edge points be duplicated on both sides of the
#' diagonal. Intended for undirected graphs. Default to `FALSE`
#'
#' @author Thomas Lin Pedersen
#'
#' @family geom_edge_*
#'
#' @rdname geom_edge_tile
#' @name geom_edge_tile
#'
#' @examples
#' require(tidygraph)
#' gr <- create_notable('zachary') %>%
#' mutate(group = group_infomap()) %>%
#' morph(to_split, group) %>%
#' activate(edges) %>%
#' mutate(edge_group = as.character(.N()$group[1])) %>%
#' unmorph()
#'
#' ggraph(gr, 'matrix', sort.by = node_rank_hclust()) +
#' geom_edge_tile(aes(fill = edge_group), mirror = TRUE) +
#' scale_y_reverse() +
#' coord_fixed() +
#' labs(edge_colour = 'Infomap Cluster') +
#' ggtitle("Zachary' Karate Club")
NULL
#' @rdname geom_edge_tile
#'
#' @export
geom_edge_tile <- function(mapping = NULL, data = get_edges(),
position = 'identity', mirror = FALSE,
show.legend = NA, ...) {
mapping <- complete_edge_aes(mapping)
mapping <- aes_intersect(mapping, aes(x = x, y = yend))
layer(
data = data, mapping = mapping, stat = StatFilter, geom = GeomEdgeTile,
position = position, show.legend = show.legend, inherit.aes = FALSE,
params = list(na.rm = FALSE, mirror = mirror, ...)
)
}
|
