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 객체를 만듭니다.

입력 인수

모두 확장

`datavals` — 샘플 데이터
스칼라 | 벡터 | 다차원 배열

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

`timevals` — 샘플 시간
스칼라 | 벡터

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

형식	예
`dd-mmm-yyyy HH:MM:SS`	`01-Mar-2000 15:45:17`
`dd-mmm-yyyy`	`01-Mar-2000`
`mm/dd/yy`	`03/01/00`
`mm/dd`	`03/01`
`HH:MM:SS`	`15:45:17`
`HH:MM:SS PM`	`3:45:17 PM`
`HH:MM`	`15:45`
`HH:MM PM`	`3:45 PM`
`mmm.dd,yyyy HH:MM:SS`	`Mar.01,2000 15:45:17`
`mmm.dd,yyyy`	`Mar.01,2000`
`mm/dd/yyyy`	`03/01/2000`

`quality` — 품질 코드
`[]` (디폴트 값) | 스칼라 | 벡터 | 다차원 배열

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

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

`tsname` — `timeseries` 이름
문자형 벡터

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

속성

모두 확장

`Data` — 샘플 데이터
스칼라 | 벡터 | 다차원 배열

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

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

Dependent true

`DataInfo` — 데이터 정보
필드의 모음

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

Units — 데이터 단위를 지정하는 문자형 벡터.
Interpolation — 보간 방법을 지정하는 tsdata.interpolation 객체.
tsdata.interpolation 객체의 필드는 다음을 포함합니다.
- Fhandle — 사용자 정의 보간 함수의 함수 핸들.
- Name — 보간 방법의 이름을 지정하는 문자형 벡터. 방법에는 선형 보간을 나타내는 'linear'(디폴트 값), 영차 유지(Zero-Order Hold)를 나타내는 'zoh' 등이 있습니다.
UserData — 문자형 벡터로 입력되는 추가 사용자 정의 정보.

`Events` — 이벤트 정보
`tsdata.event` 객체로 구성된 배열

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

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

EventData — 이벤트에 대한 추가 사용자 정의 정보입니다.
Name — 이벤트의 이름을 지정하는 문자형 벡터입니다.
Time — 이벤트가 발생하는 시간으로, 실수 또는 날짜 문자형 벡터로 지정됩니다.
Units — 시간 단위입니다.
StartDate — 기준 날짜로, 날짜 문자형 벡터로 지정됩니다. 시간 벡터가 숫자형이면 StartDate는 비어 있습니다.

`IsTimeFirst` — 시간 벡터 정렬 방식
`true` | `false`

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

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

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

`Dependent`	`true`
`SetAccess`	`'protected'`

`Length` — 시간 벡터 길이
스칼라

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

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

`Dependent`	`true`
`SetAccess`	`'protected'`

`Name` — `timeseries` 이름
문자형 벡터

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

`Quality` — 품질 코드
`[]` (디폴트 값) | 스칼라 | 벡터 | 다차원 배열

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

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

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

Dependent true

`QualityInfo` — 품질 정보
필드의 모음

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

Code — -128부터 127까지의 값을 포함하는 품질 코드를 정의하는 정수형 벡터. Quality 속성을 사용하여 각 Data 값에 이러한 정수 값 중 하나를 할당할 수 있습니다.
Description — 각 요소가 연결된 품질 Code의 읽기 쉬운 설명을 제공하는 문자형 벡터로 구성된 셀형 배열.
UserData — 추가 사용자 정의 정보.

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

`Time` — 시간 값
벡터

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

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

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

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

Dependent true

`TimeInfo` — 시간 정보
필드의 모음

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

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 형식을 사용하십시오.

`TreatNaNasMissing` — 누락값 표시자
`true` (디폴트 값) | `false`

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

true — 기술 통계량 함수를 제외하고, 모든 NaN 값을 누락된 데이터로 취급합니다.
false — 기술 통계량 함수에 NaN 값을 포함하여 결과에 NaN을 포함시킵니다.

`UserData` — 사용자 데이터
`[]` (디폴트 값)

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

객체 함수

모두 확장

수정 및 플로팅

`addevent`	`timeseries`에 이벤트 추가
`addsample`	Add data sample to `timeseries` object
`append`	`timeseries` 객체를 시간에 따라 결합
`delevent`	`timeseries`에서 이벤트 제거
`delsample`	`timeseries` 객체에서 샘플 제거
`detrend`	Subtract mean or best-fit line from `timeseries` object
`filter`	Modify frequency content of `timeseries` objects
`idealfilter`	`timeseries` ideal filter
`plot`	`timeseries` 플로팅
`resample`	`timeseries` 또는 `tscollection`의 시간 벡터 리샘플링
`setabstime`	Set `timeseries` or `tscollection` times as date character vectors
`setinterpmethod`	Set default interpolation method for `timeseries` object
`setuniformtime`	Modify uniform `timeseries` time vector
`synchronize`	공통 시간 벡터를 사용하여 두 개의 `timeseries` 객체 동기화 및 리샘플링

쿼리

`getabstime`	`timeseries` 또는 `tscollection` 시간 벡터를 셀형 배열로 변환
`getdatasamples`	`timeseries` 데이터 샘플에 액세스
`getdatasamplesize`	`timeseries` 데이터 샘플 크기
`getinterpmethod`	`timeseries` 보간 방법
`getqualitydesc`	`timeseries` data quality
`getsamples`	`timeseries`의 서브셋
`getsampleusingtime`	`timeseries` 또는 `tscollection` 데이터의 서브셋
`gettsafteratevent`	이벤트 발생 시점 또는 이후의 `timeseries` 만들기
`gettsafterevent`	이벤트 이후에 발생하는 `timeseries` 만들기
`gettsatevent`	이벤트 발생 시점의 `timeseries` 만들기
`gettsbeforeatevent`	이벤트 발생 시점 또는 이전의 `timeseries` 만들기
`gettsbeforeevent`	이벤트 발생 시점 이전의 `timeseries` 만들기
`gettsbetweenevents`	두 이벤트 사이의 `timeseries` 만들기

기술 통계량

`iqr`	`timeseries` 데이터의 사분위 범위
`max`	`timeseries` 데이터의 최댓값
`mean`	`timeseries` 데이터의 평균
`median`	`timeseries` 데이터의 중앙값
`min`	`timeseries` 데이터의 최솟값
`std`	`timeseries` 데이터의 표준편차
`sum`	`timeseries` 데이터의 합
`var`	`timeseries` 데이터의 분산

예제

모두 축소

`timeseries` 만들기

라이브 스크립트 열기

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

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

  timeseries

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

  More properties, Methods

ts1.Time

ts1.Data

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

ts2 = timeseries(rand(2,5))

  timeseries

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

  More properties, Methods

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: [1x1 tsdata.timemetadata]
            Data: [5x1 double]
        DataInfo: [1x1 tsdata.datametadata]

  More properties, Methods

ts3.Time

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: ''

  More properties, Methods

버전 내역

R2006a 이전에 개발됨

모두 확장

R2025a: 변수 편집기가 `timeseries` 객체의 속성을 직접 표시함

변수 편집기에서 timeseries 객체를 열면, 이제 timeseries 데이터에 대한 특화된 편집기가 표시되는 대신 속성, 값, 크기 및 클래스 필드가 직접 표시됩니다. 이 업데이트된 디스플레이를 사용하여 여전히 timeseries 객체의 모든 속성을 액세스 및 확인하고, 일부 속성값을 편집할 수 있습니다.

참고 항목

timetable | tscollection | tsdata.event | timeseries2timetable

도움말 항목

시계열 객체 및 컬렉션

timeseries

설명

생성

구문

설명

입력 인수

datavals — 샘플 데이터 스칼라 | 벡터 | 다차원 배열

timevals — 샘플 시간 스칼라 | 벡터

quality — 품질 코드 [] (디폴트 값) | 스칼라 | 벡터 | 다차원 배열

tsname — timeseries 이름 문자형 벡터

속성

Data — 샘플 데이터 스칼라 | 벡터 | 다차원 배열

DataInfo — 데이터 정보 필드의 모음

Events — 이벤트 정보 tsdata.event 객체로 구성된 배열

IsTimeFirst — 시간 벡터 정렬 방식 true | false

Length — 시간 벡터 길이 스칼라

Name — timeseries 이름 문자형 벡터

Quality — 품질 코드 [] (디폴트 값) | 스칼라 | 벡터 | 다차원 배열

QualityInfo — 품질 정보 필드의 모음

Time — 시간 값 벡터

TimeInfo — 시간 정보 필드의 모음

TreatNaNasMissing — 누락값 표시자 true (디폴트 값) | false

UserData — 사용자 데이터 [] (디폴트 값)

객체 함수

수정 및 플로팅

쿼리

기술 통계량

예제

timeseries 만들기

버전 내역

R2025a: 변수 편집기가 timeseries 객체의 속성을 직접 표시함

참고 항목

도움말 항목

`datavals` — 샘플 데이터
스칼라 | 벡터 | 다차원 배열

`timevals` — 샘플 시간
스칼라 | 벡터

`quality` — 품질 코드
`[]` (디폴트 값) | 스칼라 | 벡터 | 다차원 배열

`tsname` — `timeseries` 이름
문자형 벡터

`Data` — 샘플 데이터
스칼라 | 벡터 | 다차원 배열

`DataInfo` — 데이터 정보
필드의 모음

`Events` — 이벤트 정보
`tsdata.event` 객체로 구성된 배열

`IsTimeFirst` — 시간 벡터 정렬 방식
`true` | `false`

`Length` — 시간 벡터 길이
스칼라

`Name` — `timeseries` 이름
문자형 벡터

`Quality` — 품질 코드
`[]` (디폴트 값) | 스칼라 | 벡터 | 다차원 배열

`QualityInfo` — 품질 정보
필드의 모음

`Time` — 시간 값
벡터

`TimeInfo` — 시간 정보
필드의 모음

`TreatNaNasMissing` — 누락값 표시자
`true` (디폴트 값) | `false`

`UserData` — 사용자 데이터
`[]` (디폴트 값)

`timeseries` 만들기

R2025a: 변수 편집기가 `timeseries` 객체의 속성을 직접 표시함