addvars

테이블 또는 타임테이블에 변수 추가

구문

T2 = addvars(T1,var1,...,varN)

T2 = addvars(T1,var1,...,varN,'After',location)

T2 = addvars(T1,var1,...,varN,'Before',location)

T2 = addvars(___,'NewVariableNames',newNames)

설명

T2 = addvars(T1,var1,...,varN)은 T1의 마지막 변수 오른쪽에 var1,…,varN으로 지정된 배열을 새 변수로 추가합니다. 입력 배열 var1,…,varN는 임의 유형의 배열, table형, timetable형일 수 있습니다. 모든 입력 인수는 행 개수가 T1과 동일해야 합니다.

예를 들어, T1의 마지막 변수 뒤에 A라는 열 벡터를 추가하려면 T2 = addvars(T1,A)를 사용합니다.

T2 = addvars(T1,var1,...,varN,'After',location)은 location으로 표시된 테이블 변수의 오른쪽에 변수를 삽입합니다. location을 변수 이름이나 숫자형 또는 논리형 인덱스로 지정할 수 있습니다.

예를 들어, 테이블 변수 var2 뒤에 A라는 열 벡터를 삽입하려면 T2 = addvars(T1,A,'After','var2')를 사용합니다.

T2 = addvars(T1,var1,...,varN,'Before',location)은 location으로 표시된 테이블 변수의 왼쪽에 변수를 삽입합니다.

예를 들어, 테이블 변수 var3 앞에 A라는 열 벡터를 삽입하려면 T2 = addvars(T1,A,'Before','var3')을 사용합니다.

T2 = addvars(___,'NewVariableNames',newNames)는 newNames로 지정된 이름을 사용하여 T2에 추가된 변수의 이름을 바꿉니다. newNames의 이름 개수는 추가된 변수의 개수와 동일해야 합니다. 이 구문은 위에 열거된 구문 중 하나의 입력 인수에 사용할 수 있습니다.

예제

변수 추가하기

테이블을 만듭니다. 그런 다음 작업 공간의 변수를 테이블에 추가합니다.

patients.mat 파일에서 배열을 불러옵니다. 환자의 이름, 나이, 신장, 체중이 포함된 테이블을 만듭니다. 그런 다음 처음 세 개의 행을 표시합니다.

load patients
T1 = table(LastName,Age,Height,Weight);
head(T1,3)

      LastName      Age    Height    Weight
    ____________    ___    ______    ______

    {'Smith'   }    38       71       176  
    {'Johnson' }    43       69       163  
    {'Williams'}    38       64       131  

작업 공간 변수 Gender, Smoker를 테이블에 추가합니다.

T2 = addvars(T1,Gender,Smoker);
head(T2,3)

      LastName      Age    Height    Weight      Gender      Smoker
    ____________    ___    ______    ______    __________    ______

    {'Smith'   }    38       71       176      {'Male'  }    true  
    {'Johnson' }    43       69       163      {'Male'  }    false 
    {'Williams'}    38       64       131      {'Female'}    false 

지정된 위치에 변수 삽입하기

테이블을 만듭니다. 그런 다음 테이블에서 지정된 위치의 앞과 뒤에 변수를 삽입합니다.

patients.mat 파일에서 배열을 불러옵니다. 환자의 이름과 성별이 포함된 테이블을 만듭니다. 그런 다음 처음 세 개의 행을 표시합니다.

load patients
T1 = table(LastName,Gender);
head(T1,3)

      LastName        Gender  
    ____________    __________

    {'Smith'   }    {'Male'  }
    {'Johnson' }    {'Male'  }
    {'Williams'}    {'Female'}

테이블 변수 Gender 앞에 작업 공간 변수 Age를 삽입합니다. 테이블 변수를 이름으로 참조하려면 변수 이름을 문자형 벡터로 지정하십시오.

T2 = addvars(T1,Age,'Before','Gender');
head(T2,3)

      LastName      Age      Gender  
    ____________    ___    __________

    {'Smith'   }    38     {'Male'  }
    {'Johnson' }    43     {'Male'  }
    {'Williams'}    38     {'Female'}

Age 뒤에 변수를 더 삽입합니다. Age는 T2의 테이블 변수이므로, 이름을 문자형 벡터로 지정합니다.

T3 = addvars(T2,Height,Weight,'After','Age');
head(T3,3)

      LastName      Age    Height    Weight      Gender  
    ____________    ___    ______    ______    __________

    {'Smith'   }    38       71       176      {'Male'  }
    {'Johnson' }    43       69       163      {'Male'  }
    {'Williams'}    38       64       131      {'Female'}

첫 번째 테이블 변수 뒤에 Smoker를 삽입합니다. 테이블에서 이름 대신 위치로 변수를 지정할 수 있습니다.

T4 = addvars(T3,Smoker,'After',1);
head(T4,3)

      LastName      Smoker    Age    Height    Weight      Gender  
    ____________    ______    ___    ______    ______    __________

    {'Smith'   }    true      38       71       176      {'Male'  }
    {'Johnson' }    false     43       69       163      {'Male'  }
    {'Williams'}    false     38       64       131      {'Female'}

변수 이름 바꾸기

테이블을 만듭니다. 변수를 추가하고 테이블에서 이들 변수에 새 이름을 지정합니다.

먼저, 작업 공간 변수로 테이블을 만듭니다.

load patients
T1 = table(LastName,Age,Gender,Smoker);
head(T1,3)

      LastName      Age      Gender      Smoker
    ____________    ___    __________    ______

    {'Smith'   }    38     {'Male'  }    true  
    {'Johnson' }    43     {'Male'  }    false 
    {'Williams'}    38     {'Female'}    false 

Diastolic과 Systolic을 2개 열로 구성된 행렬로 결합합니다. 새 테이블 변수의 이름을 BloodPressure로 지정합니다.

T2 = addvars(T1,[Diastolic Systolic],'NewVariableNames','BloodPressure');
head(T2,3)

      LastName      Age      Gender      Smoker    BloodPressure
    ____________    ___    __________    ______    _____________

    {'Smith'   }    38     {'Male'  }    true        93    124  
    {'Johnson' }    43     {'Male'  }    false       77    109  
    {'Williams'}    38     {'Female'}    false       83    125  

Height와 Weight를 새 테이블 변수로 추가합니다. 이를 Inches와 Pounds로 이름을 바꿉니다.

T3 = addvars(T2,Height,Weight,'Before','Smoker','NewVariableNames',{'Inches','Pounds'});
head(T3,3)

      LastName      Age      Gender      Inches    Pounds    Smoker    BloodPressure
    ____________    ___    __________    ______    ______    ______    _____________

    {'Smith'   }    38     {'Male'  }      71       176      true        93    124  
    {'Johnson' }    43     {'Male'  }      69       163      false       77    109  
    {'Williams'}    38     {'Female'}      64       131      false       83    125  

입력 인수

T1 — 입력 테이블

테이블 | 타임테이블

입력 테이블로, table형 또는 timetable형으로 지정됩니다.

var1,...,varN — 출력 테이블에 추가할 변수

배열, table형, timetable형

출력 테이블에 추가할 변수로, 배열, table형 및 timetable형으로 지정됩니다. var1,...,varN으로 지정된 변수는 모두 입력 테이블 T1과 동일한 개수의 행을 가져야 합니다.

예: T2 = addvars(T1,A)는 작업 공간 변수 A를 마지막 테이블 변수의 오른쪽에 삽입합니다.

예: T2 = addvars(T1,X,Y,Z)는 작업 공간 변수 X, Y, Z를 삽입합니다.

location — 추가된 변수를 삽입할 위치

문자형 벡터 | string형 스칼라 | 정수 | 논리형 배열

추가된 변수를 삽입할 위치로, 문자형 벡터, string형 스칼라, 정수 또는 논리형 배열로 지정됩니다.

• location이 문자형 벡터 또는 string형 스칼라인 경우, 이는 입력 테이블 T1에 있는 변수의 이름입니다.

• location이 정수 n인 경우, 이는 T1에 있는 n번째 변수를 지정합니다.

• location이 n번째 요소가 1(true)인 논리형 배열인 경우, 이는 T1에 있는 n번째 변수를 지정합니다. 나머지 모든 location의 요소는 0(false)이어야 합니다.

예: T2 = addvars(T1,Latitude,'Before','Longitude')는 작업 공간 변수 Latitude를 테이블 변수 Longitude의 왼쪽에 삽입합니다.

예: T2 = addvars(T1,Y,Z,'After','X')는 작업 공간 변수 Y와 Z를 테이블 변수 X의 오른쪽에 삽입합니다.

newNames — 추가된 변수의 이름

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

추가된 변수의 이름으로, 문자형 벡터, 문자형 벡터로 구성된 셀형 배열 또는 string형 배열로 지정됩니다.

예: T2 = addvars(T1,lat,lon,'NewVariableNames',{'Latitude','Longitude'})는 작업 공간 변수 lat와 lon을 삽입하고 그에 대응하는 테이블 변수의 이름을 'Latitude'와 'Longitude'로 지정합니다.

제한 사항

• 입력 이름 'Before', 'After' 및 'NewVariableNames'에는 작은따옴표를 사용하십시오. 가변 입력값과 혼동되지 않도록 이 이름들에는 큰따옴표로 묶인 string형 스칼라(예: "Before")를 사용하지 마십시오.

확장 기능

tall형 배열

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

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

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

스레드 기반 환경

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

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

분산 배열

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

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

버전 내역

R2018a에 개발됨

참고 항목

mergevars | movevars | removevars | splitvars | renamevars

도움말 항목

• 테이블 변수 추가, 삭제 및 재배열하기
• 테이블에 행 추가나 삭제하기
• 테이블의 데이터에 액세스하기
• 테이블 변수 이름 바꾸기 및 설명하기
• 테이블에서 정리되지 않은 데이터와 누락된 데이터 정리하기