R-CMD-check CRAN checks version cranlogs Active Lifecycle: Experimental

Templated Word and PowerPoint reporting for nlmixr2


The purpose of this package is to automate the reporting of analyses performed in the nlmixr2 package in both PowerPoint and Word. This is accomplished with a yaml file that contains specifications for report elements (figures and tables) as well as the contents of Word and PowerPoint documents. Internal templates for both the documents and the report yaml file are included. These can be customized: The format of the document templates can be customized for your organization by using the onbrand package. The report contents can be customized by creating a copy of the included yaml file and modifying it to suite your needs (see the vignette below).


To install off of CRAN:

install.packages("nlmixr2rpt", dependencies = TRUE)

To install the development version from GitHub

devtools::install_github("nlmixr2/nlmixr2rpt", dependencies=TRUE)

Getting Started


Assuming you have the results of an nlmixr analysis in the object fit you can dump those results into a PowerPoint document by doing the following:

obnd_pptx = read_template(
  template = system.file(package="nlmixr2rpt", "templates","nlmixr_obnd_template.pptx"),
  mapping  = system.file(package="nlmixr2rpt", "templates","nlmixr_obnd_template.yaml"))

obnd_pptx = report_fit(
  fit     = fit, 
  obnd    = obnd_pptx)

save_report(obnd_pptx, "report.pptx")

This creates an onbrand reporting object obnd_pptx. You can add other reporting elements using onbrand or officer. Next the command report_fit() will append the results in the fit object to an onbrand report. After calling report_fit() you can append other reporting elements. Finally you just need to save the document using save_report().


The process for a Word document is the same. You simply need to use a Word onbrand template instead of a PowerPoint.

obnd_docx = read_template(
  template = system.file(package="nlmixr2rpt", "templates","nlmixr_obnd_template.docx"),
  mapping  = system.file(package="nlmixr2rpt", "templates","nlmixr_obnd_template.yaml"))

obnd_docx = report_fit(
  fit     = fit, 
  obnd    = obnd_docx)

save_report(obnd_docx, "report.docx")

Further reading

If you want to learn more about customizing the outputs or using your own organizational templates in reporting, be sure to browse through the documentation and check out the vignettes: