From 2962579e2eb3408c48514e8b8367536f0923a7ef Mon Sep 17 00:00:00 2001 From: pvictor Date: Thu, 14 Feb 2019 18:33:35 +0100 Subject: [PATCH] update README --- README.md | 36 +++++++++++++++++++++++++++++++++--- man/figures/apex-bar.png | Bin 0 -> 20476 bytes man/figures/apex-line.png | Bin 0 -> 24063 bytes 3 files changed, 33 insertions(+), 3 deletions(-) create mode 100644 man/figures/apex-bar.png create mode 100644 man/figures/apex-line.png diff --git a/README.md b/README.md index c944952..d48228e 100644 --- a/README.md +++ b/README.md @@ -1,14 +1,17 @@ # apexcharter -> Htmlwidget for [apexcharts.js](https://github.com/apexcharts/apexcharts.js) +> Htmlwidget for [apexcharts.js](https://github.com/apexcharts/apexcharts.js) : A modern JavaScript charting library to build interactive charts and visualizations with simple API. [![Travis build status](https://travis-ci.org/dreamRs/apexcharter.svg?branch=master)](https://travis-ci.org/dreamRs/apexcharter) +[![Project Status: WIP – Initial development is in progress, but there has not yet been a stable, usable release suitable for the public.](https://www.repostatus.org/badges/latest/wip.svg)](https://www.repostatus.org/#wip) -:construction: :warning: Under development !! API will change :warning: :construction: +:construction: Under development !! API will change :construction: :warning: Use RStudio >= 1.2 to properly display charts +Note: Once again, development is heavily inspired by amazing [highcharter](http://jkunst.com/highcharter/). + ## Installation @@ -20,7 +23,34 @@ devtools::install_github("dreamRs/apexcharter") ``` -## Basic example + +## Quick Charts + +Use `apex` function to quickly create visualizations : + + +```r +library(apexcharter) + +data("mpg", package = "ggplot2") +n_manufac <- dplyr::count(mpg, manufacturer) + +apex(data = n_manufac, type = "bar", mapping = aes(x = manufacturer, y = n)) +``` +![](man/figures/apex-bar.png) + + +With datetime: + +```r +data("economics", package = "ggplot2") +apex(data = economics, type = "line", mapping = aes(x = date, y = uempmed)) %>% + ax_stroke(width = 1) +``` +![](man/figures/apex-line.png) + + +## Full API Simple bar chart : diff --git a/man/figures/apex-bar.png b/man/figures/apex-bar.png new file mode 100644 index 0000000000000000000000000000000000000000..0e25538f28222addf417539141a4c425d67e88f2 GIT binary patch literal 20476 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 v8tq~Nh6jG literal 0 HcmV?d00001 diff --git a/man/figures/apex-line.png b/man/figures/apex-line.png new file mode 100644 index 0000000000000000000000000000000000000000..7e03902805fffb223bc9ccb77494c09be7fbdcd7 GIT binary patch literal 24063 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