Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/Freguglia/ggfocus
A 'ggplot2' extension that provides tools for automatically creating scales to focus on subgroups of the data plotted without removing secondary information.
https://github.com/Freguglia/ggfocus
data-visualization ggplot-extension r-package visualization
Last synced: about 2 months ago
JSON representation
A 'ggplot2' extension that provides tools for automatically creating scales to focus on subgroups of the data plotted without removing secondary information.
- Host: GitHub
- URL: https://github.com/Freguglia/ggfocus
- Owner: Freguglia
- License: gpl-3.0
- Created: 2018-05-25T16:38:44.000Z (over 6 years ago)
- Default Branch: main
- Last Pushed: 2022-12-05T12:05:23.000Z (almost 2 years ago)
- Last Synced: 2024-07-17T09:55:45.152Z (2 months ago)
- Topics: data-visualization, ggplot-extension, r-package, visualization
- Language: R
- Homepage:
- Size: 3.05 MB
- Stars: 22
- Watchers: 2
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.Rmd
- License: LICENSE.md
Awesome Lists containing this project
README
---
output:
github_document:
html_preview: false
---
# ggfocus 
```{r setup, echo = FALSE}
knitr::opts_chunk$set(
collapse = TRUE,
comment = "#>",
fig.path = "man/figures/README-",
message = FALSE,
warning = FALSE
)
```
[](https://github.com/Freguglia/ggfocus/actions/workflows/check-release.yaml)
[](https://cran.r-project.org/package=ggfocus)
## Introduction
In data analysis, one may want to visualize data for a specific subgroup of observations. Simply filtering out observations that do not belong to the subgroup may take the information out of context. Therefore, it is necessary to have tools that allow the analyst to draw attention (focus) on that subgroup within the complete relevant information available.
While `ggplot2` is a great tool for data visualization in general, constructing graphics that focus on those subgroups may need very troublesome manipulation of data and graphical scales (for example colors) together, i.e. setting low alpha for unimportant observations, coloring things in a way that highlights the focused subgroup, etc.
`ggfocus` allows you to build graphics that focus on those specific subgroups by doing the scale manipulation automatically while keeping all the flexibility from `ggplot.` The idea behind this package is from [this](https://github.com/tidyverse/ggplot2/issues/2627) issue from `tidyverse/ggplot2`.
## Installing ggfocus
The package is available on CRAN, but you can also install the latest version from Github with [devtools](https://github.com/hadley/devtools).
```{r install, eval=FALSE}
devtools::install_github("Freguglia/ggfocus") # Latest version
install.packages("ggfocus") # CRAN version
```
## Usage
The workflow of `ggfocus` is the same as any `ggplot` graphic with the addition of the **focus scales** family of functions:
* `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_alpha_focus(focus_levels, alpha_focus = 1, alpha_other = .05)`
* `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)`
The user should map the variable with the grouping variable to all the `aes` used to highlight observations and then use these functions to automatically create scales that highlight a specified group of observations.
Both the selected and unselected groups characteristics are customizable with the parameters of focus scales. See the examples below.
## Examples
Creating an example dataset.
```{r example_1}
library(ggfocus)
set.seed(1)
# Create an example dataset
df <- data.frame(u1 = runif(300),
u2 = runif(300),
grp = sample(LETTERS[1:10], 300, replace = TRUE))
dplyr::glimpse(df)
```
Suppose that we are mainly interested in groups `A` and `B`, but we do not want to lose the `u1` and `u2` information from other groups. Visualizing with focus on observations such that `grp` is `A` or `B` is shown below.
```{r example_2, out.width = "50%", results='hold'}
# Default scales
ggplot(df, aes(x = u1, y = u2, color = grp)) +
geom_point() +
ggtitle("Standard Scales")
# Focus scales
ggplot(df, aes(x = u1, y = u2, color = grp, alpha = grp)) +
geom_point() +
scale_color_focus(c("A", "B"), color_focus = c("blue", "red")) +
scale_alpha_focus(c("A", "B")) +
ggtitle("Focus Scales")
```
### Interaction with other extensions
Since `ggfocus` creates the focused visualization solely by controlling scales, other `ggplot` extensions and types of graphics can interact with it the same way, an example with the `maps` package is shown below.
```{r example_map}
library(maps)
wm <- map_data("world")
ggplot(wm, aes(x = long, y = lat, group = group, fill = region)) +
geom_polygon(color = "black") +
theme_void() +
scale_fill_focus(c("Brazil", "Canada", "Australia", "India"),
color_other = "gray")
```