이 페이지의 최신 내용은 아직 번역되지 않았습니다. 최신 내용은 영문으로 볼 수 있습니다.

timeseries

timeseries 객체 생성

설명

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

생성

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

설명

예제

ts = timeseries(datavals)datavals의 데이터를 포함하는 timeseries 객체를 반환합니다.

ts = timeseries(datavals,timevals)datavals에서 벡터 timevals의 시간에 대응하는 데이터를 포함하는 timeseries 객체를 반환합니다.

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 — 추가 사용자 정의 정보.

CodeDescription의 길이는 일치해야 합니다.

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

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 참조).

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

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

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

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

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

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

객체 함수

모두 확장

addeventtimeseries에 이벤트 추가
addsampleAdd data sample to timeseries object
appendConcatenate timeseries objects in time
deleventtimeseries에서 이벤트 제거
delsampleRemove sample from timeseries object
detrendSubtract mean or best-fit line from timeseries object
filterModify frequency content of timeseries objects
idealfiltertimeseries ideal filter
plottimeseries 플로팅
resampletimeseries 시간 벡터 리샘플링
setSet timeseries properties
setabstimeSet timeseries times as date character vectors
setinterpfunctionSet default interpolation method for timeseries object
setuniformtimeModify uniform timeseries time vector
synchronizeSynchronize and resample two timeseries objects using common time vector
getQuery timeseries properties
getabstimeConvert timeseries time vector to cell array
getdatasamplesAccess timeseries data samples
getdatasamplesizetimeseries data sample size
getinterpmethodtimeseries interpolation method
getqualitydesctimeseries data quality
getsamplesSubset of timeseries
getsampleusingtimeSubset of timeseries data
gettsafteratevent이벤트 발생 시점 또는 이후의 timeseries 만들기
gettsafterevent이벤트 이후에 발생하는 timeseries 만들기
gettsatevent이벤트 발생 시점의 timeseries 만들기
gettsbeforeatevent이벤트 발생 시점 또는 이전의 timeseries 만들기
gettsbeforeevent이벤트 발생 시점 이전의 timeseries 만들기
gettsbetweenevents두 이벤트 사이의 timeseries 만들기
iqrInterquartile range of timeseries data
maxMaximum of timeseries data
meanMean of timeseries data
medianMedian of timeseries data
minMinimum of timeseries data
stdStandard deviation of timeseries data
sumSum of timeseries data
varVariance of timeseries data

예제

모두 축소

timeseries의 이름을 지정하여 스칼라 데이터 샘플 5개를 갖는 timeseries 객체를 만듭니다.

ts1 = timeseries((1:5)','Name','MyTimeSeries');

각 샘플이 길이가 2인 열 벡터인 데이터 샘플 5개를 갖는 timeseries를 만듭니다.

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

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

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

R2006a 이전에 개발됨