Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/davidgohel/ReporteRs
Note that ReporteRs has been removed from CRAN the 16th of July 2018 and is not maintained anymore. please migrate to officer.
https://github.com/davidgohel/ReporteRs
Last synced: 3 months ago
JSON representation
Note that ReporteRs has been removed from CRAN the 16th of July 2018 and is not maintained anymore. please migrate to officer.
- Host: GitHub
- URL: https://github.com/davidgohel/ReporteRs
- Owner: davidgohel
- Archived: true
- Created: 2014-01-27T01:38:45.000Z (almost 11 years ago)
- Default Branch: master
- Last Pushed: 2020-03-23T09:28:10.000Z (over 4 years ago)
- Last Synced: 2024-05-21T03:34:10.590Z (6 months ago)
- Language: R
- Homepage:
- Size: 26.2 MB
- Stars: 245
- Watchers: 33
- Forks: 44
- Open Issues: 5
-
Metadata Files:
- Readme: README.Rmd
Awesome Lists containing this project
- jimsghstars - davidgohel/ReporteRs - Note that ReporteRs has been removed from CRAN the 16th of July 2018 and is not maintained anymore. please migrate to officer. (R)
README
---
title: "ReporteRs"
output:
github_document
---
# Important note
ReporteRs has been rewritten. The new package is
[`officer`](https://cran.r-project.org/package=officer). FlexTable objects are
now implemented in package [`flextable`](https://CRAN.R-project.org/package=flextable).
Vector graphics are now implemented in package [`rvg`](https://CRAN.R-project.org/package=rvg) and
Native Microsoft charts can be produced with package [`mschart`](https://github.com/ardata-fr/mschart).
Please **use officer instead of ReporteRs**. There are issues
when using java > 1.8 that won't be fixed.
```{r, echo = FALSE, message=FALSE, warning=FALSE}
knitr::opts_chunk$set(
collapse = TRUE,
comment = "#>"
)
library(ReporteRs)
```
## Overview
`ReporteRs` is an R package for creating Microsoft Word and Powerpoint documents. It does not require any Microsoft component to be used. It runs on Windows, Linux, Unix and Mac OS systems. It is designed to automate reporting generation from R.
## Introduction
You can use the package as a tool for fast reporting and as a tool for reporting automation.
There are several features to let you format and present R outputs, for example:
* **Editable Vector Graphics**: let your readers modify and annotate plots.
* **Tables**: `FlexTable` objects let you format any complex table.
* **Text output**: format texts and paragraphs.
* Reuse of corporate **template document** (*.docx and *.pptx).
### Produce a document in few lines of codes
There are default templates and default values, it enables easy generation
of R outputs in few lines of codes.
Below a short R script:
```{r message=FALSE, eval=FALSE}
require( ggplot2 )
doc = docx( title = 'My document' )
doc = addTitle( doc , 'First 5 lines of iris', level = 1)
doc = addFlexTable( doc , vanilla.table(iris[1:5, ]) )
doc = addTitle( doc , 'ggplot2 example', level = 1)
myggplot = qplot(Sepal.Length, Petal.Length, data = iris, color = Species, size = Petal.Width )
doc = addPlot( doc = doc , fun = print, x = myggplot )
doc = addTitle( doc , 'Text example', level = 1)
doc = addParagraph( doc, 'My tailor is rich.', stylename = 'Normal' )
writeDoc( doc, "demo.docx" )
```
### Reporting automation
It lets you also create corporate documents, creation of complex tables,
pretty graphical rendering with a set of R functions.
To automate document generation only R code is necessary.
With Word and PowerPoint document, you can add contents from R but also replace
contents. By default, content is added at the end of the specified template document.
When generating Word document, bookmarks can be used to define locations of
replacements in the document. When generating PowerPoint document, slide indexes
can be used to define locations of slides to replace in the presentation.
## Installation
ReporteRs needs `rJava` with a java version >= 1.6 and <= 1.8 ; make sure you have an installed JRE.
`system("java -version")` should return *java version '1.6.0'* or greater.
Test your `rJava` installation with the following code, you should get your java version in a string:
```{r message=FALSE}
require(rJava)
.jinit()
.jcall('java.lang.System','S','getProperty','java.version')
```
### From Github
```{r eval=FALSE}
devtools::install_github('davidgohel/ReporteRsjars')
devtools::install_github('davidgohel/ReporteRs')
```
## Ressources
### Online documentation
The help pages are located at https://davidgohel.github.io/ReporteRs/.
### Getting help
This project is developped and maintained on my own time. In order to help me to maintain the
package, do not send me private emails if you only have questions about how to use the package.
Instead, visit Stackoverflow, `ReporteRs` has its own tag [Stackoverflow link](https://stackoverflow.com/questions/tagged/reporters)!
I usually read them and answer when possible.
### Bug reports
When you file a [bug report](https://github.com/davidgohel/ReporteRs/issues), please spend some time making it easy for me to follow and reproduce. The more time you spend on making the bug report coherent, the more time I can dedicate to investigate the bug as opposed to the bug report.