最新のリリースでは、このページがまだ翻訳されていません。 このページの最新版は英語でご覧になれます。

unique

配列の一意の値

構文

C = unique(A)

C = unique(A,setOrder)

C = unique(A,occurrence)

C = unique(A,___,'rows')

C = unique(A,'rows',___)

[C,ia,ic] = unique(___)

[C,ia,ic] = unique(A,'legacy')

[C,ia,ic] = unique(A,'rows','legacy')

[C,ia,ic] = unique(A,occurrence,'legacy')

[C,ia,ic] = unique(A,'rows',occurrence,'legacy')

説明

C = unique(A) は A と同じデータを、繰り返しを除いて返します。C は並べ替られた順序になります。

• A が table または timetable の場合、unique は A の一意の行を並べ替えられた順序で返します。timetable の場合、unique は、行が一意であるかどうかを判別するときに行時間と行の値を考慮し、出力 timetable C を行時間で並べ替えます。

C = unique(A,setOrder) は、A の一意の値を特定の順序で返します。setOrder には 'sorted' (既定) または 'stable' を指定できます。

C = unique(A,occurrence) は、繰り返しの値が存在する場合に返すインデックスを指定します。occurrence には 'first' (既定) または 'last' を指定できます。

C = unique(A,___,'rows') と C = unique(A,'rows',___) は、A の各行を単一のエンティティとして扱い、A の一意の行を並べ替えられた順序で返します。A の指定は必須ですが、setOrder または occurrence はオプションで指定できます。

'rows' オプションは cell 配列をサポートしません。

[C,ia,ic] = unique(___) はまた、前述の任意の構文を使用してインデックス ベクトル ia および ic も返します。

• A がベクトルの場合、C = A(ia) かつ A = C(ic) です。

• A が行列または配列の場合、C = A(ia) かつ A(:) = C(ic) です。

• 'rows' オプションが指定されている場合、C = A(ia,:) および A = C(ic,:)。

• A が table または timetable の場合、C = A(ia,:) かつ A = C(ic,:) です。

[C,ia,ic] = unique(A,'legacy')、[C,ia,ic] = unique(A,'rows','legacy')、[C,ia,ic] = unique(A,occurrence,'legacy') および [C,ia,ic] = unique(A,'rows',occurrence,'legacy') は、R2012b およびそれ以前のリリースの関数 unique の動作を維持します。

'legacy' オプションは categorical 配列、datetime 配列、duration 配列、calendarDuration 配列、table、timetable をサポートしません。

例

ベクトルの一意の値

繰り返しの値を含むベクトルを定義します。

A = [9 2 9 5];

A の一意の値を求めます。

C = unique(A)

C = 1×3

     2     5     9

テーブルの一意の行

繰り返しのデータを含むテーブルを定義します。

Name = {'Fred';'Betty';'Bob';'George';'Jane'};
Age = [38;43;38;40;38];
Height = [71;69;64;67;64];
Weight = [176;163;131;185;131];

A = table(Age,Height,Weight,'RowNames',Name)

A=5×3 table
              Age    Height    Weight
              ___    ______    ______

    Fred      38       71       176  
    Betty     43       69       163  
    Bob       38       64       131  
    George    40       67       185  
    Jane      38       64       131  

A の一意の行を求めます。

C = unique(A)

C=4×3 table
              Age    Height    Weight
              ___    ______    ______

    Bob       38       64       131  
    Fred      38       71       176  
    George    40       67       185  
    Betty     43       69       163  

unique は、最初に変数 Age、その次に 2 番目の変数 Height に基づいて、並べ替えられた順序に A の行を返します。

一意の値とそのインデックス

繰り返しの値を含むベクトルを定義します。

A = [9 2 9 5];

A の一意の値および C = A(ia) および A = C(ic) であるインデックス ベクトル ia と ic を求めます。

[C, ia, ic] = unique(A)

C = 1×3

     2     5     9

ia = 3×1

     2
     4
     1

ic = 4×1

     3
     1
     3
     2

行列の一意の行

繰り返しの行をいくつか含む 12 行 3 列の行列を作成します。

A = randi(3,12,3)

A = 12×3

     3     3     3
     3     2     3
     1     3     3
     3     1     2
     2     2     2
     1     3     1
     1     3     3
     2     3     1
     3     2     1
     3     1     1
      ⋮

最初の 2 列のデータに基づいて A の一意の行を求めます。インデックス ベクトルの ia と ic を返すために 3 つの出力を指定します。

[C,ia,ic] = unique(A(:,1:2),'rows')

C = 6×2

     1     3
     2     2
     2     3
     3     1
     3     2
     3     3

ia = 6×1

     3
     5
     8
     4
     2
     1

ic = 12×1

     6
     5
     1
     4
     2
     1
     1
     3
     5
     4
      ⋮

ia を使用して A のインデックスを指定し、最初の 2 列に一意の要素の組み合わせをもつ行を取得します。

uA = A(ia,:)

uA = 6×3

     1     3     3
     2     2     2
     2     3     1
     3     1     2
     3     2     3
     3     3     3

一意の要素の数

ベクトル内の一意の要素を検出し、それぞれの一意の要素の出現回数を accumarray を使用してカウントします。

1 ～ 5 のランダムな整数から成るベクトルを作成します。

a = randi([1 5],200,1);

ベクトル内の一意の要素を検出します。インデックス ベクトルの ia と ic を返します。

[C,ia,ic] = unique(a);

C の各要素の a での出現回数をカウントします。ic を accumarray の最初の入力、1 を 2 番目の入力として指定し、関数で ic の添字の繰り返しがカウントされるようにします。結果を集計します。

a_counts = accumarray(ic,1);
value_counts = [C, a_counts]

value_counts = 5×2

     1    46
     2    36
     3    38
     4    39
     5    41

指定した順序のベクトルの一意の値

setOrder 引数を使って C の値の順序を指定します。

C の値を A の値と同じ順序にする場合、'stable' を指定します。

A = [9 2 9 5];
[C, ia, ic] = unique(A,'stable')

C = 1×3

     9     2     5

ia = 3×1

     1
     2
     4

ic = 4×1

     1
     2
     1
     3

または、関数 'sorted' を指定できます。

[C, ia, ic] = unique(A,'sorted')

C = 1×3

     2     5     9

ia = 3×1

     2
     4
     1

ic = 4×1

     3
     1
     3
     2

NaN を含む配列の一意の値

NaN を含むベクトルを定義します。

A = [5 5 NaN NaN];

A の一意の値を求めます。

C = unique(A)

C = 1×3

     5   NaN   NaN

unique は NaN 値を個別のものとして処理します。

数値誤差がある場合の一意の要素

ベクトル x を作成します。x の変換と復元を実行して、2 番目のベクトル y を取得します。この変換により y で丸め誤差が生じます。

x = (1:6)'*pi;
y = 10.^log10(x);

この誤差を求め、x と y が同一でないことを検証します。

x-y

ans = 6×1
10-14 ×

    0.0444
         0
         0
         0
         0
   -0.3553

unique を使用して、連結ベクトル [x;y] 内の一意の要素を検出します。関数 unique は厳密な比較を実行し、x の一部の値が y の値と厳密には等しくないと判定します。これらは、x-y の差が非ゼロである、同じ要素です。したがって、c には重複しているように "見える" 値が含まれています。

c = unique([x;y])

c = 8×1

    3.1416
    3.1416
    6.2832
    9.4248
   12.5664
   15.7080
   18.8496
   18.8496

uniquetol を使用して、わずかな誤差が許容される比較を実行します。uniquetol は許容誤差内にある要素を等価として扱います。

C = uniquetol([x;y])

C = 6×1

    3.1416
    6.2832
    9.4248
   12.5664
   15.7080
   18.8496

文字ベクトルの cell 配列に含まれる一意のエントリ

文字ベクトルの cell 配列を作成します。

A = {'one','two','twenty-two','One','two'};

A に含まれる一意の文字ベクトルを検索します。

C = unique(A)

C = 1x4 cell array
    {'One'}    {'one'}    {'twenty-two'}    {'two'}

末尾が空白文字の文字ベクトルの cell 配列

文字ベクトルの cell 配列 A を作成します。一部のベクトルは末尾に空白文字があります。

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

A に含まれる一意の文字ベクトルを検索します。

C = unique(A)

C = 1x6 cell array
    {'cat'}    {'dog'}    {'dog '}    {'fish'}    {'fish '}    {'horse'}

unique は、文字ベクトルの cell 配列内の末尾の空白文字を別個の文字として処理します。

unique のレガシ動作の保持

'legacy' フラグを使用して、コード内の R2012b およびそれ以前のリリースの unique の動作を保持します。

現在の動作における A の一意の要素を検出します。

A = [9 2 9 5];
[C1, ia1, ic1] = unique(A)

C1 = 1×3

     2     5     9

ia1 = 3×1

     2
     4
     1

ic1 = 4×1

     3
     1
     3
     2

A の一意の要素を検出し、レガシ動作を保持します。

[C2, ia2, ic2] = unique(A, 'legacy')

C2 = 1×3

     2     5     9

ia2 = 1×3

     2     4     3

ic2 = 1×4

     3     1     3     2

入力引数

A — 入力配列

配列

入力配列。

• A が table の場合、unique では行の名前が考慮されません。値が同じで名前が異なる 2 つの行は、等しいと見なされます。

• A が timetable の場合、unique は行時間を考慮します。値が同じで時間が異なる 2 つの行は、等しいとは見なされません。

また、A は次のクラス メソッドをもつオブジェクトにすることもできます。

• sort (または 'rows' オプションの sortrows)

• ne

オブジェクト クラスのメソッドは、相互に一貫していなければなりません。これらのオブジェクトは、同じルート クラスから導出した異種混合配列を含みます。たとえば、A はグラフィックス オブジェクトのハンドルの配列にすることができます。

setOrder — 順序フラグ

'sorted' (既定値) | 'stable'

'sorted' または 'stable' として指定される順序フラグは、C で値 (または行) の順序を示します。

順序フラグ	意味
'sorted'	C の値 (または行) は並べ替えられた順序で返されます。たとえば、C = unique([5 5 3 4],'sorted') は C = [3 4 5] を返します。
'stable'	C の値 (または行) は A と同じ順序で返されます。たとえば、C = unique([5 5 3 4],'stable') は C = [5 3 4] を返します。

データ型: char | string

occurrence — 発生フラグ

'first' (既定値) | 'last'

発生フラグ。'first' または 'last' として指定します。A で検出された繰り返しの値の最初のインデックスまたは最後のインデックスのいずれを ia に含めるかを指定します。

発生フラグ	意味
'last'	A に繰り返しの値 (または行) がある場合、ia は繰り返しの値の最後の発生に対するインデックスを含みます。たとえば、[C,ia,ic] = unique([9 9 9],'last','legacy') は ia = 3 を返します。これは、'legacy' フラグが指定されている場合の既定の動作です。
'first'	A に繰り返しの値 (または行) がある場合、ia は繰り返しの値の最初の発生に対するインデックスを含みます。たとえば、[C,ia,ic] = unique([9 9 9],'first') は ia = 1 を返します。これは既定の動作です。

データ型: char | string

出力引数

C — A の一意のデータ

配列

A の一意のデータ。配列として返されます。C のクラスは入力 A のクラスと同じです。C の形状は、入力がベクトルであるか行列であるかによって異なります。

• 'rows' フラグを指定しておらず、A が行ベクトルの場合、C は行ベクトルです。

• 'rows' フラグを指定しておらず、A が行ベクトルでない場合、C は列ベクトルです。

• 'rows' フラグを指定した場合、C は A の一意の行を含む行列です。

ia — A のインデックス

列ベクトル

A のインデックス。反復される要素の "最初の" 出現に対するインデックスの列ベクトルとして返されます。'legacy' フラグを指定した場合、ia は反復される要素の "最後の" 出現に対するインデックスを含む行ベクトルです。

これらのインデックスは通常 C = A(ia) を満たします。A がテーブルの場合や、'rows' オプションが指定されている場合、C = A(ia,:) です。

ic — C のインデックス

列ベクトル

C のインデックス。'legacy' フラグを指定しない場合、列ベクトルとして返されます。ic には、次のプロパティを満たすインデックスが含まれます。

• A がベクトルの場合、A = C(ic) です。

• A が行列または配列の場合、A(:) = C(ic) です。

• A がテーブルの場合や、'rows' オプションが指定されている場合、A = C(ic,:) です。

ヒント

• 許容誤差を使用して一意の浮動小数点数を求めるには uniquetol を使用します。

• 変数のサブセットに関する table または timetable の一意の行を求めるために、列の添字を使用できます。たとえば、unique(A(:,vars)) を使用できます。ここで、vars は、正の整数、正の整数のベクトル、変数名、変数名の cell 配列または論理ベクトルです。あるいは vartype を使用して、指定したタイプの変数を選択する添字を作成することもできます。

拡張機能

tall 配列

メモリの許容量を超えるような多数の行を含む配列を計算します。

この関数は tall 配列を制限付きでサポートしています。

• tall ベクトルおよび tall table には以下の構文を使用します。

  • C = unique(A)

  • [C,ia,ic] = unique(A)

• tall 行列には以下の構文を使用します。

  • C = unique(A,'rows')

  • [C,ia,ic] = unique(A,'rows')

詳細については、tall 配列を参照してください。

C/C++ コード生成

MATLAB® Coder™ を使用して C および C++ コードを生成します。

使用上の注意事項および制限事項:

• コード生成では、最初の引数として cell 配列をサポートしません。

• 'rows' オプションを指定しない場合、以下の点に注意してください。

  • 入力 A はベクトルでなければなりません。'legacy' オプションを指定した場合、入力 A は行ベクトルでなければなりません。

  • 可変サイズの行ベクトルで最初の次元は固定長 1 でなければなりません。可変サイズの列ベクトルで 2 番目の次元は固定長 1 でなければなりません。

  • [] の入力はサポートされていません。1 行 0 列または 0 行 1 列の入力 (zeros(1,0) など) を使用して、空集合を表します。

  • 'legacy' オプションを指定した場合、空の出力は 1 行 0 列の行ベクトルになります。0 行 0 列にはなりません。

• 'rows' オプションと 'legacy' オプションの両方を指定した場合、出力 ia および ic は列ベクトルになります。これらの出力が空の場合、出力 C が 0 行 0 列であっても、0 行 1 列になります。

• setOrder が 'stable' ではないか、'legacy' オプションを指定した場合、入力 A はあらかじめ昇順で並べ替えられていなければなりません。最初の出力 C は、昇順で並べ替えられています。

• 複素数入力は、single または double でなければなりません。

参考

intersect | ismember | issorted | setdiff | setxor | sort | union | uniquetol

R2006a より前に導入