R-package installation and initialization

In this page, we present the installation procedure of the R-package that allows to run Monolix from R.

Prerequisites

R version 3.0.0 or higher is required to install lixoftConnectors.

The lixoftConnectors package depends on the RJSONIO, gridExtra and ggplot2 packages that need to be installed from CRAN first using:

install.packages('RJSONIO')
install.packages('ggplot2')
install.packages('gridExtra')

Installation

The R package lixoftConnectors is located in the installation directory as tar.gz ball. It can be installed directly using Rstudio (Tools > Install packages > from package archive file) or with the following R command:

install.packages(packagePath, repos = NULL, type="source", INSTALL_opts ="--no-multiarch")

with the packagePath = ‘<installDirectory>/connectors/lixoftConnectors.tar.gz’ where <installDirectory> is the MonolixSuite installation directory.

With the default installation directory, the command is:

# for Windows OS
install.packages("C:/ProgramData/Lixoft/MonolixSuite2023R1/connectors/lixoftConnectors.tar.gz", 
                 repos = NULL, type="source", INSTALL_opts ="--no-multiarch")

# for Mac OS
install.packages("/Applications/MonolixSuite2023R1.app/Contents/Resources/\
                  monolixSuite/connectors/lixoftConnectors.tar.gz",
                  repos = NULL, type="source", INSTALL_opts ="--no-multiarch")

Notice that for MonolixSuite2018 version, the R package is called MlxConnectors .

Initializing

When starting a new R session, you need to load the library and initialize the connectors with the following commands

library(lixoftConnectors)
initializeLixoftConnectors(software = "monolix")

In some cases, it may be necessary to specify the path to the installation directory of the Lixoft suite. If no path is given, the one written in the <user home>/lixoft/lixoft.ini file is used (usually “C:/ProgramData/Lixoft/MonolixSuiteXXXX” for Windows). where XXXX corresponds to the version of MonolixSuite

library(lixoftConnectors) 
initializeLixoftConnectors(software = "monolix", path = "/path/to/MonolixSuite/")

When you initialize the connectors with one software (e.g. “monolix”) and then initialize it again with another one (e.g. “simulx”), there is a security check asking you to agree with the switch. To overpass this check and avoid having to answer “yes” manually, you can specify the option “force = TRUE”:

library(lixoftConnectors) 
initializeLixoftConnectors(software = "monolix", force = TRUE)

Making sure the installation is ok

To test if the installation is ok, you can load and run a project from the demos as on the following:

demoPath <- getDemoPath()
loadProject(file.path(demoPath, "1.creating_and_using_models", "1.1.libraries_of_models", "theophylline_project.mlxtran"))
runScenario()
getEstimatedPopulationParameters()

These three commands should output the estimated population parameters (ka_pop, V_pop, Cl_pop, omega_ka, omega_V, omega_Cl, a, and b).