Population Life Course Exposure to Health Effects Modeling

Functions, data and user interfaces for performing Physiologically Based Pharmacokinetic('PBPK') Modeling, In-vitro to In-vivo Extrapolation ('IVIVE') and exposure estimation. Also contains user interfaces to run models from the 'httk' package. Taken together these provide an easy to use and powerful modeling tool that can be used for all steps along the source-to-outcome continuum.All the analysis tools in the package can only be run as shiny apps. Check vignettes and package help for more information. More information on PBPK modeling can be found in the book 'Physiologically Based Pharmacokinetic Modeling: Science and Applications' by Reddy et al .

Installing R.

Installing PLETHEM requires the latest version of 64 bit R-3.5 or higher(link), RStudio(link), and Rtools(link). While installing Rtools make sure the box that says "Add Rtools to System Path" is checked.

Installing the package

Open Rstudio once all of the above are installed. On the Rstudio console type the following command

This will install the package "devtools". This package is needed to install PLETHEM from the repos Then type one of the following commands


to install form Github or


to install from BitBucket.

Initial Setup

PLETHEM pulls data from three databases. The master database is installed with the package and cannot be modified by the user. The User database is a local copy that is a subset of the master database. This table is used to store user specific parameters that may be needed across different projects (Like a set of chemicals that are frequently used by the user but are not a part of the main database). The final database is project database. This is used by PLETHEM internally to keep track of all the data while the used is working on a specific project in PLETHEM. When the project is closed, the database is saved out as an .Rproj file that can be used to recreate the project on any other PLETHEM installation.

To complete the initial setup, the user needs to define the location where they want to store the user database. If they are updating a previous installation of PLETHEM or want to use the user database from another installation, they can just point to the database file instead. To either create a new database or to use an existing file run the following command and follow the prompts that come up

library(plethem) To use an exiting database, click on "Select user database" from the Addins menu or type setUserDb() To create a new database, click on "Create new user database" from the Addins menu or type createUserDb()

This only needs to be done once.

PBPK modeling in PLETHEM

Load PLETHEM and start a project.

To load plethem and start a new PBPK modeling project


newProject("Name of the project")

This will bring up a popup window where you can select where you want to save the project files. Once you have selected the directory here, plethem will launch the PBPK interface in your default browser. If the interfaces launches in a popup window instead, just click "Open in Browser" button on the window.

On exit, plethem will save all the data as a .Rdata file in the folder originally selected

Load existing Projects

To reload previously created projects just enter the following on the console.


This would popup an explorer window where you can select the .Rdata project file of any previously stored project. On exiting the interface, any changes made will overwrite this file.


Reference manual

It appears you don't have a PDF plugin for this browser. You can click here to download the reference manual.


0.1.7 by Salil Pendse, a year ago

Browse source code at https://github.com/cran/plethem

Authors: Salil Pendse [aut, cre] , ScitoVation , LLC [cph]

Documentation:   PDF Manual  

MIT + file LICENSE license

Imports shiny, ggplot2, shinyBS, shinyWidgets, miniUI, shinydashboard, rstudioapi, shinythemes, data.table, rhandsontable, deSolve, truncdist, reshape2, dplyr, readxl, gdata, devtools, RSQLite, formatR, plotly, magrittr, sqldf, utils, stats, DT, shinyjs, V8, httk

Suggests testthat, rmarkdown, knitr

See at CRAN