isprotected

categorical형 배열의 범주가 보호되는지 확인

구문

tf = isprotected(A)

설명

tf = isprotected(A)는 categorical형 배열의 범주가 보호될 경우 논리값 1(true)을 반환합니다. 그렇지 않으면 isprotected는 논리값 0(false)을 반환합니다.

• 1 (true) — 새 값을 B에 할당할 때 값은 기존 범주 중 하나에 속해야 합니다. 따라서 동일한 범주의 배열만 결합시킬 수 있습니다. 새 범주를 B에 추가하려면 addcats 함수를 사용해야 합니다.

• 0 (false) — 새 값을 B에 대입할 때 범주가 자동으로 업데이트됩니다. 따라서 범주가 다른 (비순서형) categorical형 배열을 결합할 수 있습니다. 범주는 두 배열의 범주를 모두 포함하도록 업데이트될 수 있습니다.

예제

범주가 보호되는지 확인하기

객체 10개의 크기가 포함된 categorical형 배열을 만듭니다. 값 S, M, L에 대해 이름 small, medium, large를 각각 사용합니다.

valueset = ["S" "M" "L"];
catnames = ["small" "medium" "large"];
A = categorical(["M";"L";"S";"S";"M";"L";"M";"L";"M";"S"], ...
                valueset,catnames,Ordinal=true)

A = 10×1 categorical
     medium 
     large 
     small 
     small 
     medium 
     large 
     medium 
     large 
     medium 
     small 

A의 범주를 표시합니다.

categories(A)

ans = 3×1 cell
    {'small' }
    {'medium'}
    {'large' }

A의 범주가 보호되는지 확인합니다.

tf = isprotected(A)

tf = logical
   1

A는 순서형 categorical형 배열이므로 범주가 보호됩니다. 기존 범주 중 하나에 속하지 않는 새 값(예: A(11) = "xlarge")을 추가하려고 하면 오류가 반환됩니다.

먼저 addcats를 사용하여 새 범주 xlarge를 추가합니다.

A = addcats(A,"xlarge",After="large");

이제 범주가 존재하므로 xlarge에 값을 추가할 수 있습니다.

A(11) = "xlarge"

A = 11×1 categorical
     medium 
     large 
     small 
     small 
     medium 
     large 
     medium 
     large 
     medium 
     small 
     xlarge 

A는 이제 small < medium < large < xlarge와 같은 4개의 범주를 갖는 11×1 categorical형 배열입니다.

입력 인수

A — 입력 배열

categorical형 배열

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

순서형 categorical형 배열의 범주는 항상 보호됩니다.

출력 인수

tf — true 또는 false 결과

1 | 0

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

확장 기능

tall형 배열

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

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

C/C++ 코드 생성

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

이 함수는 코드 생성을 완전히 지원합니다. 자세한 내용은 Code Generation for Categorical Arrays (MATLAB Coder) 항목을 참조하십시오.

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

스레드 기반 환경

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

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

분산 배열

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

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

버전 내역

R2013b에 개발됨

참고 항목

categorical | categories

도움말 항목

• 보호된 categorical형 배열을 사용하기