plotcli is an R package that brings the power of command-line plotting to your R environment. With a simple and intuitive R6 class interface, plotcli allows you to create and customize a variety of plot types, such as scatter, line, bar, and box plots, directly in your console.
Features
ggplot2 objects to colored terminal plots with ggplotcliplotcli is heavily inspired by the excellent UnicodePlots.jl library.
> ggplotcli(ggplot(iris, aes(x = Sepal.Width, y = Sepal.Length, color = Species)) + geom_boxplot())
┌────────────────────────────────────────────────────────────┐
4.4 │ ─────── │
│ │ │
│ │ │
│ │ │
│ │ ─────── │
3.8 │ ┌───────┐ │ │
│ │ │ │ │
│ │───────│ ─────── │ │
│ │ │ │ │ │ setosa
Sepal.Length 3.2 │ └───────┘ │ ┌───────┐ │ versicolor
│ │ │ │ │ │ virginica
│ │ ┌───────┐ │───────│ │
│ ─────── │───────│ └───────┘ │
│ │ │ │ │
2.6 │ │ │ │ │
│ └───────┘ │ │
│ │ │ │
│ * │ ─────── │
│ │ │
2.0 │ ─────── │
└────────────────────────────────────────────────────────────┘
setosa versicolor virginica
Sepal.Width You can install the plotcli package from GitHub using the devtools package:
# Install devtools if you haven't already
if (!requireNamespace("devtools", quietly = TRUE)) {
install.packages("devtools")
}
# Install plotcli from GitHub
devtools::install_github("cheuerde/plotcli")The easiest way to use the package if you are already familiar with ggplot2 is to configure your ggplot2 object as usual and then simply convert to a plotcli terminal plot with ggplotcli:
# Load the plotcli package
library(plotcli)
data(mtcars)
mtcars$cf = as.character(mtcars$cyl)
p = ggplot(mtcars, aes(x = mpg, y = wt, color = cf)) + geom_point()
# print to terminal
ggplotcli(p, braille = FALSE)Check the vignettes for all possible ways of using the package.
plotcli is released under the MIT License.