Covariate modeling with the PK01 dataset

The data used in the PK01 dataset is from a simulated trial. The purpose of this example is to show how to add covariate effects to a model to determine which covariates have an effect on the model’s results.

Note:The completed project (PK01Co3.phxproj) is available for reference in …\Examples\NLME.

Set up the Maximum Likelihood Models object

  1. Create a new project called PK01Co3.

  2. Import the dataset …\Examples\NLME\Supporting files\pk01cov3.dat.
    Click Finish in the File Import Wizard dialog.

  3. Right-click the worksheet and select Send To > Modeling > Maximum Likelihood Models.

  4. Rename the object Base Model.

  5. Select the option buttons in the Main Mappings panel to map the data types to the following con­texts:
    id to the ID context.
    time to the Time context.
    conc to the CObs context.
    dose to the A1 context.
    Leave all other data types mapped to None.

  6. In the Structure tab, make sure Clearance is selected in the Parameterization menu.

  7. In the C (Continuous Observation) error model menu, select Multiplicative.

  8. Select the Parameters > Fixed Effects sub-tab.

  9. In the Initial column, type the following initial estimates for each of the study parameters:
    tvV   10
    tvCl   0.1

Add covariates

  1. Select the Structural sub-tab.

  2. pk01Co3Structuraltab.png 

  3. Click Add From Unused.

  4. Select the checkboxes beside sex, wt, and age.

  5. Click Add.
    The covariate data types are automatically mapped to the correct contexts.

  6. Covariatemappings.png 

  7. Select the Covar. Type sub-tab.
    Sex is automatically selected in the Select covariate menu.

  8. In the Type menu, select Type: Categorical.

  9. Check the Allow arbitrary category names checkbox.

  10. In the first field underneath Category Name, type male.

  11. Leave 0 as the value for male.

  12. In the second field underneath Category Name, type female.

  13. Type 1 in the value field for female.

  14. CovarTypetabexample.png 

  15. Click icon_execute_22.png (Execute icon) to execute the object.

Add covariate effects for weight and age

In this model the covariate effects for weight and age are added to the study parameters.

  1. Right-click Base Model and select Copy.

  2. Right-click the Workflow object and select Paste.
    The model object and its settings are pasted into the PK01Co3 model project and named Copy of Base Model.

  3. Rename Copy of Base Model to Covariate Model.

  4. In the Main Mappings panel, check that the data types are mapped as follows:
    id to the ID context.
    time to the Time context.
    conc to the CObs context.
    dose to the A1 context.
    sex, wt, and age to sex, wt, and age, respectively.

  5. Select the Parameters > Structural sub-tab.

  6. In the V column, click No beside wt to select a covariate effect.

  7. In the Cl column, click No beside wt to select a covariate effect.
    The study variable weight is added as a covariate effect to both V and Cl.

  8. In the Center field for wt type 75.

  9. In the Cl column, click No beside age to select a covariate effect.
    The study variable age is added as a covariate effect to Cl.

  10. In the Center field for age type 40.

  11. Covariatestabwtandage.png 

  12. Select the Fixed Effects sub-tab.

  13. Click Accept All Fixed+Random to copy the new estimates to the Initial estimates field for each parameter.

  14. In the Initial column, leave the initial values for dVdwt, dCldwt, and dCldage set to 0 (zero).

  15. Execute the object.

Add sex as a covariate effect

In this model the covariate effect for sex is added to the study parameter volume.

  1. Right-click Covariate Model and select Copy.

  2. Right-click the Workflow object and select Paste.

  3. Rename the copied object as Covariate Model_sexcov.

  4. In the Main Mappings panel, check that the data types are mapped as follows:
    id to the ID context.
    time to the Time context.
    conc to the CObs context.
    dose to the A1 context.
    sex, wt, and age to sex, wt, and age, respectively.

  5. Select the Parameters > Structural sub-tab.

  6. In the V column, click No beside the sex parameter.
    The study variable sex is added as a covariate effect to V.

  7. Select the Fixed Effects sub-tab.

  8. Click Accept All Fixed+Random to copy the new estimates to the Initial estimates field for each parameter.

  9. In the Initial column, type 1 for the initial estimate for the parameter dVdsex1.

  10. Execute the object.

  11. In the Results tab, select the Core Output text file.

Note that adding sex as a covariate has no effect on the fixed effects values, so the covariate can be removed from the model.

The concludes the covariate modeling example using the PK01 dataset.


Last modified date:7/9/20
Certara USA, Inc.
Legal Notice | Contact Certara
© 2020 Certara USA, Inc. All rights reserved.