grouptransform

Преобразуйте группой

свернуть все на странице

Синтаксис

G = grouptransform(T,groupvars,method)
G = grouptransform(T,groupvars,groupbins,method)
G = grouptransform(___,datavars)
G = grouptransform(___,Name,Value)
B = grouptransform(A,groupvars,method)
B = grouptransform(A,groupvars,groupbins,method)
B = grouptransform(___,Name,Value)
[B,BG] = grouptransform(A,___)

Описание

пример

G = grouptransform(T,groupvars,method) преобразовывает данные в таблицу или расписание с помощью вычислений в method, группируясь переменными, заданными в groupvars. Вывод G является таблицей или расписанием, содержащим преобразованные данные вместо негруппирующихся переменных из T. Например, G = grouptransform(T,'Gender','norm') нормирует данные в T полом с помощью 2-нормы.

пример

G = grouptransform(T,groupvars,groupbins,method) интервалы преобразованные данные согласно groupbins, размещая группы в конце выходной таблицы как дополнительные переменные. Например, G = grouptransform(T,'SaleDate','year','rescale') масштабирует данные в T к области значений [0,1] и интервалы к году продаж.

G = grouptransform(___,datavars) задает табличные переменные, чтобы преобразовать для любого из предыдущих синтаксисов.

пример

G = grouptransform(___,Name,Value) задает дополнительные свойства группировки с помощью одной или нескольких пар "имя-значение". Например, G = grouptransform(T,'Temp','linearfill','ReplaceValues',false) добавляет заполненные данные как дополнительную переменную T вместо замены негруппирующихся переменных.

B = grouptransform(A,groupvars,method) возвращает преобразованные данные согласно уникальным комбинациям группирующихся векторов в groupvars, когда A является вектором или матрицей. groupvars может быть вектор-столбцом, матрицей или массивом ячеек вектор-столбцов.

B = grouptransform(A,groupvars,groupbins,method) интервалы преобразованные данные согласно groupbins.

B = grouptransform(___,Name,Value) задает дополнительные свойства группировки с помощью одной или нескольких пар "имя-значение" для любого из предыдущих синтаксисов массивов.

пример

[B,BG] = grouptransform(A,___) также возвращает группы для каждого вектора группировки.

Примеры

свернуть все

Скрипт Open Live Script

Создайте расписание, содержащее состояние прогресса для 3 команд. 

timeStamp = days([1 1 1 2 2 2 3 3 3]');
teamNumber = [1 2 3 1 2 3 1 2 3]';
percentComplete = [14.2 28.1 11.5 NaN NaN 19.3 46.1 51.2 30.3]';
T = timetable(timeStamp,teamNumber,percentComplete)
T=9×3 timetable
    timeStamp    teamNumber    percentComplete
    _________    __________    _______________

    1 day            1              14.2      
    1 day            2              28.1      
    1 day            3              11.5      
    2 days           1               NaN      
    2 days           2               NaN      
    2 days           3              19.3      
    3 days           1              46.1      
    3 days           2              51.2      
    3 days           3              30.3

Заполните недостающие проценты состояния (NaN) для каждой группы, использующей линейную интерполяцию. 

G = grouptransform(T,'teamNumber','linearfill','percentComplete')
G=9×3 timetable
    timeStamp    teamNumber    percentComplete
    _________    __________    _______________

    1 day            1               14.2     
    1 day            2               28.1     
    1 day            3               11.5     
    2 days           1              30.15     
    2 days           2              39.65     
    2 days           3               19.3     
    3 days           1               46.1     
    3 days           2               51.2     
    3 days           3               30.3

Чтобы добавить заполненные данные к исходной таблице вместо замены переменной percentComplete, используйте параметр 'ReplaceValues'.

Gappend = grouptransform(T,'teamNumber','linearfill','percentComplete','ReplaceValues',false)
Gappend=9×4 timetable
    timeStamp    teamNumber    percentComplete    linearfill_percentComplete
    _________    __________    _______________    __________________________

    1 day            1              14.2                     14.2           
    1 day            2              28.1                     28.1           
    1 day            3              11.5                     11.5           
    2 days           1               NaN                    30.15           
    2 days           2               NaN                    39.65           
    2 days           3              19.3                     19.3           
    3 days           1              46.1                     46.1           
    3 days           2              51.2                     51.2           
    3 days           3              30.3                     30.3
Скрипт Open Live Script

Составьте таблицу дат и соответствующей прибыли. 

timeStamps = datetime([2017 3 4; 2017 3 2; 2017 3 15; 2017 3 10;...
                       2017 3 14; 2017 3 31; 2017 3 25;...
                       2017 3 29; 2017 3 21; 2017 3 18]);
profit = [2032 3071 1185 2587 1998 2899 3112 909 2619 3085]';
T = table(timeStamps,profit)
T=10×2 table
    timeStamps     profit
    ___________    ______

    04-Mar-2017     2032 
    02-Mar-2017     3071 
    15-Mar-2017     1185 
    10-Mar-2017     2587 
    14-Mar-2017     1998 
    31-Mar-2017     2899 
    25-Mar-2017     3112 
    29-Mar-2017      909 
    21-Mar-2017     2619 
    18-Mar-2017     3085

Группировка за день называет, нормирует прибыль 2-нормой.

G = grouptransform(T,'timeStamps','dayname','norm')
G=10×3 table
    timeStamps     profit     dayname_timeStamps
    ___________    _______    __________________

    04-Mar-2017    0.42069        Saturday      
    02-Mar-2017          1        Thursday      
    15-Mar-2017    0.79344        Wednesday     
    10-Mar-2017    0.66582        Friday        
    14-Mar-2017    0.60654        Tuesday       
    31-Mar-2017    0.74612        Friday        
    25-Mar-2017    0.64428        Saturday      
    29-Mar-2017    0.60864        Wednesday     
    21-Mar-2017    0.79506        Tuesday       
    18-Mar-2017    0.63869        Saturday
Скрипт Open Live Script

Создайте вектор дат и вектор соответствующих значений прибыли.

timeStamps = datetime([2017 3 4; 2017 3 2; 2017 3 15; 2017 3 10; ...
                       2017 3 14; 2017 3 31; 2017 3 25; ...
                       2017 3 29; 2017 3 21; 2017 3 18]);
profit = [2032 3071 1185 2587 1998 2899 3112 909 2619 3085]';

При группировке за день недели, нормируйте значения прибыли 2-нормой. Отобразите преобразованные данные и какой группе они соответствуют.

[normDailyProfit,dayOfWeek] = grouptransform(profit,timeStamps,'dayname','norm')
normDailyProfit = 10×1

    0.4207
    1.0000
    0.7934
    0.6658
    0.6065
    0.7461
    0.6443
    0.6086
    0.7951
    0.6387


dayOfWeek = 10x1 categorical array
     Saturday 
     Thursday 
     Wednesday 
     Friday 
     Tuesday 
     Friday 
     Saturday 
     Wednesday 
     Tuesday 
     Saturday

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

свернуть все

Входные данные, заданные как таблица или расписание.

Входной массив, заданный как вектор или матрица.

Группирующие переменные или векторы, заданные как скаляр, вектор, матрица, массив ячеек или указатель на функцию.

Для входных данных таблицы или расписания groupvars указывает, какие столбцы использовать, чтобы вычислить группы, и может быть одно из следующего:

  • Вектор символов или скаляр строки определение одного имени табличной переменной

  • Массив ячеек из символьных векторов или массив строк, где каждый элемент является именем табличной переменной

  • Вектор индексов табличной переменной

  • Логический вектор, элементы которого каждый соответствует табличной переменной, где true включает соответствующую переменную и false, исключает его

  • Указатель на функцию, который берет табличную переменную в качестве входа и возвращает логический скаляр

Для входа массивов groupvars может быть или вектор-столбцом с одинаковым числом строк как A или группой вектор-столбцов, расположенных в матричном или массиве ячеек.

Пример: 'Age'

Пример: {'Height','Weight'}

Метод вычисления, заданный как одно из следующего:

Метод

Описание

'zscore'

Нормируйте данные, чтобы иметь среднее значение 0 и стандартное отклонение 1

'norm'

Нормируйте данные 2-нормой

'meancenter'

Нормируйте данные, чтобы иметь среднее значение 0

'rescale'

Повторно масштабируйте область значений к [0,1]

'meanfill'

Заполните отсутствующие значения со средним значением данных группы

'linearfill'

Заполните отсутствующие значения линейной интерполяцией ненедостающих данных группы

Можно также задать указатель на функцию, который возвращает скаляр или вектор-столбец с одинаковым числом строк как входные данные. Если функция возвращает скаляр, grouptransform повторяет скаляр для каждого элемента преобразованного вывода.

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

  • Вектор символов или скаляр строки определение одного имени табличной переменной

  • Массив ячеек из символьных векторов или массив строк, где каждый элемент является именем табличной переменной

  • Вектор индексов табличной переменной

  • Логический вектор, элементы которого каждый соответствует табличной переменной, где true включает соответствующую переменную и false, исключает его

  • Указатель на функцию, который берет табличную переменную в качестве входа и возвращает логический скаляр

Когда datavars не задан, grouptransform применяет вычисления к каждой переменной негруппировки.

Пример: 'Profit'

Пример: {'Income','Expenses'}

Пример: @isnumeric

Схема Binning, заданная как одна из следующих опций:

  • 'none', не указывая ни на какое раскладывание

  • Список ребер интервала, заданных как числовой вектор или вектор datetime для группирующих переменных datetime

  • Много интервалов, заданных как целочисленный скаляр

  • Длительность времени, заданная как скаляр типа duration или calendarDuration, указывающий на ширины интервала (только для группирующих переменных datetime или duration)

  • Массив ячеек, перечисляющий раскладывание, управляет для каждой группирующей переменной

  • Временной интервал для группирующих переменных datetime и duration только, заданный как один из следующих векторов символов:

    ЗначениеОписаниеТип данных
    'second'

    Каждый интервал составляет 1 секунду.

    		datetime и duration
    'minute'

    Каждый интервал составляет 1 минуту.

    		datetime и duration
    'hour'

    Каждый интервал составляет 1 час.

    		datetime и duration
    'day'

    Каждый интервал составляет 1 календарный день. Это значение составляет сдвиги Летнего времени.

    		datetime и duration
    'week'Каждый интервал составляет 1 календарную неделю.datetime только
    'month'Каждый интервал составляет 1 календарный месяц.datetime только
    'quarter'Каждый интервал составляет 1 календарный квартал.datetime только
    'year'

    Каждый интервал составляет 1 календарный год. Это значение считает в течение дней прыжка.

    		datetime и duration
    'decade'Каждый интервал составляет 1 десятилетие (10 календарных лет).datetime только
    'century'Каждый интервал является 1-м веком (100 календарных лет).datetime только
    'secondofminute'

    Интервалы являются секундами от 0 до 59.

    		datetime только
    'minuteofhour'

    Интервалы являются минутами от 0 до 59.

    		datetime только
    'hourofday'

    Интервалы являются часами от 0 до 23.

    		datetime только
    'dayofweek'

    Интервалы являются днями от 1 до 7. Первый день недели является воскресеньем.

    		datetime только
    'dayname'Интервалы являются полными дневными именами, такими как 'Sunday'.datetime только
    'dayofmonth'Интервалы являются днями от 1 до 31.datetime только
    'dayofyear'Интервалы являются днями от 1 до 366.datetime только
    'weekofmonth'Интервалы являются неделями от 1 до 6.datetime только
    'weekofyear'Интервалы являются неделями от 1 до 54.datetime только
    'monthname'Интервалы являются полными именами месяца, такими как 'January'.datetime только
    'monthofyear'

    Интервалы являются месяцами от 1 до 12.

    		datetime только
    'quarterofyear'Интервалы являются четвертями от 1 до 4.datetime только

Когда несколько группирующих переменных заданы, можно предоставить одно правило раскладывания, которое применяется ко всем группирующим переменным или массиву ячеек, содержащему метод раскладывания для каждой группирующей переменной, таким как {'none',[0 2 4 Inf]}.

Аргументы в виде пар имя-значение

Укажите необязательные аргументы в виде пар ""имя, значение"", разделенных запятыми. Имя (Name) — это имя аргумента, а значение (Value) — соответствующее значение. Name должен появиться в кавычках. Вы можете задать несколько аргументов в виде пар имен и значений в любом порядке, например: Name1, Value1, ..., NameN, ValueN.

Пример: G = grouptransform(T,groupvars,groupbins,'zscore','IncludedEdge','right')

Включенное ребро интервала, заданное или как 'left' или как 'right', указывая, какой конец интервала интервала является содержащим.

Эта пара "имя-значение" может только быть задана, когда groupbins задан, и значение применяется ко всем схемам раскладывания всех группирующих переменных или векторов.

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

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

свернуть все

Выведите таблицу, возвращенную как таблица, содержащая преобразованные данные для каждой группы.

Выходной массив, возвращенный как вектор или матрица, содержащая преобразованные данные.

Группы для входных данных массивов, возвращенных как вектор-столбец или массив ячеек вектор-столбцов каждое соответствие группирующемуся вектору.

Когда вы обеспечиваете больше чем один группирующийся вектор, BG является массивом ячеек, содержащим вектор-столбцы равной длины. Информация о группе может быть найдена путем рассмотрения элементов, построчных через все векторы в BG. Каждая группа сопоставляет с соответствующей строкой выходного массива B.

Советы

  • При совершении многих вызовов к grouptransform полагайте, что группирующие переменные преобразования вводят categorical или logical, если это возможно, для улучшенной производительности. Например, если у вас есть группирующая переменная типа char (такой как Gender с элементами 'Male' и 'Female'), можно преобразовать его в категориальное значение с помощью команды categorical(Gender).

Расширенные возможности

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

| | | | |

Введенный в R2018b

Документация MATLAB
Поддержка
Для просмотра документации необходимо авторизоваться на сайте