Last modified date:7/9/20
Legal Notice | Contact Certara
© 2020 Certara USA, Inc. All rights reserved.
The NONMEM Comparer object allows users to compare the output of NONMEM models.
Use one of the following to add the object to a Workflow:
Right-click menu for a Workflow object: New > External Software > NONMEM Comparer.
Or Main menu: Insert > External Software > NONMEM Comparer.
Or right-click menu for a worksheet: Send To > External Software > NONMEM Comparer.
Note:To view the object in its own window, select it in the Object Browser and double-click it or press ENTER. All instructions for setting up and execution are the same whether the object is viewed in its own window or in Phoenix view.
This section contains information on the following:
User interface description
Results
Note:Although there are no icons in the Setup tab for importing/saving/loading object settings, these operations are still available using the File > Import menu, and right-clicking the object in the Object Browser or in the workflow diagram.
Models in the Setup tab are listed using the object name as seen in the object browser. If a NONMEM model was created by making a copy of a previous NONMEM model, then the copy is nested underneath the first model in the Comparison. The original model is the root model, and the copied model is the child.
Model copies that are nested underneath the original model will typically have additional parameters that are compared against the original model, which has fewer parameters.
To change the hierarchical relationship between root and sub-models
Use the pointer to select a model in the Setup tab and drag the model on top of another model.
Click Yes in the Move confirmation dialog.
The selected model is nested underneath the selected root model.
To move a child model back to the root level, right-click the child model and select Orphan Model.
Click Yes in the Move confirmation dialog.
The model is moved back to the root level in the Setup tab.
To exclude/include a model in the comparison
In the Comparison tab, users can select or clear the Hide or Compare checkboxes to exclude or include a model in the comparison.
If the Hide checkbox is checked, then the model is considered “hidden” and is removed from any comparisons.
If the Compare checkbox is checked, then the selected model is included in comparisons.
The Options tab can be used to add or remove columns, worksheets, and plots used for comparisons.
In the Columns list, clear checkbox to remove that column from the comparison. Removed columns are not included in the output worksheets.
In the Worksheets and Plots lists, clear the checkbox to exclude that worksheet or plot from the results.
In the Plot Options area, select the height, width, and graphic format for the output plot.
If a NONMEM model is marked as hidden, then check the Hide Selected checkbox to remove the model from the Setup tab and the comparison. (The hidden model is not used in any comparisons.)
Check the Full Names checkbox to display the full name of a model. The full name includes the name of the workflow containing the model.
Use the buttons in the Selections area to select or hide several models at once. Multiple rows in the Comparison panel must be selected to use these buttons.
Select multiple rows in the Comparison panel to use the buttons in the Selections area.
Click Check Hide to hide the selected models.
Click Check Compare to include the selected models in the comparison.
Click Un-Check Hide to not hide the models.
Click Un-Check Compare to remove the models from the comparison.
Worksheets
Correlation Matrix of Estimate: Estimates of the correlation of model parameter estimates listed for all the models being compared.
Covariance Matrix of Estimate: Variance-covariance matrix for model parameter estimates listed for all the models being compared.
Omega: Estimates of the random effect variance-covariance matrix (Omega) and standard errors of omega elements listed for all the models being compared.
Overall: Stacks the table 'Summary' result for each individual run but doesn't present any comparison calculation. Columns include:
NAME: The name of the NONMEM object being compared
Tot. # Obs: total number of observations
Tot. # Individuals: Total number of individuals
Length of Theta: Total number of fixed effects variables
Min. Val Of. Obj. Func: Is the minimum value of the objective function for each NONMEM run
AIC: Akaike Information Criterion for each model run
BIC: Bayesian Information Criterion for each model run
Conditions of Estimation: is the $EST statement of each control file
Residuals: Stacked results from PHXTBL created for each individual NONMEM run with the addition of Model name. It contains columns for NAME (Model names being compared), ID, TIME, CWRES, DV, PRED, RES, and WRES.
Sigma: Estimates and standard errors of the observation error variance-covariance matrix (Sigma) for all models being compared.
Theta: Estimates and standard errors of the observation error variance-covariance matrix (Sigma) for all models being compared.
Summary: Estimates and standard errors of the fixed effect parameters (Theta) for all models being compared. Models are shown across the top. Columns include:
NAME: The name of the NONMEM object being compared
Method: The $EST statement of each control file
Lineage: List the 'parent' (i.e. reduced model) if the current model is a 'child' (derived from but with additional parameters) of another model
Min. Val Of. Obj. Func: The minimum value of the objective function for each NONMEM run
AIC: Akaike Information Criterion for each model run
BIC: Bayesian Information Criterion for each model run
–2(LL)Delta: Difference in Min. Val Of Obj. Func. for nested models only (Lineage-Child model)
AICDelta: Difference in AIC values. for nested models only (Lineage-Child model)
BICDelta: Difference in BIC values for nested models only (Lineage-Child model)
#params: Number of model parameters
#obs: Number of observations
#Subj: Number of subjects
p-value: Chi-Square p-value based on the Likelihood Ratio Test for nested models only
The Plot Table is generated and illustrates all the selected plots in rows for each model being compared (columns). This plot table is not editable and it places side by side the plots from the individual runs for easy visualization. Any changes done to the individual run plots will be reflected in this Plot table. This table can be exported or printed using the right-click menu options.
The Settings text file is generated and contains the list of current columns, plots, and models being compared.
Last modified date:7/9/20
Legal Notice | Contact Certara
© 2020 Certara USA, Inc. All rights reserved.