iscategory

입력값이 범주의 이름인지 확인

구문

tf = iscategory(A,catnames)

설명

tf = iscategory(A,catnames)는 catnames의 데이터가 A의 범주에 있을 때 논리값 1(true)을 포함하는 배열을 반환합니다. 그렇지 않으면 iscategory는 논리값 0(false)을 반환합니다.

tf는 catnames와 크기가 동일합니다.

예제

이름이 범주인지 확인하기

categorical형 배열을 만듭니다.

A = categorical(["shirt" "pants"; "pants" "hat"; "shirt" "pants"])

A = 3×2 categorical
     shirt      pants 
     pants      hat   
     shirt      pants 

A의 범주가 의류 품목의 이름입니다. 의류 품목은 입력 배열의 고유한 값에서 가져옵니다.

categories(A)

ans = 3×1 cell
    {'hat'  }
    {'pants'}
    {'shirt'}

의류 품목의 이름인 shirt, pants, socks, shoes가 A의 범주인지 확인합니다.

catnames = ["shirt" "pants" "socks" "shoes"]

catnames = 1×4 string
    "shirt"    "pants"    "socks"    "shoes"

tf = iscategory(A,catnames)

tf = 1×4 logical array

   1   1   0   0

shirt와 pants는 A의 범주이지만, socks와 shoes는 A의 범주가 아닙니다.

iscategory는 범주 hat이 catnames에 포함되지 않았기 때문에 이 범주에 대해서는 어떠한 정보도 제공하지 않습니다.

대응하는 데이터가 없는 범주인지 테스트

categorical형 배열을 만듭니다.

data = ["plane" "car" "train" "car" "plane"];
categoriesOfData = ["boat" "car" "plane" "train"];
A = categorical(data,categoriesOfData)

A = 1×5 categorical
     plane      car      train      car      plane 

categories(A)

ans = 4×1 cell
    {'boat' }
    {'car'  }
    {'plane'}
    {'train'}

boat가 A의 범주인지 확인합니다.

tf = iscategory(A,"boat")

tf = logical
   1

iscategory는 A의 요소 중에 범주 boat에 속하는 요소가 없더라도 1(true)을 반환합니다.

패턴을 사용하여 범주 이름 일치시키기

categorical형 배열을 만듭니다.

C = categorical(["Y" "Yes" "Yeah" "N" "No" "Nope"])

C = 1×6 categorical
     Y      Yes      Yeah      N      No      Nope 

pattern을 사용하여 하나 이상의 범주 이름을 일치시킬 수 있습니다. 예를 들어 와일드카드 패턴을 사용하여 범주 이름이 Y로 시작하는지 확인합니다. wildcardPattern 함수를 사용하여 와일드카드 패턴을 만들 수 있습니다.

tf = iscategory(C,"Y" + wildcardPattern)

tf = logical
   1

범주 이름이 X로 시작하는지 확인합니다.

tf = iscategory(C,"X" + wildcardPattern)

tf = logical
   0

입력 인수

A — 입력 배열

categorical형 배열

입력 배열로, categorical형 배열로 지정됩니다.

catnames — 범주 이름

string형 배열 | 문자형 벡터 | 문자형 벡터로 구성된 셀형 배열 | pattern형 배열

범주 이름으로, string형 배열, 문자형 벡터, 문자형 벡터로 구성된 셀형 배열 또는 pattern 배열로 지정됩니다.

출력 인수

tf — true 또는 false 결과

1 | 0 | 논리형 배열

true 또는 false 결과로, logical 데이터형의 1이나 0으로 반환됩니다.

확장 기능

tall형 배열

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

iscategory 함수는 tall형 배열을 완전히 지원합니다. 자세한 내용은 tall형 배열 항목을 참조하십시오.

C/C++ 코드 생성

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

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

• catnames 입력 인수는 패턴 표현식을 지원하지 않습니다.

자세한 내용은 Code Generation for Categorical Arrays (MATLAB Coder) 항목을 참조하십시오.

GPU 코드 생성

GPU Coder™를 사용하여 NVIDIA® GPU용 CUDA® 코드를 생성할 수 있습니다.

C/C++ 코드 생성 섹션의 사용법 관련 참고 및 제한 사항을 참조하십시오. GPU 코드 생성에도 동일한 사용법 관련 참고 및 제한 사항이 적용됩니다.

스레드 기반 환경

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

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

분산 배열

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

iscategory 함수는 분산 배열을 완전히 지원합니다. 자세한 내용은 분산 배열을 사용하여 MATLAB 함수 실행 (Parallel Computing Toolbox) 항목을 참조하십시오.

버전 내역

R2013b에 개발됨

참고 항목

categories | categorical | removecats | mergecats | renamecats | reordercats | ismember | unique | setcats | addcats