Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://haleyjeppson.github.io/ggmosaic/

Mosaicplots in the ggplot2 framework
https://haleyjeppson.github.io/ggmosaic/

Last synced: 3 days ago
JSON representation

Mosaicplots in the ggplot2 framework

Awesome Lists containing this project

README

        

---
output: github_document
editor_options:
chunk_output_type: console
---

```{r include = FALSE}
knitr::opts_chunk$set(
collapse = TRUE,
comment = "#>",
fig.path = "man/figures/README-",
message=FALSE, warning=FALSE
)
```

[![CRAN Status](http://www.r-pkg.org/badges/version/ggmosaic)](https://cran.r-project.org/package=ggmosaic) [![CRAN RStudio mirror downloads](http://cranlogs.r-pkg.org/badges/ggmosaic)](https://www.r-pkg.org/pkg/ggmosaic)
[![R-CMD-check](https://github.com/haleyjeppson/ggmosaic/actions/workflows/R-CMD-check.yaml/badge.svg)](https://github.com/haleyjeppson/ggmosaic/actions/workflows/R-CMD-check.yaml)


# ggmosaic

ggmosaic was designed to create visualizations of categorical data and is capable of producing bar charts, stacked bar charts, mosaic plots, and double decker plots.

## Installation

You can install ggmosaic from github with:

```{r gh-installation, eval = FALSE}
# install.packages("devtools")
devtools::install_github("haleyjeppson/ggmosaic")
```

## Example

```{r example}
library(ggmosaic)
library(dplyr)
happy %>%
mutate(finrela = forcats::fct_recode(finrela,
"far below " = "far below average",
" below" = "below average",
"average" = "average",
"above " = "above average",
"l\n far above" = "far above average")) %>%
ggplot() +
geom_mosaic(aes(x = product(finrela), fill=health), show.legend = FALSE) +
theme_mosaic() +
scale_fill_manual(values = c("#4575B4", "#ABD9E9", "#FEE090", "#F46D43"))
```

## geom_mosaic: setting the aesthetics

In `geom_mosaic()`, the following aesthetics can be specified:

- `weight`: select a weighting variable

- `x`: select variables to add to formula

- declared as `x = product(var2, var1, ...)`

- `alpha`: add an alpha transparency to the selected variable

- unless the variable is called in `x`, it will be added to the formula in the first position

- `fill`: select a variable to be filled

- unless the variable is called in `x`, it will be added to the formula in the first position after the optional `alpha` variable.

- `conds` : select a variable to condition on

- declared as `conds = product(cond1, cond2, ...)`

These values are then sent through repurposed `productplots` functions to create the desired formula: `weight ~ alpha + fill + x | conds`.

## Version compatibility issues with ggplot2

Since the initial release of ggmosaic, ggplot2 has evolved considerably. And as ggplot2 continues to evolve, ggmosaic must continue to evolve alongside it. Although these changes affect the underlying code and not the general usage of ggmosaic, the general user may need to be aware of compatibility issues that can arise between versions. The table below summarizes the compatibility between versions.

| ggmosaic | ggplot2 | Axis labels | Tick marks |
|----------|---------|-------------------------------------------------------------------------------|---------------|
| 0.3.3 | 3.3.3 | x | x |
| 0.3.0 | 3.3.0 | x | x |
| 0.2.2 | 3.3.0 | Default labels are okay, but must use
`scale_*_productlist()` to modify | No tick marks |
| 0.2.2 | 3.2.0 | Default labels okay, but must use
`scale_*_productlist()` to modify | x |
| 0.2.0 | 3.2.0 | Default labels are wrong, but can use
`labs()` to modify | x |