ismember

데이터 집합의 멤버 찾기

구문

Lia = ismember(A,B)

Lia = ismember(A,B,"rows")

[Lia,Locb] = ismember(___)

[Lia,Locb] = ismember(___,"legacy")

설명

Lia = ismember(A,B)는 A의 데이터가 B에 있는 경우, 반환되는 배열의 그 위치에 1(true)이 있는 배열을 반환합니다. 배열의 다른 위치에는 논리값 0(false)이 있습니다.

• A와 B가 table형이나 timetable형인 경우 ismember는 각 행의 논리값을 반환합니다. timetable형인 경우 ismember는 행 시간값을 고려하여 동일한지를 판별합니다. 출력값 Lia는 열 벡터입니다.

Lia = ismember(A,B,"rows")는 A의 각 행과 B의 각 행을 단일 엔터티로 취급하고, A의 행이 B의 행이기도 한 경우 논리값 1(true)을 포함하는 열 벡터를 반환합니다. 배열의 다른 위치에는 논리값 0(false)이 있습니다.

"rows" 옵션은 입력값 중 하나가 categorical형 배열이나 datetime형 배열이 아닌 한, 셀형 배열을 지원하지 않습니다.

[Lia,Locb] = ismember(___)는 위에 열거된 구문 중 하나를 사용하여 배열 Locb도 반환합니다.

• 일반적으로, Locb는 B의 멤버인 A의 각 값에 대해 B에서 가장 작은 인덱스를 포함합니다. 논리값 0은 A가 B의 멤버가 아닌 경우를 나타냅니다.

• "rows" 옵션을 지정하면 Locb는 B의 행이기도 한 A의 각 행에 대해 B에서 가장 낮은 인덱스를 포함합니다. 논리값 0은 A가 B의 행이 아닌 경우를 나타냅니다.

• A와 B가 table형이나 timetable형인 경우 Locb는 B의 행이기도 한 A의 각 행에 대해 B에서 가장 낮은 인덱스를 포함합니다. 논리값 0은 A가 B의 행이 아닌 경우를 나타냅니다.

[Lia,Locb] = ismember(___,"legacy")는 위에 열거된 구문에 나와 있는 입력 인수 중 하나를 사용하여 R2012b와 이전 릴리스의 ismember 함수 동작을 유지합니다.

'legacy' 옵션은 categorical형 배열, datetime형 배열, duration형 배열, table형 또는 timetable형을 지원하지 않습니다.

예제

집합의 멤버인 값

공통된 값을 갖는 두 개의 벡터를 만듭니다.

A = [5 3 4 2]; 
B = [2 4 4 4 6 8];

A의 요소 중 B에도 있는 요소를 확인합니다.

Lia = ismember(A,B)

Lia = 1×4 logical array

   0   0   1   1

A(3)과 A(4)는 B에도 있습니다.

다른 테이블에도 있는 테이블 행

공통된 행을 갖는 두 개의 테이블을 만듭니다.

A = table([1:5]',["red";"green";"blue";"cyan";"magenta"],logical([0;1;0;1;0]))

A=5×3 table
    Var1      Var2       Var3 
    ____    _________    _____

     1      "red"        false
     2      "green"      true 
     3      "blue"       false
     4      "cyan"       true 
     5      "magenta"    false

B = table([1:2:10]',["red";"blue";"magenta";"yellow";"black"],logical(zeros(5,1)))

B=5×3 table
    Var1      Var2       Var3 
    ____    _________    _____

     1      "red"        false
     3      "blue"       false
     5      "magenta"    false
     7      "yellow"     false
     9      "black"      false

A의 행 중 B에도 있는 행을 확인합니다.

Lia = ismember(A,B)

Lia = 5×1 logical array

   1
   0
   1
   0
   1

행 A(1,:), A(3,:), A(5,:)은 B에도 있습니다.

집합의 멤버 및 값의 인덱스

공통된 값을 갖는 두 개의 벡터를 만듭니다.

A = [5 3 4 2]; 
B = [2 4 4 4 6 8];

A의 요소 중 B에도 있는 요소와, B에서 해당하는 위치를 확인합니다.

[Lia,Locb] = ismember(A,B)

Lia = 1×4 logical array

   0   0   1   1

Locb = 1×4

     0     0     2     1

A(3)에 대한 가장 작은 인덱스는 B(2)이며, A(4)는 B(1)에 위치합니다.

수치 오차가 있는 집합 멤버

벡터 x를 만듭니다. x를 변환한 후 이 변환된 값을 다시 역변환하여 두 번째 벡터 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

ismember를 사용하여 x의 요소 중 y에도 있는 요소를 찾습니다. ismember 함수는 정확한 비교를 수행한 후 x의 행렬 요소 중 일부가 y의 멤버가 아님을 확인합니다.

lia = ismember(x,y)

lia = 6×1 logical array

   0
   1
   1
   1
   1
   0

ismembertol을 사용하여 작은 허용오차로 비교를 수행합니다. ismembertol은 허용오차 범위 내에 있는 요소를 서로 같은 것으로 간주하여, x의 모든 요소가 y의 멤버임을 확인합니다.

LIA = ismembertol(x,y)

LIA = 6×1 logical array

   1
   1
   1
   1
   1
   1

다른 테이블의 행과 해당 위치

5명의 흡연 여부, 연령, 키를 포함하는 테이블 A를 만듭니다.

A = table([true;true;false;true;false],[27;52;31;46;35],[74;68;64;61;64],...
VariableNames=["Smoker" "Age" "Height"],...
RowNames=["Sanchez" "Johnson" "Li" "Diaz" "Brown"])

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

    Sanchez    true      27       74  
    Johnson    true      52       68  
    Li         false     31       64  
    Diaz       true      46       61  
    Brown      false     35       64  

A와 공통된 행을 갖는 테이블 B를 하나 더 만듭니다.

B = table([false;false;false;false],[47;31;35;23],[68;64;62;58],...
VariableNames=["Smoker" "Age" "Height"],...
RowNames=["Nguyen" "Cohen" "Jones" "Garcia"])

B=4×3 table
              Smoker    Age    Height
              ______    ___    ______

    Nguyen    false     47       68  
    Cohen     false     31       64  
    Jones     false     35       62  
    Garcia    false     23       58  

A의 행 중 B에도 있는 행과, B에서 해당하는 위치를 확인합니다.

[Lia,Locb] = ismember(A,B)

Lia = 5×1 logical array

   0
   0
   1
   0
   0

Locb = 5×1

     0
     0
     2
     0
     0

두 테이블 행의 이름이 달라도 값이 같으면 같은 것으로 간주됩니다. Li에 대한 동일한 데이터가 B(2,:)에 있으며 Cohen에 해당합니다.

세트에 속해 있는 행

하나의 공통된 행을 갖는 두 개의 행렬을 만듭니다.

A = [1 3 5 6; 2 4 6 8];
B = [2 4 6 8; 1 3 5 7; 2 4 6 8];

A의 행 중 B에도 있는 행과, B에서 해당하는 위치를 확인합니다.

[Lia, Locb] = ismember(A,B,"rows")

Lia = 2×1 logical array

   0
   1

Locb = 2×1

     0
     1

A(2,:)에 대한 가장 작은 인덱스는 B(1,:)입니다.

NaN 값을 포함하는 집합의 멤버

NaN을 포함하는 두 개의 벡터를 만듭니다.

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

A의 요소 중 B에도 있는 요소와, B에서 해당하는 위치를 확인합니다.

[Lia,Locb] = ismember(A,B)

Lia = 1×3 logical array

   1   0   0

Locb = 1×3

     1     0     0

ismember는 각각의 NaN 값을 서로 다른 값으로 취급합니다.

후행 공백이 있는 문자열

string형 배열 A를 만듭니다.

A = ["dog","cat","fish","horse"];

일부 요소에 후행 공백이 있는 또 다른 string형 배열 B를 만듭니다.

B = ["dog ","cat","fish ","horse"];

A의 문자열 중 B에도 있는 요소를 확인합니다.

[Lia,Locb] = ismember(A,B)

Lia = 1×4 logical array

   0   1   0   1

Locb = 1×4

     0     2     0     4

ismember는 string형 배열과 문자형 벡터로 구성된 셀형 배열에 있는 후행 공백을 별개의 문자로 취급합니다.

ismember의 레거시 동작 유지

R2012b를 비롯한 이전 릴리스와 동일한 방식으로 ismember 결과를 출력하려면 코드에서 "legacy" 플래그를 사용하십시오.

현재 동작으로 B의 멤버를 찾습니다.

A = [5 3 4 2]; 
B = [2 4 4 4 6 8];
[Lia1,Locb1] = ismember(A,B)

Lia1 = 1×4 logical array

   0   0   1   1

Locb1 = 1×4

     0     0     2     1

레거시 동작을 유지하여 B의 멤버를 찾습니다.

[Lia2,Locb2] = ismember(A,B,"legacy")

Lia2 = 1×4 logical array

   0   0   1   1

Locb2 = 1×4

     0     0     4     1

입력 인수

A — 쿼리 배열(Query Array)

배열 | 테이블 | 타임테이블

쿼리 배열로, 배열, 테이블 또는 타임테이블로 지정됩니다. "rows" 옵션을 지정할 경우 A와 B의 열 개수는 같아야 합니다.

A는 B와 동일한 클래스에 속해야 하며, 다음과 같은 예외가 있습니다.

• logical, char 및 모든 숫자형 클래스는 double형 배열과 함께 사용할 수 있습니다.

• string형 배열은 문자형 벡터 및 문자형 벡터로 구성된 셀형 배열과 함께 사용할 수 있습니다.

• categorical형 배열은 string형 배열, 문자형 벡터, 문자형 벡터로 구성된 셀형 배열과 함께 사용할 수 있습니다.

• datetime형 배열과 duration형 배열은 날짜와 시간을 표현하도록 형식이 지정된 string형 스칼라 및 문자형 벡터와 함께 사용할 수 있습니다.

데이터형에 따라 A와 B에 대한 다음과 같은 추가 요구 사항이 있습니다.

• A가 categorical형 배열인 경우 B는 categorical형 배열, string형 배열, 문자형 벡터 또는 문자형 벡터로 구성된 셀형 배열일 수 있습니다. 이 경우 두 번째 입력값 B는 범주 이름 집합입니다.

• A와 B가 모두 순서형 categorical형 배열인 경우 A와 B는 순서를 포함하여 동일한 범주 집합을 가져야 합니다.

  A와 B가 모두 순서형이 아니면 범주 집합이 동일할 필요가 없으며 범주 이름을 사용하여 비교가 수행됩니다.

• A가 table형이나 timetable형이면 B와 동일한 변수 이름을 가져야 합니다(순서는 제외).

  • table형인 경우 행 이름이 무시되기 때문에 두 행의 이름이 달라도 값이 같으면 같은 것으로 간주됩니다.

  • timetable형인 경우 행 시간값이 고려되기 때문에 두 행의 값이 같아도 시간값이 다르면 같은 것으로 간주되지 않습니다.

• A와 B가 datetime형 배열인 경우 두 배열 모두 표준 시간대를 지정하거나 표준 시간대를 지정하지 않아야 합니다.

또한, A는 다음 클래스 메서드를 갖는 객체일 수 있습니다.

• sort(또는 "rows" 옵션의 경우 sortrows)

• eq

• ne

객체 클래스 메서드는 서로 일치해야 합니다. 이 객체들은 동일한 루트 클래스에서 파생된 이종 배열을 포함합니다. 예를 들어, A는 그래픽스 객체에 대한 핸들로 구성된 배열일 수 있습니다.

B — 세트 배열

배열 | 테이블 | 타임테이블

집합 배열로, 배열, 테이블 또는 타임테이블로 지정됩니다. "rows" 옵션을 지정할 경우 A와 B의 열 개수는 같아야 합니다.

B는 A와 동일한 클래스에 속해야 하며, 다음과 같은 예외가 있습니다.

• logical, char 및 모든 숫자형 클래스는 double형 배열과 함께 사용할 수 있습니다.

• string형 배열은 문자형 벡터 및 문자형 벡터로 구성된 셀형 배열과 함께 사용할 수 있습니다.

• categorical형 배열은 string형 배열, 문자형 벡터, 문자형 벡터로 구성된 셀형 배열과 함께 사용할 수 있습니다.

• datetime형 배열과 duration형 배열은 날짜와 시간을 표현하도록 형식이 지정된 string형 스칼라 및 문자형 벡터와 함께 사용할 수 있습니다.

데이터형에 따라 A와 B에 대한 다음과 같은 추가 요구 사항이 있습니다.

• A가 categorical형 배열인 경우 B는 categorical형 배열, string형 배열, 문자형 벡터 또는 문자형 벡터로 구성된 셀형 배열일 수 있습니다. 이 경우 두 번째 입력값 B는 범주 이름 집합입니다.

• A와 B가 모두 순서형 categorical형 배열인 경우 A와 B는 순서를 포함하여 동일한 범주 집합을 가져야 합니다.

  A와 B가 모두 순서형이 아니면 범주 집합이 동일할 필요가 없으며 범주 이름을 사용하여 비교가 수행됩니다.

• A가 table형이나 timetable형이면 B와 동일한 변수 이름을 가져야 합니다(순서는 제외).

  • table형인 경우 행 이름이 무시되기 때문에 두 행의 이름이 달라도 값이 같으면 같은 것으로 간주됩니다.

  • timetable형인 경우 행 시간값이 고려되기 때문에 두 행의 값이 같아도 시간값이 다르면 같은 것으로 간주되지 않습니다.

• A와 B가 datetime형 배열인 경우 두 배열 모두 표준 시간대를 지정하거나 표준 시간대를 지정하지 않아야 합니다.

또한, B는 다음 클래스 메서드를 갖는 객체일 수 있습니다.

• sort(또는 "rows" 옵션의 경우 sortrows)

• eq

• ne

객체 클래스 메서드는 서로 일치해야 합니다. 이 객체들은 동일한 루트 클래스에서 파생된 이종 배열을 포함합니다. 예를 들어, B는 그래픽스 객체에 대한 핸들로 구성된 배열일 수 있습니다.

출력 인수

Lia — A에 대한 논리형 인덱스

벡터 | 행렬 | N차원 배열

A에 대한 논리형 인덱스로, A의 값(또는 행)이 B의 멤버인 경우 항상 논리값 1(true)을 포함하는 벡터, 행렬, N차원 배열 중 하나로 반환됩니다. 그렇지 않으면 논리값 0(false)을 포함합니다.

Lia는 "rows" 플래그를 지정하지 않은 경우 A와 크기가 같은 배열입니다.

"rows" 플래그를 지정했거나 A가 table형이나 timetable형인 경우 Lia는 A와 행 개수가 동일한 열 벡터입니다.

Locb — B에서의 위치

벡터 | 행렬 | N차원 배열

B에서의 위치로, 벡터, 행렬, N차원 배열 중 하나로 반환됩니다. "legacy" 플래그가 지정되지 않은 경우 Locb는 A에서 찾은 B의 값(또는 행)에 대한 가장 낮은 인덱스를 포함합니다. 논리값 0은 A가 B의 멤버가 아닌 경우를 나타냅니다.

Locb는 "rows" 플래그를 지정하지 않은 경우 A와 크기가 같은 배열입니다.

"rows" 플래그를 지정했거나 A가 table형이나 timetable형인 경우 Locb는 A와 행 개수가 동일한 열 벡터입니다.

팁

• 허용오차를 사용하여 부동소수점 숫자를 서로 비교하려면 ismembertol을 사용하십시오.

• 변수의 부분 집합에 대해 테이블이나 타임테이블 A의 행 중 B에도 있는 행을 찾으려면 열 콜론 첨자를 사용할 수 있습니다. 예를 들어, ismember(A(:,vars),B(:,vars))를 사용할 수 있습니다. 여기서 vars는 양의 정수, 양의 정수로 구성된 벡터, 변수 이름, string형 배열 또는 변수 이름으로 구성된 셀형 배열, 논리형 벡터 중 하나일 수 있습니다. 또는 vartype을 사용하여, 지정된 유형의 변수를 선택하는 첨자를 만들 수 있습니다.

확장 기능

tall형 배열

메모리에 담을 수 없을 정도로 많은 행을 가진 배열을 계산할 수 있습니다.

ismember 함수는 tall형 배열을 지원하지만 다음과 같은 사용법 관련 참고 및 제한 사항이 있습니다.

• A와 B가 모두 tall형 배열이면 둘 중 하나는 첫 번째 차원에 적용된 축소 연산(sum, prod, max 등)의 결과여야 합니다.

자세한 내용은 tall형 배열 항목을 참조하십시오.

C/C++ 코드 생성

MATLAB® Coder™를 사용하여 C 코드나 C++ 코드를 생성할 수 있습니다.

사용법 관련 참고 및 제한 사항:

• 코드 생성 시 첫 번째 인수나 두 번째 인수에 대해 string형 배열 또는 셀형 배열은 지원되지 않습니다.

• 복소수 입력값은 single형이거나 double형이어야 합니다.

• Code Generation for Complex Data with Zero-Valued Imaginary Parts (MATLAB Coder) 항목을 참조하십시오.

스레드 기반 환경

MATLAB®의 backgroundPool을 사용해 백그라운드에서 코드를 실행하거나 Parallel Computing Toolbox™의 ThreadPool을 사용해 코드 실행 속도를 높일 수 있습니다.

이 함수는 스레드 기반 환경을 완전히 지원합니다. 자세한 내용은 스레드 기반 환경에서 MATLAB 함수 실행하기 항목을 참조하십시오.

GPU 배열

Parallel Computing Toolbox™를 사용해 GPU(그래픽스 처리 장치)에서 실행하여 코드 실행 속도를 높일 수 있습니다.

ismember 함수는 GPU 배열 입력값을 지원하지만 다음과 같은 사용법 관련 참고 및 제한 사항이 있습니다.

• "legacy" 플래그는 지원되지 않습니다.

• 64비트 정수는 지원되지 않습니다.

자세한 내용은 GPU에서 MATLAB 함수 실행하기 (Parallel Computing Toolbox) 항목을 참조하십시오.

분산 배열

Parallel Computing Toolbox™를 사용하여 대규모 배열을 클러스터의 결합된 메모리에 걸쳐 분할할 수 있습니다.

사용법 관련 참고 및 제한 사항:

• "legacy" 플래그는 지원되지 않습니다.

자세한 내용은 분산 배열을 사용하여 MATLAB 함수 실행 (Parallel Computing Toolbox) 항목을 참조하십시오.

버전 내역

R2006a 이전에 개발됨

참고 항목

unique | intersect | union | issorted | setdiff | setxor | sort | ismembertol