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
ggplotcli
plotcli
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 3.2 │ └───────┘ │ ┌───────┐ │ versicolor
Sepal.Length
│ │ │ │ │ │ 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
::install_github("cheuerde/plotcli") devtools
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)
$cf = as.character(mtcars$cyl)
mtcars
= ggplot(mtcars, aes(x = mpg, y = wt, color = cf)) + geom_point()
p
# 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.