exponenta event banner

createDoses

Создание дозовых объектов на основе объекта Data

Описание

пример

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 соответственно.

Создайте множество объектов дозы, используя информацию о дозировании от 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 к категориальным векторам и сравнивает их. I-й ряд doseArray соответствует i-ой группе, указанной в groups.

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

свернуть все

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

Примечание

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

Представлен в R2014a