addsampletocollection

サンプルを tscollection に追加

構文

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

説明

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 にサンプルを同時に追加します。

例

tscollection サンプルの追加

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

入力引数

tscin — 入力 tscollection

スカラー

入力 tscollection。スカラーとして指定します。

timevals — サンプル時間

スカラー | ベクトル

サンプル時間。数値スカラーまたは数値ベクトル、あるいは日付文字ベクトルの cell 配列として指定します。有効な日付の文字ベクトルと 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,...)

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

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

バージョン履歴

R2006a より前に導入

参考

timeseries | delsamplefromcollection | tscollection