View source: R/geom_edge_bundle_minimal.R
geom_edge_bundle_minimal | R Documentation |
This geom performs edge bundling by letting edges follow the shortest path
along the minimal spanning tree of the graph. Due to it's simplicity it is
very fast but does enforce a tree-like appearance to the bundling. Adjusting
the max_distortion
and tension
parameters may alleviate this to some
extend.
geom_edge_bundle_minimal(
mapping = NULL,
data = get_edges(),
position = "identity",
arrow = NULL,
n = 100,
max_distortion = 2,
weight_fac = 2,
tension = 1,
lineend = "butt",
linejoin = "round",
linemitre = 1,
label_colour = "black",
label_alpha = 1,
label_parse = FALSE,
check_overlap = FALSE,
angle_calc = "rot",
force_flip = TRUE,
label_dodge = NULL,
label_push = NULL,
show.legend = NA,
...
)
geom_edge_bundle_minimal2(
mapping = NULL,
data = get_edges("long"),
position = "identity",
arrow = NULL,
n = 100,
max_distortion = 2,
weight_fac = 2,
tension = 1,
lineend = "butt",
linejoin = "round",
linemitre = 1,
label_colour = "black",
label_alpha = 1,
label_parse = FALSE,
check_overlap = FALSE,
angle_calc = "rot",
force_flip = TRUE,
label_dodge = NULL,
label_push = NULL,
show.legend = NA,
...
)
geom_edge_bundle_minimal0(
mapping = NULL,
data = get_edges(),
position = "identity",
arrow = NULL,
max_distortion = 2,
weight_fac = 2,
tension = 1,
lineend = "butt",
show.legend = NA,
...
)
mapping |
Set of aesthetic mappings created by |
data |
The return of a call to |
position |
Position adjustment, either as a string naming the adjustment
(e.g. |
arrow |
Arrow specification, as created by |
n |
The number of points to create along the path. |
max_distortion |
A multiplication factor to determine the maximum
allowed distortion of the path during bundling. If the new edge is longer
than |
weight_fac |
The exponent used to assign weights to the graph when
calculating the shortest path. The final weights are given as
|
tension |
A loosening factor when calculating the b-spline of the edge based on the shortest path. Will move control points closer and closer to the direct line as it approaches 0 |
lineend |
Line end style (round, butt, square). |
linejoin |
Line join style (round, mitre, bevel). |
linemitre |
Line mitre limit (number greater than 1). |
label_colour |
The colour of the edge label. If |
label_alpha |
The opacity of the edge label. If |
label_parse |
If |
check_overlap |
If |
angle_calc |
Either 'none', 'along', or 'across'. If 'none' the label will use the angle aesthetic of the geom. If 'along' The label will be written along the edge direction. If 'across' the label will be written across the edge direction. |
force_flip |
Logical. If |
label_dodge |
A |
label_push |
A |
show.legend |
logical. Should this layer be included in the legends?
|
... |
Other arguments passed on to |
geom_edge_force_minimal
and geom_edge_force_minimal0
understand the following
aesthetics. Bold aesthetics are automatically set, but can be overwritten.
x
y
xend
yend
edge_id (should not be overwritten)
edge_colour
edge_width
edge_linetype
edge_alpha
filter
geom_edge_force_minimal2
understand the following aesthetics. Bold aesthetics are
automatically set, but can be overwritten.
x
y
group
edge_id (should not be overwritten)
edge_colour
edge_width
edge_linetype
edge_alpha
filter
geom_edge_force_minimal
and geom_edge_force_minimal2
furthermore takes the following
aesthetics.
start_cap
end_cap
label
label_pos
label_size
angle
hjust
vjust
family
fontface
lineheight
The position along the path (not computed for the *0 version)
Many geom_edge_* layers comes in 3 flavors depending on the level of control
needed over the drawing. The default (no numeric postfix) generate a number
of points (n
) along the edge and draws it as a path. Each point along
the line has a numeric value associated with it giving the position along the
path, and it is therefore possible to show the direction of the edge by
mapping to this e.g. colour = after_stat(index)
. The version postfixed with a
"2" uses the "long" edge format (see get_edges()
) and makes it
possible to interpolate node parameter between the start and end node along
the edge. It is considerable less performant so should only be used if this
is needed. The version postfixed with a "0" draws the edge in the most
performant way, often directly using an appropriate grob from the grid
package, but does not allow for gradients along the edge.
Often it is beneficial to stop the drawing of the edge before it reaches the
node, for instance in cases where an arrow should be drawn and the arrowhead
shouldn't lay on top or below the node point. geom_edge_* and geom_edge_*2
supports this through the start_cap and end_cap aesthetics that takes a
geometry()
specification and dynamically caps the termini of the
edges based on the given specifications. This means that if
end_cap = circle(1, 'cm')
the edges will end at a distance of 1cm even
during resizing of the plot window.
All geom_edge_*
and geom_edge_*2
have the ability to draw a
label along the edge. The reason this is not a separate geom is that in order
for the label to know the location of the edge it needs to know the edge type
etc. Labels are drawn by providing a label aesthetic. The label_pos can be
used to specify where along the edge it should be drawn by supplying a number
between 0 and 1. The label_size aesthetic can be used to control the size of
the label. Often it is needed to have the label written along the direction
of the edge, but since the actual angle is dependent on the plot dimensions
this cannot be calculated beforehand. Using the angle_calc argument allows
you to specify whether to use the supplied angle aesthetic or whether to draw
the label along or across the edge.
In order to avoid excessive typing edge aesthetic names are
automatically expanded. Because of this it is not necessary to write
edge_colour
within the aes()
call as colour
will
automatically be renamed appropriately.
Thomas Lin Pedersen
Other geom_edge_*:
geom_edge_arc()
,
geom_edge_bend()
,
geom_edge_bundle_force()
,
geom_edge_bundle_path()
,
geom_edge_density()
,
geom_edge_diagonal()
,
geom_edge_elbow()
,
geom_edge_fan()
,
geom_edge_hive()
,
geom_edge_link()
,
geom_edge_loop()
,
geom_edge_parallel()
,
geom_edge_point()
,
geom_edge_sf()
,
geom_edge_span()
,
geom_edge_tile()
ggraph(highschool) +
geom_edge_bundle_minimal()
# Allow more edges to bundle
ggraph(highschool) +
geom_edge_bundle_minimal(max_distortion = 5, tension = 0.9)
Add the following code to your website.
For more information on customizing the embed code, read Embedding Snippets.