movevars

테이블 또는 타임테이블에서 변수 이동

구문

T2 = movevars(T1,vars)

T2 = movevars(T1,vars,After=location)

T2 = movevars(T1,vars,Before=location)

설명

T2 = movevars(T1,vars)는 지정된 변수를 입력 테이블의 끝으로 이동합니다. 끝은 맨 오른쪽에 있는 변수입니다. (R2023a 이후)

예를 들어, var3이라는 테이블 변수를 T1의 끝으로 옮기려면 T2 = movevars(T1,'var3')을 사용합니다. T1의 마지막 변수 이름이 var5인 경우 이 구문은 var3을 var5의 오른쪽으로 옮깁니다.

T2 = movevars(T1,vars,After=location)은 지정된 테이블 변수를 location으로 표시된 테이블 변수의 오른쪽으로 옮깁니다. 이름, 위치 또는 논리형 인덱스로 구성된 배열을 사용하여 변수와 location을 지정할 수 있습니다. location으로 지정된 변수는 입력 테이블에 있는 임의 변수일 수 있습니다.

예를 들어, var3이라는 테이블 변수를 테이블 변수 var5 뒤로 옮기려면 T2 = movevars(T1,"var3",After="var5")를 사용합니다.

• R2023a 이전: 마지막 변수의 이름이나 위치를 모르는 경우에는 구문 T2 = movevars(T1,vars,After=width(T1))을 사용하여 vars를 테이블의 끝으로 옮길 수 있습니다. width 함수는 테이블에 포함된 변수의 개수를 반환합니다.

T2 = movevars(T1,vars,Before=location)은 vars로 지정된 테이블 변수를 location으로 지정된 변수의 왼쪽으로 이동합니다.

• vars를 테이블의 맨 앞으로 옮기려면 T2 = movevars(T1,vars,Before=1)을 사용합니다. 맨 앞은 첫 번째 테이블 변수의 왼쪽입니다.

예제

변수 이동하기

테이블을 만든 다음 변수를 한 번에 하나씩 이동합니다. 테이블에서 이름 또는 위치로 변수를 지정할 수 있습니다.

스프레드시트 데이터를 테이블로 읽어 들입니다.

T1 = readtable("outages.csv",TextType="string")

T1=1468×6 table
      Region          OutageTime        Loss     Customers     RestorationTime           Cause      
    ___________    ________________    ______    __________    ________________    _________________

    "SouthWest"    2002-02-01 12:18    458.98    1.8202e+06    2002-02-07 16:50    "winter storm"   
    "SouthEast"    2003-01-23 00:49    530.14    2.1204e+05                 NaT    "winter storm"   
    "SouthEast"    2003-02-07 21:15     289.4    1.4294e+05    2003-02-17 08:14    "winter storm"   
    "West"         2004-04-06 05:44    434.81    3.4037e+05    2004-04-06 06:10    "equipment fault"
    "MidWest"      2002-03-16 06:18    186.44    2.1275e+05    2002-03-18 23:23    "severe storm"   
    "West"         2003-06-18 02:49         0             0    2003-06-18 10:54    "attack"         
    "West"         2004-06-20 14:39    231.29           NaN    2004-06-20 19:16    "equipment fault"
    "West"         2002-06-06 19:28    311.86           NaN    2002-06-07 00:51    "equipment fault"
    "NorthEast"    2003-07-16 16:23    239.93         49434    2003-07-17 01:12    "fire"           
    "MidWest"      2004-09-27 11:09    286.72         66104    2004-09-27 16:37    "equipment fault"
    "SouthEast"    2004-09-05 17:48    73.387         36073    2004-09-05 20:46    "equipment fault"
    "West"         2004-05-21 21:45    159.99           NaN    2004-05-22 04:23    "equipment fault"
    "SouthEast"    2002-09-01 18:22    95.917         36759    2002-09-01 19:12    "severe storm"   
    "SouthEast"    2003-09-27 07:32       NaN    3.5517e+05    2003-10-04 07:02    "severe storm"   
    "West"         2003-11-12 06:12    254.09    9.2429e+05    2003-11-17 02:04    "winter storm"   
    "NorthEast"    2004-09-18 05:54         0             0                 NaT    "equipment fault"
      ⋮

Region이라는 변수를 Cause라는 변수 앞에 오도록 이동합니다.

T2 = movevars(T1,"Region",Before="Cause")

T2=1468×6 table
       OutageTime        Loss     Customers     RestorationTime       Region             Cause      
    ________________    ______    __________    ________________    ___________    _________________

    2002-02-01 12:18    458.98    1.8202e+06    2002-02-07 16:50    "SouthWest"    "winter storm"   
    2003-01-23 00:49    530.14    2.1204e+05                 NaT    "SouthEast"    "winter storm"   
    2003-02-07 21:15     289.4    1.4294e+05    2003-02-17 08:14    "SouthEast"    "winter storm"   
    2004-04-06 05:44    434.81    3.4037e+05    2004-04-06 06:10    "West"         "equipment fault"
    2002-03-16 06:18    186.44    2.1275e+05    2002-03-18 23:23    "MidWest"      "severe storm"   
    2003-06-18 02:49         0             0    2003-06-18 10:54    "West"         "attack"         
    2004-06-20 14:39    231.29           NaN    2004-06-20 19:16    "West"         "equipment fault"
    2002-06-06 19:28    311.86           NaN    2002-06-07 00:51    "West"         "equipment fault"
    2003-07-16 16:23    239.93         49434    2003-07-17 01:12    "NorthEast"    "fire"           
    2004-09-27 11:09    286.72         66104    2004-09-27 16:37    "MidWest"      "equipment fault"
    2004-09-05 17:48    73.387         36073    2004-09-05 20:46    "SouthEast"    "equipment fault"
    2004-05-21 21:45    159.99           NaN    2004-05-22 04:23    "West"         "equipment fault"
    2002-09-01 18:22    95.917         36759    2002-09-01 19:12    "SouthEast"    "severe storm"   
    2003-09-27 07:32       NaN    3.5517e+05    2003-10-04 07:02    "SouthEast"    "severe storm"   
    2003-11-12 06:12    254.09    9.2429e+05    2003-11-17 02:04    "West"         "winter storm"   
    2004-09-18 05:54         0             0                 NaT    "NorthEast"    "equipment fault"
      ⋮

네 번째 변수를 첫 번째 변수 뒤에 오도록 이동합니다.

T3 = movevars(T2,4,After=1)

T3=1468×6 table
       OutageTime       RestorationTime      Loss     Customers       Region             Cause      
    ________________    ________________    ______    __________    ___________    _________________

    2002-02-01 12:18    2002-02-07 16:50    458.98    1.8202e+06    "SouthWest"    "winter storm"   
    2003-01-23 00:49                 NaT    530.14    2.1204e+05    "SouthEast"    "winter storm"   
    2003-02-07 21:15    2003-02-17 08:14     289.4    1.4294e+05    "SouthEast"    "winter storm"   
    2004-04-06 05:44    2004-04-06 06:10    434.81    3.4037e+05    "West"         "equipment fault"
    2002-03-16 06:18    2002-03-18 23:23    186.44    2.1275e+05    "MidWest"      "severe storm"   
    2003-06-18 02:49    2003-06-18 10:54         0             0    "West"         "attack"         
    2004-06-20 14:39    2004-06-20 19:16    231.29           NaN    "West"         "equipment fault"
    2002-06-06 19:28    2002-06-07 00:51    311.86           NaN    "West"         "equipment fault"
    2003-07-16 16:23    2003-07-17 01:12    239.93         49434    "NorthEast"    "fire"           
    2004-09-27 11:09    2004-09-27 16:37    286.72         66104    "MidWest"      "equipment fault"
    2004-09-05 17:48    2004-09-05 20:46    73.387         36073    "SouthEast"    "equipment fault"
    2004-05-21 21:45    2004-05-22 04:23    159.99           NaN    "West"         "equipment fault"
    2002-09-01 18:22    2002-09-01 19:12    95.917         36759    "SouthEast"    "severe storm"   
    2003-09-27 07:32    2003-10-04 07:02       NaN    3.5517e+05    "SouthEast"    "severe storm"   
    2003-11-12 06:12    2003-11-17 02:04    254.09    9.2429e+05    "West"         "winter storm"   
    2004-09-18 05:54                 NaT         0             0    "NorthEast"    "equipment fault"
      ⋮

여러 개의 변수 지정하기

movevars 함수를 사용하여 여러 개의 테이블 변수를 이동합니다. 이름 또는 위치로 변수를 지정할 수 있습니다.

스프레드시트 데이터를 테이블로 읽어 들입니다.

T1 = readtable("outages.csv",TextType="string")

T1=1468×6 table
      Region          OutageTime        Loss     Customers     RestorationTime           Cause      
    ___________    ________________    ______    __________    ________________    _________________

    "SouthWest"    2002-02-01 12:18    458.98    1.8202e+06    2002-02-07 16:50    "winter storm"   
    "SouthEast"    2003-01-23 00:49    530.14    2.1204e+05                 NaT    "winter storm"   
    "SouthEast"    2003-02-07 21:15     289.4    1.4294e+05    2003-02-17 08:14    "winter storm"   
    "West"         2004-04-06 05:44    434.81    3.4037e+05    2004-04-06 06:10    "equipment fault"
    "MidWest"      2002-03-16 06:18    186.44    2.1275e+05    2002-03-18 23:23    "severe storm"   
    "West"         2003-06-18 02:49         0             0    2003-06-18 10:54    "attack"         
    "West"         2004-06-20 14:39    231.29           NaN    2004-06-20 19:16    "equipment fault"
    "West"         2002-06-06 19:28    311.86           NaN    2002-06-07 00:51    "equipment fault"
    "NorthEast"    2003-07-16 16:23    239.93         49434    2003-07-17 01:12    "fire"           
    "MidWest"      2004-09-27 11:09    286.72         66104    2004-09-27 16:37    "equipment fault"
    "SouthEast"    2004-09-05 17:48    73.387         36073    2004-09-05 20:46    "equipment fault"
    "West"         2004-05-21 21:45    159.99           NaN    2004-05-22 04:23    "equipment fault"
    "SouthEast"    2002-09-01 18:22    95.917         36759    2002-09-01 19:12    "severe storm"   
    "SouthEast"    2003-09-27 07:32       NaN    3.5517e+05    2003-10-04 07:02    "severe storm"   
    "West"         2003-11-12 06:12    254.09    9.2429e+05    2003-11-17 02:04    "winter storm"   
    "NorthEast"    2004-09-18 05:54         0             0                 NaT    "equipment fault"
      ⋮

Loss, Customer 및 Cause라는 변수를 첫 번째 변수 앞에 오도록 이동합니다.

T2 = movevars(T1,["Loss" "Customers" "Cause"],Before=1)

T2=1468×6 table
     Loss     Customers           Cause            Region          OutageTime       RestorationTime 
    ______    __________    _________________    ___________    ________________    ________________

    458.98    1.8202e+06    "winter storm"       "SouthWest"    2002-02-01 12:18    2002-02-07 16:50
    530.14    2.1204e+05    "winter storm"       "SouthEast"    2003-01-23 00:49                 NaT
     289.4    1.4294e+05    "winter storm"       "SouthEast"    2003-02-07 21:15    2003-02-17 08:14
    434.81    3.4037e+05    "equipment fault"    "West"         2004-04-06 05:44    2004-04-06 06:10
    186.44    2.1275e+05    "severe storm"       "MidWest"      2002-03-16 06:18    2002-03-18 23:23
         0             0    "attack"             "West"         2003-06-18 02:49    2003-06-18 10:54
    231.29           NaN    "equipment fault"    "West"         2004-06-20 14:39    2004-06-20 19:16
    311.86           NaN    "equipment fault"    "West"         2002-06-06 19:28    2002-06-07 00:51
    239.93         49434    "fire"               "NorthEast"    2003-07-16 16:23    2003-07-17 01:12
    286.72         66104    "equipment fault"    "MidWest"      2004-09-27 11:09    2004-09-27 16:37
    73.387         36073    "equipment fault"    "SouthEast"    2004-09-05 17:48    2004-09-05 20:46
    159.99           NaN    "equipment fault"    "West"         2004-05-21 21:45    2004-05-22 04:23
    95.917         36759    "severe storm"       "SouthEast"    2002-09-01 18:22    2002-09-01 19:12
       NaN    3.5517e+05    "severe storm"       "SouthEast"    2003-09-27 07:32    2003-10-04 07:02
    254.09    9.2429e+05    "winter storm"       "West"         2003-11-12 06:12    2003-11-17 02:04
         0             0    "equipment fault"    "NorthEast"    2004-09-18 05:54                 NaT
      ⋮

T2의 처음 4개의 변수를 RestorationTime 뒤에 오도록 이동합니다.

T3 = movevars(T2,[1:4],After="RestorationTime")

T3=1468×6 table
       OutageTime       RestorationTime      Loss     Customers           Cause            Region   
    ________________    ________________    ______    __________    _________________    ___________

    2002-02-01 12:18    2002-02-07 16:50    458.98    1.8202e+06    "winter storm"       "SouthWest"
    2003-01-23 00:49                 NaT    530.14    2.1204e+05    "winter storm"       "SouthEast"
    2003-02-07 21:15    2003-02-17 08:14     289.4    1.4294e+05    "winter storm"       "SouthEast"
    2004-04-06 05:44    2004-04-06 06:10    434.81    3.4037e+05    "equipment fault"    "West"     
    2002-03-16 06:18    2002-03-18 23:23    186.44    2.1275e+05    "severe storm"       "MidWest"  
    2003-06-18 02:49    2003-06-18 10:54         0             0    "attack"             "West"     
    2004-06-20 14:39    2004-06-20 19:16    231.29           NaN    "equipment fault"    "West"     
    2002-06-06 19:28    2002-06-07 00:51    311.86           NaN    "equipment fault"    "West"     
    2003-07-16 16:23    2003-07-17 01:12    239.93         49434    "fire"               "NorthEast"
    2004-09-27 11:09    2004-09-27 16:37    286.72         66104    "equipment fault"    "MidWest"  
    2004-09-05 17:48    2004-09-05 20:46    73.387         36073    "equipment fault"    "SouthEast"
    2004-05-21 21:45    2004-05-22 04:23    159.99           NaN    "equipment fault"    "West"     
    2002-09-01 18:22    2002-09-01 19:12    95.917         36759    "severe storm"       "SouthEast"
    2003-09-27 07:32    2003-10-04 07:02       NaN    3.5517e+05    "severe storm"       "SouthEast"
    2003-11-12 06:12    2003-11-17 02:04    254.09    9.2429e+05    "winter storm"       "West"     
    2004-09-18 05:54                 NaT         0             0    "equipment fault"    "NorthEast"
      ⋮

입력 인수

T1 — 입력 테이블

테이블 | 타임테이블

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

vars — 입력 테이블의 변수

string형 배열 | 문자형 벡터 | 문자형 벡터로 구성된 셀형 배열 | pattern형 스칼라 | 숫자형 배열 | 논리형 배열

입력 테이블의 변수로, string형 배열, 문자형 벡터, 문자형 벡터로 구성된 셀형 배열, pattern형 스칼라, 숫자형 배열 또는 논리형 배열로 지정됩니다.

location — 이동된 변수를 삽입할 위치

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

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

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

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

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

출력 인수

T2 — 이동된 변수를 갖는 출력 테이블

테이블 | 타임테이블

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

확장 기능

tall형 배열

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

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

C/C++ 코드 생성

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

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

• vars 입력 인수는 중복된 변수 이름을 포함할 수 없습니다.

• vars 입력 인수는 패턴 표현식을 지원하지 않습니다.

자세한 내용은 Code Generation for Tables (MATLAB Coder) 항목과 Table Limitations for Code Generation (MATLAB Coder) 항목을 참조하십시오.

GPU 코드 생성

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

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

스레드 기반 환경

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

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

분산 배열

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

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

버전 내역

R2018a에 개발됨

R2023a: After 이름-값 인수 없이 테이블 변수를 마지막 변수 뒤로 이동

이제 After 이름-값 인수를 지정하지 않고 변수를 마지막 변수 뒤로 옮길 수 있습니다. 이전 릴리스에서는 After 또는 Before 이름-값 인수를 지정하지 않고 movevars를 호출하면 오류가 발생했습니다.

참고 항목

addvars | mergevars | removevars | splitvars | renamevars

도움말 항목

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