Vpop calibration
Description
A set of Python tools to allow for virtual population calibration, using a non-linear mixed effects (NLME) model approach, combined with surrogate models in order to speed up the simulation of QSP models.
The approach was mainly inspired from 1.
Here is an overview of the proposed workflow:
Currently available features
- Surrogate modeling using gaussian processes, implemented using GPyTorch
- Synthetic data generation using ODE models. The current implementation uses scipy.integrate.solve_ivp, parallelized with multiprocessing
- Non-linear mixed effect models, see the dedicated doc:
- Log-distributed parameters
- Additive or multiplicative error model
- Covariates handling
- Known individual patient descriptors (i.e. covariates with no effect on other descriptors outside of the structural model)
- SAEM: see the dedicated doc
- Optimization of random and fixed effects using repeated longitudinal data
- Individual parameter estimation
- Conditional distribution sampling: the posterior conditional distribution may directly be sampled using Metropolis-Hastings algorithm
- Empirical Bayesian Estimators (EBEs) or Maximum A Posteriori (MAP) estimates: these values represent the mode of the conditional distribution for each parameter and each patient. The current implementation is sub-optimal for
torchsurrogate models as it does not leverage the gradient predictions.
- Diagnostics:
- Post-inference diagnostics are available, and different type sof weighted residuals may be plotted (IWRES, PWRES, NPDE)
Getting started
- Tutorial: this notebook demonstrates step-by-step how to create and train a surrogate model, using a reference ODE model and a GP surrogate model. It then showcases how to optimize the surrogate model on synthetic data using SAEM
In-depth examples
- Surrogate model training
- Running SAEM without surrogate model
- Running SAEM on a reference ODE model. Note: the current implementation is notably under-optimized for running SAEM directly on an ODE structural model. This is implemented for testing purposes mostly
- Benchmarking examples
Support
For any issue or comments, please reach out to eliott.tixier@novainsilico.ai, or feel free to open an issue in the repo directly.
Authors
- Paul Lemarre
- Eléonore Dravet
- Hugo Alves
Active maintainers
- Eliott Tixier
- Guillaume Bouchard
- Louis Philippe
- Hugo Alves
- Nicolas Ratto
- Théo Plissonneau
QSPC26 poster
This work was presented at QSPC2026 in Leiden, and all the corresponding material is introduced in this document. The benchmark notebooks for standard data sets are available directly for orange trees and theophylline.
The poster itself is available in this document. The full list of references is available in this document.
Roadmap
Here are a few planned features, in an unordered and non-exhaustive list:
- NLME:
- Support additional error models (additive-multiplicative, power, etc...)
- Support additional covariate models (categorical covariates)
- Compute likelihood via importance sampling following population parameters optimization
- Structural models:
- Integrate with SBML models (e.g. Roadrunner)
- Surrogate models:
- Support additional surrogate models in PyTorch
- Optimizer:
- Add preconditioned Stochastic-Gradient-Descent (SGD) method for surrogate model optimization
References
-
Grenier et al. 2018: Grenier, E., Helbert, C., Louvet, V. et al. Population parametrization of costly black box models using iterations between SAEM algorithm and kriging. Comp. Appl. Math. 37, 161–173 (2018). https://doi.org/10.1007/s40314-016-0337-5 ↩
3 maintainers
Metadata
3 maintainers
Release files for vpop-calibration 4.7.4
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| vpop_calibration-4.7.4.tar.gz | 411.5 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| vpop_calibration-4.7.4-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 872.3 kB
Release files / vpop_calibration-4.7.4.tar.gz
| Download URL | vpop_calibration-4.7.4.tar.gz |
|---|---|
| Size | 411.5 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
4740fb4d6ac400c2678675eb59e6bc4f504d4c48a36d0eefa671c3e9753b2f93
|
|
BLAKE2b-256 checksum How to use checksums |
e93144f780f8169a26a5c15fbde2bdee7a8b70d4e55a8cb8f1005507e892920f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
poetry/2.4.1 CPython/3.13.13 Linux/6.18.33
|
Release files / vpop_calibration-4.7.4-py3-none-any.whl
| Download URL | vpop_calibration-4.7.4-py3-none-any.whl |
|---|---|
| Size | 460.8 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
641e7decfc1dded77f9e2dbde907eb557d610ae4eb5b8138ceb034eb13a110c5
|
|
BLAKE2b-256 checksum How to use checksums |
75d444358e93ad2186e6caaaded023050d84fc5aecf3d4dfdb867a4bc071d388
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
poetry/2.4.1 CPython/3.13.13 Linux/6.18.33
|
