runModelBuilding | Run the model building task. |
getModelBuildingSettings | Get the settings that will be used during the run of model building. |
getModelBuildingResults | Get the results (detailed models) of the model building. |
Run model building task
Description
Run model building. Call isRunning
to check if the building is still running and get information about the current task, call stopModelBuilding
to stop the execution.
Usage
runModelBuilding(wait = TRUE, ...)
Arguments
wait
(bool) Should R wait for run completion before giving back the hand to the user. Equals TRUE by default.
...
(list<settings>) Settings to initialize the model building algorithm. See getModelBuildingSettings
.
Details
To change the initialization before a run, use getModelBuildingSettings
to receive all the settings. See example.
To launch the function in the background, so that functions which do not modify the project (“get” functions for example) remains available, set the input argument “wait” to FALSE.
See Also
getModelBuildingSettings getModelBuildingResults stopModelBuilding
Click here to see examples
## Not run:
runModelBuilding() # sequential run
set = getModelBuildingSettings()
runModelBuilding(settings = set) # sequential run
runModelBuilding(wait = TRUE) # background run
## End(Not run)
Top of the page, Monolix-R functions
Get model building settings
Description
Get the settings that will be used during the run of model building.
Usage
getModelBuildingSettings()
Value
The list of settings:
- covariates: (vector<string>) covariate names
- parameters: (vector<string>) parameters names
- strategy: (string) strategy to search best model ([cossac], samba, scm)
- criterion: (string) crtierion to search best model ([BIC], LRT)
- relationships: (data.frame<parameters, covariates, locked>) Use to lock relationships between parameters and covariates. By default, all the combinations are possible. This parameter forces the use or not of some combinations. See example where ka must have SEX and V must not have WEIGHT
- threshold$lrt: threshold used by criterion LRT to continue or not to improve the model (first element is for forward and the second one is for the backward method)
- threshold$correlation: threshold used by cossac to choose what combinations (parameter- covariate) must be tried as next candidate model (first element is for forward and the second one is for the backward method)
- useLin: (boolean) computes linearization ([TRUE]) or the Importance Sampling (FALSE)
- useSAMBABeforeCossac: (boolean) gives the possibility to launch one SAMBA iteration before the COSSAC strategy (TRUE, [FALSE])
See Also
Click here to see examples
set = getModelBuildingSettings()
set$relationships[1,] = c(“ka”, “SEX”, TRUE)
set$relationships[2,] = c(“V”, “WEIGHT”, FALSE)
-> set$relationships
parameters covariates locked
1 ka SEX TRUE
2 V WEIGHT FALSE
runModelBuilding(settings = set)
## End(Not run)
Top of the page, Monolix-R functions
Get the results of the model building
Description
Get the results (detailed models) of the model building
Usage
getModelBuildingResults()
Value
The results of model building. All the detailed tried models are returned:
- LL: result of -2*Log-Likelihood
- BICc: modified BIC.
- individualModels: (data.frame) individual model for each individual parameter. The columns are the covariates and the elements of the data.frame notes if a covariate is used or not for the current parameter.
COSSAC send 2 additional fields:
- tested: (vector<string>) first element is the individual parameter and the second one is the covariate. This combination notes if the covariate is tested or not with respect to the previous model.
- bestModel (boolean) best model amongst all the tried models according to the chosen criterion.
SAMBA send the error model and covariance model information if there are exist
- errorModels: chosen type for each error model
- covarianceModels: chosen correlations between individual parameters
See Also
Click here to see examples
getModelBuildingResults()
##End(Not run)
Top of the page, Monolix-R functions.