Main Content

addsampletocollection

tscollection에 샘플 추가

설명

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

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

예제

예제

모두 축소

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

입력 인수

모두 축소

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

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

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

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

데이터형: char

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

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

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

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

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

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

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

버전 내역

R2006a 이전에 개발됨