addsampletocollection

tscollection에 샘플 추가

구문

tscout = addsampletocollection(tscin,'Time',timevals,tsname,tsdata)

설명

tscout = addsampletocollection(tscin,'Time',timevals,tsname,tsdata)는 하나 이상의 시간 값에 대해 이름 tsname으로 지정된 tscollection 멤버에 데이터 샘플을 추가합니다. tsdata는 샘플 데이터를 포함합니다.

한 번에 둘 이상의 tscollection 멤버에 샘플을 추가하려면, 계속해서 각 tscollection 멤버 이름 다음에 그에 대응하는 데이터를 쉼표로 구분하여 나열하십시오. 예를 들어, 명령 tscout = addsampletocollection(tscin,'Time',timevals,ts1name,ts1data,ts2name,ts2data)는 tscin의 timeseries 2개에 샘플을 동시에 추가합니다.

예제

tscollection 샘플 추가하기

두 timeseries 객체에서 tscollection 객체를 만들고 샘플을 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');
tscin = tscollection({ts1;ts2});
tscout = addsampletocollection(tscin,'Time',3.5,'Acceleration',10,'Speed',4.9);
tscout.Acceleration.Data

ans = 6×1

    1.1000
    2.9000
    3.7000
   10.0000
    4.0000
    3.0000

tscout.Speed.Data

ans = 6×1

    3.2000
    4.2000
    6.2000
    4.9000
    8.5000
    1.1000

입력 인수

tscin — 입력 tscollection

스칼라

입력 tscollection으로, 스칼라로 지정됩니다.

timevals — 샘플 시간

스칼라 | 벡터

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

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

tsname — timeseries 이름

문자형 벡터

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

데이터형: char

tsdata — timeseries 데이터

스칼라 | 벡터 | 다차원 배열

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

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

팁

• tscollection 멤버에 대한 데이터 샘플을 지정하지 않을 경우, timeseries는 숫자형 데이터의 경우 timevals에 지정된 시간에 대해 NaN 값을 포함합니다. 논리형 데이터의 경우, timeseries는 false 값을 포함합니다.

• tscollection 멤버에 Quality 값이 필요한 경우 다음 구문을 사용하여 데이터 샘플과 함께 데이터 품질 코드를 지정할 수 있습니다.

  tsc = addsampletocollection(tsc,'Time',timevals,...
  ts1name,ts1cellarray,ts2name,ts2cellarray,...)

  첫 번째 셀형 배열 요소에 데이터를 지정하고 두 번째 셀형 배열 요소에 Quality를 지정합니다.

  tscollection 멤버에 이미 Quality 값이 있는데 데이터 샘플만 지정하면 timevals로 지정된 시간에 0이 기존 Quality 배열에 추가됩니다.

버전 내역

R2006a 이전에 개발됨

참고 항목

timeseries | delsamplefromcollection | tscollection