| Type: | Package |
| Title: | Highlight Lines and Points in 'ggplot2' |
| Version: | 0.5.0 |
| Description: | Make it easier to explore data with highlights. |
| License: | MIT + file LICENSE |
| URL: | https://yutannihilation.github.io/gghighlight/, https://github.com/yutannihilation/gghighlight |
| BugReports: | https://github.com/yutannihilation/gghighlight/issues |
| Depends: | ggplot2 (≥ 3.3.6), R (≥ 3.4.0) |
| Imports: | dplyr (≥ 1.0.4), ggrepel, lifecycle, purrr, rlang, tibble, scales, grDevices |
| Suggests: | geomtextpath, knitr, rmarkdown, sf, testthat, vdiffr (≥ 0.3.0) |
| VignetteBuilder: | knitr |
| Encoding: | UTF-8 |
| RoxygenNote: | 7.3.2 |
| Config/testthat/edition: | 3 |
| NeedsCompilation: | no |
| Packaged: | 2025-06-14 07:26:33 UTC; yutan |
| Author: | Hiroaki Yutani 
[aut, cre] |
| Maintainer: | Hiroaki Yutani <yutani.ini@gmail.com> |
| Repository: | CRAN |
| Date/Publication: | 2025-06-14 07:50:02 UTC |
Highlight Lines and Points in 'ggplot2'
Description
Make it easier to explore data with highlights.
Author(s)
Maintainer: Hiroaki Yutani yutani.ini@gmail.com (ORCID)
See Also
Useful links:
Report bugs at https://github.com/yutannihilation/gghighlight/issues
Highlight Data With Predicate
Description
gghighlight() highlights (almost) any geoms according to the given predicates.
Usage
gghighlight(
...,
n = NULL,
max_highlight = 5L,
unhighlighted_params = list(),
use_group_by = NULL,
use_direct_label = NULL,
label_key = NULL,
label_params = list(fill = "white"),
keep_scales = FALSE,
calculate_per_facet = FALSE,
line_label_type = c("ggrepel_label", "ggrepel_text", "text_path", "label_path",
"sec_axis"),
unhighlighted_colour = NULL
)
Arguments
... |
Expressions to filter data, which is passed to |
n |
Number of layers to clone. |
max_highlight |
Max number of series to highlight. |
unhighlighted_params |
Aesthetics (e.g. colour, fill, and size) for unhighlighted geoms. Specifying
|
use_group_by |
If |
use_direct_label |
If |
label_key |
Column name for |
label_params |
A list of parameters, which is passed to |
keep_scales |
If |
calculate_per_facet |
(Experimental) If |
line_label_type |
(Experimental) Method to add labels (or texts) on the highlighted lines.
|
unhighlighted_colour |
(Deprecated) Colour for unhighlighted geoms. |
Examples
d <- data.frame(
idx = c(1, 1, 1, 2, 2, 2, 3, 3, 3),
value = c(1, 2, 3, 10, 11, 12, 9, 10, 11),
category = rep(c("a", "b", "c"), 3),
stringsAsFactors = FALSE
)
# Highlight the lines whose max values are larger than 10
ggplot(d, aes(idx, value, colour = category)) +
geom_line() + gghighlight(max(value) > 10)
# Highlight the points whose values are larger than 10
ggplot(d, aes(idx, value)) +
geom_point() +
gghighlight(value > 10, label_key = category)
# Specify the styles for unhighlighted layer
ggplot(d, aes(idx, value, colour = category)) +
geom_line(linewidth = 5) +
gghighlight(max(value) > 10,
unhighlighted_params = list(linewidth = 1)
)
Objects exported from other packages
Description
These objects are imported from other packages. Follow the links below to see their documentation.