'Sparklines' in the 'R' Terminal

A 'sparkline' is a line chart, without axes and labels. Its goal is to show the general shape of changes over time, or another quantity. This package is an 'R' implementation of the original shell project: < http://zachholman.com/spark/>.


Linux Build Status Windows Build status CRAN RStudio mirror downloads Coverage Status

This is an R port of spark.sh.

The spark.sh wiki has some cool usage examples.

Installation

Install it from github, with the devtools package:

devtools::install_github("gaborcsardi/spark")
library(spark)

Enhancements

The R package has some improvements compared to the original shell implementation.

Scaling

The length of the spark line can be fitted to the width of the teminal window:

spark(lynx, width = "auto")
##> ▁▁▂▄▆▇▃▁▁▁▄▄▂▁▁▁▁▃▃▁▁▁▂▄▃▁▁▁▂▆▆▁▁▁▂▃▂▁▁▁▂▄▅▂▁▁▁▁▃▅▁▁▁▂▇█▄▁▁▂▅▅▅▂▁▁▁▂▄▄▂▁▂▃▄

Matrices

Matrices can be plotted row-wise:

spark(t(EuStockMarkets), width="auto", common_scale = FALSE)
##> ▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▂▂▂▂▂▂▂▂▂▂▂▂▂▂▂▁▂▂▂▂▂▂▂▂▂▂▂▂▂▂▃▃▃▃▃▄▄▄▅▅▆▅▅▅▆▆▇▇███
##> ▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▂▂▂▂▂▂▂▂▂▂▂▂▂▂▂▂▂▂▂▂▂▂▂▂▂▃▃▃▃▃▃▃▃▃▃▃▄▄▄▅▅▆▅▅▅▆▆▇█████
##> ▁▁▁▁▁▁▁▁▁▂▁▁▁▁▁▁▁▁▁▁▁▁▂▂▂▂▂▂▂▂▂▁▂▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▂▂▂▁▂▂▂▂▃▃▃▄▄▄▄▅▄▄▄▅▇▇███
##> ▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▂▂▁▂▂▂▂▂▂▃▃▂▂▂▂▂▂▂▂▂▂▂▂▂▃▃▃▃▃▃▃▄▃▄▄▄▄▄▄▄▄▄▅▅▅▆▆▆▆▆▆▇▇█████

Marking minima and maxima

spark(lh, max = crayon::red)
##> ▄▄▄▄▃▁▄▄▅▃▂▂▄▂▇▇▅▄▄▂▂▂▅▇▄▃▃▆▆▅▅▄▅▄▂▂▁▁▃███▇▅▃█▇▆

News

2.0.0

  • Add a sparkline class.

  • Remove the print option, the sparkline class auto-prints.

  • Remove the magrittr dependency.

  • Import symbols from the clisymbols package, to get automatic fallback symbols in non-UTF8 terminals.

  • Better detection of UTF-8 terminals, use l10n_info().

1.0.1

First version with a NEWS file.

  • Various fixes for R CMD check.

1.0.0

Last version without a NEWS file.

Reference manual

It appears you don't have a PDF plugin for this browser. You can click here to download the reference manual.

install.packages("spark")

2.0.0 by Gábor Csárdi, 9 months ago


https://github.com/gaborcsardi/spark


Report a bug at https://github.com/gaborcsardi/spark/issues


Browse source code at https://github.com/cran/spark


Authors: Gábor Csárdi


Documentation:   PDF Manual  


MIT + file LICENSE license


Imports clisymbols, methods, utils

Suggests covr, crayon, mockr, testthat


See at CRAN