brinton v0.1.7

0

Monthly downloads

0th

Percentile

A Graphical EDA Tool

An automated graphical exploratory data analysis (EDA) tool that introduces: a.) wideplot() graphics for exploring the structure of a dataset through a grid of variables and graphic types. b.) longplot() graphics, which present the entire catalog of available graphics for representing a particular variable using a grid of graphic types and variations on these types. c.) plotup() function, which presents a particular graphic for a specific variable of a dataset. The plotup() function also makes it possible to obtain the code used to generate the graphic, meaning that the user can adjust its properties as needed.

Readme

brinton

This package introduces:

  • wideplot() graphics for exploring the structure of a dataset through a grid of variables and graphic types.
  • longplot() graphics, which present the entire catalog of available graphics for representing one particular variable or a limited number of variables using a grid of graphic types and variations on these types.
  • plotup() function, which complements the previous two functions in that it presents a particular graphic for a specific variable or a limited number of variables of a dataset.

Future work will include the ability to draw longplot() and plotup() graphics from a selection of a wider number and combinations of types of variables within a dataset.

Installation

You can install the released version of brinton from CRAN with:

install.packages("brinton")

And then load the functions included in the package:

library(brinton)
#> Loading required package: ggplot2
#> Loading required package: gridExtra
#> Loading required package: rmarkdown
#> Loading required package: glue
#> M a G i C i N G R a P H S

Example

When a new dataset comes up, R users use to call the str() function that describes textually the main characteristics of this dataset. The new wideplot() function does the same but graphically. As an example, just run:

wideplot(infert)

This function includes the argument dataclass that sets the types of variables to be included in the grid as well as the order in which they are listed. As an example, the following line will plot only the numeric variables included in the iris dataset:

wideplot(infert, dataclass = c("numeric"))

Although, the wideplot() function shows only a small set of the graphics suitable for each type of data. If the user wants to see all the available graphics for some specific variable included in the dataset, then the longplot() is useful. As an example, just run:

longplot(infert, "pooled.stratum")

Any of the graphics presented in the longplot() output can also be presented. If one wants to compare the output of some other specific graphics one can, for instance, run:

wideplot(infert,
         dataclass = c("numeric"),
         numeric = c("point graph", "binned point graph", "binned heatmap"),
         label = TRUE)

Sometimes, specially with character variables, there is not enought space for the graphic area, and the user may want to increase the width of the columns in the matrix. The user can then modify the defalut value of the ncol argument:

wideplot(infert,
         dataclass = c("numeric"),
         numeric = c("point graph", "binned point graph", "binned heatmap"),
         label = TRUE,
         ncol = 3)

If the user is interested in one particular graphic then the function plotup() is useful.

plotup(infert, "pooled.stratum", "color binned stripe graph")

Or, as example of a graphic that requires more than one input variable:

plotup(faithful, c("waiting", "eruptions"), "color scatter plot")

The default output is still a html file but the plotup() function allows to plot the graphic in the plots pane or the console:

plotup(infert, "pooled.stratum", "color binned stripe graph", output = "plots pane")

plotup(faithful, c("waiting", "eruptions"), "color scatter plot", output = "plots pane")
#> Warning: Use of `faithful$waiting` is discouraged. Use `waiting` instead.
#> Warning: Use of `faithful$eruptions` is discouraged. Use `eruptions` instead.

plotup(infert, "pooled.stratum", "color binned stripe graph", output = "console")
#> theme_set(theme_minimal())
#> 
#> binwidth <- (max(infert['pooled.stratum'], na.rm=TRUE)-min(infert['pooled.stratum'], na.rm=TRUE))/20
#> ggplot(infert, aes(x=pooled.stratum)) +
#>   geom_bin2d(aes(y=1), binwidth = c(binwidth, 1)) +
#>   scale_fill_gradientn(colours = colorRampPalette(rev(RColorBrewer::brewer.pal(4, 'Spectral')))(3)) +
#>   theme(panel.grid = element_line(colour = NA),
#>     axis.text.y =element_text(color = NA),
#>     axis.title.y =element_text(color = NA),
#>     axis.ticks.x =element_line(color = 'black'),
#>     legend.position='none')

Functions in brinton

Name Description
plotup Presents a specific graphic explicitly called by name.
wideplot Presents a wideplot in a html output.
longplot Presents a longplot in a html output.
No Results!

Vignettes of brinton

Name
figures/2datetime_01-1.png
figures/2datetime_02-1.png
figures/2datetime_03-1.png
figures/2datetime_04-1.png
figures/2datetime_05-1.png
figures/2datetime_06-1.png
figures/2numeric_01-1.png
figures/2numeric_02-1.png
figures/2numeric_03-1.png
figures/2numeric_04-1.png
figures/2numeric_05-1.png
figures/2numeric_06-1.png
figures/2numeric_07-1.png
figures/2numeric_08-1.png
figures/2numeric_09-1.png
figures/2numeric_10-1.png
figures/2numeric_11-1.png
figures/2numeric_12-1.png
figures/2numeric_13-1.png
figures/2numeric_14-1.png
figures/2numeric_15-1.png
figures/2numeric_16-1.png
figures/2numeric_17-1.png
figures/2numeric_18-1.png
figures/2numeric_19-1.png
figures/2numeric_20-1.png
figures/2numeric_21-1.png
figures/2numeric_22-1.png
figures/2numeric_23-1.png
figures/2numeric_24-1.png
figures/character_01-1.png
figures/character_02-1.png
figures/character_03-1.png
figures/character_04-1.png
figures/character_05-1.png
figures/character_06-1.png
figures/character_07-1.png
figures/character_08-1.png
figures/character_09-1.png
figures/character_10-1.png
figures/character_11-1.png
figures/date-num_01-1.png
figures/date-num_02-1.png
figures/date-num_03-1.png
figures/date-num_04-1.png
figures/date-num_05-1.png
figures/date-num_06-1.png
figures/datetime_01-1.png
figures/datetime_02-1.png
figures/datetime_03-1.png
figures/datetime_04-1.png
figures/datetime_05-1.png
figures/fac-num_01-1.png
figures/fac-num_02-1.png
figures/fac-num_03-1.png
figures/fac-num_04-1.png
figures/fac-num_05-1.png
figures/fac-num_06-1.png
figures/fac-num_07-1.png
figures/fac-num_08-1.png
figures/factor_01-1.png
figures/factor_02-1.png
figures/factor_03-1.png
figures/factor_04-1.png
figures/factor_05-1.png
figures/factor_06-1.png
figures/factor_07-1.png
figures/factor_08-1.png
figures/factor_09-1.png
figures/factor_10-1.png
figures/factor_11-1.png
figures/logical_01-1.png
figures/logical_01.png
figures/logical_02-1.png
figures/logical_03-1.png
figures/logical_04-1.png
figures/longplot_esoph_alcgp.png
figures/numeric_01-1.png
figures/numeric_02-1.png
figures/numeric_03-1.png
figures/numeric_04-1.png
figures/numeric_05-1.png
figures/numeric_06-1.png
figures/numeric_07-1.png
figures/numeric_08-1.png
figures/numeric_09-1.png
figures/numeric_10-1.png
figures/numeric_11-1.png
figures/numeric_12-1.png
figures/numeric_13-1.png
figures/numeric_14-1.png
figures/numeric_15-1.png
figures/numeric_16-1.png
figures/numeric_17-1.png
figures/numeric_18-1.png
figures/numeric_19-1.png
figures/ordered_01-1.png
figures/ordered_02-1.png
figures/ordered_03-1.png
figures/ordered_04-1.png
figures/plotup_esoph_ncases_linegraph.png
figures/wideplot_esoph.jpeg
figures/wideplot_esoph.png
brinton.Rmd
specimen.Rmd
No Results!

Last month downloads

Details

Type Package
License GPL-3
Encoding UTF-8
LazyData true
RoxygenNote 7.0.2
VignetteBuilder knitr
SystemRequirements Pandoc (>= 1.12.3), web browser
URL https://sciencegraph.github.io/brinton/
NeedsCompilation no
Packaged 2020-05-22 11:46:43 UTC; 34601
Repository CRAN
Date/Publication 2020-05-22 22:40:16 UTC

Include our badge in your README

[![Rdoc](http://www.rdocumentation.org/badges/version/brinton)](http://www.rdocumentation.org/packages/brinton)