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

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

doseArray = createDoses(grpData,'DOSE');

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

свернуть все

Сгруппированные данные в виде a 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ПримечанияТег, и UserData.

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

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

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

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

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

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

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

свернуть все

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

Примечание

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

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

| | |

Введенный в R2014a