The reporter package creates regulatory-style statistical reports. It was designed to produce Tables, Listings, and Figures (TLFs) for the the pharmaceutical, biotechnology, and medical-device industries. However, the functions are generalized enough to provide statistical reporting for any industry. The package is written in Base R, and has no dependencies on any other reporting package.
The package is intended to give R programmers flexible report layout capabilities and a choice of output formats. The package will initially focus on printable, file-based output formats. The current version supports TXT, RTF, PDF, HTML, and DOCX output types. Note that, unlike other packages, all outputs from the reporter package are paged by default.
The reporter package is distributed under a Creative Commons non-commercial license. It is freely available for personal and organizational use, but cannot be used to create a commercial product without permission of the license holder.
The reporter package contains the following key features:
There are four steps to creating a report:
You can create the report with the
function. Content is created with the
create_plot() functions. Add
content to the report with the
Finally, the report can be written to a file with the
Let’s look at a simple example:
library(reporter) library(magrittr) # Create temp file name <- file.path(tempdir(), "example.pdf") tmp # Create report content <- create_table(mtcars) %>% tbl titles("MTCARS Sample Data") %>% footnotes("* Motor Trend, 1974") # Create report and add content <- create_report(tmp, output_type = "PDF", rpt font = "Courier", font_size = 12) %>% add_content(tbl) # Write out the report write_report(rpt) # Un-comment to view report # file.show(tmp)
As you can see, using the reporter package, you can create a useful report with just a few lines of code. By default, the package creates a text report. But you can create reports in RTF, PDF, HTML, and DOCX with just a single parameter change.
Besides the functions shown above, there are additional functions to create page headers and footers, spanning headers, a report stub, a by-variable, and more. The package also allows you to add text and plots to a report. All of these capabilities are demonstrated in the examples below.
For next steps, it is recommended that you review some examples of the reporter package in action. The examples show a variety of common use cases. You will see that the reporter functions are very intuitive and easy to use. Here is a list of examples: