tscollection

tscollection 객체 만들기

설명

tscollection 객체는 동일한 시간 벡터를 갖는 하나 이상의 timeseries 객체들 모음입니다. timeseries 모음은 동시에 발생하는 여러 데이터 추세를 분석하는 데 유용합니다.

생성

tscollection 객체를 만들려면 tscollection 함수를 사용하십시오.

구문

tsc = tscollection(ts)

tsc = tscollection(timevals)

tsc = tscollection(___,Name,Value)

설명

tsc = tscollection(ts)는 ts에서 timeseries 객체를 포함하는 tscollection 객체를 생성합니다. 입력 ts는 단일 timeseries 객체 또는 timeseries 객체로 구성된 셀형 배열일 수 있습니다. 각 timeseries는 동일한 시간 벡터를 가져야 합니다.

tsc = tscollection(timevals)는 tscollection의 시간 벡터를 정의합니다.

tsc = tscollection(___,Name,Value)는 하나 이상의 이름-값 인수를 사용하여 옵션을 추가로 지정합니다.

입력 인수

ts — 입력 timeseries

스칼라 | 셀형 배열

입력 timeseries로, 스칼라 또는 셀형 배열로 지정됩니다.

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

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

이름-값 인수

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

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

예: tsc = tscollection(ts,'Name','MyTSC')

Name — tscollection 이름

문자형 벡터

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

isDatenum — datenum 표시자

true (디폴트 값) | false

datenum 표시자로, true 또는 false로 지정됩니다. 값 true는 tscollection 객체의 시간 벡터가 datenum형 값으로 구성되었음을 나타냅니다. 자세한 내용은 datenum 항목을 참조하십시오.

데이터형: logical

속성

Name — tscollection 이름

문자형 벡터

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

Time — 시간 값

벡터

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

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

Time의 길이는 각 컬렉션에서 Data의 첫 번째 또는 마지막 차원과 같아야 합니다.

TimeInfo — 시간 정보

필드의 모음

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

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

• Start — 시작 시간.

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

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

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

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

• StartDate — 기준 날짜를 정의하는 날짜 문자형 벡터(setabstime 참조).

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

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

객체 함수

addsampletocollection	tscollection에 샘플 추가
addts	tscollection에 timeseries 추가
delsamplefromcollection	tscollection에서 샘플 삭제
getabstime	timeseries 또는 tscollection 시간 벡터를 셀형 배열로 변환
getsampleusingtime	timeseries 또는 tscollection 데이터의 서브셋
gettimeseriesnames	tscollection에 있는 timeseries의 이름
removets	Remove timeseries from tscollection
resample	timeseries 또는 tscollection의 시간 벡터 리샘플링
setabstime	Set timeseries or tscollection times as date character vectors
settimeseriesnames	Rename timeseries in tscollection

예제

tscollection 만들기

두 timeseries 객체에서 tscollection 객체를 만듭니다.

ts1 = timeseries([1.1 2.9 3.7 4.0 3.0]',1:5,...
'Name','Acceleration');
ts2 = timeseries([3.2 4.2 6.2 8.5 1.1]',1:5,...
'Name','Speed');
ts = tscollection({ts1;ts2})

Time Series Collection Object: unnamed

Time vector characteristics

      Start time            1 seconds
      End time              5 seconds

Member Time Series Objects:

      Acceleration
      Speed

버전 내역

R2006a 이전에 개발됨

참고 항목

timeseries

도움말 항목

• 시계열 객체 및 컬렉션