exponenta event banner

createDoses

Создайте объекты дозы из объекта groupedData

Описание

пример

doseArray = createDoses(grpData,amountVarNames) создает массив SimBiology® дозировать объекты, используя данные о времени и количестве дозы, указанные в grpData, с одной строкой на группу и по одному столбцу на суммарную дозу переменную.

grpData.Properties.IndependentVariable задает, какая переменная содержит время дозы, и amountVarNames определяет, какие переменные содержат допустимые суммарные дозы.

пример

doseArray = createDoses(grpData,amountVarNames,rateVarNames) использует переменные скорости дозы, заданные rateVarNames.

пример

doseArray = createDoses(grpData,amountVarNames,rateVarNames,tempDoses) использует шаблонные дозы, заданные tempDoses как шаблоны для объектов дозы в doseArray. Другими словами, этот аргумент позволяет вам скопировать некоторые свойства дозы шаблона, такие как TargetName, DurationParameterName, и LagParameterName, для дозирования объектов в doseArray.

пример

doseArray = createDoses(grpData,amountVarNames,rateVarNames,tempDoses,groups) задает группы в grpData для создания доз для.

Примеры

свернуть все

Загрузите набор выборочных данных.

load pheno.mat ds

Создайте groupedData объект из набора данных ds.

grpData = groupedData(ds);

Отображение свойств объекта.

grpData.Properties
ans = struct with fields:
                Description: ''
                   UserData: []
             DimensionNames: {'Observations'  'Variables'}
              VariableNames: {'ID'  'TIME'  'DOSE'  'WEIGHT'  'APGAR'  'CONC'}
       VariableDescriptions: {}
              VariableUnits: {}
         VariableContinuity: []
                   RowNames: {}
           CustomProperties: [1x1 matlab.tabular.CustomProperties]
          GroupVariableName: 'ID'
    IndependentVariableName: 'TIME'

GroupVariableName и IndpendentVariableName были автоматически назначены символам 'ID' и 'Time', соответственно.

Создайте массив объектов дозы с помощью информации о дозах из сгруппированных данных, заданных DOSE переменная. Каждая строка (объект дозы) представляет график дозирования для каждого индивидуума (группы).

doseArray = createDoses(grpData,'DOSE');

Входные параметры

свернуть все

Сгруппированные данные, заданные как groupedData объект.

Задайте grpData.Properties.IndependentVariable в допустимую переменную в grpData который определяет время дозы. grpData.Properties.GroupVariableName опционально определяет сгруппированную переменную. grpData.Properties.VariableUnits опционально задает модули для соответствующих переменных. Если указанные модули являются недействительными, выдается предупреждение и модули соответствующих доз в doseArray установлены в пустые символьные векторы ('').

Имена переменных величины, заданные как вектор символов, строка, строковый вектор или массив ячеек из векторов символов, который задает переменные в grpData которые определяют суммарные дозы. Каждый вектор символов или строка должны задавать допустимую переменную суммы.

Переменная суммы действительна, если она является вещественным неотрицательным вектором-столбцом, не содержащей бесконечных значений.

Имена переменных скорости, заданные как вектор символов, строка, строковый вектор или массив ячеек из векторов символов, которые задают переменные в grpData которые определяют уровни дозы. Если он пуст [] или {}, это указывает на отсутствие частот дозы. Если он не пуст, это должен быть векторы символов, строка, массив ячеек из векторов символов или строкового вектора имен той же длины, что и amountVarNames. Отдельные имена могут быть пустыми ('' или ""), чтобы указать отсутствие частот дозы для соответствующих доз или могут быть допустимыми именами переменной в grpData определение коэффициентов дозы.

Переменная скорости действительна, если она является вещественным неотрицательным вектором-столбцом, не содержащей бесконечных значений. NaN допускаются значения скорости, но их обрабатывают так же, как и значения скорости 0, то есть дозы обрабатывают как болюсные (мгновенные) дозы.

Шаблонные дозы, заданные как объект дозы (ScheduleDose object или RepeatDose object), вектор объектов дозы или пустой массив [].

Используйте этот аргумент, чтобы скопировать следующие свойства дозы шаблона для каждой дозы в doseArray: TargetName, DurationParameterName, LagParameterName, Notes, Tag, и UserData.

Если tempDoses является объектом разовой дозы, эти свойства с объекта копируются во все дозы в doseArray. Если это вектор, он должен иметь ту же длину, что и amountVarNamesи эти свойства из каждого элемента (доза) копируются в соответствующий столбец доз в doseArray.

The Name свойство каждой дозы в doseArray состоит из Name из шаблона дозы, за которой следуют групповые имена в круглых скобках, таких как 'DailyDose (Patient1)'.

Если вы не задаете модулей в grpData.Properties.VariableUnits, следующие свойства модулей дозы шаблона копируются в дозы в doseArray: AmountUnits, RateUnits, и TimeUnits.

Имена групп, заданные как вектор символов, строковый вектор, пустой массив [], или вектор типов данных, который может быть преобразован в категориальный вектор. Список поддерживаемых типов данных см. в разделе categorical.

По умолчанию groups установлено в [], что означает, что функция создает дозы для каждой группы в grpData, с doseArray содержит по одной строке на группу в grpData, в порядке первого вхождения каждой группы в grpData.

Если вы задаете любую группу, функция преобразует эти группы и сгруппированную переменную в grpData к категориальным векторам и сравнивает их. i-я строка doseArray соответствует i-й группе, указанной в groups.

Выходные аргументы

свернуть все

Объекты дозы SimBiology, возвращенные как 2-D матрица объектов дозы, содержащих данные о времени дозы и количестве от grpData. Если время дозы для конкретной дозы в grpData регулярно разделяются, затем соответствующий объект дозы в doseArray является RepeatDose object. В противном случае соответствующим объектом дозы является ScheduleDose object.

Примечание

Если существует время разовой дозы, то объект дозы представлен как ScheduleDose object.

Введенный в R2014a