Main Content

timeseries

timeseries 객체 생성

페이지 내 모두 확장

설명

시계열은 동적 모집단 또는 동적 과정에서의 시간에 따른 변화를 나타냅니다. 시계열은 이산시간 간격으로 샘플링된 데이터의 패턴과 동작을 식별하고 모델링하고 전망하는 데 사용됩니다.

참고

timetable이 timeseries보다 권장됩니다. 타임테이블은 타임스탬프가 지정된 다양한 형식의 데이터를 저장할 수 있으며 전처리, 재구성, 분석을 위한 광범위한 지원 함수를 갖습니다.

timeseries 데이터형을 제거할 계획은 없습니다.

생성

timeseries 객체를 생성하려면 데이터 샘플을 설명하는 입력 인수와 함께 timeseries 함수를 사용하십시오.

구문

ts = timeseries(datavals)
ts = timeseries(datavals,timevals)
ts = timeseries(datavals,timevals,quality)
ts = timeseries(___,'Name',tsname)
ts = timeseries()
ts = timeseries(tsname)

설명

예제

ts = timeseries(datavals)는 datavals의 데이터를 포함하는 timeseries 객체를 반환합니다. 0초에서 시작하고 시간 스텝이 1초인 디폴트 샘플 시간이 할당됩니다.

ts = timeseries(datavals,timevals)는 시계열의 샘플 시간을 지정합니다. 결과로 생성되는 객체는 시간을 기준으로 데이터를 정렬합니다.

ts = timeseries(datavals,timevals,quality)는 QualityInfo.Code로 정의된 코드에 대한 품질 설명을 지정합니다.

ts = timeseries(___,'Name',tsname)은 timeseries 객체의 이름 tsname을 지정합니다.

ts = timeseries()는 빈 timeseries 객체를 반환합니다.

ts = timeseries(tsname)은 이름이 tsname인 빈 timeseries 객체를 만듭니다.

입력 인수

모두 확장

샘플 데이터로, 숫자형 스칼라나 logical 스칼라, 벡터 또는 다차원 배열로 지정됩니다.

데이터형: double | single | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | logical

샘플 시간으로, 숫자형 스칼라나 숫자형 벡터 또는 날짜 문자형 벡터로 구성된 셀형 배열로 지정됩니다. 유효한 날짜 문자형 벡터의 형식은 다음과 같습니다.

형식예
dd-mmm-yyyy HH:MM:SS01-Mar-2000 15:45:17
dd-mmm-yyyy01-Mar-2000
mm/dd/yy03/01/00
mm/dd03/01
HH:MM:SS15:45:17
HH:MM:SS PM3:45:17 PM
HH:MM15:45
HH:MM PM3:45 PM
mmm.dd,yyyy HH:MM:SSMar.01,2000 15:45:17
mmm.dd,yyyyMar.01,2000
mm/dd/yyyy03/01/2000

데이터형: double | single | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | cell

품질 코드로, [] 또는 -128부터 127까지의 정수로 구성된 스칼라, 벡터 또는 다차원 배열로 지정됩니다.

  • 품질 코드 값이 벡터인 경우 시간 벡터와 길이가 같아야 합니다. 각 요소는 대응하는 데이터 샘플에 적용됩니다.

  • 품질 코드 값이 배열인 경우 데이터 배열과 크기가 같아야 합니다. 각 요소는 데이터 배열의 대응하는 요소에 적용됩니다.

데이터형: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

timeseries 이름으로, 문자형 벡터로 지정됩니다.

속성

모두 확장

샘플 데이터로, 숫자형 스칼라나 logical 스칼라, 벡터 또는 다차원 배열로 표현됩니다. 데이터의 첫 번째 차원 또는 마지막 차원은 시간 벡터의 방향과 같아야 합니다.

Data의 특성은 다음과 같습니다.

Dependenttrue

데이터형: double | single | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | logical

데이터 정보로, 다음 필드의 모음으로 표현됩니다.

  • Units — 데이터 단위를 지정하는 문자형 벡터.

  • Interpolation — 보간 방법을 지정하는 tsdata.interpolation 객체.

    tsdata.interpolation 객체의 필드는 다음을 포함합니다.

    • Fhandle — 사용자 정의 보간 함수의 함수 핸들.

    • Name — 보간 방법의 이름을 지정하는 문자형 벡터. 방법에는 선형 보간을 나타내는 'linear'(디폴트 값), 영차 유지(Zero-Order Hold)를 나타내는 'zoh' 등이 있습니다.

  • UserData — 문자형 벡터로 입력되는 추가 사용자 정의 정보.

이벤트 정보로, 이벤트 정보를 포함하는 tsdata.event 객체로 구성된 배열로 표현됩니다.

tsdata.event 객체의 필드는 다음을 포함합니다.

  • EventData — 이벤트에 대한 추가 사용자 정의 정보입니다.

  • Name — 이벤트의 이름을 지정하는 문자형 벡터입니다.

  • Time — 이벤트가 발생하는 시간으로, 실수 또는 날짜 문자형 벡터로 지정됩니다.

  • Units — 시간 단위입니다.

  • StartDate — 기준 날짜로, 날짜 문자형 벡터로 지정됩니다. 시간 벡터가 숫자형이면 StartDate는 비어 있습니다.

시간 벡터 정렬 방식으로, 다음 옵션 중 하나로 표현됩니다.

  • true — 데이터 배열의 첫 번째 차원이 시간 벡터에 맞춰 정렬됩니다. 예를 들어, ts = timeseries(rand(3,3),1:3);입니다.

  • false — 데이터 배열의 마지막 차원이 시간 벡터에 맞춰 정렬됩니다. 예를 들어, ts = timeseries(rand(3,4,5),1:5);입니다.

IsTimeFirst의 특성은 다음과 같습니다.

Dependenttrue
SetAccess'protected'

시간 벡터 길이로, 스칼라로 표현됩니다.

Length의 특성은 다음과 같습니다.

Dependenttrue
SetAccess'protected'

timeseries 이름으로, 문자형 벡터로 표현됩니다.

품질 코드로, [], 스칼라, 벡터 또는 -128부터 127까지의 정수로 구성된 다차원 배열로 지정됩니다.

  • 품질 코드 값이 벡터인 경우 시간 벡터와 길이가 같아야 합니다. 각 요소는 대응하는 데이터 샘플에 적용됩니다.

  • 품질 코드 값이 배열인 경우 데이터 배열과 크기가 같아야 합니다. 각 요소는 데이터 배열의 대응하는 요소에 적용됩니다.

Quality의 특성은 다음과 같습니다.

Dependenttrue

데이터형: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

Quality 코드를 설명하는 품질 정보로, 다음 필드의 모음으로 표현됩니다.

  • Code — -128부터 127까지의 값을 포함하는 품질 코드를 정의하는 정수형 벡터. Quality 속성을 사용하여 각 Data 값에 이러한 정수 값 중 하나를 할당할 수 있습니다.

  • Description — 각 요소가 연결된 품질 Code의 읽기 쉬운 설명을 제공하는 문자형 벡터로 구성된 셀형 배열.

  • UserData — 추가 사용자 정의 정보.

Code와 Description의 길이는 일치해야 합니다.

시간 값으로, 벡터로 표현됩니다.

TimeInfo.StartDate가 비어 있으면 값은 0을 기준으로 측정됩니다. TimeInfo.StartDate가 정의되어 있으면 값은 StartDate을 기준으로 측정된 날짜 문자형 벡터를 나타냅니다.

Time의 길이는 Data의 첫 번째 또는 마지막 차원과 같아야 합니다.

Time의 특성은 다음과 같습니다.

Dependenttrue

시간 정보로, 시간 벡터를 설명하는 다음 필드의 모음으로 표현됩니다.

  • Units — 값이 'weeks', 'days', 'hours', 'minutes', 'seconds', 'milliseconds', 'microseconds' 또는 'nanoseconds'인 시간 단위.

  • Start — 시작 시간.

  • End — 종료 시간(읽기 전용).

  • Increment — 연속한 시간 값 사이의 간격(시간이 균일하게 샘플링되지 않은 경우 NaN).

  • Length — 시간 벡터의 길이(읽기 전용).

  • Format — 날짜 표시를 정의하는 문자형 벡터(datestr 참조).

  • StartDate — 기준 날짜를 정의하는 날짜 문자형 벡터(setabstime 참조). Format과 동일한 형식을 사용하여 StartDate를 지정하십시오.

  • UserData — 추가 사용자 정의 정보.

필드의 값에 액세스하려면 timeseries 객체 ts에 대해 ts.TimeInfo.field 형식을 사용하십시오.

누락값 표시자로, 다음 옵션 중 하나로 표현됩니다.

  • true — 기술 통계량 함수를 제외하고, 모든 NaN 값을 누락된 데이터로 취급합니다.

  • false — 기술 통계량 함수에 NaN 값을 포함하여 결과에 NaN을 포함시킵니다.

사용자 데이터로, timeseries 객체에 추가할 임의의 추가 데이터로 표현됩니다.

객체 함수

모두 확장

addeventtimeseries에 이벤트 추가
addsampleAdd data sample to timeseries object
appendtimeseries 객체를 시간에 따라 결합
deleventtimeseries에서 이벤트 제거
delsampletimeseries 객체에서 샘플 제거
detrendSubtract mean or best-fit line from timeseries object
filterModify frequency content of timeseries objects
idealfiltertimeseries ideal filter
plottimeseries 플로팅
resampletimeseries 또는 tscollection의 시간 벡터 리샘플링
setabstimeSet timeseries or tscollection times as date character vectors
setinterpmethodSet default interpolation method for timeseries object
setuniformtimeModify uniform timeseries time vector
synchronize공통 시간 벡터를 사용하여 두 개의 timeseries 객체 동기화 및 리샘플링
getabstimetimeseries 또는 tscollection 시간 벡터를 셀형 배열로 변환
getdatasamplestimeseries 데이터 샘플에 액세스
getdatasamplesizetimeseries 데이터 샘플 크기
getinterpmethodtimeseries 보간 방법
getqualitydesctimeseries data quality
getsamplestimeseries의 서브셋
getsampleusingtimetimeseries 또는 tscollection 데이터의 서브셋
gettsafteratevent이벤트 발생 시점 또는 이후의 timeseries 만들기
gettsafterevent이벤트 이후에 발생하는 timeseries 만들기
gettsatevent이벤트 발생 시점의 timeseries 만들기
gettsbeforeatevent이벤트 발생 시점 또는 이전의 timeseries 만들기
gettsbeforeevent이벤트 발생 시점 이전의 timeseries 만들기
gettsbetweenevents두 이벤트 사이의 timeseries 만들기
iqrtimeseries 데이터의 사분위 범위
maxtimeseries 데이터의 최댓값
meantimeseries 데이터의 평균
mediantimeseries 데이터의 중앙값
mintimeseries 데이터의 최솟값
stdtimeseries 데이터의 표준편차
sumtimeseries 데이터의 합
vartimeseries 데이터의 분산

예제

모두 축소

라이브 스크립트 열기

timeseries의 이름을 지정하여 스칼라 데이터 샘플 5개를 갖는 timeseries 객체를 만듭니다. 그런 다음 샘플 시간값과 데이터 값을 표시합니다.

ts1 = timeseries(([5 10 15 20 25])',"Name","MyTimeSeries")
  timeseries

  Common Properties:
            Name: 'MyTimeSeries'
            Time: [5x1 double]
        TimeInfo: tsdata.timemetadata
            Data: [5x1 double]
        DataInfo: tsdata.datametadata

ts1.Time
ans = 5×1

     0
     1
     2
     3
     4


ts1.Data
ans = 5×1

     5
    10
    15
    20
    25

각 샘플이 길이 2의 열 벡터인 데이터 샘플 5개를 갖는 timeseries를 만듭니다. 이에 따라 이제 0초에서 시작하는 2개의 샘플 시간이 있습니다.

ts2 = timeseries(rand(2,5))
  timeseries

  Common Properties:
            Name: 'unnamed'
            Time: [2x1 double]
        TimeInfo: tsdata.timemetadata
            Data: [2x5 double]
        DataInfo: tsdata.datametadata

ts2.Time
ans = 2×1

     0
     1

10초 간격으로 샘플링된 데이터 샘플 5개를 갖는 timeseries를 만듭니다.

ts3 = timeseries((1:5)',[0 10 20 30 40])
  timeseries

  Common Properties:
            Name: 'unnamed'
            Time: [5x1 double]
        TimeInfo: tsdata.timemetadata
            Data: [5x1 double]
        DataInfo: tsdata.datametadata

ts3.Time
ans = 5×1

     0
    10
    20
    30
    40


ts3.TimeInfo
  tsdata.timemetadata
  Namespace: tsdata

  Uniform Time:
    Length       5
    Increment    10 seconds

  Time Range:
    Start        0 seconds
    End          40 seconds

  Common Properties:
          Units: 'seconds'
         Format: ''
      StartDate: ''

버전 내역

R2006a 이전에 개발됨

모두 확장

참고 항목

| | |

도움말 항목