ismissing

누락값 찾기

구문

TF = ismissing(A)

TF = ismissing(A,indicator)

TF = ismissing(___,OutputFormat=format)

설명

TF = ismissing(A)는 입력 데이터의 요소 중 표준 누락값이 있는 요소를 나타내는 논리형 배열을 반환합니다. TF의 크기는 A의 크기와 같습니다.

표준 누락값은 A의 데이터형에 따라 정의되며, A가 테이블인 경우 다음과 같이 각 변수의 데이터형에 따라 정의됩니다.

• NaN — double형, single형, duration형, calendarDuration형

• NaT — datetime

• <missing> — string

• <undefined> — categorical

• {''} — 문자형 벡터로 구성된 cell형

데이터형에 표준 누락값의 디폴트 정의가 없는 경우 ismissing(A)는 A와 동일한 크기의 논리값 0(false)으로 구성된 배열 또는 테이블을 반환합니다.

라이브 스크립트에 누락된 데이터 정리 작업을 추가하여 ismissing 기능을 대화형 방식으로 사용할 수 있습니다.

TF = ismissing(A,indicator)는 indicator에 있는 값을 누락값 표시자로 취급하여, 위에 열거된 구문에 나와 있는 모든 디폴트 표시자를 무시합니다. indicator는 하나의 표시자일 수도 있고 여러 개의 표시자일 수도 있습니다. 예를 들어, A가 double형의 배열인 경우 ismissing(A,[0 -99])는 NaN 대신 0과 –99를 누락된 숫자형 값으로 취급합니다.

TF = ismissing(___,OutputFormat=format)은 위에 열거된 구문에 대해 테이블 형식 데이터의 출력 유형을 지정합니다.

예제

벡터 내 NaN 값

NaN 값이 포함된 행 벡터 A를 만든 다음 A에서 이러한 값의 위치를 식별합니다.

A = [3 NaN 5 6 7 NaN NaN 9];
TF = ismissing(A)

TF = 1×8 logical array

   0   1   0   0   0   1   1   0

여러 데이터형이 포함된 테이블

다양한 데이터형의 변수가 있는 테이블을 만듭니다.

dblVar = [NaN; 2; 3; 4; 5; 6];
singleVar = single([1; NaN; 3; 4; 5; 6]);
cellstrVar = {'one'; 'two'; ''; 'four'; 'five'; 'six'};
categoryVar = categorical(["red"; "orange"; "yellow"; ""; "blue"; "indigo"]);
dateVar = [datetime(2015,1:4,15) NaT datetime(2015,6,15)]';
stringVar = ["a"; "b"; "c"; "d"; "e"; missing];

A = table(dblVar,singleVar,cellstrVar,categoryVar,dateVar,stringVar)

A=6×6 table
    dblVar    singleVar    cellstrVar    categoryVar      dateVar      stringVar
    ______    _________    __________    ___________    ___________    _________

     NaN           1       {'one'   }    red            15-Jan-2015    "a"      
       2         NaN       {'two'   }    orange         15-Feb-2015    "b"      
       3           3       {0×0 char}    yellow         15-Mar-2015    "c"      
       4           4       {'four'  }    <undefined>    15-Apr-2015    "d"      
       5           5       {'five'  }    blue                   NaT    "e"      
       6           6       {'six'   }    indigo         15-Jun-2015    <missing>

누락값이 있는 요소를 찾습니다.

ismissing은 누락값이 있는 A의 모든 대응 요소에 대해 논리값 1을 갖는 배열을 반환합니다. TF의 크기는 A의 크기와 같습니다.

TF = ismissing(A)

TF = 6×6 logical array

   1   0   0   0   0   0
   0   1   0   0   0   0
   0   0   1   0   0   0
   0   0   0   1   0   0
   0   0   0   0   1   0
   0   0   0   0   0   1

테이블에 누락값 표시자 사용

'NA', '', <missing>, -99, NaN, Inf가 누락값을 나타내는 테이블을 만듭니다. 그런 다음, 누락값이 있는 요소를 찾습니다.

dblVar = [NaN; 3; Inf; 7; 9];
int8Var = int8([1; 3; 5; 7; -99]);
cellstrVar = {'one'; 'three'; ''; 'NA'; 'nine'};
stringVar = ["A"; "C"; "E"; missing; "I"];

A = table(dblVar,int8Var,cellstrVar,stringVar)

A=5×4 table
    dblVar    int8Var    cellstrVar    stringVar
    ______    _______    __________    _________

     NaN          1      {'one'   }    "A"      
       3          3      {'three' }    "C"      
     Inf          5      {0×0 char}    "E"      
       7          7      {'NA'    }    <missing>
       9        -99      {'nine'  }    "I"      

누락값 표시자를 지정합니다. ismissing은 누락값이 있는 A의 모든 대응 요소에 대해 논리값 1을 갖는 배열을 반환합니다.

id = {'NA' '' string(missing) -99 NaN Inf};
TF = ismissing(A,id)

TF = 5×4 logical array

   1   0   0   0
   0   0   0   0
   1   0   1   0
   0   0   1   1
   0   1   0   0

ismissing은 문자형 배열의 후행 공백을 무시합니다. 따라서, 빈 문자형 벡터 ''이 누락값 표시자로 지정되므로 ismissing은 A.cellstrVar의 빈 문자형 벡터를 누락값으로 식별합니다.

입력 인수

A — 입력 데이터

벡터 | 행렬 | 다차원 배열 | 문자형 벡터로 구성된 셀형 배열 | 테이블 | 타임테이블

입력 데이터로, 벡터, 행렬, 다차원 배열, 문자형 벡터로 구성된 셀형 배열, table형 또는 timetable형으로 지정됩니다.

• A가 timetable형이면 ismissing은 테이블 데이터에 대해서만 동작하고 행 시간값으로 구성된 벡터의 NaT 값 및 NaN 값은 무시합니다.

• A가 셀형 배열이거나 셀형 배열 변수를 갖는 table형이면 ismissing은 셀형 배열에 문자형 벡터가 포함된 경우에만 누락된 값을 감지합니다.

데이터형: single | double | char | string | table | timetable | cell | categorical | datetime | duration | calendarDuration

indicator — 비표준 누락값 표시자

스칼라 | 벡터 | 셀형 배열

비표준 누락값 표시자로, ismissing 함수가 누락값으로 취급해야 하는 스칼라, 벡터 또는 값으로 구성된 셀형 배열로 지정됩니다.

• A가 배열인 경우 indicator는 스칼라 또는 벡터여야 합니다.

• A가 테이블 또는 타임테이블인 경우 indicator는 여러 데이터형을 요소로 가지는 셀형 배열일 수도 있습니다.

indicator를 지정하지 않으면 ismissing 함수는 다음과 같이 A의 데이터형에 따라 정의된 표준 누락값 표시자를 사용합니다.

• NaN — double형, single형, duration형, calendarDuration형

• NaT — datetime

• <missing> — string

• <undefined> — categorical

• {''} — 문자형 벡터로 구성된 cell형

indicator의 항목은 모든 표준 누락값 표시자를 재정의합니다. 표준 목록을 유지하면서 추가 표시자를 지정하려면 indicator에 missing을 요소로 포함합니다.

각 표시자는 A에서 동일한 클래스의 누락 요소를 식별하는 데 사용됩니다. 이러한 표시자는 다음과 같이 클래스가 서로 다른 A의 요소와도 일치합니다.

• double형 표시자는 A의 숫자형 항목과도 일치합니다.

• string형 표시자, char형 표시자, 문자형 벡터로 구성된 셀형 배열 표시자는 A의 categorical형 항목 및 string 항목과도 일치합니다.

• single형 표시자, 정수형 표시자, logical형 표시자는 A의 double형 요소와도 일치합니다.

예: TF = ismissing(A,0)은 0만 누락값으로 인식합니다.

예: TF = ismissing(A,["Unset" missing])은 categorical형 배열 A에서 categorical형 값의 기본 누락값 외에 Unset도 누락값으로 인식합니다.

예: TF = ismissing(T,{-99 missing})은 테이블 T에서 각 테이블 변수 유형의 기본 누락값 외에 -99도 누락값으로 인식합니다.

format — 테이블 형식 데이터의 출력 유형

"logical" (디폴트 값) | "tabular"

테이블 형식 데이터의 출력 유형으로, 다음 값 중 하나로 지정됩니다.

• "logical" — table형 또는 timetable형 입력 데이터의 경우 출력값 TF를 논리형 배열로 반환합니다.

• "tabular" — table형 입력 데이터의 경우 출력값 TF를 table형으로 반환합니다. timetable형 입력 데이터의 경우 출력값 TF를 timetable형으로 반환합니다.

배열 입력 데이터에는 출력 유형을 지정하는 것이 지원되지 않습니다.

예: ismissing(T,OutputFormat="tabular")

출력 인수

TF — 누락된 데이터 표시자

벡터 | 행렬 | 다차원 배열 | 테이블 | 타임테이블

누락된 데이터 표시자로, 벡터, 행렬, 다차원 배열, table형 또는 timetable형으로 반환됩니다. 값 1(true)은 F에서 이전에 누락되었다가 채워진 요소에 대응합니다. 값 0(false)은 변경되지 않은 요소에 대응합니다.

배열 입력 데이터의 경우 TF는 논리형 배열로, A와 크기가 동일합니다. 테이블 형식 입력 데이터의 경우, format은 TF가 논리형 배열인지 또는 논리형 변수를 가진 테이블이나 타임테이블인지 지정합니다.

데이터형: logical

팁

• 정수 변수는 NaN을 저장할 수 없으므로, -99처럼 다른 용도로 절대 사용되지 않을 특별한 정수 값을 사용하여누락된 정수 데이터를 나타내야 합니다.

• 누락값인 string형을 찾는 데 대한 자세한 내용은 빈 문자열과 누락값이 있는지 테스트하기 항목을 참조하십시오.

• 문자형이 아닌 벡터로 구성된 셀형 배열이나 구조체형 배열인 입력 데이터의 경우, ismissing은 false를 반환합니다. 구조체형 배열에서 누락값을 찾으려면, structfun 함수를 사용하여 구조체의 각 필드에 ismissing을 적용합니다. 문자형이 아닌 벡터로 구성된 셀형 배열에서 누락값을 찾으려면, cellfun 함수를 사용하여 셀형 배열의 각 셀에 ismissing을 적용합니다.

알고리즘

ismissing은 문자형 벡터로 구성된 셀형 배열, 문자형 배열 또는 categorical형 배열인 표시자에 대해 선행 공백과 후행 공백을 각각 다르게 처리합니다.

• 문자형 벡터로 구성된 셀형 배열의 경우 ismissing은 표시자 공백을 무시하지 않습니다. 모든 문자형 벡터가 정확하게 일치해야 합니다.

• 테이블 변수의 문자형 배열의 경우 ismissing은 표시자의 후행 공백을 무시합니다.

• categorical형 배열의 경우 ismissing은 표시자의 선행 공백과 후행 공백을 무시합니다.

대체 기능

라이브 편집기 작업

라이브 스크립트에 누락된 데이터 정리 작업을 추가하여 ismissing 기능을 대화형 방식으로 사용할 수 있습니다.

확장 기능

tall형 배열

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

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

C/C++ 코드 생성

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

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

• string형 입력 배열은 지원되지 않습니다.

GPU 코드 생성

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

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

스레드 기반 환경

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

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

분산 배열

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

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

버전 내역

R2013b에 개발됨

R2022b: 문자형 배열은 표준 누락값을 갖지 않음

문자형 배열은 표준 누락값에 대한 디폴트 정의를 갖지 않습니다. 따라서 ismissing은 빈 문자형 배열 요소(' ')를 누락값이 아닌 값으로 처리합니다. 예를 들어, ismissing(['a'; ' '])은 논리형 배열 [0; 0]을 반환합니다. 이전에는 [0; 1]을 반환했습니다.

빈 문자형 배열 요소를 누락된 것으로 처리하려면 누락값 표시자를 사용하여 빈 char을 누락된 것으로 정의하십시오. 예를 들어 ismissing(['a'; ' '],' ')은 빈 char을 누락값으로 지정하고 [0; 1]을 반환합니다.

R2022a: 논리형 출력값을 포함하는 테이블 또는 타임테이블 반환

table형 또는 timetable형 입력 데이터의 경우 OutputFormat 이름-값 인수를 'tabular'로 설정하여 논리형 배열 대신 테이블 형식 출력값 TF를 반환합니다.

R2022a: 표준 누락값이 없는 데이터형 허용

구문 ismissing(A)는 이제 입력 데이터형에 표준 누락값의 디폴트 정의가 없는 경우 false(0)를 반환합니다.

try/catch 블록 내의 코드와 같이 해당 입력값에 대해 MATLAB이 발생시키는 오류와 관련된 코드는 더 이상 이러한 오류를 포착하지 않을 수 있습니다.

참고 항목

함수

• isoutlier | standardizeMissing | anymissing | rmmissing | fillmissing | fillmissing2 | missing | isnan | isnat | isundefined | isempty | isundefined | any | all

라이브 편집기 작업

• 누락된 데이터 정리

앱

• 데이터 정리기

도움말 항목

• 라이브 편집기 작업을 사용하여 정리되지 않은 데이터 정리 및 극값 찾기
• MATLAB에서 누락된 데이터