pkpdsim: building blocks of PBPK/PD models
pkpdsim is a python package with the building blocks shared by physiologically based pharmacokinetic and pharmacodynamic (PBPK/PD) models in SBML. The models of pkdb_models are written in python with the factory of sbmlutils and simulated with sbmlsim; what they share lives in pkpdsim, so that the folder of a model imports nothing but itself and released packages.
Features include
- templates and annotations - the creators and the terms of use of a model, the annotations of the compartments which recur in the models (liver, kidneys, gut, blood, urine, ...)
- study data - the study folders of PK-DB in a checkout of pkdb_data, found through the environment variable
PKDB_DATA, and the data of a model collected from them into its own folder - initial values - the same initial concentration or amount of a substance in every tissue of a model, which removes the distribution kinetics
- licenses - the texts of CC BY-SA 4.0 and MIT for the COMBINE archive of a model, written byte for byte the same on every platform
- models and their commands - the model object and the commands of a model (
run,fit,report,identifiability), the tests of a model as functions and the verification of a change, also across versions of sbmlsim (pkpdsim-verify) - experiments and their metadata - the base class of the simulation experiments of a model (the SIds of its keys, the units of its data), the presets of the impaired organ function, the shared vocabulary of the metadata of a fit mapping and the filters which select the mappings of a fit by it
- scans and sensitivity analyses - the timecourse of a point of a scan as sbmlsim 0.8 gave it and the table of the parameters, the distributions and the runner of the sensitivity analyses of a script
- release of a model repository -
pkpd_releasemakes the complete release of the repository of a model (models, simulations, fit reports, release notes, docs, Docker image, GitHub release) from its package, with--no-publishfor a review before the commit
The documentation is available at https://matthiaskoenig.github.io/pkpdsim.
If you have any questions or issues please open an issue.
Quickstart
from pathlib import Path
from pkpdsim.annotations import compartments
from pkpdsim.licenses import License, write_license
from pkpdsim.templates import creators
print(creators[0].givenName, creators[0].familyName)
print([resource for _, resource in compartments["li"]])
results = Path("results")
results.mkdir()
print(write_license(results, License.MIT, copyright="2026 Matthias König").name)
Matthias König
['fma/FMA:7197', 'bto/BTO:0000759', 'ncit/C12392']
mit.txt
The user guide of the documentation describes every module with a snippet which runs.
How to cite
If you use pkpdsim please cite the archived software on Zenodo:
König, M. (2026). pkpdsim: building blocks of physiologically based pharmacokinetic and pharmacodynamic models in SBML (Version 0.9.7) [Computer software]. Zenodo. https://doi.org/10.5281/zenodo.23558968
@software{konig_pkpdsim,
author = {König, Matthias},
title = {pkpdsim: building blocks of physiologically based pharmacokinetic and pharmacodynamic models in SBML},
year = {2026},
month = oct,
version = {0.9.7},
publisher = {Zenodo},
doi = {10.5281/zenodo.23558968},
url = {https://doi.org/10.5281/zenodo.23558968},
}
Installation
pkpdsim requires python >= 3.14, simulates with sbmlsim 0.13 (sbmlsim>=0.13.0,<0.14, installed with it) and is available from pypi:
uv add pkpdsim
or with pip
pip install pkpdsim
See Installation for details and Development for working on the repository.
License
- Source Code: MIT
- Documentation: CC BY-SA 4.0
Funding
Matthias König is supported by the German Research Foundation (DFG) within the Research Unit Programme FOR 5151 "QuaLiPerF (Quantifying Liver Perfusion-Function Relationship in Complex Resection - A Systems Medicine Approach)" by grant number 436883643 and by grant number 465194077 (Priority Programme SPP 2311, Subproject SimLivA).
Matthias König was supported by the Federal Ministry of Education and Research (BMBF, Germany) within the research network Systems Medicine of the Liver (LiSyM, grant number 031L0054).
© 2026 Matthias König.
1 maintainer
Metadata
1 maintainer
Release files for pkpdsim 0.12.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| pkpdsim-0.12.0.tar.gz | 491.1 kB | With provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| pkpdsim-0.12.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 671.6 kB
Release files / pkpdsim-0.12.0.tar.gz
| Download URL | pkpdsim-0.12.0.tar.gz |
|---|---|
| Size | 491.1 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
9e541ed00beab863107fef015e7100e8d8a3fc7d27de6215685bb5629c77d43f
|
|
BLAKE2b-256 checksum How to use checksums |
b9adb1887ed9abcaeb05d27d14a7269f83c730c5f5dd6767963e56dad44e55d5
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 24, 2026.
Transparency logRelease files / pkpdsim-0.12.0-py3-none-any.whl
| Download URL | pkpdsim-0.12.0-py3-none-any.whl |
|---|---|
| Size | 180.5 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
4c9b0c4365322488a00c1375e5fe2379617de9062e33a5505620187e40fa3058
|
|
BLAKE2b-256 checksum How to use checksums |
dcfcfd4706393f9b110300e3acf25fea4c3092c4f29bc37248757dbcad668963
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 24, 2026.
Transparency logSecurity for pkpdsim 0.12.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
Full provenance
All 2 files in this release have been uploaded with provenance metadata.
Attestation for pkpdsim-0.12.0.tar.gz
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 24, 2026.
Transparency logA note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.
