topkrows

Верхние строки в отсортированном порядке

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

Синтаксис

B = topkrows(X,k)

B = topkrows(X,k,col)

B = topkrows(___,direction)

B = topkrows(___,'ComparisonMethod',method)

[B,I] = topkrows(X,___)

B = topkrows(T,k)

B = topkrows(T,k,vars)

B = topkrows(T,k,vars,direction)

B = topkrows(___,'ComparisonMethod',method)

[B,I] = topkrows(T,___)

Описание

пример

B = topkrows(X,k) возвращает первые строки k в массиве X, отсортированный в порядке убывания (для числовых данных) или противоположный алфавитный порядок (для текстовых данных). виды topkrows на основе элементов в первом столбце. Когда первый столбец содержит элементы равного значения, видов topkrows согласно элементам в следующем столбце и повторяет это поведение для следования за равными значениями.

пример

B = topkrows(X,k,col) сортирует результаты по столбцам, заданным col. Используйте этот синтаксис, чтобы выполнить несколько сортировок столбца по очереди. Например, topkrows(X,k,5) сортирует строки X в порядке убывания на основе элементов в пятой колонне. topkrows(X,k,[4 6]) первые виды строки в порядке убывания элементами в четвертом столбце, и затем это сортирует на основе элементов в шестом столбце, чтобы повредить связи.

пример

B = topkrows(___,direction) задает направление сортировки с помощью любого из предыдущих синтаксисов. direction может быть 'ascend', 'descend' или массив ячеек, содержащий те значения.

Например, topkrows(A,2,[2 3],{'ascend' 'descend'}) получает лучшие 2 строки первыми строками сортировки в порядке возрастания элементами в столбце 2. Затем это сортирует строки с равными записями в столбце 2 в порядке убывания элементами в столбце 3.

пример

B = topkrows(___,'ComparisonMethod',method) задает, как сравнить комплексные числа. Методом сравнения может быть 'auto', 'real' или 'abs'.

[B,I] = topkrows(X,___) также возвращает индексный вектор I, который описывает порядок выбранных строк, таким образом что B = X(I,:).

пример

B = topkrows(T,k) возвращает первые строки k в таблице или расписании T, в отсортированном порядке. Строки таблицы находятся в убывающем отсортированном порядке всеми их переменными, и строки расписания находятся в убывающем отсортированном порядке ко времени.

пример

B = topkrows(T,k,vars) сортирует результаты по переменным, заданным vars. Используйте этот синтаксис для вида с несколькими переменными по очереди. Например, topkrows(T,k,{'Var1','Var2'}) первые виды строки T на основе элементов в Var1, и затем это сортирует по элементам в Var2.

B = topkrows(T,k,vars,direction) задает направление сортировки. Например, используйте 'ascend', чтобы отсортировать T в порядке возрастания.

[B,I] = topkrows(T,___) также возвращает индексный вектор I, который описывает порядок выбранных строк, таким образом что B = T(I,:).

Примеры

свернуть все

Сортировка строк матрицы

Скрипт Open Live Script

Сортировка строк матрицы с помощью различных порядков сортировки и представления верхние строки.

Создайте 20 5 матрица случайных целых чисел между 1 и 10.

rng default % for reproducibility
X = randi(10,20,5);

Сортировка строк X в порядке убывания и возвращает лучшие 4 строки. По умолчанию, виды topkrows с помощью первого столбца матрицы. Для любых строк, которые имеют равные элементы в конкретном столбце, сортировка основана на столбце сразу направо.

TA = topkrows(X,4)

TA = 4×5

    10    10     8     7     6
    10     7     8     2     4
    10     4     4     3     5
    10     3     7     9     6

Когда названо тремя входными параметрами, topkrows основывает вид полностью на столбце, заданном в третьем аргументе. Это означает, что строки с равными значениями в заданном столбце остаются в их первоначальном заказе. Сортировка X в порядке убывания с помощью значений в третьем столбце и возвращает лучшие 5 строк.

TB = topkrows(X,5,3)

TB = 5×5

     5     7    10     2     6
     2     9     8     6     6
    10    10     8     7     6
    10     7     8     2     4
    10     2     8     3     6

Сортировка X с помощью и третьих и четвертых столбцов. В этом случае topkrows сортирует строки по столбцу 3. Затем для любых строк с равными значениями в столбце 3 это сортирует по столбцу 4.

TC = topkrows(X,5,[3 4])

TC = 5×5

     5     7    10     2     6
    10    10     8     7     6
     2     9     8     6     6
    10     2     8     3     6
    10     7     8     2     4

Определение направлений сортировки для столбцов матрицы

Скрипт Open Live Script

Сортировка матрицы с помощью нескольких столбцов с различными направлениями сортировки.

Создайте 100 5 матрица случайных целых чисел между 1 и 10.

rng default % for reproducibility
X = randi(10,100,5);

Сортировка X с помощью первых трех столбцов и возвращает лучшие 10 строк. Задайте направление сортировки для каждого столбца с помощью массива ячеек.

TA = topkrows(X,10,1:3,{'descend','ascend','ascend'})

TA = 10×5

    10     1     4     6     7
    10     1     8     5     1
    10     2     3     4     7
    10     3     5    10     5
    10     4     7     2     4
    10     5     5     2     7
    10     5     5     6     7
    10     6     5     5     7
    10     6     6     1     5
    10     7     7     8     1

Сортировка строк таблицы

Скрипт Open Live Script

Сортировка строк гетерогенных данных в таблице.

Составьте таблицу от набора данных patients.mat, который включает основную медицинскую информацию для группы пациентов. Включайте возраст пациентов, пол, высоту и их самооцененное состояние здоровья в таблице. Сделайте переменную SelfAssessedHealthStatus порядковым категориальным массивом.

load patients
vals = {'Poor','Fair','Good','Excellent'};
SelfAssessedHealthStatus = categorical(SelfAssessedHealthStatus,vals,'Ordinal',true);
T = table(Age,Gender,Height,SelfAssessedHealthStatus);

Найдите лучшие 10 строк, когда таблица будет отсортирована в порядке убывания. Результат сортируется по первой переменной, Age, в порядке убывания. Остальные столбцы подсортируются, чтобы повредить связи:

Переменная Gender подсортируется, чтобы повредить связи с возрастом.
Переменная Height повреждает связи с полом.
Переменная SelfAssessedHealthStatus повреждает связи с высотой.

TA = topkrows(T,10)

TA=10×4 table
    Age     Gender     Height    SelfAssessedHealthStatus
    ___    ________    ______    ________________________

    50     'Male'        72             Excellent        
    50     'Male'        68             Good             
    49     'Male'        70             Fair             
    49     'Male'        68             Poor             
    49     'Female'      64             Good             
    49     'Female'      63             Good             
    48     'Male'        71             Good             
    48     'Male'        71             Good             
    48     'Male'        66             Fair             
    48     'Female'      66             Excellent

Найдите лучшие 10 строк, содержащих самых молодых женщин путем сортировки на переменной Gender и подсортировки на переменной Age.

TB = topkrows(T,10,{'Gender','Age'},'ascend')

TB=10×4 table
    Age     Gender     Height    SelfAssessedHealthStatus
    ___    ________    ______    ________________________

    25     'Female'      63             Good             
    25     'Female'      64             Excellent        
    27     'Female'      69             Fair             
    28     'Female'      65             Good             
    28     'Female'      65             Good             
    28     'Female'      66             Good             
    29     'Female'      63             Excellent        
    29     'Female'      68             Excellent        
    29     'Female'      64             Good             
    30     'Female'      67             Excellent

Найдите лучшие 10 самых старых женщин путем изменения направления сортировки переменной Age к 'descend'.

TB = topkrows(T,10,{'Gender','Age'},{'ascend','descend'})

TB=10×4 table
    Age     Gender     Height    SelfAssessedHealthStatus
    ___    ________    ______    ________________________

    49     'Female'      64             Good             
    49     'Female'      63             Good             
    48     'Female'      65             Excellent        
    48     'Female'      66             Excellent        
    48     'Female'      64             Excellent        
    48     'Female'      64             Good             
    48     'Female'      66             Excellent        
    47     'Female'      66             Excellent        
    46     'Female'      68             Good             
    45     'Female'      68             Excellent

Сортировка комплексных чисел

Скрипт Open Live Script

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

Создайте 100 2 матрица случайных комплексных чисел.

valRange = [-10 10];
X = randi(valRange,100,2) + 1i*randi(valRange,100,2);

Найдите лучшие 10 строк матрицы. По умолчанию topkrows сравнивает комплексные числа абсолютным значением.

TA = topkrows(X,10)

TA = 10×2 complex

 -10.0000 + 9.0000i  10.0000 - 2.0000i
  -8.0000 + 9.0000i   2.0000 - 8.0000i
   9.0000 + 8.0000i   4.0000 + 7.0000i
  -6.0000 +10.0000i  -8.0000 - 7.0000i
   6.0000 -10.0000i  -1.0000 - 5.0000i
   6.0000 -10.0000i   0.0000 + 5.0000i
  -7.0000 + 9.0000i  -2.0000 - 5.0000i
   9.0000 - 7.0000i  10.0000 + 7.0000i
   9.0000 - 7.0000i   6.0000 + 6.0000i
  -9.0000 - 7.0000i   9.0000 + 9.0000i

Найдите лучшие 10 строк матрицы с помощью только действительную часть комплексных чисел путем определения пары "имя-значение" 'ComparisonMethod'.

TB = topkrows(X,10,'ComparisonMethod','real')

TB = 10×2 complex

  10.0000 + 4.0000i  -3.0000 - 7.0000i
  10.0000 + 3.0000i   4.0000 + 5.0000i
  10.0000 + 2.0000i   5.0000 - 7.0000i
  10.0000 - 1.0000i  -1.0000 - 8.0000i
  10.0000 - 1.0000i  -6.0000 +10.0000i
  10.0000 - 4.0000i  -9.0000 + 0.0000i
  10.0000 - 5.0000i  -8.0000 - 3.0000i
   9.0000 + 8.0000i   4.0000 + 7.0000i
   9.0000 + 5.0000i -10.0000 + 0.0000i
   9.0000 + 1.0000i   1.0000 - 9.0000i

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

свернуть все

`X` Входной массив
числовой массив | логический массив | символьный массив | массив строк | категориальный массив | массив datetime | массив длительности

Входной массив, заданный как числовое, логическое, символ, строка, категориальная, datetime или массив длительности.

Если X является непорядковым категориальным массивом, то topkrows сортирует элементы в порядке убывания на основе порядка категорий, возвращенных categories(X).
Если X содержит NaN, NaT или другие отсутствующие значения, то topkrows помещает отсутствующие значения в конце убывающего вида.

`T` Входная таблица
таблица | расписание

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

Типы данных: table | timetable

`k` Количество строк, чтобы возвратиться
скаляр

Количество строк, чтобы возвратиться, заданный как неотрицательное скалярное целое число. Если k больше, чем количество строк в X, то topkrows возвращает все строки в X.

`col` — Столбцы к виду
скаляр | вектор

Столбцы к виду, заданный как положительное скалярное целое число или вектор положительных целых чисел.

Пример: виды B = topkrows(X,100,[1 3]) по первым и третьим столбцам прежде, чем возвратить лучшие 100 строк.

`вар` Переменные к виду
скаляр | вектор | имя переменной | массив ячеек | `'RowNames'`

Переменные к виду, заданный как одна из опций в этой таблице.

Опция	Пример	Описание
положительное целое число	`topkrows(T,k,3)`	Целочисленный `n` задает индекс переменной к виду, как возвращено `T.Properties.VariableNames{n}`.
вектор положительных целых чисел	`topkrows(T,k,[1 3])`	Векторный `[n1 n2 …]` задает индексы нескольких переменных к виду, как возвращено `T.Properties.VariableNames{[n1 n2 …]}`.
логический вектор	`topkrows(T,k,[true false true])`	Задает одну или несколько переменных к виду при помощи значений `true` или `false`.
имя переменной	`topkrows(T,k,'Var3')`	Задает переменную сортировки как одни из имен переменных, перечисленных в `T.Properties.VariableNames`.
cellArray	`topkrows(T,k,{'Var1 'Var3'})`	Задает несколько переменных сортировки, выбранных из `T.Properties.VariableNames`.
`'RowNames'`	`topkrows(T,k,'RowNames')`	Для таблиц только. Эта опция сортирует результаты по именам строки.

Пример: виды B = topkrows(X,k,[1 3]) по первым и третьим столбцам.

Пример: виды B = topkrows(X,k,'Year') с помощью переменной Year.

`direction` — Сортировка направления
`'descend'` (значение по умолчанию) | `'ascend'` | массив ячеек

Сортируя направление, заданное или как 'descend', 'ascend' или как массив ячеек, который задает некоторую комбинацию этих значений.

Если direction является массивом ячеек, то он должен содержать 'descend' или 'ascend' для каждого столбца сортировки, заданного col или vars. Если вы не задаете col или vars, то массив ячеек должен содержать 'descend' или 'ascend' для каждого столбца в X или переменной в T.

`method` — Метод сравнения для комплексных чисел
`'auto'` (значение по умолчанию) | `'real'` | `'abs'`

Метод сравнения для комплексных чисел, заданных как одно из этих значений:

'auto' (значение по умолчанию) Сравнивает вещественные числа согласно 'real' и комплексные числа согласно 'abs'.
действительный Сравнивает числа действительной частью real(A). Числа с равной действительной частью подсортируются по мнимой части imag(A).
abs Сравнивает числа абсолютным значением abs(A). Числа с равным значением подсортируются по углу фазы angle(A).

Эта опция не поддерживает нечисловые входные данные (datetime, duration, string, и так далее).

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

свернуть все

`B` Требуемые строки
массив

Требуемые строки, возвращенные как массив того же класса как X или T.

`I` Индексы строки
вектор

Индексы строки, возвращенные как вектор. I описывает порядок выбранных строк, таким образом что B = X(I,:) или B = T(I,:).

Советы

topkrows не делает полного вида входных данных, таким образом, это обычно быстрее, чем sort и sortrows, когда количество требуемых строк является маленьким.

Вопросы совместимости

развернуть все

Изменение поведения с длинными массивами

Поведение изменяется в R2017b

Некоторые поведения topkrows, работающего с длинными массивами, изменились:

topkrows помещает NaN, NaT и другие отсутствующие значения в конце убывающего вида. В предыдущих релизах topkrows поместил отсутствующие значения в начале убывающего вида.
topkrows больше не принимает высокие массивы ячеек, содержащие только скалярные числовые значения как входные параметры. Используйте cell2mat, чтобы преобразовать высокий массив ячеек скалярных числовых значений в высокую матрицу перед использованием topkrows.

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

"Высокие" массивы
Осуществление вычислений с массивами, которые содержат больше строк, чем помещается в памяти.

Указания и ограничения по применению:

Пара "имя-значение" 'ComparisonMethod' не поддержана.
Опция 'RowNames' для таблиц не поддержана.

Для получения дополнительной информации см. Раздел "Высокие массивы".

Документация

topkrows

Синтаксис

Описание

Примеры

Сортировка строк матрицы

Определение направлений сортировки для столбцов матрицы

Сортировка строк таблицы

Сортировка комплексных чисел

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

`X` Входной массив
числовой массив | логический массив | символьный массив | массив строк | категориальный массив | массив datetime | массив длительности

`T` Входная таблица
таблица | расписание

`k` Количество строк, чтобы возвратиться
скаляр

`col` — Столбцы к виду
скаляр | вектор

`вар` Переменные к виду
скаляр | вектор | имя переменной | массив ячеек | `'RowNames'`

`direction` — Сортировка направления
`'descend'` (значение по умолчанию) | `'ascend'` | массив ячеек

`method` — Метод сравнения для комплексных чисел
`'auto'` (значение по умолчанию) | `'real'` | `'abs'`

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

`B` Требуемые строки
массив

`I` Индексы строки
вектор

Советы

Вопросы совместимости

Изменение поведения с длинными массивами

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

"Высокие" массивы
Осуществление вычислений с массивами, которые содержат больше строк, чем помещается в памяти.

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

Введенный в R2017b

Документация MATLAB

Поддержка

Документация

topkrows

Синтаксис

Описание

Примеры

Сортировка строк матрицы

Определение направлений сортировки для столбцов матрицы

Сортировка строк таблицы

Сортировка комплексных чисел

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

X Входной массив числовой массив | логический массив | символьный массив | массив строк | категориальный массив | массив datetime | массив длительности

T Входная таблица таблица | расписание

k Количество строк, чтобы возвратиться скаляр

col — Столбцы к виду скаляр | вектор

вар Переменные к виду скаляр | вектор | имя переменной | массив ячеек | 'RowNames'

direction — Сортировка направления 'descend' (значение по умолчанию) | 'ascend' | массив ячеек

method — Метод сравнения для комплексных чисел 'auto' (значение по умолчанию) | 'real' | 'abs'

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

B Требуемые строки массив

I Индексы строки вектор

Советы

Вопросы совместимости

Изменение поведения с длинными массивами

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

"Высокие" массивы Осуществление вычислений с массивами, которые содержат больше строк, чем помещается в памяти.

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

Введенный в R2017b

Документация MATLAB

Поддержка

`X` Входной массив
числовой массив | логический массив | символьный массив | массив строк | категориальный массив | массив datetime | массив длительности

`T` Входная таблица
таблица | расписание

`k` Количество строк, чтобы возвратиться
скаляр

`col` — Столбцы к виду
скаляр | вектор

`вар` Переменные к виду
скаляр | вектор | имя переменной | массив ячеек | `'RowNames'`

`direction` — Сортировка направления
`'descend'` (значение по умолчанию) | `'ascend'` | массив ячеек

`method` — Метод сравнения для комплексных чисел
`'auto'` (значение по умолчанию) | `'real'` | `'abs'`

`B` Требуемые строки
массив

`I` Индексы строки
вектор

"Высокие" массивы
Осуществление вычислений с массивами, которые содержат больше строк, чем помещается в памяти.