rmmissing

누락된 요소 제거

구문

R = rmmissing(A)

R = rmmissing(A,dim)

R = rmmissing(___,Name,Value)

[R,TF] = rmmissing(___)

설명

R = rmmissing(A)는 배열 또는 테이블에서 누락된 요소를 제거합니다. A가 벡터인 경우 rmmissing은 누락된 데이터가 포함된 요소를 제거합니다. A가 행렬이나 테이블인 경우 rmmissing은 누락된 데이터가 포함된 행을 제거합니다.

누락값은 다음과 같이 A의 데이터형에 따라 정의됩니다.

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

• NaT — datetime

• <missing> — string

• <undefined> — categorical

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

A가 테이블이면 각 변수의 데이터형에 따라 해당 변수의 누락값이 정의됩니다.

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

R = rmmissing(A,dim)은 함수 연산이 수행될 A의 차원을 지정합니다. 기본적으로 rmmissing은 크기가 1이 아닌 첫 번째 차원을 따라 연산합니다.

R = rmmissing(___,Name,Value)는 하나 이상의 이름-값 인수를 사용하여 누락된 요소를 제거하기 위한 추가 파라미터를 지정합니다. 예를 들어, rmmissing(A,'MinNumMissing',n)을 사용하여 최소 n개의 누락값이 포함된 A의 행을 제거할 수 있습니다.

[R,TF] = rmmissing(___)은 제거된 A의 행 또는 열에 해당하는 논리형 벡터도 반환합니다.

예제

벡터의 누락 요소

누락 요소가 있는 벡터를 만들고 각 누락 요소를 제거합니다.

A = [1 3 NaN 6 NaN];
R = rmmissing(A)

R = 1×3

     1     3     6

테이블의 여러 데이터형

여러 데이터형이 포함된 테이블에서 불완전한 행을 제거합니다.

먼저, categorical, double, char 데이터형의 변수로 구성된 테이블을 만듭니다.

A = table(categorical({''; 'F'; 'M'}),[45; 32; NaN],{''; 'CA'; 'MA'},[6051; 7234; NaN],...
    'VariableNames',{'Gender' 'Age' 'State' 'ID'})

A=3×4 table
      Gender       Age      State        ID 
    ___________    ___    __________    ____

    <undefined>     45    {0×0 char}    6051
    F               32    {'CA'    }    7234
    M              NaN    {'MA'    }     NaN

누락된 데이터가 포함된 테이블의 행을 모두 제거합니다.

R = rmmissing(A)

R=1×4 table
    Gender    Age    State      ID 
    ______    ___    ______    ____

      F       32     {'CA'}    7234

Age 또는 ID 테이블 변수에 누락값이 있는 행만 제거합니다.

R = rmmissing(A,'DataVariables',{'Age','ID'})

R=2×4 table
      Gender       Age      State        ID 
    ___________    ___    __________    ____

    <undefined>    45     {0×0 char}    6051
    F              32     {'CA'    }    7234

또는 isnumeric 함수를 사용하여 연산을 수행할 숫자형 변수를 식별할 수도 있습니다.

R = rmmissing(A,'DataVariables',@isnumeric)

R=2×4 table
      Gender       Age      State        ID 
    ___________    ___    __________    ____

    <undefined>    45     {0×0 char}    6051
    F              32     {'CA'    }    7234

행렬 열의 여러 누락 요소

누락된 데이터가 있는 행렬을 생성한 다음 둘 이상의 누락값을 포함하는 열(두 번째 차원)을 모두 제거합니다. 새 행렬과 A의 어떤 열이 제거되었는지 표시하는 논리형 행 벡터를 반환합니다.

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

A = 3×10

   NaN   NaN     5     3   NaN     5     7   NaN     9     2
     8     9   NaN     1     4     5     6     5   NaN     5
   NaN     4     9     8     7     2     4     1   NaN     3

[R,TF] = rmmissing(A,2,'MinNumMissing',2)

R = 3×8

   NaN     5     3   NaN     5     7   NaN     2
     9   NaN     1     4     5     6     5     5
     4     9     8     7     2     4     1     3

TF = 1×10 logical array

   1   0   0   0   0   0   0   0   1   0

테이블의 비표준 누락값

테이블을 만들고 -99로 정의된 누락 요소를 제거합니다. 제거할 누락 요소의 위치를 나타내는 논리형 변수 테이블 loc를 만듭니다.

A = [1; 4; 9; -99; 3];
B = [9; 0; 6; 2; 1];
C = [-99; 4; 2; 3; 8];
T = table(A,B,C)

T=5×3 table
     A     B     C 
    ___    _    ___

      1    9    -99
      4    0      4
      9    6      2
    -99    2      3
      3    1      8

loc = T==-99

loc=5×3 table
      A        B        C  
    _____    _____    _____

    false    false    true 
    false    false    false
    false    false    false
    true     false    false
    false    false    false

그런 다음 MissingLocations 이름-값 인수를 사용하여 rmmissing의 알려진 누락 요소 위치를 지정합니다. 누락 요소가 제거된 데이터뿐만 아니라 제거된 행을 나타내는 논리형 벡터도 반환합니다.

[R,TF] = rmmissing(T,MissingLocations=loc)

R=3×3 table
    A    B    C
    _    _    _

    4    0    4
    9    6    2
    3    1    8

TF = 5×1 logical array

   1
   0
   0
   1
   0

입력 인수

A — 입력 데이터

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

입력 데이터로, 벡터, 행렬, 문자형 벡터로 구성된 셀형 배열, 테이블 또는 타임테이블로 지정됩니다.

• A가 timetable형인 경우 rmmissing(A)는 누락된 데이터가 포함된 A의 행을 제거하고, 이에 대응하는 시간 벡터의 요소도 제거합니다. 시간 벡터에 NaT 또는 NaN이 포함된 경우 rmmissing(A)는 시간 벡터에서 이를 제거하고, 이에 대응하는 A의 행도 제거합니다.

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

dim — 연산을 수행할 차원

1 | 2

연산을 수행할 차원으로, 1 또는 2로 지정됩니다. 차원을 지정하지 않을 경우, 디폴트 값은 크기가 1이 아닌 첫 번째 배열 차원이 됩니다.

m×n 입력 행렬 배열 A가 있다고 가정합니다.

• rmmissing(A,1)은 누락된 데이터가 포함된 A의 행을 제거합니다.

  

• rmmissing(A,2)는 누락된 데이터가 포함된 A의 열을 제거합니다.

  

이름-값 인수

선택적 인수 쌍을 Name1=Value1,...,NameN=ValueN으로 지정합니다. 여기서 Name은 인수 이름이고 Value는 대응값입니다. 이름-값 인수는 다른 인수 뒤에 와야 하지만, 인수 쌍의 순서는 상관없습니다.

예: rmmissing(A,DataVariables=["Temperature" "Altitude"])는 Temperature 또는 Altitude 변수에 누락된 데이터가 포함된 A의 행을 제거합니다.

R2021a 이전 릴리스에서는 쉼표를 사용하여 각 이름과 값을 구분하고 Name을 따옴표로 묶으십시오.

예: rmmissing(A,"DataVariables",["Temperature" "Altitude"])는 Temperature 또는 Altitude 변수에 누락된 데이터가 포함된 A의 행을 제거합니다.

MinNumMissing — 최소 누락 요소 개수

1 (디폴트 값) | 음이 아닌 스칼라

행 또는 열을 제거하기 위해 요구되는 누락 요소의 최소 개수로, 음이 아닌 스칼라(기본적으로 1임)로 지정됩니다.

예: rmmissing(A,'MinNumMissing',6)

MissingLocations — 알려진 누락 요소 표시자

벡터 | 행렬 | 테이블 | 타임테이블

R2024b 이후

알려진 누락 요소 표시자로, 논리형 벡터나 행렬 또는 논리형 변수를 가진 테이블이나 타임테이블로 지정됩니다. 값이 1(true)인 요소는 A의 누락된 요소의 위치를 나타냅니다. 값이 0(false)인 요소는 누락되지 않은 요소를 나타냅니다.

MissingLocations를 지정할 경우 rmmissing은 표준 누락값을 사용하지 않습니다. 대신 알려진 누락 요소 표시자의 요소를 사용하여 누락 요소를 정의합니다.

MissingLocations가 벡터나 행렬이라면 A와 크기가 같아야 합니다. MissingLocations가 테이블이나 타임테이블인 경우 연산을 수행할 입력 테이블 변수와 크기와 이름이 같은 논리형 변수를 포함해야 합니다.

데이터형: logical | table | timetable

DataVariables — 연산을 수행할 테이블 변수

스칼라 | 벡터 | 셀형 배열 | pattern형 | 함수 핸들 | 테이블 vartype 첨자

연산을 수행할 테이블 변수로, 다음 표에 있는 옵션 중 하나로 지정됩니다. DataVariables 값은 입력 테이블에서 누락값이 있는지 조사할 변수를 나타냅니다.

테이블에서 DataVariables로 지정되지 않은 다른 변수는 누락값이 있는지 조사되지 않은 채 출력값으로 전달됩니다.

인덱싱 방식	지정할 값	예제
변수 이름	string형 스칼라 또는 문자형 벡터 string형 배열 또는 문자형 벡터로 구성된 셀형 배열 pattern 객체	"A" 또는 'A' — A라는 변수 ["A" "B"] 또는 {'A','B'} — A 및 B라는 두 개의 변수 "Var"+digitsPattern(1) — "Var" 다음에 하나의 숫자가 오는 이름을 갖는 변수
변수 인덱스	테이블에서의 변수 위치를 나타내는 인덱스 번호 숫자로 구성된 벡터 logical형 벡터. 일반적으로 이 벡터는 변수의 개수와 길이가 같지만 후행 0(false) 값을 생략할 수 있습니다.	3 — 테이블의 세 번째 변수 [2 3] — 테이블의 두 번째 변수와 세 번째 변수 [false false true] — 세 번째 변수
함수 핸들	테이블 변수를 입력값으로 받고 logical형 스칼라를 반환하는 함수 핸들	@isnumeric — 숫자형 값을 포함하는 모든 변수
변수 유형	지정된 유형의 변수를 선택하는 vartype 첨자	vartype("numeric") — 숫자형 값을 포함하는 모든 변수

예: rmmissing(T,'DataVariables',["Var1" "Var2" "Var4"])

출력 인수

R — 누락된 요소가 제거된 데이터

벡터 | 행렬 | 테이블 | 타임테이블

누락된 요소가 제거된 데이터로, 벡터, 행렬, 테이블 또는 타임테이블로 반환됩니다. R의 크기는 제거된 행 또는 열의 개수에 따라 달라집니다.

TF — 제거된 요소 표시기

벡터

제거된 요소 표시기로, 논리형 벡터로 반환됩니다. 값 1(true)은 제거된 A의 행 또는 열에 해당합니다. 값 0(false)은 변경되지 않은 행과 열에 해당합니다. TF의 방향과 크기는 A 및 연산 차원에 따라 다릅니다.

데이터형: logical

팁

• 입력 데이터가 구조체형 배열이거나 문자형이 아닌 벡터로 구성된 셀형 배열인 경우, rmmissing은 어떤 요소도 제거하지 않습니다. 구조체형 배열에서 누락 요소를 제거하려면 structfun 함수를 사용하여 구조체의 각 필드에 rmmissing을 적용하십시오. 문자형이 아닌 벡터로 이루어진 셀형 배열에서 누락 요소를 제거하려면 cellfun 함수를 사용하여 셀형 배열의 각 셀에 rmmissing을 적용하십시오.

대체 기능

라이브 편집기 작업

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

확장 기능

tall형 배열

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

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

• DataVariables 이름-값 인수에는 함수 핸들을 지정할 수 없습니다.

• rmmissing(A,2)는 tall형 테이블에 지원되지 않습니다.

• MissingLocations의 값은 테이블 또는 타임테이블일 수 없습니다.

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

C/C++ 코드 생성

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

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

• table형 입력값의 경우 dim은 1이어야 합니다.

• MissingLocations 이름-값 인수는 지원되지 않습니다.

스레드 기반 환경

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

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

GPU 배열

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

rmmissing 함수는 GPU 배열을 완전히 지원합니다. GPU에서 이 함수를 실행하려면 입력 데이터를 gpuArray (Parallel Computing Toolbox)로 지정하십시오. 자세한 내용은 GPU에서 MATLAB 함수 실행하기 (Parallel Computing Toolbox) 항목을 참조하십시오.

분산 배열

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

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

• MissingLocations 인수에는 테이블 또는 타임테이블 입력값이 지원되지 않습니다.

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

버전 내역

R2016b에 개발됨

R2024b: 누락 요소 위치 정의

알려진 누락 요소 표시자를 사용하여 입력 데이터에서 누락 요소의 위치를 정의합니다. MissingLocations 이름-값 인수를 논리형 벡터나 행렬 또는 논리형 변수를 가진 테이블이나 타임테이블로 지정하여, 표준 누락값을 감지하는 대신 누락 요소 위치를 정의할 수 있습니다. 이전에는 MissingLocations를 벡터 또는 행렬로만 지정할 수 있었습니다.

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

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

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

rmmissing은 이제 입력 데이터형에 표준 누락값의 디폴트 정의가 없는 경우 오류를 반환하지 않습니다.

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

참고 항목

함수

• ismissing | standardizeMissing | anymissing | fillmissing | fillmissing2 | isnan | isnat | rmoutliers

라이브 편집기 작업

• 누락된 데이터 정리

앱

• 데이터 정리기

도움말 항목

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