using PumasUtilities
using Random
using Pumas
using PumasUtilities
using CairoMakie
using AlgebraOfGraphics
using CSV
using DataFramesMeta
using Dates
PK19 - Two compartment with limited capacity metabolite model
1 Background
- Structural model - Two Compartment model with a Metabolite Compartment
- Route of administration - IV Bolus
- Dosage Regimen - 10 μmol/kg, 50 μmol/kg, 300 μmol/kg
- Number of Subjects - 3
2 Learning Outcome
This exercise demonstrates simulating 3 different doses of a given IV bolus for 3 different subjects.
3 Objectives
To build a two-compartment model, simulate the model for subjects given 3 different IV doses of a drug undergoing capacity limited metabolite kinetics, and subsequently perform simulation for a population.
4 Libraries
Load the necessary libraries.
5 Model definition
Note the expression of the model parameters with helpful comments. The model is expressed with differential equations. Residual variability is a proportional error model.
In this two compartment model, we administer 3 different doses in 3 different subjects of a drug that undergoes metabolite kinetics.
= @model begin
pk_19 @metadata begin
= "Non-linear formation of Metabolite Model"
desc = u"hr"
timeu end
@param begin
"""
Volume of Central Compartment (L/kg)
"""
∈ RealDomain(lower = 0)
tvvc """
Volume of Perpheral Compartment (L/kg)
"""
∈ RealDomain(lower = 0)
tvvp """
Inter-Compartmental Clearance (L/min)
"""
∈ RealDomain(lower = 0)
tvq """
Maximum Velocity of Reaction (μmol/min/kg)
"""
∈ RealDomain(lower = 0)
tvvmax """
Michaelis-Menten constant (μmol/L)
"""
∈ RealDomain(lower = 0)
tvkm """
Rate of Elimination of Metabolite (min⁻¹)
"""
∈ RealDomain(lower = 0)
tvkme """
Volume of Metabolite Compartment (L/kg)
"""
∈ RealDomain(lower = 0)
tvvme #Ω ∈ PDiagDomain(7)
∈ RealDomain(lower = 0.0001)
Ω_vc ∈ RealDomain(lower = 0.0001)
Ω_vp ∈ RealDomain(lower = 0.0001)
Ω_q ∈ RealDomain(lower = 0.0001)
Ω_vmax ∈ RealDomain(lower = 0.0001)
Ω_km ∈ RealDomain(lower = 0.0001)
Ω_kme ∈ RealDomain(lower = 0.0001)
Ω_vme """
Proportional RUV - Plasma
"""
∈ RealDomain(lower = 0)
σ_prop_cp """
Proportional RUV - Metabolite
"""
∈ RealDomain(lower = 0)
σ_prop_met end
@random begin
~ Normal(0, sqrt(Ω_vc))
η_vc ~ Normal(0, sqrt(Ω_vp))
η_vp ~ Normal(0, sqrt(Ω_q))
η_q ~ Normal(0, sqrt(Ω_vmax))
η_vmax ~ Normal(0, sqrt(Ω_km))
η_km ~ Normal(0, sqrt(Ω_kme))
η_kme ~ Normal(0, sqrt(Ω_vme))
η_vme end
@pre begin
= tvvc * exp(η_vc)
Vc = tvvp * exp(η_vp)
Vp = tvq * exp(η_q)
Q = tvvmax * exp(η_vmax)
Vmax = tvkm * exp(η_km)
Km = tvkme * exp(η_kme)
Kme = tvvme * exp(η_vme)
Vme end
@vars begin
:= Vmax / (Km + (Central / Vc))
VMKM end
@dynamics begin
' = -VMKM * (Central / Vc) - (Q / Vc) * Central + (Q / Vp) * Peripheral
Central' = (Q / Vc) * Central - (Q / Vp) * Peripheral
Peripheral' = VMKM * (Central / Vc) - Kme * Metabolite
Metaboliteend
@derived begin
= @. Central / Vc
cp """
Observed Plasma Concentration (μmol/L)
"""
~ @. Normal(cp, cp * σ_prop_cp)
dv_cp = @. Metabolite / Vme
met """
Observed Metabolite Concentration (μmol/L)
"""
~ @. Normal(met, met * σ_prop_met)
dv_met end
end
PumasModel
Parameters: tvvc, tvvp, tvq, tvvmax, tvkm, tvkme, tvvme, Ω_vc, Ω_vp, Ω_q, Ω_vmax, Ω_km, Ω_kme, Ω_vme, σ_prop_cp, σ_prop_met
Random effects: η_vc, η_vp, η_q, η_vmax, η_km, η_kme, η_vme
Covariates:
Dynamical system variables: Central, Peripheral, Metabolite
Dynamical system type: Nonlinear ODE
Derived: cp, dv_cp, met, dv_met
Observed: cp, dv_cp, met, dv_met
6 Initial Estimates of Model Parameters
The model parameters for simulation are the following. Note that tv
represents the typical value for parameters.
Vc
- Volume of Central Compartment (L/kg)Vp
- Volume of Peripheral Compartment (L/kg)Q
- Inter-Compartmental Clearance (L/min)Vmax
- Maximum Velocity of Reaction (μmol/min/kg)Km
- Michaelis-Menten constant (μmol/L)Kme
- Rate of Elimination of Metabolite (min⁻¹)Vme
- Volume of Metabolite Compartment (L/kg)Ω
- Between Subject Variabilityσ
- Residual error
= (
param = 1.06405,
tvvc = 2.00748,
tvvp = 0.128792,
tvq = 1.64429,
tvvmax = 54.794,
tvkm = 0.145159,
tvkme = 0.290811,
tvvme = 0.01,
Ω_vc = 0.01,
Ω_vp = 0.01,
Ω_q = 0.01,
Ω_vmax = 0.01,
Ω_km = 0.01,
Ω_kme = 0.01,
Ω_vme = 0.12,
σ_prop_cp = 0.12,
σ_prop_met )
7 Dosage Regimen
Three Subjects were administered three different doses of 10 μmol/kg, 50 μmol/kg and 300 μmol/kg.
= [10, 50, 300] dose
8 Single-individual that receives the defined dose
= ["ID:1 Dose 10", "ID:2 Dose 50", "ID:3 Dose 300"] ids
ev(x) = DosageRegimen(dose[x], cmt = 1, time = 0)
= map(zip(1:3, ids)) do (i, id)
pop return Subject(id = id, events = ev(i), observations = (cp = nothing, met = nothing))
end
Population
Subjects: 3
Observations: cp, met
9 Single-Subject Simulation
Simulate the parent plasma concentration and metabolite plasma concentration.
Initialize the random number generator with a seed for reproducibility of the simulation.
Random.seed!(123)
Define the timepoints at which concentration values will be simulated.
= simobs(pk_19, pop, param, obstimes = 0.1:1:300) sim_pop3_sub
Simulated population (Vector{<:Subject})
Simulated subjects: 3
Simulated variables: cp, dv_cp, met, dv_met
9.1 Visualize Results
= DataFrame(sim_pop3_sub)
df_plots first(df_plots, 5)
Row | id | time | cp | dv_cp | met | dv_met | evid | amt | cmt | rate | duration | ss | ii | route | Central | Peripheral | Metabolite | Vc | Vp | Q | Vmax | Km | Kme | Vme | η_vc | η_vp | η_q | η_vmax | η_km | η_kme | η_vme |
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
String | Float64 | Float64? | Float64? | Float64? | Float64? | Int64 | Float64? | Symbol? | Float64? | Float64? | Int8? | Float64? | NCA.Route? | Float64? | Float64? | Float64? | Float64? | Float64? | Float64? | Float64? | Float64? | Float64? | Float64? | Float64 | Float64 | Float64 | Float64 | Float64 | Float64 | Float64 | |
1 | ID:1 Dose 10 | 0.0 | missing | missing | missing | missing | 1 | 10.0 | Central | 0.0 | 0.0 | 0 | 0.0 | NullRoute | missing | missing | missing | 1.33729 | 2.21881 | 0.131675 | 1.73691 | 60.9883 | 0.146355 | 0.272359 | 0.228566 | 0.100091 | 0.0221355 | 0.0547971 | 0.107102 | 0.00820405 | -0.0655541 |
2 | ID:1 Dose 10 | 0.1 | 7.39069 | 6.95578 | 0.0687838 | 0.0726144 | 0 | missing | missing | missing | missing | missing | missing | missing | 9.88353 | 0.0975981 | 0.0187339 | 1.33729 | 2.21881 | 0.131675 | 1.73691 | 60.9883 | 0.146355 | 0.272359 | 0.228566 | 0.100091 | 0.0221355 | 0.0547971 | 0.107102 | 0.00820405 | -0.0655541 |
3 | ID:1 Dose 10 | 1.1 | 6.59444 | 6.16244 | 0.66797 | 0.634963 | 0 | missing | missing | missing | missing | missing | missing | missing | 8.81871 | 0.984028 | 0.181927 | 1.33729 | 2.21881 | 0.131675 | 1.73691 | 60.9883 | 0.146355 | 0.272359 | 0.228566 | 0.100091 | 0.0221355 | 0.0547971 | 0.107102 | 0.00820405 | -0.0655541 |
4 | ID:1 Dose 10 | 2.1 | 5.91922 | 4.82119 | 1.12758 | 1.05325 | 0 | missing | missing | missing | missing | missing | missing | missing | 7.91574 | 1.72562 | 0.307105 | 1.33729 | 2.21881 | 0.131675 | 1.73691 | 60.9883 | 0.146355 | 0.272359 | 0.228566 | 0.100091 | 0.0221355 | 0.0547971 | 0.107102 | 0.00820405 | -0.0655541 |
5 | ID:1 Dose 10 | 3.1 | 5.34643 | 6.54973 | 1.47442 | 1.57254 | 0 | missing | missing | missing | missing | missing | missing | missing | 7.14975 | 2.34495 | 0.40157 | 1.33729 | 2.21881 | 0.131675 | 1.73691 | 60.9883 | 0.146355 | 0.272359 | 0.228566 | 0.100091 | 0.0221355 | 0.0547971 | 0.107102 | 0.00820405 | -0.0655541 |
9.2 Parent
@chain df_plots begin
dropmissing(:cp)
data(_) *
mapping(
:time => "Time (minutes)",
:cp => "Parent concentrations (μmol/L)";
= :id => "",
color *
) visual(Lines; linewidth = 4)
draw(
= (; fontsize = 22),
figure = (;
axis = log10,
yscale = map(i -> 10.0^i, -1:2),
yticks = i -> (@. string(round(i; digits = 1))),
ytickformat = 0:50:300,
xticks
),= (; position = :bottom),
legend
)end
9.3 Metabolite
@chain df_plots begin
dropmissing(:met)
data(_) *
mapping(
:time => "Time (minutes)",
:met => "Metabolite concentrations (μmol/L)";
= :id => "",
color *
) visual(Lines; linewidth = 4)
draw(
= (; fontsize = 22),
figure = (;
axis = log10,
yscale = map(i -> 10.0^i, -1:2),
yticks = i -> (@. string(round(i; digits = 1))),
ytickformat = 0:50:300,
xticks
),= (; position = :bottom),
legend
)end
10 Population Simulation
We perform a population simulation with 50 participants.
This code demonstrates how to write the simulated concentrations to a comma separated file (.csv
).
= (
par = 1.06405,
tvvc = 2.00748,
tvvp = 0.128792,
tvq = 1.64429,
tvvmax = 54.794,
tvkm = 0.145159,
tvkme = 0.290811,
tvvme = 0.042,
Ω_vc = 0.0125,
Ω_vp = 0.0924,
Ω_q = 0.0625,
Ω_vmax = 0.0358,
Ω_km = 0.0111,
Ω_kme = 0.0498,
Ω_vme = 0.04587,
σ_prop_cp = 0.0625,
σ_prop_met
)
= DosageRegimen(10, cmt = 1, time = 0)
ev1 = map(i -> Subject(id = i, events = ev1), 1:20)
pop1 = DosageRegimen(50, cmt = 1, time = 0)
ev2 = map(i -> Subject(id = i, events = ev2), 21:40)
pop2 = DosageRegimen(300, cmt = 1, time = 0)
ev3 = map(i -> Subject(id = i, events = ev3), 41:60)
pop3 = [pop1; pop2; pop3]
pop
Random.seed!(1234)
= simobs(pk_19, pop, par, obstimes = [0, 5, 10, 20, 30, 60, 90, 120, 180, 300])
pop_sim sim_plot(pop_sim)
= DataFrame(pop_sim)
pkdata_19_sim
#CSV.write("pk_19_sim.csv", pkdata_19_sim);
11 Conclusion
This tutorial showed how to build a two-compartment model with a limited capacity metabolite of a given IV bolus and perform a single subject and population simulation.