This example evaluates a G-CSF / filgrastim population design with PFIM, based on the PK-PD model of Krzyzanski et al. (Krzyzanski et al. 2010).
The model describes subcutaneous filgrastim with quasi-steady-state target-mediated drug disposition (TMDD) and a myelopoiesis cascade for absolute neutrophil count (ANC). The population Fisher information matrix (FIM) is evaluated for Design 1: three parallel arms (1, 3 and 10 µg/kg), 10 subjects per arm, dense PK and ANC sampling on days 1 and 7.
Combined2 residual error).The 11-state ODE FIM is expensive. During rendering,
example04_execute.R reuses
vignettes/data/vignette4_evaluation_populationFIM.RDS when
present; otherwise it runs the evaluation. Set
PFIM_GCSF_FORCE_RUN=true to ignore the cache. HTML
Report() is rebuilt only when regenerating the FIM or when
PFIM_VIGNETTE_REPORT=true.
Design 1 is a three-arm parallel study. Body weight is fixed at 75 kg
so the administered amount is \(\mathrm{DOSE}\times\mathrm{WT}\). Seven
daily subcutaneous doses are given at times \(0, 24, \ldots, 144\) h. Bioavailability
FF enters the depot initial condition
(ABS = FF * dose_ABS).
| Arm | \(n\) | Dose | Sampling |
|---|---|---|---|
dose_1ugkg |
10 | 1 µg/kg × 75 kg | PK and ANC dense on days 1 and 7 |
dose_3ugkg |
10 | 3 µg/kg × 75 kg | same grid |
dose_10ugkg |
10 | 10 µg/kg × 75 kg | same grid |
PK samples on day 1: 0.167–24 h (22 points), repeated on day 7, plus 172, 192 and 216 h. ANC adds daily troughs on days 2–6 and a 240 h point. Later PK peaks are lower than the day-1 peak because of TMDD feedback: higher ANC clears G-CSF faster.
Two observed responses:
CENT.NB.Eleven ODE states: depot ABS, central CENT,
nine bone-marrow transit compartments B1–B9,
and blood neutrophils NB. Prefix Deriv_
identifies each right-hand side; the suffix must match the state name.
Operators follow R (** for exponentiation).
The full right-hand sides are built by
.pfimGcsfModelEquations() in
example04_execute.R. The evaluation only needs the equation
list, the algebraic PK output, and baseline initial conditions
.pfimGcsfBaselineICs().
Inter-individual variability (\(\omega\)) is set only for the parameters that are estimated (nonzero \(\omega\)). Fixed \(\mu\) flags remove parameters from the FIM.
| Parameter | Description | \(\mu\) | \(\omega\) | Fixed μ |
|---|---|---|---|---|
| FF | Bioavailability | 0.626 | 0 | Yes |
| KA | Absorption rate (h⁻¹) | 0.642 | 0 | No |
| KEL | Elimination rate of free G-CSF (h⁻¹) | 0.148 | √0.312 | No |
| VD | Central volume (L) | 2.56 | √0.328 | No |
| KD | Equilibrium dissociation constant (ng/mL) | 1.27 | 0 | No |
| KINT | Internalization rate (h⁻¹) | 0.101 | 0 | No |
| KSI | Binding capacity (Rmax-related) | 0.211 | √0.224 | No |
| KMT | Neutrophil elimination from blood (h⁻¹) | 0.0723 | 0 | No |
| KTT | Myeloid transit rate (h⁻¹) | 0.0102 | 0 | No |
| NB0 | Baseline circulating ANC (10³/µL) | 1.65 | √0.298 | No |
| SC1 | G-CSF EC₅₀ for stimulation (ng/mL) | 3.21 | √0.803 | No |
| SM1 | Max. stimulation of production | 34.3 | √0.0128 | No |
| SM2 | Max. stimulation of maturation | 32.3 | 0 | No |
FR, D2, KOFF,
KBB1, SM3 and BAS are fixed and
do not appear in the FIM.
modelParameters = list(
ModelParameter(name = "KA", distribution = LogNormal(mu = 0.642, omega = 0)),
ModelParameter(name = "KEL", distribution = LogNormal(mu = 0.148, omega = sqrt(0.312))),
ModelParameter(name = "VD", distribution = LogNormal(mu = 2.56, omega = sqrt(0.328))),
# ... remaining parameters as in example04_execute.R
)PFIM Combined2 stores residual standard
deviations (sigmaInter, sigmaSlope).
The variance form is
\[ V = \sigma_{\mathrm{inter}}^2 + (\sigma_{\mathrm{slope}}\, f)^2. \]
| Response | Term | PFIM SD |
|---|---|---|
| RespPK | proportional | √0.253 |
| RespPK | additive | 0, fixed |
| RespPD | proportional | √0.0227 |
| RespPD | additive | √2.10 |
WT = 75
dose_times = seq(0, 6 * 24, by = 24)
mk_arm = function(name, dose_ug_per_kg) {
Arm(
name = name, size = 10,
administrations = list(Administration(
outcome = "ABS", timeDose = dose_times,
dose = rep(dose_ug_per_kg * WT, length(dose_times))
)),
samplingTimes = list(samplingPK, samplingPD),
initialConditions = .pfimGcsfBaselineICs()
)
}
design1 = Design(
name = "gcsf_design1",
arms = list(
mk_arm("dose_1ugkg", 1),
mk_arm("dose_3ugkg", 3),
mk_arm("dose_10ugkg", 10)
)
)pfim_set_option(perf.fdLinearOnly = TRUE)
evaluationPop = Evaluation(
name = "gcsf_design1",
modelEquations = modelEquations,
modelParameters = modelParameters,
modelError = modelError,
outputs = list(RespPK = .pfimGcsfCp(), RespPD = "NB"),
designs = list(design1),
fimType = "population",
odeSolverParameters = list(atol = 1e-8, rtol = 1e-8)
)
evaluationPop = run(evaluationPop)
show(evaluationPop)
getRSE(evaluationPop)
***************************************
Population Fisher Matrix
***************************************
μ_KA μ_KEL μ_VD μ_KD μ_KINT μ_KSI μ_KMT μ_KTT μ_NB0 μ_SC1 μ_SM1 μ_SM2 ω²_KEL
μ_KA 3971.1311156 1186.9218298 -2.036910e+01 -43.0557970 13963.30995 -244.505941 -6.798335e+02 7174.6916 -7.09980650 12.44065292 1.916216e+00 0.1939741 0.000000000
μ_KEL 1186.9218298 3276.6125964 6.240750e+00 -156.3236244 9250.01901 -4.066780 2.179500e+03 8740.5620 -2.35299025 0.73943343 4.034423e-01 1.2497026 0.000000000
μ_VD -20.3691010 6.2407503 1.143137e+01 3.8378322 -94.80479 46.860295 -3.208658e+00 -728.5192 0.47053982 0.09993536 2.053618e-04 -0.1446296 0.000000000
μ_KD -43.0557970 -156.3236244 3.837832e+00 284.9748591 -6639.55813 -193.952738 -1.759877e+03 6329.5127 -1.59457642 -2.93350653 -6.571671e-01 1.2214591 0.000000000
μ_KINT 13963.3099523 9250.0190055 -9.480479e+01 -6639.5581293 280625.07795 2536.417058 7.140062e+04 -162853.1163 -13.80764317 128.70795076 4.117431e+01 -40.5458885 0.000000000
μ_KSI -244.5059408 -4.0667795 4.686030e+01 -193.9527380 2536.41706 1757.093492 1.291056e+03 -35042.1221 7.95346612 9.43280439 2.382649e+00 -9.9768049 0.000000000
μ_KMT -679.8334795 2179.5003307 -3.208658e+00 -1759.8765917 71400.62066 1291.055650 2.516249e+05 -102117.7445 402.89285135 277.64187376 2.988309e+01 110.7877980 0.000000000
μ_KTT 7174.6915719 8740.5619687 -7.285192e+02 6329.5127120 -162853.11626 -35042.122084 -1.021177e+05 1371025.1260 -261.47968877 -581.86254459 4.025250e+02 -125.4816343 0.000000000
μ_NB0 -7.0998065 -2.3529903 4.705398e-01 -1.5945764 -13.80764 7.953466 4.028929e+02 -261.4797 35.37313289 -0.50505033 -8.216462e-02 1.0780692 0.000000000
μ_SC1 12.4406529 0.7394334 9.993536e-02 -2.9335065 128.70795 9.432804 2.776419e+02 -581.8625 -0.50505033 3.20793111 -6.164331e-02 -0.1954826 0.000000000
μ_SM1 1.9162163 0.4034423 2.053618e-04 -0.6571671 41.17431 2.382649 2.988309e+01 402.5250 -0.08216462 -0.06164331 1.947301e+00 -1.9885161 0.000000000
μ_SM2 0.1939741 1.2497026 -1.446296e-01 1.2214591 -40.54589 -9.976805 1.107878e+02 -125.4816 1.07806922 -0.19548259 -1.988516e+00 2.4205231 0.000000000
ω²_KEL 0.0000000 0.0000000 0.000000e+00 0.0000000 0.00000 0.000000 0.000000e+00 0.0000 0.00000000 0.00000000 0.000000e+00 0.0000000 96.431122784
ω²_VD 0.0000000 0.0000000 0.000000e+00 0.0000000 0.00000 0.000000 0.000000e+00 0.0000 0.00000000 0.00000000 0.000000e+00 0.0000000 0.121067757
ω²_KSI 0.0000000 0.0000000 0.000000e+00 0.0000000 0.00000 0.000000 0.000000e+00 0.0000 0.00000000 0.00000000 0.000000e+00 0.0000000 0.001812156
ω²_NB0 0.0000000 0.0000000 0.000000e+00 0.0000000 0.00000 0.000000 0.000000e+00 0.0000 0.00000000 0.00000000 0.000000e+00 0.0000000 0.007300912
ω²_SC1 0.0000000 0.0000000 0.000000e+00 0.0000000 0.00000 0.000000 0.000000e+00 0.0000 0.00000000 0.00000000 0.000000e+00 0.0000000 0.008543976
ω²_SM1 0.0000000 0.0000000 0.000000e+00 0.0000000 0.00000 0.000000 0.000000e+00 0.0000 0.00000000 0.00000000 0.000000e+00 0.0000000 0.779939847
σ_slope_RespPK 0.0000000 0.0000000 0.000000e+00 0.0000000 0.00000 0.000000 0.000000e+00 0.0000 0.00000000 0.00000000 0.000000e+00 0.0000000 17.867806893
σ_inter_RespPD 0.0000000 0.0000000 0.000000e+00 0.0000000 0.00000 0.000000 0.000000e+00 0.0000 0.00000000 0.00000000 0.000000e+00 0.0000000 0.868053723
σ_slope_RespPD 0.0000000 0.0000000 0.000000e+00 0.0000000 0.00000 0.000000 0.000000e+00 0.0000 0.00000000 0.00000000 0.000000e+00 0.0000000 8.192692601
ω²_VD ω²_KSI ω²_NB0 ω²_SC1 ω²_SM1 σ_slope_RespPK σ_inter_RespPD σ_slope_RespPD
μ_KA 0.0000000 0.000000e+00 0.000000e+00 0.000000000 0.000000e+00 0.000000 0.0000000 0.000000
μ_KEL 0.0000000 0.000000e+00 0.000000e+00 0.000000000 0.000000e+00 0.000000 0.0000000 0.000000
μ_VD 0.0000000 0.000000e+00 0.000000e+00 0.000000000 0.000000e+00 0.000000 0.0000000 0.000000
μ_KD 0.0000000 0.000000e+00 0.000000e+00 0.000000000 0.000000e+00 0.000000 0.0000000 0.000000
μ_KINT 0.0000000 0.000000e+00 0.000000e+00 0.000000000 0.000000e+00 0.000000 0.0000000 0.000000
μ_KSI 0.0000000 0.000000e+00 0.000000e+00 0.000000000 0.000000e+00 0.000000 0.0000000 0.000000
μ_KMT 0.0000000 0.000000e+00 0.000000e+00 0.000000000 0.000000e+00 0.000000 0.0000000 0.000000
μ_KTT 0.0000000 0.000000e+00 0.000000e+00 0.000000000 0.000000e+00 0.000000 0.0000000 0.000000
μ_NB0 0.0000000 0.000000e+00 0.000000e+00 0.000000000 0.000000e+00 0.000000 0.0000000 0.000000
μ_SC1 0.0000000 0.000000e+00 0.000000e+00 0.000000000 0.000000e+00 0.000000 0.0000000 0.000000
μ_SM1 0.0000000 0.000000e+00 0.000000e+00 0.000000000 0.000000e+00 0.000000 0.0000000 0.000000
μ_SM2 0.0000000 0.000000e+00 0.000000e+00 0.000000000 0.000000e+00 0.000000 0.0000000 0.000000
ω²_KEL 0.1210678 1.812156e-03 7.300912e-03 0.008543976 7.799398e-01 17.867807 0.8680537 8.192693
ω²_VD 96.4111185 1.501672e+01 2.001819e-01 0.149257544 3.307127e-01 6.457008 0.6128612 2.418923
ω²_KSI 15.0167242 1.157098e+02 3.188220e-01 0.696509059 6.474389e+00 21.993134 1.1966022 15.044794
ω²_NB0 0.2001819 3.188220e-01 1.549261e+02 0.335554086 1.096557e+00 1.147716 1.2844870 4.533607
ω²_SC1 0.1492575 6.965091e-01 3.355541e-01 18.249985669 1.096434e+00 1.315882 0.8195170 8.313513
ω²_SM1 0.3307127 6.474389e+00 1.096557e+00 1.096434311 8.753110e+04 50.382840 8.4710336 43.458001
σ_slope_RespPK 6.4570079 2.199313e+01 1.147716e+00 1.315881531 5.038284e+01 10401.414719 5.7904536 104.906026
σ_inter_RespPD 0.6128612 1.196602e+00 1.284487e+00 0.819517001 8.471034e+00 5.790454 380.5603736 1719.216620
σ_slope_RespPD 2.4189227 1.504479e+01 4.533607e+00 8.313512679 4.345800e+01 104.906026 1719.2166196 48953.726924
***************************************
Fixed effects (μ)
***************************************
μ_KA μ_KEL μ_VD μ_KD μ_KINT μ_KSI μ_KMT μ_KTT μ_NB0 μ_SC1 μ_SM1 μ_SM2
μ_KA 3971.1311156 1186.9218298 -2.036910e+01 -43.0557970 13963.30995 -244.505941 -6.798335e+02 7174.6916 -7.09980650 12.44065292 1.916216e+00 0.1939741
μ_KEL 1186.9218298 3276.6125964 6.240750e+00 -156.3236244 9250.01901 -4.066780 2.179500e+03 8740.5620 -2.35299025 0.73943343 4.034423e-01 1.2497026
μ_VD -20.3691010 6.2407503 1.143137e+01 3.8378322 -94.80479 46.860295 -3.208658e+00 -728.5192 0.47053982 0.09993536 2.053618e-04 -0.1446296
μ_KD -43.0557970 -156.3236244 3.837832e+00 284.9748591 -6639.55813 -193.952738 -1.759877e+03 6329.5127 -1.59457642 -2.93350653 -6.571671e-01 1.2214591
μ_KINT 13963.3099523 9250.0190055 -9.480479e+01 -6639.5581293 280625.07795 2536.417058 7.140062e+04 -162853.1163 -13.80764317 128.70795076 4.117431e+01 -40.5458885
μ_KSI -244.5059408 -4.0667795 4.686030e+01 -193.9527380 2536.41706 1757.093492 1.291056e+03 -35042.1221 7.95346612 9.43280439 2.382649e+00 -9.9768049
μ_KMT -679.8334795 2179.5003307 -3.208658e+00 -1759.8765917 71400.62066 1291.055650 2.516249e+05 -102117.7445 402.89285135 277.64187376 2.988309e+01 110.7877980
μ_KTT 7174.6915719 8740.5619687 -7.285192e+02 6329.5127120 -162853.11626 -35042.122084 -1.021177e+05 1371025.1260 -261.47968877 -581.86254459 4.025250e+02 -125.4816343
μ_NB0 -7.0998065 -2.3529903 4.705398e-01 -1.5945764 -13.80764 7.953466 4.028929e+02 -261.4797 35.37313289 -0.50505033 -8.216462e-02 1.0780692
μ_SC1 12.4406529 0.7394334 9.993536e-02 -2.9335065 128.70795 9.432804 2.776419e+02 -581.8625 -0.50505033 3.20793111 -6.164331e-02 -0.1954826
μ_SM1 1.9162163 0.4034423 2.053618e-04 -0.6571671 41.17431 2.382649 2.988309e+01 402.5250 -0.08216462 -0.06164331 1.947301e+00 -1.9885161
μ_SM2 0.1939741 1.2497026 -1.446296e-01 1.2214591 -40.54589 -9.976805 1.107878e+02 -125.4816 1.07806922 -0.19548259 -1.988516e+00 2.4205231
***************************************
Variance components (ω², γ², σ)
***************************************
ω²_KEL ω²_VD ω²_KSI ω²_NB0 ω²_SC1 ω²_SM1 σ_slope_RespPK σ_inter_RespPD σ_slope_RespPD
ω²_KEL 96.431122784 0.1210678 1.812156e-03 7.300912e-03 0.008543976 7.799398e-01 17.867807 0.8680537 8.192693
ω²_VD 0.121067757 96.4111185 1.501672e+01 2.001819e-01 0.149257544 3.307127e-01 6.457008 0.6128612 2.418923
ω²_KSI 0.001812156 15.0167242 1.157098e+02 3.188220e-01 0.696509059 6.474389e+00 21.993134 1.1966022 15.044794
ω²_NB0 0.007300912 0.2001819 3.188220e-01 1.549261e+02 0.335554086 1.096557e+00 1.147716 1.2844870 4.533607
ω²_SC1 0.008543976 0.1492575 6.965091e-01 3.355541e-01 18.249985669 1.096434e+00 1.315882 0.8195170 8.313513
ω²_SM1 0.779939847 0.3307127 6.474389e+00 1.096557e+00 1.096434311 8.753110e+04 50.382840 8.4710336 43.458001
σ_slope_RespPK 17.867806893 6.4570079 2.199313e+01 1.147716e+00 1.315881531 5.038284e+01 10401.414719 5.7904536 104.906026
σ_inter_RespPD 0.868053723 0.6128612 1.196602e+00 1.284487e+00 0.819517001 8.471034e+00 5.790454 380.5603736 1719.216620
σ_slope_RespPD 8.192692601 2.4189227 1.504479e+01 4.533607e+00 8.313512679 4.345800e+01 104.906026 1719.2166196 48953.726924
*********************************************
Determinant, condition numbers and D-criterion
***********************************************
Determinant: 4.833743e+56
D-criterion: 500.3243
Condition number (fixed effects): 19670405
Condition number (variance components): 4798.393
***************************************
Parameters estimation
***************************************
Parameter Value SE RSE(%)
μ_KA 0.6420000 0.021116261 3.289137
μ_KEL 0.1480000 0.020007804 13.518786
μ_VD 2.5600000 0.322665143 12.604107
μ_KD 1.2700000 0.104970938 8.265428
μ_KINT 0.1010000 0.003860719 3.822495
μ_KSI 0.2110000 0.041203487 19.527719
μ_KMT 0.0723000 0.002940078 4.066498
μ_KTT 0.0102000 0.001735777 17.017423
μ_NB0 1.6500000 0.177727482 10.771363
μ_SC1 3.2100000 0.669325581 20.851264
μ_SM1 34.3000000 2.843452279 8.289948
μ_SM2 32.3000000 2.475776746 7.664943
ω²_KEL 0.3120000 0.101851203 32.644616
ω²_VD 0.3280000 0.102890719 31.369122
ω²_KSI 0.2240000 0.093948373 41.941238
ω²_NB0 0.2980000 0.080344111 26.961111
ω²_SC1 0.8030000 0.234129307 29.156825
ω²_SM1 0.0128000 0.003380033 26.406507
σ_slope_RespPK 0.5029911 0.009808890 1.950112
σ_inter_RespPD 1.4491377 0.055888640 3.856683
σ_slope_RespPD 0.1506652 0.004927586 3.270554
[1] 500.3243
RSE (%) reported by PFIM for Design 1.
| Parameter | Description | RSE (%) |
|---|---|---|
| \(\mu_{\mathrm{KA}}\) | Absorption rate | 3.289 |
| \(\mu_{\mathrm{KEL}}\) | Elimination rate of free G-CSF | 13.519 |
| \(\mu_{\mathrm{VD}}\) | Central volume | 12.604 |
| \(\mu_{\mathrm{KD}}\) | Equilibrium dissociation constant | 8.265 |
| \(\mu_{\mathrm{KINT}}\) | Internalization rate | 3.822 |
| \(\mu_{\mathrm{KSI}}\) | Binding capacity (Rmax-related) | 19.528 |
| \(\mu_{\mathrm{KMT}}\) | Neutrophil elimination from blood | 4.066 |
| \(\mu_{\mathrm{KTT}}\) | Myeloid transit rate | 17.017 |
| \(\mu_{\mathrm{NB0}}\) | Baseline circulating ANC | 10.771 |
| \(\mu_{\mathrm{SC1}}\) | G-CSF EC50 for stimulation | 20.851 |
| \(\mu_{\mathrm{SM1}}\) | Max. stimulation of production | 8.290 |
| \(\mu_{\mathrm{SM2}}\) | Max. stimulation of maturation | 7.665 |
| Parameter | Description | RSE (%) |
|---|---|---|
| \(\omega^2_{\mathrm{NB0}}\) | Baseline circulating ANC | 26.961 |
| \(\omega^2_{\mathrm{KEL}}\) | Elimination rate of free G-CSF | 32.645 |
| \(\omega^2_{\mathrm{VD}}\) | Central volume | 31.369 |
| \(\omega^2_{\mathrm{KSI}}\) | Binding capacity (Rmax-related) | 41.941 |
| \(\omega^2_{\mathrm{SC1}}\) | G-CSF EC50 for stimulation | 29.157 |
| \(\omega^2_{\mathrm{SM1}}\) | Max. stimulation of production | 26.407 |
Console and report rows are labelled \(\sigma_{\mathrm{slope/inter}}\) — the Value column is the SD, not the variance.
| Parameter | Description | Value (SD) | RSE (%) |
|---|---|---|---|
| \(\sigma_{\mathrm{slope,PK}}\) | PK proportional (SD) | 0.5030 | 1.950 |
| \(\sigma_{\mathrm{slope,ANC}}\) | ANC proportional (SD) | 0.1507 | 3.271 |
| \(\sigma_{\mathrm{inter,ANC}}\) | ANC additive (SD) | 1.4491 | 3.857 |
Overlay of the three dose groups (PK | ANC): ODE re-simulation on a dense \(0..t_{\max}\) grid. Sampling times are shown as points. SE and RSE bar charts follow.