局所的極値の検出

ライブエディターでの局所的最大値と局所的最小値の検出

R2019b 以降

このページをすべて展開する

説明

[局所的極値の検出] タスクでは、対話的にデータの局所的最大値と局所的最小値を検出します。このタスクは、ライブスクリプト用の MATLAB^® コードを自動生成します。

このタスクを使用すると、次を行うことができます。

ワークスペース変数のデータから、局所的最大値、局所的最小値、または両方を検出
パラメーターを調整して検出する極値を増減
検出した極値を可視化

Find Local Extrema task in the Live Editor

タスクを開く

[局所的極値の検出] タスクを MATLAB エディターでライブスクリプトに追加するには、次を行います。

[ライブエディター] タブで [タスク] 、 [局所的極値の検出] を選択します。
スクリプトのコードブロック内に、extrema、find などの関連キーワードを入力します。コマンドの補完候補から [局所的極値の検出] を選択します。

例

パラメーター

すべて展開する

`入力データ` — ワークスペースからの有効な入力データ
ベクトル | table | timetable

このタスクは、ベクトル、table、または timetable に含まれる入力データに対して実行されます。データは single 型、double 型、logical 型、あるいは int64 などの符号付きまたは符号なし整数型にできます。

入力データとして table または timetable を提供する場合、[サポートされているすべての変数] を選択すると、サポートされる型のすべての変数が対象になります。[すべての数値変数] を選択すると、single 型、double 型、符号付きまたは符号なし整数型のすべての変数が対象になります。サポートされる特定の変数を対象として選択するには、[指定した変数] を選択し、変数を個別に選択します。

`フラットの選択` — フラット領域インジケーター
`Center` (既定値) | `First` | `Last` | `All`

連続する局所的極値がある場合のフラット領域インジケーターを指定します。

メソッド	説明
`Center`	フラット領域の中心要素のみを局所的極値として表す
`First`	フラット領域の最初の要素のみを局所的極値として表す
`Last`	フラット領域の最後の要素のみを局所的極値として表す
`All`	フラット領域のすべての要素を局所的極値として表す

`最小プロミネンス` — 極値の最小プロミネンス
`0` (既定値) | 正のスカラー

最小プロミネンスを指定します。この値以上のプロミネンスをもつ局所的極値のみが返されます。プロミネンス値が高くなるほど、検出される極値が少なくなります。

局所的最大値 (ピーク) のプロミネンスは、ピークの高さと位置に関して、他のピークを基準としたピークの突出の尺度です。局所的最小値 (谷) のプロミネンスは、谷の深さと位置に関して、他の谷を基準とした谷の突出の尺度です。

`プロミネンスウィンドウ` — プロミネンスの計算対象のウィンドウ
`中央揃え` (既定値) | `非対称`

プロミネンスウィンドウのタイプとサイズを指定して、各局所的極値のプロミネンスの計算対象となる、隣接する点のウィンドウを定義します。

ウィンドウ	説明
`中央揃え`	現在の点を中心にしてウィンドウの長さを指定する
`非対称`	現在の点の前にある要素数と、現在の点の後にある要素数を含むウィンドウを指定する

ウィンドウのサイズは、[X 軸] の変数の単位を基準とします。

バージョン履歴

R2019b で導入

すべて展開する

R2022b: 複数の table 変数のプロット

このライブエディタータスクの表示で、複数の table 変数を同時にプロットします。データが table または timetable の場合、選択したすべての table 変数をタイル表示チャートレイアウトで一度に可視化するには、[表示する変数] フィールドを設定します。

R2022b: 表形式の出力の指定

局所的極値がチェックされた table 変数に対応する logical 変数を使用して table または timetable を出力するか、logical 変数を入力 table に追加します。入力データが table または timetable の場合、表形式を指定するには、[出力形式] フィールドを設定します。

R2022a: 入力に 100 万個を超える要素がある場合、ライブエディタータスクは自動実行されない

入力に 100 万個を超える要素がある場合、このライブエディタータスクは自動実行されません。以前のリリースでは、入力がどのようなサイズでもタスクは必ず自動実行されていました。入力の要素が多い場合、このタスクで生成されたコードは実行にかなりの時間 (数秒間以上) を要することがあります。

タスクが自動的に実行されない場合、自動実行インジケーターが無効になります。必要に応じてタスクを手動で実行するか、タスクの自動実行の有効化を選択することができます。

R2021a: 複数の table 変数の操作

このライブエディタータスクは、複数の table 変数を同時に操作できます。入力データが table または timetable の場合、複数の変数を操作するには、[サポートされているすべての変数] または [指定された変数] を選択します。すべての変数、または変更した変数のみを返し、可視化する変数を指定します。