array2timetable

동종 배열(Homogeneous Array)을 타임테이블로 변환

구문

TT = array2timetable(X,'RowTimes',rowTimes)

TT = array2timetable(X,'SampleRate',Fs)

TT = array2timetable(X,'TimeStep',dt)

TT = array2timetable(___,'StartTime',t0)

T = array2timetable(X,Name,Value)

설명

TT = array2timetable(X,'RowTimes',rowTimes)는 입력 배열을 타임테이블로 변환합니다. 입력 배열 X는 M×N 배열이고 벡터 rowTimes는 datetime형 값이나 duration형 값으로 구성된 M×1 벡터입니다. X의 각 열은 TT의 변수가 됩니다. rowTimes의 시간 값이 타임테이블의 행 레이블로 지정됩니다. TT는 M×N 타임테이블입니다.

타임테이블을 만들고 사용하는 방법에 대한 자세한 내용은 타임테이블 항목을 참조하십시오.

TT = array2timetable(X,'SampleRate',Fs)는 샘플 레이트 Fs를 사용하여 규칙적인 간격의 행 시간값을 계산합니다. Fs는 초당 샘플 수(Hz)를 지정하는 숫자형 스칼라입니다. 첫 번째 행 시간값은 0초입니다.

TT = array2timetable(X,'TimeStep',dt)는 시간 스텝 dt를 사용하여 규칙적인 간격의 행 시간값을 계산합니다. dt는 연속된 행 시간값 사이의 시간 길이를 지정하는 duration형 값 또는 calendarDuration형 값입니다. 첫 번째 행 시간값은 0초입니다.

TT = array2timetable(___,'StartTime',t0)은 0초 대신 시작 시간 t0을 첫 번째 행 시간값으로 지정합니다. 위에 열거된 두 구문 중 하나에서 'SampleRate' 또는 'TimeStep' 이름-값 쌍의 인수를 사용하여 규칙적인 타임테이블을 만들 경우, 이 구문을 사용할 수 있습니다.

T = array2timetable(X,Name,Value)는 하나 이상의 Name,Value 쌍 인수를 추가 옵션으로 지정하여 배열 X에서 타임테이블을 만들고자 할 때 사용합니다.

예를 들어, 타임테이블에 포함할 변수 이름을 지정할 수 있습니다.

예제

배열을 타임테이블로 변환하기

배열을 타임테이블로 변환합니다. duration형의 벡터를 행 시간값으로 추가합니다.

X = rand(5,3);
Time = seconds(1:5);
TT = array2timetable(X,'RowTimes',Time)

TT=5×3 timetable
    Time       X1         X2         X3   
    _____    _______    _______    _______

    1 sec    0.81472    0.09754    0.15761
    2 sec    0.90579     0.2785    0.97059
    3 sec    0.12699    0.54688    0.95717
    4 sec    0.91338    0.95751    0.48538
    5 sec    0.63236    0.96489    0.80028

타임테이블의 크기를 반환합니다. TT에는 5개 행과 3개의 변수가 있습니다. 행 시간값의 집합은 테이블 속성입니다. 테이블 변수에는 행 시간값이 포함되어 있지 않습니다.

size(TT)

ans = 1×2

     5     3

샘플 레이트 지정하기

샘플 레이트를 500Hz로 지정하고, 배열을 timetable형으로 변환합니다.

X = rand(5,3);
TT = array2timetable(X,'SampleRate',500)

TT=5×3 timetable
      Time         X1         X2         X3   
    _________    _______    _______    _______

    0 sec        0.81472    0.09754    0.15761
    0.002 sec    0.90579     0.2785    0.97059
    0.004 sec    0.12699    0.54688    0.95717
    0.006 sec    0.91338    0.95751    0.48538
    0.008 sec    0.63236    0.96489    0.80028

시간 스텝 지정하기

시간 스텝을 0.5초로 지정하고, 배열을 timetable형으로 변환합니다.

X = rand(5,3);
TT = array2timetable(X,'TimeStep',seconds(0.5))

TT=5×3 timetable
     Time        X1         X2         X3   
    _______    _______    _______    _______

    0 sec      0.81472    0.09754    0.15761
    0.5 sec    0.90579     0.2785    0.97059
    1 sec      0.12699    0.54688    0.95717
    1.5 sec    0.91338    0.95751    0.48538
    2 sec      0.63236    0.96489    0.80028

시작 시간 지정하기

시간 스텝을 15초로 지정하고, 시작 시간을 5분으로 지정합니다.

X = rand(5,3);
TT = array2timetable(X,'TimeStep',seconds(15),'StartTime',minutes(5))

TT=5×3 timetable
      Time        X1         X2         X3   
    ________    _______    _______    _______

    5 min       0.81472    0.09754    0.15761
    5.25 min    0.90579     0.2785    0.97059
    5.5 min     0.12699    0.54688    0.95717
    5.75 min    0.91338    0.95751    0.48538
    6 min       0.63236    0.96489    0.80028

변수 이름 지정하기

배열을 타임테이블로 변환합니다. 행 시간값을 datetime형 벡터로 지정합니다. 타임테이블 변수의 이름을 지정합니다.

X = randi([70 90],5,3);
Time = datetime(2016,7,1:5);
varNames = {'Temp1','Temp2','Temp3'};
TT = array2timetable(X,'RowTimes',Time,'VariableNames',varNames)

TT=5×3 timetable
       Time        Temp1    Temp2    Temp3
    ___________    _____    _____    _____

    01-Jul-2016     87       72       73  
    02-Jul-2016     89       75       90  
    03-Jul-2016     72       81       90  
    04-Jul-2016     89       90       80  
    05-Jul-2016     83       90       86  

입력 인수

X — 입력 행렬

행렬

입력 행렬입니다.

데이터형: double | single | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | logical | char | string | categorical | datetime | duration | calendarDuration
복소수 지원 여부: 예

rowTimes — 타임테이블의 행과 연관된 시간값

datetime형 벡터 | duration형 벡터

타임테이블의 행과 연관된 시간값으로, datetime형 벡터 또는 duration형 벡터로 지정됩니다. 각 시간값은 출력 타임테이블의 행에 레이블을 지정합니다. rowTimes의 시간값은 고유하거나 정렬되거나 규칙적이지 않아도 됩니다.

Fs — 샘플 레이트

숫자형 스칼라

샘플 레이트로, 숫자형 스칼라로 지정됩니다. Fs는 초당 샘플 수(Hz)를 지정합니다.

dt — 시간 스텝

duration형 스칼라 | calendarDuration형 스칼라

시간 스텝으로, duration형 스칼라 또는 calendarDuration형 스칼라로 지정됩니다.

데이터형: duration | calendarDuration

t0 — 시작 시간

datetime형 스칼라 | duration형 스칼라

시작 시간으로, datetime형 스칼라 또는 duration형 스칼라로 지정됩니다.

• t0이 datetime형 값인 경우, TT의 행 시간값은 datetime형 값입니다.

• t0이 duration형인 경우, 행 시간값은 duration형입니다.

시간 스텝 dt가 calendarDuration형 값인 경우 t0은 datetime형 값이어야 합니다.

데이터형: datetime | duration

이름-값 인수

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

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

예: TT = array2timetable(X,'RowTimes',Time,'VariableNames',{'Latitude','Longitude'})는 Time으로 지정된 행 시간값을 사용하여 입력 배열 X에서 타임테이블을 생성하고 해당 타임테이블 변수의 이름을 Latitude와 Longitude로 지정합니다.

VariableNames — 변수 이름

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

변수 이름으로, 비어 있지 않은 고유한 요소를 갖는 문자형 벡터로 구성된 셀형 배열 또는 string형 배열로 지정됩니다. 변수 이름의 개수는 입력 배열의 열 개수와 같아야 합니다.

변수 이름에는 공백과 비ASCII 문자를 포함하여 모든 Unicode^® 문자를 사용할 수 있습니다. 하지만 변수 이름은 테이블 차원 이름이나 예약된 이름 'Properties', 'RowNames', 'VariableNames' 또는 ':'과 일치할 수 없습니다.

DimensionNames — 차원 이름

문자형 벡터로 구성된, 요소를 2개 가진 셀형 배열 | 요소를 2개 가진 string형 배열

R2021a 이후

차원 이름으로, 문자형 벡터 요소를 2개 가진 셀형 배열 또는 비어 있지 않고 고유한 요소를 2개 가진 string형 배열로 지정됩니다.

차원 이름에는 공백 및 비ASCII 문자를 포함하여 모든 Unicode 문자를 사용할 수 있습니다. 하지만 차원 이름은 테이블 변수 이름이나 예약된 이름 'Properties', 'RowNames', 'VariableNames' 또는 ':'과 일치할 수 없습니다.

또는 모든 릴리스에서 테이블의 DimensionNames 속성을 설정하여 차원 이름을 지정할 수 있습니다.

출력 인수

TT — 출력 타임테이블

타임테이블

출력 타임테이블입니다. 이 타임테이블에는 설명, 변수 단위, 변수 이름, 행 시간값과 같은 메타데이터가 저장될 수 있습니다. 자세한 내용은 timetable 속성 섹션을 참조하십시오.

팁

• 행 시간값 사이의 규칙적인 시간 스텝을 지정하는 구문을 사용하여 array2timetable 함수를 호출했는데도 array2timetable 함수가 불규칙적인 타임테이블을 반환하는 경우가 있습니다. 이러한 결과는 달력 시간 단위를 사용하여 시간 스텝을 지정할 때 불규칙적인 스텝을 발생시키는 행 시간값이 포함되어 있는 경우에 발생합니다. 예를 들어, 2019년 1월 31일부터 시작하여 달력상의 월수 1개의 시간 스텝으로 타임테이블을 만든 경우 이 타임테이블은 월에 대해 불규칙적입니다.

  stime = datetime(2019,1,31);
  tstep = calmonths(1);
  X = [1:3]';
  TT = array2timetable(X,'TimeStep',tstep,'StartTime',stime)
  

  TT =
  
    3×1 timetable
  
         Time        X
      ___________    _
  
      31-Jan-2019    1
      28-Feb-2019    2
      31-Mar-2019    3
  

  DST(일광 절약 시간제)의 전환이나 윤초인 datetime형 값으로 인해 불규칙성이 발생하는 경우도 있습니다. 다음 표에서는 예기치 않게 불규칙적인 결과를 생성할 수 있는 날짜, 시간 및 시간 스텝을 보여줍니다.

  행 시간값	시간 스텝
  월의 29일, 30일 또는 31일로 지정된 시작 시간.	달력상의 월수 또는 사분기수.
  2월 29일로 지정된 시작 시간.	달력상의 연수.
  DST에서 표준 시간으로 전환되는 날 오전 1시와 오전 2시 사이의 모든 datetime형 값(이러한 값이 DST가 적용되는 표준 시간대를 갖는 경우).	달력상의 일수 또는 월수.
  윤초인 모든 datetime형 값(이러한 값의 표준 시간대가 UTCLeapSeconds 표준 시간대인 경우). 윤초 목록은 leapseconds를 참조하십시오.	임의의 달력 단위(일수, 주수, 월수, 사분기수 또는 연수)로 지정된 시간 스텝.

확장 기능

tall형 배열

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

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

C/C++ 코드 생성

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

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

• 생성된 코드에서 이 함수를 사용할 때는 'VariableNames' 이름-값 쌍의 인수를 지정해야 합니다.

• 'SampleRate', 'TimeStep' 또는 'StartTime' 이름-값 쌍의 인수를 사용하여 규칙적인 행 시간값을 지정하는 경우, 행 시간값이 규칙적이려면 컴파일할 때 값이 상수여야 합니다. 그렇지 않으면 생성된 코드에서 행 시간값이 불규칙적인 것으로 간주됩니다.

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

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

버전 내역

R2016b에 개발됨

R2021a: 'SamplingRate'는 제거될 예정임

'SamplingRate' 이름-값 인수는 향후 릴리스에서 제거될 예정입니다. 'SampleRate'를 대신 사용하십시오. 대응하는 timetable형의 속성도 SampleRate라는 이름을 갖습니다.

이전 버전과의 호환성을 위해 'SamplingRate'를 이름-값 인수의 이름으로 지정하는 것은 여전히 가능합니다. 단, 이때 이 값은 SampleRate 속성에 할당됩니다.

R2019b: 변수 이름에 선행 공백과 후행 공백 문자가 포함될 수 있음

선행 또는 후행 공백 문자가 있는 테이블 및 타임테이블 변수 이름은 수정되지 않습니다.

이전 릴리스에서는 'VariableNames' 이름-값 쌍의 인수를 사용하여 변수 이름을 지정하거나 VariableNames 속성에 변수 이름을 할당한 경우 변수 이름에서 선행 및 후행 공백 문자가 삭제되었습니다.

이러한 문자를 직접 제거하려면, 먼저 이름에 strtrim 함수를 사용한 다음 이 이름을 테이블 또는 타임테이블에 변수 이름으로 할당하십시오.

참고 항목

table2timetable | timetable | isvarname | summary | uitable

도움말 항목

• 타임테이블 생성하기
• 누락되거나 중복되거나 불균일하게 분포된 시간값이 포함된 타임테이블 정리하기
• 타임테이블의 데이터를 리샘플링하고 집계하기
• 타임테이블을 결합하고 타임테이블의 데이터를 동기화하기
• 타임테이블에서 시간값 선택하기
• 테이블의 데이터에 액세스하기
• 테이블
• MATLAB에서 날짜/시간 표시하기