Documentation

This is machine translation

Translated by Microsoft
Mouseover text to see original. Click the button below to return to the English verison of the page.

Note: This page has been translated by MathWorks. Please click here
To view all translated materals including this page, select Japan from the country navigator on the bottom of this page.

getdose

Class: SimBiology.export.Model

Return exported SimBiology model dose object

Syntax

doses = getdose(model)
doses = getdose(model,doseName)

Description

doses = getdose(model) returns all the SimBiology.export.Dose objects associated with the exported model.

doses = getdose(model,doseName) returns the export dose object with the Name property matching doseName.

Input Arguments

model

SimBiology.export.Model object.

doseName

String containing a dose name to match against the Name property of the export dose objects in model.

Default: All dose objects.

Output Arguments

doses

Export dose objects in model, or the export dose object with Name property doseName.

Examples

expand all

Open a sample SimBiology model project, and export the included model object.

sbioloadproject('AntibacterialPKPD')
em = export(m1);

Display the editable doses in the exported model object.

doses = getdose(em)
doses = 

  1x4 RepeatDose array with properties:

    Interval
    RepeatCount
    StartTime
    TimeUnits
    Amount
    AmountUnits
    DurationParameterName
    LagParameterName
    Name
    Notes
    Parent
    Rate
    RateUnits
    TargetName

The exported model has 4 repeated dose objects. Display the dose names.

{doses.Name}

ans = 

    '250 mg bid'    '250 mg tid'    '500 mg bid'    '500 mg tid'

Extract only the 3rd dose object from the exported model object.

dose3 = getdose(em,'500 mg bid')

dose3 = 

  RepeatDose with properties:

                 Interval: 12
              RepeatCount: 27
                StartTime: 0
                TimeUnits: 'hour'
                   Amount: 500
              AmountUnits: 'milligram'
    DurationParameterName: 'TDose'
         LagParameterName: ''
                     Name: '500 mg bid'
                    Notes: ''
                   Parent: 'Antibacterial'
                     Rate: 0
                RateUnits: ''
               TargetName: 'Central.Drug'

Was this topic helpful?