Select Page

R-package installation and initialization

In this page, we present the installation procedure of the R-package that allow to run MonolixSuite applications with R.

Installation

The R package lixoftConnectors is located in the installation directory as tar.gz ball. It can be installed directly using Rstudio or by the following R command:

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

with the packagePath = ‘<installDirectory>/mlxConnectors/R/lixoftConnectors.tar.gz’ where <installDirectory> the MonolixSuite installation directory. By default, it is

  • “C:/ProgramData/Lixoft/MonolixSuite2019R1” for Windows OS
  • “/Applications/MonolixSuite2019R1.app/Contents/Resources/mlxsuite/” for MAC OS

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 lixoft.ini file is used (usually “C:/ProgramData/Lixoft/MonolixSuiteXXXX” for Windows). where XXXX corresponds to the version of MonolixSuite

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

 

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 = '<userFolder>/lixoft/monolix/monolix2018R1/demos/1.creating_and_using_models/'
loadProject(paste0(demoPath ,'1.1.libraries_of_models/theophylline_project.mlxtran'))
runScenario()
getEstimatedPopulationParameters()

where <userFolder> is the user’s home folder (on windows C:/Users/toto if toto is your username). These three commands should output the estimated population parameters (ka_pop, V_pop, Cl_pop, omega_ka, omega_V, omega_Cl, a, and b).