exponenta event banner

createDoses

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

Синтаксис

doseArray = createDoses(grpData,amountVarNames)
doseArray = createDoses(grpData,amountVarNames,rateVarNames)
doseArray = createDoses(grpData,amountVarNames,rateVarNames,tempDoses)
doseArray = createDoses(grpData,amountVarNames,rateVarNames,tempDoses,groups)

Описание

пример

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' и 'Время', соответственно.

Создайте массив объектов дозы с помощью информации о дозировании от groupedData, заданного переменной 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.

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

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

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

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

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

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

свернуть все

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

Примечание

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

Смотрите также

| | |

Введенный в R2014a