addsample
データ サンプルを timeseries
オブジェクトに追加
構文
説明
tsout = addsample(
は、1 つ以上の名前と値のペアを使用して、データ サンプルを追加するための追加情報を指定します。tsin
,'Data'
,datavals
,'Time'
,timevals
,Name,Value
)
例
データ サンプルの追加
timeseries
オブジェクトでデータの追加と変更を行います。
timeseries
オブジェクト ts1
を作成し、データ サンプルと時間サンプルを表示します。
ts1 = timeseries((0:10:50)',(0:5)'); ts1.Data
ans = 6×1
0
10
20
30
40
50
ts1.Time
ans = 6×1
0
1
2
3
4
5
データ サンプルを ts1
の末尾に追加します。
ts2 = addsample(ts1,'Data',60,'Time',6); ts2.Data
ans = 7×1
0
10
20
30
40
50
60
ts2.Time
ans = 7×1
0
1
2
3
4
5
6
ts2
の最後のデータ サンプルを 60 から 100 に変更します。
ts3 = addsample(ts2,'Data',100,'Time',6,'OverwriteFlag',true); ts3.Data
ans = 7×1
0
10
20
30
40
50
100
入力引数
tsin
— 入力 timeseries
スカラー
入力 timeseries
。スカラーとして指定します。
datavals
— サンプル データ
スカラー | ベクトル | 多次元配列
サンプル データ。数値または logical
スカラー、ベクトル、または多次元配列として指定します。
データ型: double
| single
| int8
| int16
| int32
| int64
| uint8
| uint16
| uint32
| uint64
| logical
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
s
— サンプル構造体
スカラー
サンプル構造体。型が struct
であり、次のオプションのフィールドをもつスカラーとして指定します。
s.data
— データの数値配列s.time
— 数値時間ベクトル、または有効な日付文字ベクトルまたは string の cell 配列s.quality
— 特性コード (-128 ~ 127) の整数配列s.overwriteflag
— 上書きインジケーター。true
に指定すると、既存のデータ サンプルが追加サンプルで上書きされます。
データ型: struct
名前と値の引数
引数のオプションのペアを Name1=Value1,...,NameN=ValueN
として指定します。ここで Name
は引数名で、Value
は対応する値です。名前と値の引数は他の引数の後になければなりませんが、ペアの順序は重要ではありません。
R2021a より前では、コンマを使用してそれぞれの名前と値を区切り、Name
を引用符で囲みます。
例: tsout = addsample(tsin,'Data',5,'Time',3,'OverwriteFlag',true)
Quality
— 特性コード
[]
(既定値) | スカラー | ベクトル | 多次元配列
特性コード。[]
または -128 ~ 127 の範囲の整数のスカラー、ベクトル、または多次元配列として指定します。
特性コードの値がベクトルの場合は、時間ベクトルと同じ長さでなければなりません。各要素は、対応するデータ サンプリングに適用されます。
特性コードの値が配列の場合は、データ配列と同じサイズでなければなりません。各要素は、データ配列の対応する要素に適用されます。
データ型: single
| double
| int8
| int16
| int32
| int64
| uint8
| uint16
| uint32
| uint64
OverwriteFlag
— 上書きインジケーター
false
(既定値) | true
上書きインジケーター。追加サンプルと同じ時間が関連付けられているデータ サンプルを上書きするかどうかを制御する論理値として指定します。true
を指定すると、追加されたデータで以前のデータが上書きされます。false
を指定すると、サンプルが追加され、時間値が繰り返されます。
データ型: logical
バージョン履歴
R2006a より前に導入
MATLAB コマンド
次の MATLAB コマンドに対応するリンクがクリックされました。
コマンドを MATLAB コマンド ウィンドウに入力して実行してください。Web ブラウザーは MATLAB コマンドをサポートしていません。
Select a Web Site
Choose a web site to get translated content where available and see local events and offers. Based on your location, we recommend that you select: .
You can also select a web site from the following list:
How to Get Best Site Performance
Select the China site (in Chinese or English) for best site performance. Other MathWorks country sites are not optimized for visits from your location.
Americas
- América Latina (Español)
- Canada (English)
- United States (English)
Europe
- Belgium (English)
- Denmark (English)
- Deutschland (Deutsch)
- España (Español)
- Finland (English)
- France (Français)
- Ireland (English)
- Italia (Italiano)
- Luxembourg (English)
- Netherlands (English)
- Norway (English)
- Österreich (Deutsch)
- Portugal (English)
- Sweden (English)
- Switzerland
- United Kingdom (English)