Main Content

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)는 하나 이상의 이름-값 인수를 사용하여 옵션을 추가로 지정합니다.

입력 인수

모두 확장

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

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

형식예
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

이름-값 인수

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

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

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

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

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

데이터형: logical

속성

모두 확장

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

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

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

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

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

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

  • Start — 시작 시간.

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

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

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

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

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

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

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

객체 함수

addsampletocollectiontscollection에 샘플 추가
addtstscollection에 timeseries 추가
delsamplefromcollectiontscollection에서 샘플 삭제
getabstimetimeseries 또는 tscollection 시간 벡터를 셀형 배열로 변환
getsampleusingtimetimeseries 또는 tscollection 데이터의 서브셋
gettimeseriesnamestscollection에 있는 timeseries의 이름
removetsRemove timeseries from tscollection
resampletimeseries 또는 tscollection의 시간 벡터 리샘플링
setabstimeSet timeseries or tscollection times as date character vectors
settimeseriesnamesRename timeseries in 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 이전에 개발됨

참고 항목

도움말 항목