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

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, whose DOI is added here with the first release.

Installation

pkpdsim requires python >= 3.13 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.