Type: | Package |
Title: | Data Visualisation Using an HTML Page and 'D3.js' |
Version: | 0.2.8 |
Date: | 2019-09-16 |
Maintainer: | Timothy Bell <horia.yeb@gmail.com> |
Description: | Gives access to data visualisation methods that are relevant from the statistician's point of view. Using 'D3”s existing data visualisation tools to empower R language and environment. The throw chart method is a line chart used to illustrate paired data sets (such as before-after, male-female). |
License: | GPL-2 | GPL-3 [expanded from: GPL (≥ 2)] |
Imports: | Rcpp (≥ 1.0.0) |
LinkingTo: | Rcpp |
Depends: | tibble |
LazyData: | true |
NeedsCompilation: | yes |
Packaged: | 2019-09-16 16:57:51 UTC; Timothy |
Author: | Timothy Bell [aut, cre], Christophe Genolini [aut, ths] |
Repository: | CRAN |
Date/Publication: | 2019-09-16 17:10:03 UTC |
~ Overview: package DataViz ~
Description
Various data vizualisation methods.
Details
Data Visualisation is the art of graphically representing data. There are numerous data visualisation methods, but they aren't always relevant -and sometimes less informative than basic representations-. Moreover they are often created by programmers in various computer languages and the code being seldom available.
DataViz is a package aiming to give access to Data Visualisation methods that are relevant from the statistician's point of view.
The 3 first methods to be implemented are throwchart, Gravity Bubble Chart (V0.3, june 2019) and XXX (V0.4, septembre 2019)
Author(s)
Timothy Bell horia.yeb@gmail.com Christophe Genolini christophe.genolini@u-paris10.fr
Maintainer: Timothy Bell <horia.yeb@gmail.com>
References
Inspired from http://tiffanyfrance.com/data-is-beautiful/19-01/
See Also
Examples
if(interactive()){
throwchart(c(1,2),c(2,8),c("#000","#F82"),id = c("id1","id2"),c(1,5))
throwchart(c(1,2),c(2,8))
}
if(!interactive()){
throwchart(c(1,2),c(2,8), offSet = 1, webinteract=FALSE)
throwchart(c(1,2),c(2,1), webinteract=FALSE)
throwchart(c(1,2),c(2,8),c("#000","#F00"),c(1,5), webinteract=FALSE)
}
~ Example data set for force layout ~
Description
Set for force layout, artificial data.
~ Main function: forcelayout ~
Description
forcelayout method is a dynamic method showing longitudinal data set evolution.
Usage
forcelayout(schedule, webinteract, ttime)
Arguments
schedule |
[numeric] or [integer]: A (non-empty) vector of data values. |
webinteract |
[bool]: Is the function used in interactive mode? |
ttime |
[string]: A (non-empty) time-unit value to fetch data from data.frame. |
Examples
if(interactive()){
forcelayout(weekschedule)
}
if(!interactive()){
forcelayout(weekschedule, webinteract = FALSE, ttime = "Monday")
}
~ List of the oldest people in the world data set ~
Description
This is data from http://www.grg.org/Adams/Deaths2012.HTM, a list of all the oldest people in history holding the record.
~ Quadratic fitting function: quad ~
Description
Fits a set of paired points with a quadratic curve. Returns the quadratic set of points. Function only called by r_throwchart.
Usage
quad(point,before_point,after_point,offSet)
Arguments
point |
[numeric] or [integer]: A set of points between before and after points. |
before_point |
[numeric] or [integer]: The first point of the curve. |
after_point |
[numeric] or [integer]: The last point of the curve. |
offSet |
[integer]: Single value offset for the graph. |
Value
returns the quadratic point equivalent.
~ R graphics function: r_forcelayout ~
Description
Used when interactive is false and creates a plot through R of this data visualisation method.
Usage
r_forcelayout(schedule, ttime)
Arguments
schedule |
[string]: A (non-empty) data.frame of data values. |
ttime |
[string]: A (non-empty) time-unit value to fetch data from data.frame. |
Examples
if(interactive()){
r_forcelayout(weekschedule,ttime = "Tuesday")
}
~ R graphics function: r_throwchart ~
Description
Used when interactive is false and creates a plot through R of this data visualisation method.
Usage
r_throwchart(before, after,xlim, ylim, col, lwd, offSet)
Arguments
before |
[numeric] or [integer]: A (non-empty) vector of data values. |
after |
[numeric] or [integer]: A (non-empty) vector of data values. |
col |
[character]: A vector of hex code colours, by default "#123". |
lwd |
[integer]: Line width, a column of line widths, by default value is 2.5. |
xlim |
[numeric]: 2 value colum with x limits. |
ylim |
[numeric]: 2 value colum with y limits. |
offSet |
[integer]: Single value offset for the graph. |
Examples
if(interactive()){
r_throwchart(tibble(c(1,2)),tibble(c(2,8)),c(0,0),c(0,0),col = "blue", c(1,5), offSet = 1)
}
~ C++ called function: rcpp_forcelayout ~
Description
This function takes the inputs from forcelayout, and writes the data in Json array, then this function calls a windows cmd function to open an index.html in the extdata.
Usage
rcpp_forcelayout(schedule, path)
Arguments
schedule |
A number column |
path |
The path for the library |
Examples
if(interactive()){
rcpp_throwchart(weekschedule,path.package("DataViz"))
}
~ C++ called function: rcpp_throwchart ~
Description
This function takes the inputs from throwchart, and writes the data in Json array, then this function calls a windows cmd function to open an index.html in the extdata.
Usage
rcpp_throwchart(before, after ,col, id, lwd, xlim, ylim, offSet, path)
Arguments
before |
A number column |
after |
A number column |
col |
A hex code colour colum has to be format "#000" |
id |
An id has to be string |
lwd |
A number for the line width best between 1-5) |
xlim |
[numeric]: 2 value colum with x limits. |
ylim |
[numeric]: 2 value colum with y limits. |
offSet |
[integer]: Single value for the graph offset. |
path |
The path for the library |
Examples
if(interactive()){
before = tibble(c(1,2))
after = tibble(c(2,8))
col = tibble(c("#000","#F82"))
id = tibble(c("",""))
lwd = tibble(c(1,5))
xlim = tibble(c(0,0))
rcpp_throwchart(before,after,col,id,lwd,xlim,0,path.package("DataViz"))}
~ Main function: throwchart ~
Description
Throwchart method is useful for visualising paired data, such as before/after data sets. Each pair of points are set on a horizontal axis and joined by a parabola. The height of the parabola is proportional to the difference: after- before = difference. If the difference is negative (after < before) then the curve is drawn under the axis.
Usage
throwchart(before, after, col, id, lwd, xlim, ylim, offSet, webinteract)
Arguments
before |
[numeric] or [integer]: A (non-empty) vector of data values. |
after |
[numeric] or [integer]: A (non-empty) vector of data values. |
col |
[character]: A vector of hex code colours, by default "#123". |
id |
[factor]: Column of string or number identifiers. |
lwd |
[integer]: Line width, a column of line widths, by default value is 2.5. |
xlim |
[numeric]: 2 value colum with x limits. |
ylim |
[numeric]: 2 value colum with y limits. |
offSet |
[integer]: Single value offset for the graph. |
webinteract |
[bool]: Is the function used in interactive mode? |
Examples
if(interactive()){
throwchart(c(1,2),c(2,8),c("#000","#F82"),id = c("id1","id2"),c(1,5))
throwchart(c(1,2),c(2,8), offSet = 1, webinteract=TRUE)
}
if(!interactive()){
throwchart(c(1,2),c(2,8), offSet = 1, webinteract=FALSE)
throwchart(c(1,2),c(2,1), webinteract=FALSE)
throwchart(c(1,2),c(2,8),c("#000","#F00"),id = c("id1","id2"),c(1,5), webinteract=FALSE)
n <- 10
Avant <- rnorm(n)
Apres <- Avant + rnorm(n) + 10
throwchart(Avant, Apres, xlim = c(-4,14), webinteract = FALSE)
throwchart(Avant, Apres, offSet = 0, webinteract = FALSE)
throwchart(Avant, Apres, offSet = 8, webinteract = FALSE)
}
~ Example data set number 2 for force layout ~
Description
Set for force layout, artificial data.