Help for package ggfocus

Type:

Package

Title:

Scales that Focus Specific Levels in your ggplot()

Version:

1.0.0

BugReports:

https://github.com/Freguglia/ggfocus/issues

URL:

https://github.com/Freguglia/ggfocus

Description:

A 'ggplot2' extension that provides tools for automatically creating scales to focus on subgroups of the data plotted without losing other information.

License:

GPL-3

Encoding:

UTF-8

LazyData:

true

RoxygenNote:

7.0.2

Depends:

ggplot2

Imports:

magrittr, dplyr, rlang, RColorBrewer

Suggests:

knitr, rmarkdown, maps, ggrepel

VignetteBuilder:

knitr

NeedsCompilation:

Packaged:

2020-01-22 19:00:47 UTC; victor

Author:

Victor Freguglia [aut, cre]

Maintainer:

Victor Freguglia <victorfreguglia@gmail.com>

Repository:

CRAN

Date/Publication:

2020-01-23 13:20:02 UTC

(Deprecated) Sets focus scales to an existing 'ggplot' object

Description

'ggfocus()' is deprecated. Add focus scales with 'scale_color_focus()', 'scale_fill_focus()', 'scale_alpha_focus()', ... instead.

Creates a 'ggplot' object with focus scales from another 'ggplot' object.

Usage

ggfocus(
  p,
  var,
  focus_levels,
  focus_aes = c("color", "alpha", "fill"),
  color_focus = NULL,
  color_other = "black",
  alpha_focus = 1,
  alpha_other = 0.05
)

Arguments

p

a 'ggplot' object.

var

Sets.

focus_levels

levels to be highlited.

focus_aes

list of aesthetics used to highlight. "color","alpha" and "fill" are available.

color_focus

vector of colors (or a single color) for focused levels.

color_other

color for non-focused levels.

alpha_focus, alpha_other

alpha value for focused and non-focused levels.

Value

a ggplot object with focusing scales.

Author(s)

Victor Freguglia

Examples

library(ggplot2)
p <- ggplot(iris,aes(x=Sepal.Length,y=Petal.Length)) + geom_point()
ggfocus(p, Species, "versicolor")

Objects exported from other packages

Description

These objects are imported from other packages. Follow the links below to see their documentation.

magrittr: %>%

Focus scales for 'ggplot' objects

Description

Scale that focus on specific levels.

Usage

scale_alpha_focus(focus_levels, alpha_focus = 1, alpha_other = 0.2)

scale_color_focus(
  focus_levels,
  color_focus = NULL,
  color_other = "gray",
  palette_focus = "Set1"
)

scale_fill_focus(
  focus_levels,
  color_focus = NULL,
  color_other = "gray",
  palette_focus = "Set1"
)

scale_linetype_focus(focus_levels, linetype_focus = 1, linetype_other = 3)

scale_shape_focus(focus_levels, shape_focus = 8, shape_other = 1)

scale_size_focus(focus_levels, size_focus = 3, size_other = 1)

Arguments

focus_levels

character vector with levels to focus on.

alpha_focus

'alpha' value for focused levels. Defaults to 1.

alpha_other

'alpha' value for other levels. Defaults to 0.05.

color_focus

color(s) for focused levels (a single value or a vector with the same length as the number of highlighted levels).

color_other

color for other levels.

palette_focus

If 'color_focus' is not specified, provide a pelette from RColorBrewer to pick colors.

linetype_focus

vector of 'linetype' value(s) for focused levels with length 1 or equal to 'focus_levels'. Defaults to 1.

linetype_other

'linetype' value for other levels. Defaults to 3.

shape_focus

'shape' value for focused levels. Defaults to 8.

shape_other

'shape' value for other levels. Defaults to 1.

size_focus

'size' value for focused levels. Defaults to 3.

size_other

'size' value for other levels. Defaults to 1.

Note

Use RColorBrewer::display.brewer.all() to see the palettes available.

Examples

ggplot(iris, aes(x = Petal.Length, y = Sepal.Length, alpha = Species)) +
 geom_point() +
 scale_alpha_focus(focus_levels = "versicolor")


ggplot(iris, aes(x = Petal.Length, y = Sepal.Length, color = Species)) +
 geom_point() +
 scale_color_focus(focus_levels = "setosa", color_focus = "red")

ggplot(iris, aes(x = Petal.Length, y = Sepal.Length, color = Species)) +
 geom_point() +
 scale_color_focus(focus_levels = c("setosa", "virginica"), color_focus = c("red", "blue"))

ggplot(mtcars, aes(x = wt, y = mpg, color = rownames(mtcars))) +
 geom_point() +
 scale_color_focus(focus_levels = c("Mazda RX4", "Merc 230"), palette_focus = "Set2")

ggplot(iris,aes(x = Petal.Length, group = Species, fill = Species)) +
  geom_histogram() +
  scale_fill_focus(focus_levels = "versicolor", color_focus = "red")

ggplot(iris,aes(x = Petal.Length, y = Sepal.Length, shape = Species)) +
 geom_point() +
 scale_shape_focus(focus_levels = "versicolor")


ggplot(iris,aes(x = Petal.Length, y = Sepal.Length, size = Species)) +
 geom_point() +
 scale_size_focus(focus_levels = "versicolor")