groupcounts

Количество элементов группы

Синтаксис

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

Описание

пример

G = groupcounts(T,groupvars) вычисляет число элементов в каждой группе данных в таблице или расписании, и возвращает таблицу, содержащую группы и их количества. Группа является набором уникальных комбинаций группирующих переменных в groupvars. Например, G = groupcounts(T,'Gender') возвращает количество элементов Male и количество элементов Female в переменной Gender.

пример

G = groupcounts(T,groupvars,groupbins) задает как к интервалу данные в groupvars. Например, G = groupcounts(T,'SaleDate','year') дает ежегодные количества продаж согласно SaleDate.

пример

G = groupcounts(___,Name,Value) задает дополнительные свойства группировки с помощью одной или нескольких пар "имя-значение" для любого из предыдущих синтаксисов. Например, G = groupcounts(T,'Category1','IncludeMissingGroups',false) исключает группу, сделанную из пропавших без вести данных categorical, обозначенных <undefined>.

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

B = groupcounts(A,groupbins) интервалы данные согласно groupbins.

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

пример

[B,BG] = groupcounts(A,___) также возвращает группы, соответствующие количествам в B.

Примеры

свернуть все

Вычислите количество элементов группы от табличных данных.

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

Gender = ["male";"female";"male";"female";"male"];
Smoker = logical([1;0;1;0;1]);
Weight = [176;163;131;133;119];
T = table(Gender,Smoker,Weight)
T=5×3 table
     Gender     Smoker    Weight
    ________    ______    ______

    "male"      true       176  
    "female"    false      163  
    "male"      true       131  
    "female"    false      133  
    "male"      true       119  

Считайте число элементов в каждой группе полом.

G1 = groupcounts(T,'Gender')
G1=2×2 table
     Gender     GroupCount
    ________    __________

    "female"        2     
    "male"          3     

Считайте число элементов в каждой группе состоянием курильщика и полом. По умолчанию groupcounts подавляет группы с нулевыми элементами.

G2 = groupcounts(T,{'Gender','Smoker'})
G2=2×3 table
     Gender     Smoker    GroupCount
    ________    ______    __________

    "female"    false         2     
    "male"      true          3     

Чтобы считать все группы, включая тех с нулевыми элементами, задают параметр 'IncludeEmptyGroups' со значением true.

G3 = groupcounts(T,{'Gender','Smoker'},'IncludeEmptyGroups',true)
G3=4×3 table
     Gender     Smoker    GroupCount
    ________    ______    __________

    "female"    false         2     
    "female"    true          0     
    "male"      false         0     
    "male"      true          3     

Данные группы согласно заданным интервалам.

Создайте расписание, содержащее данные по продажам в течение многих дней в течение одного месяца.

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]';
TotalItemsSold = [14 13 8 5 10 16 8 6 7 11]';
TT = timetable(TimeStamps,Profit,TotalItemsSold)
TT=10×3 timetable
    TimeStamps     Profit    TotalItemsSold
    ___________    ______    ______________

    04-Mar-2017     2032           14      
    02-Mar-2017     3071           13      
    15-Mar-2017     1185            8      
    10-Mar-2017     2587            5      
    14-Mar-2017     1998           10      
    31-Mar-2017     2899           16      
    25-Mar-2017     3112            8      
    29-Mar-2017      909            6      
    21-Mar-2017     2619            7      
    18-Mar-2017     3085           11      

Вычислите количества группы общими проданными товарами, раскладывание группы на интервалы номеров изделия.

G = groupcounts(TT,'TotalItemsSold',[0 4 8 12 16])
G=3×2 table
    disc_TotalItemsSold    GroupCount
    ___________________    __________

         [4, 8)                3     
         [8, 12)               4     
         [12, 16]              3     

Вычислите количества группы, сгруппированные за день недели.

G = groupcounts(TT,'TimeStamps','dayname')
G=5×2 table
    dayname_TimeStamps    GroupCount
    __________________    __________

        Tuesday               2     
        Wednesday             2     
        Thursday              1     
        Friday                2     
        Saturday              3     

Вычислите группу, значит четыре группы на основе их пола и состояния курильщика.

Храните терпеливую информацию как три вектора различных типов.

Gender = ["male";"female";"male";"female";"male"];
Smoker = logical([1;0;1;0;1]);
Weight = [176;163;131;133;119];

При группировке полом и состоянием курильщика, вычислите количества группы. B содержит счета для каждой группы. BG является массивом ячеек, содержащим два вектора, которые описывают группы, когда вы смотрите на их построчные элементы. Например, первая строка BG{1} говорит, что пациентки в первой группе являются розеткой, и первая строка BG{2} говорит, что они - некурящие. Счет для той группы равняется 2, найденному в соответствующей строке B.

[B,BG] = groupcounts({Gender,Smoker},'IncludeEmptyGroups',true);
B
B = 4×1

     2
     0
     0
     3

BG{1}
ans = 4x1 string array
    "female"
    "female"
    "male"
    "male"

BG{2}
ans = 4x1 logical array

   0
   1
   0
   1

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

свернуть все

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

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

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

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

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

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

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

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

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

Пример: 'Age'

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

Схема 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 = groupcounts(T,groupvars,groupbins,'IncludedEdge','right')

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

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

Недостающий индикатор групп, заданный как числовой или логический 1 (true) или 0 (false). Если значением параметров является true, то группы отображений groupcounts, составленные из отсутствующих значений, такие как NaN. Если значением параметров является false, то groupcounts не отображает группы отсутствующего значения.

Пустой индикатор групп, заданный как числовой или логический 0 (false) или 1 (true). Если значением параметров является false, то groupcounts не делает дисплейных групп с нулевыми элементами. Если значением параметров является true, то groupcounts отображает пустые группы.

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

свернуть все

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

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

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

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

Советы

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

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

Введенный в R2019a

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