A dose object represents one or more increases to the amount of a species during a model simulation. It lets you increase the amount of a species during a simulation, either at specific times or time intervals. The increase in the amount of a species occurs only during a simulation, and does not alter the species' value permanently.
For example, you can use a dose to represent the addition of a drug to a model every two hours.
There are two types of dose objects:
Repeat doses and schedule doses support three kinds of increases to species amounts:
Instantaneous increase (or step change) in the amount of a species
Increase at a fixed rate over a period of time calculated from the dose amount
Increase at a fixed rate calculated from the dose amount and dose duration
By using repeat doses and schedule doses with SimBiology models, you can easily model common dosing strategies, such as bolus, infusion, zero-order absorption, and first-order absorption.
Create a dose and add it to the model using the adddose method.
Configure the properties of the dose. For example, set the TargetName property to the name of the species in the model that will receive the dose. Set the Active property to true to use it during a simulation.
Enter the model as an input argument to sbiosimulate to apply the dose.
SimBiology® will simulate the model using all active doses associated with the model.
|For information about...||See...|
|Creating and adding a dose to a model||adddose|
|Creating a stand-alone dose||sbiodose|
|Methods and properties of a dose||ScheduleDose object and RepeatDose object|
To simulate models containing doses, use a deterministic (ODE or SUNDIALS) solver. Stochastic solvers do not support doses. For more information, see Choosing a Simulation Solver.