Main Content

addsampletocollection

サンプルを tscollection に追加

説明

tscout = addsampletocollection(tscin,'Time',timevals,tsname,tsdata) は、1 つ以上の時間値の名前 tsname によって指定された tscollection メンバーにデータ サンプルを追加します。tsdata にはサンプル データが含まれます。

複数の tscollection メンバーに一度にサンプルを追加するには、各 tscollection メンバー名の後に対応するデータをコンマで区切って続けてリストします。たとえば、コマンド tscout = addsampletocollection(tscin,'Time',timevals,ts1name,ts1data,ts2name,ts2data)tscin 内の 2 つの timeseries にサンプルを同時に追加します。

すべて折りたたむ

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。スカラーとして指定します。

サンプル時間。数値スカラーまたは数値ベクトル、あるいは日付文字ベクトルの cell 配列として指定します。有効な日付の文字ベクトルと 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 メンバーのデータ サンプルを指定しない場合、数値データでは timeseriestimevals で指定された時間に NaN 値が含まれます。論理データでは、timeseriesfalse 値が含まれます。

  • tscollection メンバーに Quality 値が必要な場合、以下の構文を使用して、データ サンプルと共にデータ品質コードを指定できます。

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

    最初の cell 配列要素にデータを指定して、2 番目の cell 配列要素に Quality を指定します。

    tscollection メンバーに Quality 値が既にあるが、データ サンプルのみを提供する場合、timevals で指定された時間の既存の配列 Quality0 が追加されます。

バージョン履歴

R2006a より前に導入