-
Notifications
You must be signed in to change notification settings - Fork 10
/
README.Rmd
118 lines (91 loc) · 4.37 KB
/
README.Rmd
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
---
output:
md_document:
variant: gfm
---
<!-- README.md is generated from README.Rmd. Please edit that file -->
```{r, echo = FALSE}
knitr::opts_chunk$set(
collapse = TRUE,
comment = "#>",
fig.path = "README-"
)
```
taucharts is an R htmlwidget interface to the TauCharts javascript library
Take a look at the [TODO list](https://github.com/hrbrmstr/taucharts/issues/1) and chip in!
Right now, you can make & customize (including manual color scales & ordered factors + legends + tooltips + trendlines):
- scatterplots
- scatterplot matrices
- line charts
- bar charts (veritical, horizontal & stacked)
Composite plots are on the road map for support but not in the R package yet.
Have a look [on RPubs](http://rpubs.com/hrbrmstr/taucharts) to see what `taucharts` can do!
The following functions are implemented:
- `tauchart`: Create a new TauChart
- `tau_line`: Create a TauCharts line chart
- `tau_point`: Create a TauCharts scatterplot
- `tau_bar`: Create a TauCharts bar chart (horizontal or vertical)
- `tau_stacked_bar`: Create a TauCharts stacked bar chart (veritcal only)
- `tau_guide_gridlines`: Control showing of axis gridlines
- `tau_guide_padding`: Set overall chart padding
- `tau_guide_x`: Control x-axis padding, label, scale & tick format
- `tau_guide_y`: Control y-axis padding, label, scale & tick format
- `tau_legend`: Add a TauCharts legend
- `tau_tooltip`: Add a TauCharts tooltip
- `tau_trendline`: Add a TauCharts trendline
- `run_tau_app`: Run a built-in example Shiny app
- `tau_tasks`: Add post-render JavaScript tasks to taucharts
- `tau_add_css_rule`: Add a CSS rule to the rendered htmlwidget
- `tau_set_font`: Set `font-family` for the chart
- `as_tauchart`: Turn a simple (single-geom) ggplot plot into an tauchart object
- `tau_title`: Add a title to the tauchart plot
with many color palette options:
- `tau_color_manual`: Specify the colors used in the charts
- `tau_color_brewer`: Use the ColorBrewer palette in the charts
- `tau_color_economist`: Use the "Economist" palette used in the charts
- `tau_color_few`: Use the "Few" palette used in the charts
- `tau_color_highcharts`: Use the HighchartsJS palette used in the charts
- `tau_color_manual`: Specify the colors used in the charts
- `tau_color_tableau`: Use the Tableau palette in the charts
- `tau_color_wsj`: Use the "Wall Street Journal" palette used in the charts
The following datasets are included:
- `cars_data`: statistics on cars released from 1997 through 2013 (a data frame with 135 rows and 7 variables)
### News
- Version 0.4.5 released : Shiny click events, color themes for faceted charts, updated TauCharts JS lib
- Version 0.4.4.9000 released : `tau_title`
- Version 0.4.3.9000 released : minor issue with guides
- Version 0.4.2.9000 released : pre-CRAN flight check
- Version 0.4.0.9000 released : added `as_tauchart` & updated TauCharts JS lib
- Version 0.3.4.9000 released : added warning for global targeted CSS rules and font ref fix thx to @jlewis91
- Version 0.3.3.9001 released : fix for custom colors and `tau_line`
- Version 0.3.3 released : custom font for chart (`?tau_set_font`)
- Version 0.3.2 released : custom colors working in legend & trendlines
- Version 0.3.1 released : removed R 3.2.0 dependency (removed the dependent code)
- Version 0.3.0 released : color palettes galore!
- Version 0.3.0.9000 released : `?tau_add_css_rule` (add CSS rules to a chart)
- Version 0.2.6.9000 released : `?tau_tasks` (add JavaScript to a chart)
- Version 0.2.5.9000 released : list & run example Shiny apps - see `?run_tau_app` for more info
- Version 0.2.5.9000 released : stacked bar charts
- Version 0.1.0 released : trendline, tooltips & dev fork (prod is pretty much stable & functional)
- Version 0.0.1.9003 released : facet-based ordering + legends
- Version 0.0.1.9000 released : auto-detects column classes, can add manual colors & faceted plots are now working (see the Rpub for an example)
- Version 0.0.0.9000 released
### Installation
```{r eval=FALSE}
devtools::install_github("hrbrmstr/taucharts")
```
### Usage
```{r}
library(taucharts)
# current verison
packageVersion("taucharts")
```
### Test Results
```{r}
library(testthat)
date()
test_dir("tests/testthat", reporter = SummaryReporter)
```
### Code of Conduct
Please note that this project is released with a [Contributor Code of Conduct](CONDUCT.md).
By participating in this project you agree to abide by its terms.