Check parameters initialization

PKanalix uses Nelder – Mead optimization algorithm to fit a selected model to individual or pooled data. “Good” parameters initialization represents characteristic features of a selected model. Selection of initial values is important to avoid local minima during the optimization process and increases the runtime of the algorithm. The goal of the CHECK INIT. sub tab is to:

  • Visually check parameters initialization. It displays the model predictions obtained with the initial model parameters values and the individual designs (doses and regressors) for each individual together with the data points.
  • Help finding “good” initial values: manually or with the auto-init function.

CHECK INIT. tab in PKanalix uses the same auto-init algorithm and has the features as CHECK INIT. in Monolix.

  • You can modify the initial values of the parameters, shown on the bottom of the screen, manually by typing new values or using the auto-init algorithm – click the button RUN in the right panel.
  • Switch toggle buttons in the X-axis and Y-axis sections to set the log-scale and to apply the same limits for all individual plots. It gives a better comparison between the individuals.
  • If there are not enough points for the prediction (e.g. there are a lot of doses ), change the grid size by increasing the number of points (last section in the right panel).

IMPORTANT: Click on the “SET AS INITIAL VALUES” button on the top of the plot to save the initial values for the optimization step.

If there are several observation types which obs-ids have been mapped to model outputs (for example a parent and a metabolite, or a PK and a PD observation), then switch the plots between them in the “Output” section on the top-right corner, see figure below.

Reference in the “check initial estimates”

The following video describes how to use the Reference option and when it can be helpful. It uses an example in Monolix, but this feature works in the same way in PKanalix.


Adding a reference helps to see better how changing parameter values impacts the prediction. To add a reference click on the icon next to “Set as initial values” button. It saves the current fit ( i.e. current parameters values) as a reference and adds it to the list on top of the right panel, see below. The solid red curve corresponds to the current set of parameters (displayed at the bottom), while the dashed one corresponds to the reference. At any time, you can restore the reference as the current fit (green arrow next to the reference curve name), delete the reference (red cross) or delete all references by clicking on the trash icon above the list.


Automatic initialization of the parameters

PKanalix has an automatic algorithm for the initialization. It is in the right panel in the Auto-init section and you can lunch it by clicking on the button RUN. The following video describes how it works using an example in Monolix.[

After clicking on the button RUN, PKanalix computes initial model parameters that best fit the data points, starting from parameter values currently used in the panel at the bottom. By default, the algorithm uses all individual data from all observations mapped to a model output. You can change the set of individuals in the “Ids” selection panel just below the RUN button.

The algorithm is a custom optimization method, on the pooled data. The purpose is not to find a perfect match but rather to have all the parameters in the good range for starting the Nelder – Mead optimization.

  • While auto-init is running, the pop-up shows the evolution of the cost of the optimization algorithm over the iterations. Stop the algorithm at any time, e.g. if you the cost has decreased sufficiently and you want to check the parameter values.
  • Note that the more individuals you select, the longer the run will take.
  • Selecting one or few individual that show clearly model characteristics (eg a third compartment, a complex absorption) can help the auto-init algorithm to find set of parameters that is sensitive to specific model features.

After running the auto-init, PKanalix interface updates automatically parameter values and plots with new predictions. To use these parameters as initial values in the optimization process, you click on the button “SET AS INITIAL VALUES”.

Note that the auto-init procedure takes into account the current initial values. Sometimes the auto-init might give poor results. To improve it change manually the parameter values before running the auto-init again.