用途:将 SimBiology 模型参数拟合到实验或观测数据,支持参数估计、群体 PK/PD 与 NLME 混合效应建模、虚拟患者/队列生成,以及 NCA 指标(AUC、Cmax、Tmax、半衰期、清除率)计算。不适用于模型构建(用 simbiology-build-model)或无拟合的仿真与敏感性分析(用 simbiology-simulate-model)。
主要能力与用法:参数估计统一使用 fitproblem,而非直接调用 sbiofit 或 sbiofitmixed。数据须用 groupedData 包装并设置 IndependentVariableName;ResponseMap 采用 "模型输出 = 数据列" 格式,多房室时用 Compartment.Species 限定。估计参数用 estimatedInfo,务必设置 Bounds,跨数量级的速率常数可用 .Transform='log'(InitialValue 与 Bounds 仍用自然域)。群体拟合设 FitFunction="sbiofitmixed",误差模型可选 constant、proportional、combined、exponential;含协变量时改用 CovariateModel。算法可选 scattersearch、nlinfit、lsqnonlin、fminsearch、particleswarm。多受试者给药可用 createDoses 提取剂量对象,非给药行须为 NaN。虚拟患者可由 SimBiology.Scenarios 加 makedist 生成,或用 sbiosampleparameters 从 NLME 结果采样。NCA 使用 sbioncaoptions 对象(列名为 camelCase),支持 ExtraVascular、IVBolus、IVInfusion 等给药途径。置信区间用 sbioparameterci,仅支持 sbiofit 结果,不支持 NLME。
限制:sbiofitmixed 忽略 Bounds,需依赖良好初值;小数据集(少于 5 名受试者)可能不收敛;使用 CategoryVariableName 时不要设置 prob.Pooled;拟合前不要调用 sbioaccelerate;物种名不得与房室名相同;房室体积应指定单位。拟合质量可通过 plot、plotResiduals、AIC、BIC、MSE 等评估。