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(Age,Height,Weight)

T1=100×3 table
    Age    Height    Weight
    ___    ______    ______

    38       71       176  
    43       69       163  
    38       64       131  
    40       67       133  
    49       64       119  
    46       68       142  
    33       64       142  
    40       68       180  
    28       68       183  
    31       66       132  
    45       68       128  
    42       66       137  
    25       71       174  
    39       72       202  
    36       65       129  
    48       71       181  
      ⋮

작업 공간 변수 Smoker와 LastName을 테이블에 추가합니다. LastName을 추가하기 전에 string형 배열로 변환합니다.

LastName = string(LastName);
T2 = addvars(T1,Smoker,LastName)

T2=100×5 table
    Age    Height    Weight    Smoker     LastName 
    ___    ______    ______    ______    __________

    38       71       176      true      "Smith"   
    43       69       163      false     "Johnson" 
    38       64       131      false     "Williams"
    40       67       133      false     "Jones"   
    49       64       119      false     "Brown"   
    46       68       142      false     "Davis"   
    33       64       142      true      "Miller"  
    40       68       180      false     "Wilson"  
    28       68       183      false     "Moore"   
    31       66       132      false     "Taylor"  
    45       68       128      false     "Anderson"
    42       66       137      false     "Thomas"  
    25       71       174      false     "Jackson" 
    39       72       202      true      "White"   
    36       65       129      false     "Harris"  
    48       71       181      true      "Martin"  
      ⋮

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

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

patients.mat 파일에서 배열을 불러옵니다. 환자의 이름과 위치가 포함된 테이블을 만듭니다.

load patients
LastName = string(LastName);
Location = string(Location);
T1 = table(LastName,Location)

T1=100×2 table
     LastName              Location          
    __________    ___________________________

    "Smith"       "County General Hospital"  
    "Johnson"     "VA Hospital"              
    "Williams"    "St. Mary's Medical Center"
    "Jones"       "VA Hospital"              
    "Brown"       "County General Hospital"  
    "Davis"       "St. Mary's Medical Center"
    "Miller"      "VA Hospital"              
    "Wilson"      "VA Hospital"              
    "Moore"       "St. Mary's Medical Center"
    "Taylor"      "County General Hospital"  
    "Anderson"    "County General Hospital"  
    "Thomas"      "St. Mary's Medical Center"
    "Jackson"     "VA Hospital"              
    "White"       "VA Hospital"              
    "Harris"      "St. Mary's Medical Center"
    "Martin"      "VA Hospital"              
      ⋮

테이블 변수 Location 앞에 작업 공간 변수 Age를 삽입합니다. 테이블 변수를 이름으로 참조하려면 변수 이름을 string형으로 지정합니다.

T2 = addvars(T1,Age,Before="Location")

T2=100×3 table
     LastName     Age             Location          
    __________    ___    ___________________________

    "Smith"       38     "County General Hospital"  
    "Johnson"     43     "VA Hospital"              
    "Williams"    38     "St. Mary's Medical Center"
    "Jones"       40     "VA Hospital"              
    "Brown"       49     "County General Hospital"  
    "Davis"       46     "St. Mary's Medical Center"
    "Miller"      33     "VA Hospital"              
    "Wilson"      40     "VA Hospital"              
    "Moore"       28     "St. Mary's Medical Center"
    "Taylor"      31     "County General Hospital"  
    "Anderson"    45     "County General Hospital"  
    "Thomas"      42     "St. Mary's Medical Center"
    "Jackson"     25     "VA Hospital"              
    "White"       39     "VA Hospital"              
    "Harris"      36     "St. Mary's Medical Center"
    "Martin"      48     "VA Hospital"              
      ⋮

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

T3 = addvars(T2,Height,Weight,After="Age")

T3=100×5 table
     LastName     Age    Height    Weight             Location          
    __________    ___    ______    ______    ___________________________

    "Smith"       38       71       176      "County General Hospital"  
    "Johnson"     43       69       163      "VA Hospital"              
    "Williams"    38       64       131      "St. Mary's Medical Center"
    "Jones"       40       67       133      "VA Hospital"              
    "Brown"       49       64       119      "County General Hospital"  
    "Davis"       46       68       142      "St. Mary's Medical Center"
    "Miller"      33       64       142      "VA Hospital"              
    "Wilson"      40       68       180      "VA Hospital"              
    "Moore"       28       68       183      "St. Mary's Medical Center"
    "Taylor"      31       66       132      "County General Hospital"  
    "Anderson"    45       68       128      "County General Hospital"  
    "Thomas"      42       66       137      "St. Mary's Medical Center"
    "Jackson"     25       71       174      "VA Hospital"              
    "White"       39       72       202      "VA Hospital"              
    "Harris"      36       65       129      "St. Mary's Medical Center"
    "Martin"      48       71       181      "VA Hospital"              
      ⋮

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

T4 = addvars(T3,Smoker,After=1)

T4=100×6 table
     LastName     Smoker    Age    Height    Weight             Location          
    __________    ______    ___    ______    ______    ___________________________

    "Smith"       true      38       71       176      "County General Hospital"  
    "Johnson"     false     43       69       163      "VA Hospital"              
    "Williams"    false     38       64       131      "St. Mary's Medical Center"
    "Jones"       false     40       67       133      "VA Hospital"              
    "Brown"       false     49       64       119      "County General Hospital"  
    "Davis"       false     46       68       142      "St. Mary's Medical Center"
    "Miller"      true      33       64       142      "VA Hospital"              
    "Wilson"      false     40       68       180      "VA Hospital"              
    "Moore"       false     28       68       183      "St. Mary's Medical Center"
    "Taylor"      false     31       66       132      "County General Hospital"  
    "Anderson"    false     45       68       128      "County General Hospital"  
    "Thomas"      false     42       66       137      "St. Mary's Medical Center"
    "Jackson"     false     25       71       174      "VA Hospital"              
    "White"       true      39       72       202      "VA Hospital"              
    "Harris"      false     36       65       129      "St. Mary's Medical Center"
    "Martin"      true      48       71       181      "VA Hospital"              
      ⋮

변수 이름 바꾸기

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

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

load patients
LastName = string(LastName);
T1 = table(LastName,Age,Smoker)

T1=100×3 table
     LastName     Age    Smoker
    __________    ___    ______

    "Smith"       38     true  
    "Johnson"     43     false 
    "Williams"    38     false 
    "Jones"       40     false 
    "Brown"       49     false 
    "Davis"       46     false 
    "Miller"      33     true  
    "Wilson"      40     false 
    "Moore"       28     false 
    "Taylor"      31     false 
    "Anderson"    45     false 
    "Thomas"      42     false 
    "Jackson"     25     false 
    "White"       39     true  
    "Harris"      36     false 
    "Martin"      48     true  
      ⋮

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

T2 = addvars(T1,[Diastolic Systolic],NewVariableNames="BloodPressure")

T2=100×4 table
     LastName     Age    Smoker    BloodPressure
    __________    ___    ______    _____________

    "Smith"       38     true        93    124  
    "Johnson"     43     false       77    109  
    "Williams"    38     false       83    125  
    "Jones"       40     false       75    117  
    "Brown"       49     false       80    122  
    "Davis"       46     false       70    121  
    "Miller"      33     true        88    130  
    "Wilson"      40     false       82    115  
    "Moore"       28     false       78    115  
    "Taylor"      31     false       86    118  
    "Anderson"    45     false       77    114  
    "Thomas"      42     false       68    115  
    "Jackson"     25     false       74    127  
    "White"       39     true        95    130  
    "Harris"      36     false       79    114  
    "Martin"      48     true        92    130  
      ⋮

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

T3 = addvars(T2,Height,Weight,Before="Smoker",NewVariableNames=["Inches" "Pounds"])

T3=100×6 table
     LastName     Age    Inches    Pounds    Smoker    BloodPressure
    __________    ___    ______    ______    ______    _____________

    "Smith"       38       71       176      true        93    124  
    "Johnson"     43       69       163      false       77    109  
    "Williams"    38       64       131      false       83    125  
    "Jones"       40       67       133      false       75    117  
    "Brown"       49       64       119      false       80    122  
    "Davis"       46       68       142      false       70    121  
    "Miller"      33       64       142      true        88    130  
    "Wilson"      40       68       180      false       82    115  
    "Moore"       28       68       183      false       78    115  
    "Taylor"      31       66       132      false       86    118  
    "Anderson"    45       68       128      false       77    114  
    "Thomas"      42       66       137      false       68    115  
    "Jackson"     25       71       174      false       74    127  
    "White"       39       72       202      true        95    130  
    "Harris"      36       65       129      false       79    114  
    "Martin"      48       71       181      true        92    130  
      ⋮

입력 인수

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로 지정합니다.

출력 인수

T2 — 추가 변수를 갖는 출력 테이블

테이블 | 타임테이블

추가 변수를 갖는 출력 테이블로, 테이블이나 타임테이블로 반환됩니다.

제한 사항

• 이름-값 인수에는 Name=Value 구문이 권장됩니다. 그러나 Name,Value 구문을 사용할 경우, 입력 이름 'Before', 'After', 'NewVariableNames'에 작은따옴표를 사용하십시오. 가변 입력값과 혼동되지 않도록 이 이름들에는 큰따옴표로 묶인 string형 스칼라(예: "Before")를 사용하지 마십시오.

확장 기능

tall형 배열

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

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

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

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

스레드 기반 환경

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

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

분산 배열

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

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

버전 내역

R2018a에 개발됨

참고 항목

mergevars | movevars | removevars | splitvars | renamevars

도움말 항목

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