The following options are available under the General Settings node. You can override any parameters set under this node for individual tables or graphs found under the applicable node, such as PK Automation or PK Comparison. For example, the administrator can select to allow access to specific parameters for specific types of studies. For a specific example, see the “Selecting content for generated output” section.
PK parameters
On the Available to User tab, the administrator determines which PK parameters are available for inclusion in generated output on a model-specific basis. If a parameter checkbox is cleared on this page, then it is also unavailable for individual selection under the PK Automation node, when selecting details on tabular and graphical output.
On the User Default Selection tab, the administrator determines whether a PK parameter is included in all generated output by default. Others can then choose to not include a given parameter on a per-run basis.
Variable data
An administrator can configure variables and their associated descriptive statistics and precision.
Variables tab
Using the Variables tabs, an administrator can determine which demographic and data collection points (DCP) are available and which are selected by default in the AP Automation object. An administrator can define discrete demographics which are used in stratifications, continuous demographics, which are used in normalizations, or sample collection points.
With the Category set to Discrete Demographics or Continuous Demographics, press Edit Master List to add or remove custom demographic variables.
In the dialog, press Add to add custom System and Client Name variables.
Press Delete to remove a demographic variable, and press Close and Save to add the new demographic variable.
Statistics tab
Using the Statistics tabs, an administrator can determine which statistical variables along with their order of display in worksheet output are available and which are included by default. Statistical variables are available for all study variables and PK parameters.
Precision tab
Using the Precision tab, an administrator can set the precision type, decimal or significant digits, and the corresponding value for each variable and statistic combination.
An administrator can use column mapping to apply an organization’s settings regarding input or study data and output nomenclature for PK parameters by using the Study Variables tab, PK Parameters tab, Concentration Variable Template Selection tab, and Time Variables tab.
In the Study Variables tab, an administrator can change the default names in AutoPilot Toolkit, which are called System names, to match what is used in the study data, or the Client name. The Plasma and Urine Display Names show how the variables are displayed in the AP Automation output. The Display names are independent of both System names and Client names and can be changed at any time. To support stacked datasets a new column called Analyte is included in the Study Variables tab.
Note: The Plasma and Urine Display Names for Treatment_Description cannot be changed because they are not used in the output. The Display Names for Treatment_Display are used instead.
Treatment_Description and Treatment_Display
AutoPilot Toolkit's default behavior requires the use of a Treatment_Description column in datasets as a sort variable for crossover studies. Treatment_Description in AutoPilot Toolkit can be mapped to whatever column in a dataset that contains treatment information.
Some datasets use a treatment information column that solely contains alphanumeric values (1, 2, A, or B, for example) that are used as sort variables in a model, and a treatment display column that is used to display meaningful treatment information in table and graph output.
AutoPilot Toolkit provides a study variable, Treatment_Display, that allows for meaningful treatment descriptions in table and graph output instead of simply 1, 2, A, or B.
The treatment display order is displayed in the Treatments tab in the AP Automation object’s Ordering tab. The Treatment Description values are matched to the corresponding Treatment Display values. There must be a one to one correspondence between the Treatment_Description and Treatment_Display values.
Default treatment order:
Custom treatment order:
To use a custom treatment display, an administrator must first change the treatment sort variable from its default setting to a custom setting. For example, if a dataset contains Treatment and Treatment_Description columns, to set Treatment as the NCA model’s sort variable and include Treatment_Description in the output, an administrator must make the following changes:
1. Open the Admin Module.
2. In the Admin Module menu, select Config > General > Column Mapping.
3. Select the Treatment_Description Client Name field.
4. Change the Client Name to Treatment.
The System Name Treatment_Display is mapped to Treatment_Description by default.
5. If needed, change the default mapping by selecting the Treatment_Display Client Name field. Change the Client Name to the treatment description variable in the input dataset.
Note: Treatment_Display can be mapped to any column in a dataset.
6. Click to save the custom System Config file.
7. To make this configuration the default one, select the Make Default Configuration checkbox in the Save Changes? dialog.
8. Press Yes to save the system configuration file.
To load a custom configuration file in the Admin Module
1. Open the Admin Module.
2. Click to select a custom configuration file.
Only a custom configuration file can be loaded before mapping an input dataset to the AP Automation object.
3. Select Use Custom Configuration in the General tab.
4. Click the […] button to browse to the custom system configuration file.
5. Select the file in the Select System Configuration dialog and press Open.
6. Press Set as Default to set the custom configuration as the default configuration.
Default study variables:
Custom study variables:
Note: If Treatment_Display is not in the dataset, AutoPilot Toolkit displays a warning and defaults to the Client Name that Treatment_Description is mapped to. Either fix the problem or proceed with the project.
If the Treatment and Treatment_Display columns do not match with unique values, AutoPilot Toolkit gives an error message and does not allow proceeding with the project until the problem is fixed.
While LOQ numbers can be set on a run-by-run basis, AutoPilot Toolkit can also be configured to read LOQ values from a data column by mapping the LOQ system name to the correct column.
For wide data, a cell in the LOQ column can be empty or contain a value. However, the LOQ value must be the same for all concentration variables that use the column. For example, wide data can contain an LOQ column with empty cells and cells with a value of 0.05.
For data stacked by analyte, a different LOQ value can be set for each analyte. The value for LOQ must be the same across a single analyte. For example, the following table depicts data stacked by analyte for three analytes.
In this case, the Alpha analyte will have no LOQ, the Beta analyte will have an LOQ of 0.05, and the Gamma analyte will have no LOQ: if different LOQ values are entered for the same analyte, they are all ignored.
To use LOQ values from the data columns, select the Output Options tab in the AP Automation object.
For more information see the “Display tabs” section.
In the PK Parameters tab, an administrator can set the display name, which is used in the final generated output, and the file name, which determines the root name of the graph output file for a specific parameter (AUClast.jpg, for example). The display name can have superscripts, subscripts, and some symbols.
To set the file name
1. Select a parameter in the File Name column.
2. Change the file name.
To set the display name
1. Select a PK Parameter.
The parameter is displayed in the Display Name area.
2. Modify the parameter display name by clicking the Superscript or Subscript button.
3. Add a symbol to the parameter display name by selecting one in the Symbols menu.
Concentration Variable Template Selection tab
On the Concentration Variable Template Selection tab, administrators can set the mapping for the Concentration Variable column by using the pointer to drag the matrix [M], analyte [A], route [R], and asterisk [*] symbols from the Palette to the Template, or by typing a base name in the Base Name field.
Note: To support a greater variety of concentration columns, the concentration variable template now contains an asterisk [*] as a wildcard field.
As shown below, no route is selected and the base name is Conc, so the column name is defined by the template [Matrix]_[Analyte]_*Conc*.
Concentration variable template using an asterisk
Some concentration column names in datasets that must be supported by AutoPilot Toolkit have components set off by underscores that are neither analytes, matrices, routes, or base names. For example, Concentration_1, Concentration_2, and Concentration_3. or the name of the compound being tested. To handle a greater variety of concentration columns, the concentration variable template recognizes a wildcard field with an asterisk [*].
For example, if the concentration column name is PLS_XYZ_PKConc, use the following steps to change the concentration variable template:
1. Use the pointer to drag [A] (analyte) from the Template to the Palette.
2. Use the pointer to drag [*] (asterisk) from the Palette to the Template to allow AutoPilot Toolkit to bypass the XYZ part of the name.
The column name PLS_XYZ_PKConc is defined by the template [Matrix]_[*]_*Conc*.
Concentration variable template selection for stacked data
To use stacked data, use the pointer to drag [A] (analyte) to the Pallet. The column name is defined by the template [Matrix]_ *Conc*.
The AutoPilot Toolkit project AutoPilot Comparison Demo - Stacked Data.phxproj is located in …\Examples\AutoPilot. This project file can be used to run a comparison project using stacked data. Compare the output from a stacked data comparison project with the output from a wide data comparison project.
Missing analyte columns
An analyte must be present in a data column in order for AutoPilot Toolkit to recognize a stacked dataset. If an analyte column is not present, the data is analyzed as if it was wide data.
The Time Variables tab is used to set the default time variables and to map the Relative and Nominal start and end times to the correct column names in the dataset. Select the time variable to map, and enter the input data variable name in the Identifying Text field.
In the screen shot below, Time is entered as the identifying text for Relative Nominal End Time. This means that AutoPilot Toolkit will select all columns with Time in the name.
When an AP Automation object is created, select which column to use. See the “Display tabs” section.
Legal Notice | Contact Certara
© Certara USA, Inc. All rights reserved.