объединение

Установите объединение двух массивов

Синтаксис

C = union(A,B)
C = union(A,B,setOrder)
C = union(A,B,___,'rows')
C = union(A,B,'rows',___)
[C,ia,ib] = union(___)
[C,ia,ib] = union(A,B,'legacy')
[C,ia,ib] = union(A,B,'rows','legacy')

Описание

пример

C = union(A,B) возвращает объединенные данные из A и B без повторений. C находится в отсортированном порядке.

  • Если A и B являются таблицами или расписаниями, то union возвращает объединенный набор строк из обеих таблиц. Для расписаний union принимает времена строки во внимание, чтобы определить равенство и сортирует выходное расписание C ко временам строки.

пример

C = union(A,B,setOrder) возвращает C в определенном порядке. setOrder может быть 'sorted' или 'stable'.

C = union(A,B,___,'rows') и C = union(A,B,'rows',___) обработайте каждую строку A и каждую строку B как одна сущности и возвратите объединенные строки в A и B без повторений. Вы должны задать A и B и опционально можете задать setOrder.

Опция 'rows' не поддерживает массивы ячеек, если одни из входных параметров не являются или категориальным массивом или массивом datetime.

пример

[C,ia,ib] = union(___) также возвращает индексные векторы ia и ib с помощью любого из предыдущих синтаксисов.

  • Обычно значения в C являются отсортированной комбинацией элементов A(ia) и B(ib).

  • Если опция 'rows' задана, то строки C являются отсортированной комбинацией строк A(ia,:) и B(ib,:).

  • Если A и B являются таблицами или расписаниями, то C является отсортированной комбинацией строк A(ia,:) и B(ib,:).

пример

[C,ia,ib] = union(A,B,'legacy') и [C,ia,ib] = union(A,B,'rows','legacy') сохраните поведение функции union от R2012b и предшествующих релизов.

Опция 'legacy' не поддерживает категориальные массивы, массивы datetime, массивы длительности, таблицы или расписания.

Примеры

свернуть все

Задайте два вектора со значением вместе.

A = [5 7 1]; 
B = [3 1 1];

Найдите объединение векторов A и B.

C = union(A,B)
C = 1×4

     1     3     5     7

Задайте две таблицы со строками вместе.

A = table([1:5]',['A';'B';'C';'D';'E'],logical([0;1;0;1;0]))
A=5×3 table
    Var1    Var2    Var3 
    ____    ____    _____

     1       A      false
     2       B      true 
     3       C      false
     4       D      true 
     5       E      false

B = table([1:2:10]',['A';'C';'E';'G';'I'],logical(zeros(5,1)))
B=5×3 table
    Var1    Var2    Var3 
    ____    ____    _____

     1       A      false
     3       C      false
     5       E      false
     7       G      false
     9       I      false

Найдите объединение таблиц A и B.

C = union(A,B)
C=7×3 table
    Var1    Var2    Var3 
    ____    ____    _____

     1       A      false
     2       B      true 
     3       C      false
     4       D      true 
     5       E      false
     7       G      false
     9       I      false

Задайте два вектора со значением вместе.

A = [5 7 1]; 
B = [3 1 1];

Найдите объединение векторов A и B, а также индексными векторами, ia и ib.

[C,ia,ib] = union(A,B)
C = 1×4

     1     3     5     7

ia = 3×1

     3
     1
     2

ib = 1

Значения в C являются общей стоимостью A(ia) и B(ib).

Задайте таблицу, A, пола, возраста и высоты для трех человек.

A = table(['M';'M';'F'],[27;52;31],[74;68;64],...
'VariableNames',{'Gender' 'Age' 'Height'},...
'RowNames',{'Ted' 'Fred' 'Betty'})
A=3×3 table
             Gender    Age    Height
             ______    ___    ______

    Ted        M       27       74  
    Fred       M       52       68  
    Betty      F       31       64  

Задайте таблицу, B с теми же переменными как A.

B = table(['F';'M'],[64;68],[31;47],...
'VariableNames',{'Gender' 'Height' 'Age'},...
'RowNames',{'Meg' 'Joe'})
B=2×3 table
           Gender    Height    Age
           ______    ______    ___

    Meg      F         64      31 
    Joe      M         68      47 

Найдите объединение таблиц A и B, а также индексные векторы, ia и ib.

[C,ia,ib] = union(A,B)
C=4×3 table
             Gender    Age    Height
             ______    ___    ______

    Betty      F       31       64  
    Ted        M       27       74  
    Joe        M       47       68  
    Fred       M       52       68  

ia = 3×1

     3
     1
     2

ib = 2

Данные для Meg и Betty являются тем же самым. union только возвращает индекс в A, который соответствует Betty.

Задайте две матрицы со строкой вместе.

A = [2 2 2; 0 0 1];
B = [1 2 3; 2 2 2; 2 2 2];

Найдите объединенные строки A и B без повторения, а также индексных векторов ia и ib.

[C,ia,ib] = union(A,B,'rows')
C = 3×3

     0     0     1
     1     2     3
     2     2     2

ia = 2×1

     2
     1

ib = 1

Строки C являются объединенными строками A(ia,:) и B(ib,:).

Используйте аргумент setOrder, чтобы задать упорядоченное расположение значений в C.

Задайте 'stable', если вы хотите, чтобы значения в C имели тот же порядок как в A и B.

A = [5 7 1]; 
B = [3 1 1];
[C,ia,ib] = union(A,B,'stable')
C = 1×4

     5     7     1     3

ia = 3×1

     1
     2
     3

ib = 1

Также можно задать порядок 'sorted'.

A = [5 7 1]; 
B = [3 1 1];
[C,ia,ib] = union(A,B,'sorted')
C = 1×4

     1     3     5     7

ia = 3×1

     3
     1
     2

ib = 1

Задайте два вектора, содержащие NaN.

A = [5 NaN 1]; 
B = [4 NaN NaN];

Найдите объединение векторов A и B.

C = union(A,B)
C = 1×6

     1     4     5   NaN   NaN   NaN

union обрабатывает значения NaN как отличные.

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

A = {'dog','cat','fish','horse'};

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

B = {'dog ','cat','fish ','horse'};

Объедините элементы A и B.

[C,ia,ib] = union(A,B)
C = 1x6 cell array
    {'cat'}    {'dog'}    {'dog '}    {'fish'}    {'fish '}    {'horse'}

ia = 4×1

     2
     1
     3
     4

ib = 2×1

     1
     3

union обрабатывает конечный пробел в массивах ячеек из символьных векторов как отличные символы.

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

A = ['A';'B';'C']
A = 3x1 char array
    'A'
    'B'
    'C'

class(A)
ans = 
'char'

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

B = [68 69 70]
B = 1×3

    68    69    70

class(B)
ans = 
'double'

union A и B возвращает символьный массив вектор-столбца.

C = union(A,B)
C = 6x1 char array
    'A'
    'B'
    'C'
    'D'
    'E'
    'F'

class(C)
ans = 
'char'

Создайте вектор символов, содержащий буквы a, b и c.

A = ['a';'b';'c'];
class(A)
ans = 
'char'

Создайте массив ячеек из символьных векторов, содержащий буквы c, d и e.

B = {'c','d','e'};
class(B)
ans = 
'cell'

Объедините элементы A и B.

C = union(A,B)
C = 5x1 cell array
    {'a'}
    {'b'}
    {'c'}
    {'d'}
    {'e'}

Результатом, C, является массив ячеек из символьных векторов.

class(C)
ans = 
'cell'

Используйте флаг 'legacy', чтобы сохранить поведение union от R2012b и предшествующих релизов в вашем коде.

Найдите объединение A и B с текущим поведением.

A = [5 7 1]; 
B = [3 1 1];
[C1,ia1,ib1] = union(A,B)
C1 = 1×4

     1     3     5     7

ia1 = 3×1

     3
     1
     2

ib1 = 1

Найдите объединение A и B, и сохраните устаревшее поведение.

A = [5 7 1]; 
B = [3 1 1];
[C2,ia2,ib2] = union(A,B,'legacy')
C2 = 1×4

     1     3     5     7

ia2 = 1×2

     1     2

ib2 = 1×2

     3     1

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

свернуть все

Входные массивы, заданные как числовые массивы, логические массивы, символьные массивы, строковые массивы, категориальные массивы, массивы datetime, массивы длительности, массивы ячеек из символьных векторов, таблицы или расписания. Если вы задаете опцию 'rows', A и B должны иметь одинаковое число столбцов.

A и B должны иметь тот же класс за следующими исключениями:

  • logical, char и все числовые классы могут объединиться с массивами double.

  • Массивы ячеек из символьных векторов могут объединиться с символьными массивами или строковыми массивами.

  • Категориальные массивы могут объединиться с символьными массивами, массивами ячеек из символьных векторов или строковыми массивами.

  • Массивы datetime могут объединиться с массивами ячеек векторов символов даты или одного векторов символов даты.

Существуют дополнительные требования для A и B на основе типа данных:

  • Если A и B являются оба порядковыми категориальными массивами, у них должны быть те же наборы категорий, включая их порядок. Если ни A, ни B не являются порядковыми, у них не должно быть тех же наборов категорий, и сравнение выполняется с помощью названий категории. В этом случае категории C являются отсортированным объединением категорий от A и B.

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

  • Если A и B являются массивами datetime, они должны быть сопоставимы друг с другом в том, задают ли они часовой пояс.

A и B также могут быть объектами со следующими методами класса:

  • sort (или sortrows для опции 'rows')

  • ne

Методы класса объекта должны быть сопоставимы друг с другом. Эти объекты включают разнородные массивы, выведенные от того же корневого класса. Например, A и B могут быть массивами указателей на графические объекты.

Прикажите, чтобы флаг, заданный как 'sorted' или 'stable', указал на порядок значений (или строки) в C.

Закажите флагЗначение
'sorted'Значения (или строки) в C возвращаются в отсортированном порядке. Например: C = union([5 5 3],[1 2],'sorted') возвращает C = [1 2 3 5].
'stable'Значения (или строки) в C возвращаются в том же порядке, как они появляются в A и B. Например: C = union([5 5 3],[1 2],'stable') возвращает C = [5 3 1 2].

Типы данных: char | string

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

свернуть все

Объединенные данные A и B, возвращенного как вектор, матрица, таблица или расписание. Если входные параметры A и B являются таблицами или расписаниями, то порядок переменных в C совпадает с порядком переменных в A.

Следующее описывает форму C, когда входные параметры являются векторами или матрицами и когда флаг 'legacy' не задан:

  • Если флаг 'rows' не задан, то C является вектор-столбцом, если и A и B не являются векторами - строками, в этом случае C является вектором - строкой. Например, union([],[1 2]) возвращает вектор-столбец.

  • Если флаг 'rows' задан, то C является матрицей, содержащей объединенные строки A и B.

Класс входных параметров A и B определяет класс C:

  • Если класс A и B является тем же самым, то C является тем же классом.

  • Если вы комбинируете char или не удваиваете числовой класс с double, то C является тем же классом как недвойной вход.

  • Если вы комбинируете класс logical с double, то C является double.

  • Если вы комбинируете массив ячеек из символьных векторов с char, то C является массивом ячеек из символьных векторов.

  • Если вы комбинируете категориальный массив с вектором символов, массивом ячеек из символьных векторов или строкой, то C является категориальным массивом.

  • Если вы комбинируете массив datetime с массивом ячеек векторов символов даты или одного вектора символов даты, то C является массивом datetime.

  • Если вы комбинируете массив строк с вектором символов или массивом ячеек из символьных векторов, то C является массивом строк.

Индексируйте к A, возвращенному как вектор-столбец, когда флаг 'legacy' не будет задан. ia указывает на значения (или строки) в A, которые способствуют объединению. Если значение (или строка) появляется многократно в A, то ia содержит индекс к первому вхождению значения (или строка). Если значение появляется и в A и в B, то ia содержит индекс к первому вхождению в A.

Индексируйте к B, возвращенному как вектор-столбец, когда флаг 'legacy' не будет задан. ib указывает на значения (или строки) в B, которые способствуют объединению. Если существует повторное значение (или строка) появляющийся исключительно в B, то ib содержит индекс к первому вхождению значения. Если значение (или строка) появляется и в A и в B, то ib не содержит индекс к значению (или строка).

Советы

  • Чтобы найти объединение относительно подмножества переменных из таблицы или расписания, можно использовать индексирование столбца. Например, можно использовать union(A(:,vars),B(:,vars)), где vars является положительным целым числом, вектором положительных целых чисел, имени переменной, массива ячеек имен переменных или логического вектора. Также можно использовать vartype, чтобы создать индекс, который выбирает переменные заданного типа.

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

Представлено до R2006a

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