search

helgasoft / echarty

Minimal R/Shiny Interface to ECharts.js
https://helgasoft.github.io/echarty/
87 stars 3 forks source link
3d animation boxplot charts crosstalk dendrogram echarts geojson globe graphs heatmap hierarchical-data leaflet maps morphing r shapefiles shiny visualization webr

readme

echarty

R-CMD-check coverage size website twitter

echarty.gallery

This package is a thin R wrapper around Javascript library ECharts.
One major command(ec.init) uses R lists to support the ECharts API.
Benefit from ECharts full functionality and build interactive charts in R and Shiny with minimal overhead.

Wider connectivity and deployment potential through WebR and crosstalk.

Compare to echarts4r 📌 R package | echarts4r | echarty --- | --- | --- initial commit | Mar 12, 2018 | Feb 5, 2021 library size | ![878 KB](https://img.shields.io/github/languages/code-size/JohnCoene/echarts4r.svg) | ![224KB](https://img.shields.io/github/languages/code-size/helgasoft/echarty) test coverage | ![32%](https://coveralls.io/repos/github/JohnCoene/echarts4r/badge.svg) [![link](man/figs/external-link-16.png)](https://coveralls.io/github/JohnCoene/echarts4r) | ![93%](https://coveralls.io/repos/github/helgasoft/echarty/badge.svg) [![link](man/figs/external-link-16.png)](https://coveralls.io/github/helgasoft/echarty) lines of code | 1,202,623 [![link](man/figs/external-link-16.png)](https://api.codetabs.com/v1/loc/?github=JohnCoene/echarts4r) | 5,517 [![link](man/figs/external-link-16.png)](https://api.codetabs.com/v1/loc?github=helgasoft/echarty) API design (1) | own commands with parameters | mostly [ECharts option](https://echarts.apache.org/en/option.html) lists number of commands | over [200](https://echarts4r.john-coene.com/reference/) | **one** command + optional utility commands data storage support | series data | **[datasets](https://echarts.apache.org/en/option.html#dataset)**, series data dependencies ([packrat](https://rdrr.io/cran/packrat/src/R/recursive-package-dependencies.R#sym-recursivePackageDependencies)) | 65 | 40 dependencies ([WebR](https://repo.r-wasm.org)) | 188 | 46 [WebR](https://docs.r-wasm.org/webr/latest/) support | no | **yes** [crosstalk](https://rstudio.github.io/crosstalk/) support | no | **yes** utilities | bezier, correlations, histogram, density, loess, flip, nesting, more | extended boxplots, tabsets, layouts, shapefiles, lotties, more (1) We encourage users to follow the original ECharts API to construct charts with echarty. This differs from echarts4r which uses own commands for most chart options. Comparison review done Feb 2024 for current versions of echarts4R and echarty. ___

Please consider granting a Github star ⭐ to show your support.

Installation

Latest development build 1.6.4.1

if (!requireNamespace('remotes')) install.packages('remotes')
remotes::install_github('helgasoft/echarty')

CRAN status From CRAN:

install.packages('echarty')

Examples

library(echarty); library(dplyr)

#  scatter chart (default)
cars |> ec.init()

#  parallel chart
ToothGrowth |> ec.init(ctype= 'parallel')

#  3D chart with GL plugin
iris |> group_by(Species) |> ec.init(load= '3D')

#  timeline of two series with grouping, formatting, autoPlay
iris |> group_by(Species) |> 
ec.init(
  timeline= list(autoPlay= TRUE),
  series.param = list(
    symbolSize= ec.clmn('Petal.Width', scale= 9),
    encode= list(x= 'Sepal.Width', y='Petal.Length'),
    markLine= list(data= list(list(type='max'), list(type='min')))
  )
)

# show a remote map chart, needs package leaflet installed
echarty::ec.fromJson('https://helgasoft.github.io/echarty/test/pfull.json')

Get started

The Coder is a good introduction, type library(echarty); demo(coder).
The WEBSITE has a vast gallery with code and tutorials.
The package itself has also code examples included. Type ?ec.examples, then copy/paste any code to see the chart.

Now you can start building beautiful ECharts (and more) with R and Shiny!


Polar Stack

Made with echarty. Powered by ECharts.