Documentation Center

  • Trial Software
  • Product Updates

Dose Object

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:

  • ScheduleDose object — Applies a dose to a single species at a pre-defined list of times.

  • RepeatDose object — Repeatedly applies a dose to a single species at regularly spaced time intervals.

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.

Creating and Simulating Dose Objects

  1. Create a dose and add it to the model using the adddose method.

  2. 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.

  3. 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 modeladddose
Creating a stand-alone dosesbiodose
Methods and properties of a doseScheduleDose object and RepeatDose object

Simulation Solvers for Models Containing Doses

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.

Was this topic helpful?