/ggedit

Interactively edit ggplot layer aesthetics and theme definitions

Primary LanguageHTMLOtherNOASSERTION

CRAN_Status_Badge Project Status: Active - The project has reached a stable, usable state and is being actively developed. downloadsCoverage StatusCovrpage Summary

ggedit

ggplot2 has become the standard of plotting in R for many users. New users, however, may find the learning curve steep at first, and more experienced users may find it challenging to keep track of all the options (especially in the theme!).

ggedit is a package that helps users bridge the gap between making a plot and getting all of those pesky plot aesthetics just right, all while keeping everything portable for further research and collaboration.

ggedit is powered by a Shiny gadget where the user inputs a ggplot plot object or a list of ggplot objects. You can run ggedit directly from the console or from the Addin menu within RStudio.

Online User Manual Gitbook

A gitbook is maintained as the user manual for the package, you can access it here:

https://yonicd.github.io/ggedit/

Short clip from rstudio::conf 2017 (13:35-19:35)

Lightning Talks - Users - RStudio

Installation

CRAN

install.packages('ggedit')

For a quick example, run the following:

library('ggedit')
library(ggplot2)
p <- ggplot(mtcars, aes(x = hp, y = wt)) + geom_point() + geom_smooth()
p2 <- ggedit(p)
names(p2) # will show you which objects are available.
plot(p2) # shows the updated plot (it is available in the first element of p2)

DEV

remotes::install_github("yonicd/ggedit")

Limitations

  • layers
    • non colour aesthetics of numeric inputs are not currently supported, e.g.:

      iris |> 
        ggplot(aes(x = Sepal.Length, y = Sepal.Width)) +
        geom_point() + 
        geom_text(aes(label = Species, size = Sepal.Length))
      
    • geom_text: family is not currently open to change