最新のリリースでは、このページがまだ翻訳されていません。 このページの最新版は英語でご覧になれます。
Time Scope, Scope
シミュレーション時に生成された信号を表示して解析し、信号データを MATLAB に記録
- ライブラリ:
DSP System Toolbox / Sinks
説明
Simulink® Scope ブロックと DSP System Toolbox™ Time Scope ブロックは時間領域信号を表示します。
2 つのブロックの機能は同じですが、既定の設定は異なります。Time Scope は離散時間の処理向けに最適化されています。Scope は一般的な時間領域シミュレーション向けに最適化されています。左右に並べて比較する場合は、Simulink スコープと DSP System Toolbox 時間スコープ (Simulink)を参照してください。
オシロスコープの機能:
ピークの検出、バイレベル測定、信号の統計を使用するには、Simscape™ または DSP System Toolbox のライセンスが必要です。
スコープの表示機能:
シミュレーション コントロール — [実行]、[1 ステップ進む]、および [Step Backward] ツール バー ボタンを使用して、スコープ ウィンドウからモデルをデバッグします。
複数の信号 — 複数の入力端子を使用して、同じ y 軸 (表示) 上で複数の信号をプロットします。
複数の y 軸 (表示) — 複数の y 軸を表示します。すべての y 軸が x 軸上に共通の時間範囲をもっています。
パラメーターの変更 — シミュレーション前およびシミュレーション中にスコープのパラメーター値を変更します。
軸のオートスケーリング — シミュレーション中またはシミュレーションの最後に座標軸をオートスケールします。座標軸の上下に余白が描画されます。
シミュレーション後にデータを表示 — シミュレーションの開始時にスコープが閉じられた場合、スコープ データはシミュレーション中に引き続きそのスコープに書き込まれます。その結果、シミュレーション後にスコープを開くと、そのスコープには付加された入力信号のシミュレーション結果が表示されます。
プログラムによるスコープの制御の詳細については、プログラムによる Scope ブロックの制御 (Simulink)を参照してください。
制限
ライブラリでは Scope ブロックを使用しないでください。ロックされたリンクをもつライブラリ ブロック内またはロックされたライブラリに Scope ブロックを配置すると、スコープ ウィンドウを開こうとするときに Simulink によってエラーが表示されます。ライブラリ ブロックの内部データを表示するには、ライブラリ ブロックに出力端子を追加して、その端子をモデル内の Scope ブロックに接続します。
Scope ブロックは定数信号に接続されたときに 1 つの点をプロットする場合があります。
端子
入力
プロパティ
コンフィギュレーション プロパティ
[コンフィギュレーション プロパティ] ダイアログ ボックスでは、スコープの表示に関するさまざまなプロパティを制御します。スコープ メニューで [表示] 、 [コンフィギュレーション プロパティ] を選択します。
メイン
Open at simulation start — スコープ ウィンドウを開くタイミングを指定する
オフ (Scope の既定の設定) | オン (Time Scope の既定の設定)
Display the full path — スコープのタイトル バーにブロックのパスを表示
off (既定値) | on
このチェック ボックスをオンにすると、ブロックの名前の他にブロックのパスが表示されます。
Number of input ports — Scope ブロック上の入力端子の数
1 (既定値) | 整数
Layout — 表示領域の数と配置
1 行 1 列の表示領域 (既定値) | m 行 n 列の座標軸の配置
表示領域の数と配置を指定します。最大レイアウトは 16 行 16 列です。
レイアウト グリッドを拡張して 4 行 4 列より大きくするには、ダイアログ ボックス内をクリックしてドラッグします。最大で 16 行 16 列です。
表示領域の数が端子の数と等しい場合、端子ごとの信号が個別の表示領域に表示されます。表示領域の数が端子の数より少ない場合、追加の端子からの信号が最後の表示領域に表示されます。複数の列と行を含むレイアウトでは、端子は下方向にマッピングされてから横方向にマッピングされます。
プログラムからの使用
LayoutDimensions を参照してください。
Sample time — スコープの更新間のシミュレーション間隔
-1 (継承向け) (既定値) | 正の実数
Input processing — チャネルまたは要素信号の処理
チャネルとしての要素 (サンプル ベース) (Scope の既定の設定) | チャネルとしての列 (フレーム ベース) (Time Scope の既定の設定)
[チャネルとしての要素 (サンプル ベース)]— 各要素を一意のサンプルとして処理します。[チャネルとしての列 (フレーム ベース)]- チャネルの信号値を複数の時間間隔からの値のグループとして処理します。フレームベースの処理は、離散入力信号でのみ使用できます。
プログラムからの使用
FrameBasedProcessing を参照してください。
Maximize axes — プロットのサイズを最大化
オフ (Scope の既定の設定) | 自動 (Time Scope の既定の設定) | オン
時間
Time span — 表示する x 軸の長さ
自動 (既定値) | ユーザー定義
[自動]— シミュレーションの開始時間と終了時間の差分。ブロックでは、Time display offsetプロパティとTime spanプロパティを使用して時間範囲の開始時間と終了時間を計算します。たとえば、[時間表示オフセット] を
10に設定し、[時間範囲] を20に設定する場合、スコープは10から30の時間範囲を設定します。ユーザー定義— 合計シミュレーション時間より小さい任意の値を入力します。
プログラムからの使用
TimeSpan を参照してください。
Time span overrun action — 表示されている x 軸を超えるデータを表示
ラップ (既定値) | スクロール
表示されている x 軸の範囲を超えるデータを表示する方法を指定します。
モデルが大規模であったり、ステップ サイズが小さくてプロットが低速である場合にのみ、このオプションの効果を確認できます。
ラップ— 左から右にデータを全画面に描画し、画面をクリアして、左からデータの描画を再開します。スクロール— 新しいデータを右側に描画しながら、データを左側に移動させます。このモードはグラフィックスの負荷が高いので実行速度に影響が出る場合があります。
プログラムからの使用
TimeSpanOverrunAction を参照してください。
Time display offset — x 軸のオフセット
0 (既定値) | スカラー | ベクトル
指定された時間値によって x 軸をオフセットします。実数または実数のベクトルとして指定します。
複数のチャネルをもつ入力信号の場合、スカラーまたはベクトルを入力できます。
スカラー — 入力信号のすべてのチャネルを同じ時間値でオフセットします。
ベクトル — チャネルを個別にオフセットします。
プログラムからの使用
TimeDisplayOffset を参照してください。
Time-axis labels — x 軸ラベルの表示
下部表示のみ (Scope の既定の設定) | すべて (Time Scope の既定の設定) | None
x 軸 (時間) のラベルの表示方法を指定します。
すべて— x 軸のラベルをすべての y 軸上に表示します。なし— ラベルを表示しません。[なし]を選択すると [時間軸ラベルの表示] チェック ボックスもオフになります。下部表示のみ— x 軸のラベルを下部の y 軸上に表示します。
依存関係
このプロパティをアクティブにするには、次のように設定します。
Show time-axis labelをオンに設定する。
Maximize axesをオフに設定する。
Active displayプロパティによって、影響を受ける表示が決まります。
プログラムからの使用
TimeAxisLabels を参照してください。
Show time-axis label — x 軸ラベルを表示または非表示
オフ (Scope の既定の設定) | オン (Time Scope の既定の設定)
アクティブな表示に対して x 軸のラベルを表示するには、このチェック ボックスを選択します。
依存関係
このプロパティをアクティブにするには、Time-axis labelsを [すべて] または [下部表示のみ] に設定します。
Active displayプロパティによって、影響を受ける表示が決まります。
プログラムからの使用
ShowTimeAxisLabel を参照してください。
Display
Active display — 選択した表示領域
1 (既定値) | 正の整数
選択した表示領域。このプロパティを使用して、スタイルのプロパティや座標軸固有のプロパティを変更したときに変更される表示領域を制御します。
列方向の配置インデックスに対応する正の整数を使用して、目的の表示領域を指定します。複数の列と行を含むレイアウトでは、表示番号は下方向にマッピングされてから横方向にマッピングされます。
プログラムからの使用
Active displayを参照してください。
Title — 表示名
%<SignalLabel> (既定値) | 文字ベクトル | string
表示のタイトル。文字ベクトルまたは string として指定します。既定値 %<SignalLabel> ではタイトルに対して入力信号名が使用されます。
依存関係
Active displayプロパティによって、影響を受ける表示が決まります。
プログラムからの使用
Title を参照してください。
Show legend — 信号の凡例を表示
off (既定値) | on
信号の凡例の表示/非表示を切り替えます。凡例にリストされている名前はモデルから取得した信号名です。複数のチャネルをもつ信号の場合、信号名の後ろにチャネル インデックスが追加されます。連続信号には名前の前に直線があり、離散信号にはステップ状の線があります。
表示する信号を凡例から制御できます。この制御は、[スタイル] プロパティでの可視性の変更と等価です。スコープの凡例で、信号名をクリックするとそのスコープ内の信号が非表示になります。信号を表示する場合は、信号名を再度クリックします。信号を 1 つのみ表示する場合は信号名を右クリックします。これにより、他のすべての信号が非表示になります。すべての信号を表示するには Esc キーを押します。
依存関係
Active displayプロパティによって、影響を受ける表示が決まります。
プログラムからの使用
ShowLegend を参照してください。
Show grid — 内部グリッド線を表示
on (既定値) | off
グリッド ラインを表示するには、このチェック ボックスをオンにします。
依存関係
Active displayプロパティによって、影響を受ける表示が決まります。
プログラムからの使用
ShowGrid を参照してください。
Plot signals as magnitude and phase — 表示領域を振幅プロットと位相プロットに分割
off (既定値) | on
オン — 振幅プロットと位相プロットを表示します。信号が実数である場合、振幅について信号の絶対値がプロットされます。位相は、正の値の場合には 0°、負の値の場合には 180° になります。この機能は、複素数値の入力信号の場合に役に立ちます。入力が実数値の信号である場合、このチェック ボックスをオンにすると、振幅について信号の絶対値が返されます。
オフ — 信号のプロットを表示します。信号が複素数である場合、同じ y 軸上で実数部と虚数部をプロットします。
依存関係
Active displayプロパティによって、影響を受ける表示が決まります。
プログラムからの使用
PlotAsMagnitudePhase を参照してください。
Y-limits (Minimum) — y 軸の最小値
-10 (既定値) | 実数スカラー
y 軸の最小値を実数値として指定します。
調整可能: Yes
依存関係
[信号を振幅および位相としてプロット] をオンにすると、このプロパティは振幅プロットにのみ適用されます。位相プロットの y 軸範囲は常に [-180 180] となります。
Active displayプロパティによって、影響を受ける表示が決まります。
プログラムからの使用
YLimits を参照してください。
Y-limits (Maximum) — y 軸の最大値
10 (既定値) | 実数スカラー
y 軸の最大値を実数値として指定します。
調整可能: Yes
依存関係
[信号を振幅および位相としてプロット] をオンにすると、このプロパティは振幅プロットにのみ適用されます。位相プロットの y 軸範囲は常に [-180 180] となります。
Active displayプロパティによって、影響を受ける表示が決まります。
プログラムからの使用
YLimits を参照してください。
Y-label — Y 軸ラベル
なし (Scope の既定の設定) | 'Amplitude' (Time Scope の既定の設定) | 文字ベクトル | string
y 軸上に表示するテキストを指定します。信号の単位を表示するには、(%<SignalUnits>) をラベルに追加します。シミュレーションの開始時に、Simulink は (%SignalUnits) を信号に関連付けられた単位で置き換えます。
例: 単位が m/s の速度信号の場合、「Velocity (%<SignalUnits>)」と入力します。
依存関係
[信号を振幅および位相としてプロット] をオンにすると、このプロパティは適用されません。y 軸には Magnitude および Phase というラベルが付けられます。
Active displayプロパティによって、影響を受ける表示が決まります。
プログラムからの使用
YLabel を参照してください。
ログ記録
Limit data points to last — バッファーされたデータ値を制限
オフおよび 5000 (既定値) | on | 正の整数
信号をプロットおよび保存する前に、バッファーされたデータ値を制限することを指定します。データ値はシミュレーションの終わりから取得されます。このプロパティを使用するには、テキスト ボックスに正の整数を入力することでデータ値の数も指定しなければなりません。
オン — 各信号の指定された数のデータ値を保存します。信号がフレームベースの場合、バッファーされたデータ値の数は指定されたデータ値の数とフレーム サイズの積になります。
[終了時間] が
infに設定されたシミュレーションの場合、[データ点の制限] を選択することを検討してください。場合によっては (たとえば、サンプル時間が短い場合など)、このパラメーターを選択することで、シミュレーションの時間範囲全体の一部でしか信号をプロットしないという結果になる可能性があります。スコープが信号の一部をプロットする場合は、保存するデータ値の数を増やすことを検討してください。
オフ — すべてのデータ値を保存およびプロットします。[データ点の制限] をオフにすると、大量のデータを生成するシミュレーションや使用可能な十分なメモリを持たないシステムでメモリ不足エラーが発生する可能性があります。
依存関係
このプロパティを有効にするには、ワークスペースにデータのログを作成, Log data to workspaceワークスペースにデータのログを作成Log data to workspace (Simulink)を選択します。
このプロパティは、スコープでプロットされるデータ値と、Variable nameで指定された MATLAB® 変数に保存されるデータ値を制限します。
プログラムからの使用
DataLoggingLimitDataPoints および DataLoggingMaxPoints を参照してください。
Decimation — 表示および保存するスコープのデータ量を削減
オフ、2 (既定値) | on | 正の整数
オン — スコープ データを
N番目のデータ点ごとにプロットおよび記録 (保存) します。ここで、Nはテキスト ボックスに入力された間引き係数です。値1はすべてのデータ値をバッファーします。オフ — すべてのスコープ データ値を保存します。
依存関係
このプロパティを有効にするには、ワークスペースにデータのログを作成, Log data to workspaceワークスペースにデータのログを作成Log data to workspace (Simulink)を選択します。
このプロパティは、スコープでプロットされるデータ値と、Variable nameで指定された MATLAB 変数に保存されるデータ値を制限します。
プログラムからの使用
DataLoggingDecimateData および DataLoggingDecimation を参照してください。
Log data to workspace — MATLAB ワークスペースにデータを保存
off (既定値) | on
このチェック ボックスをオンにするとログ記録がアクティブ化され、[変数名] プロパティ、[保存形式] プロパティ、および [間引き] プロパティがアクティブ化されます。このプロパティはフローティング スコープとスコープ ビューアーには適用されません。
Scope ブロックを使用して MATLAB ワークスペースに信号を保存する例については、Floating Scope ブロックを使用したシミュレーション データの保存 (Simulink)を参照してください。
プログラムからの使用
DataLogging を参照してください。
Variable name — 保存されたデータ変数の名前
ScopeData (既定値) | 文字ベクトル | string
スコープ データを MATLAB ワークスペースに保存する際の変数名を文字ベクトルまたは string として指定します。このプロパティはフローティング スコープとスコープ ビューアーには適用されません。
依存関係
このプロパティを有効にするには、ワークスペースにデータのログを作成, Log data to workspaceワークスペースにデータのログを作成Log data to workspace (Simulink)を選択します。
プログラムからの使用
DataLoggingVariableName を参照してください。
Save format — MATLAB 変数の形式
データセット (既定値) | 時間付き構造体 | 構造体 | 配列
データを MATLAB ワークスペースに保存する際の変数の形式を選択します。このプロパティはフローティング スコープとスコープ ビューアーには適用されません。
データセット— データをデータセット オブジェクトとして保存します。[データセットの信号形式] コンフィギュレーション パラメーターを使用して、データセット オブジェクトを選択します。この形式は、可変サイズのデータ、MAT ファイルのログ、エクスターナル モードのアーカイブには対応していません。Simulink.SimulationData.Datasetを参照してください。時間付き構造体— データを時間の情報が関連付けられた構造体として保存します。構造体— データを構造体として保存します。配列— データを時間の情報が関連付けられた配列として保存します。この形式は可変サイズのデータをサポートしていません。
依存関係
このプロパティを有効にするには、ワークスペースにデータのログを作成, Log data to workspaceワークスペースにデータのログを作成Log data to workspace (Simulink)を選択します。
プログラムからの使用
DataLoggingSaveFormat を参照してください。
座標軸スケーリングのプロパティ
[座標軸のスケーリング] ダイアログでは、スコープの座標軸の範囲を制御します。座標軸スケーリングのプロパティを開くには、スコープ メニューで [ツール] 、 [座標軸のスケーリング] 、 [座標軸スケーリングのプロパティ] を選択します。
Axes scaling — Y 軸のスケーリング モード
手動 (既定値) | 自動 | N 回の更新後
手動— [Y 軸の範囲をスケール] ツール バー ボタンを使用して、y 軸の範囲を手動でスケーリングします。自動— シミュレーション中およびシミュレーション後に y 軸の範囲をスケーリングします。このオプションを選択すると、Do not allow Y-axis limits to shrinkチェック ボックスが表示されます。信号の最大値を使用して Y 軸の範囲を増加および削減する場合は、[座標軸のスケーリング] を[自動]に設定し、[Y 軸範囲を縮小させない] チェック ボックスをオフにします。N 回の更新後— Number of updatesテキスト ボックスで指定されたタイム ステップ数 (既定値 10) の後y軸をスケーリングします。スケーリングは各実行中に 1 回のみ実行されます。
プログラムからの使用
AxesScaling を参照してください。
Do not allow Y-axis limits to shrink — Y 軸の範囲を変更するタイミング
on (既定値) | off
Number of updates — スケーリング前の更新回数
10 (既定値) | 整数
このプロパティを設定すると、y 軸の自動スケーリングが遅延されます。
依存関係
このプロパティを使用するには、Axes scalingを [N 回の更新後] に設定します。
プログラムからの使用
AxesScalingNumUpdates を参照してください。
Scale axes limits at stop — Y 軸の範囲を変更するタイミング
on (既定値) | off
オン — シミュレーションが停止したときに座標軸をスケーリングします。
オフ — 座標軸を連続的にスケーリングします。
依存関係
このプロパティを使用するには、Axes scalingを [自動] に設定します。
Y-axis Data range (%) — プロットに使用する y 軸の割合
80 (既定値) | [1, 100] の間の整数
データのプロットに使用する y 軸の範囲の割合を指定します。このプロパティを 100 に設定すると、プロットされたデータは y 軸の範囲全体を使用します。
Y-axis Align — y 軸に沿った配置
Center (既定値) | Top | Bottom
Y 軸の [データ範囲] が 100 パーセントより小さい値に設定されている場合に、プロットされたデータを y 軸のデータ範囲に沿って配置する位置を指定します。
上— y 軸の範囲の最大値をもつ信号を整列します。中央— 最小値と最大値の間の中央に信号を配置します。下— y 軸の範囲の最小値をもつ信号を整列します。
Autoscale X-axis limits — x 軸の範囲限界値をスケーリング
off (既定値) | on
すべての信号値に適合するように xx 軸の範囲をスケーリングします。[座標軸のスケーリング] が Auto に設定されている場合、データ バッファー内の全体の信号ではなく、現在軸内にあるデータがスケーリングされます。
X-axis Data range (%) — プロットに使用する x 軸の割合
100 (既定値) | 範囲 [1, 100] の整数
データをプロットする x 軸の範囲の割合を指定します。たとえば、このプロパティを 100 に設定すると、プロットされたデータは x 軸の範囲全体を使用します。
X-axis Align — x 軸に沿った配置
Center (既定値) | Top | Bottom
[X-axis Data range] が 100 パーセントより小さい値に設定されている場合に、プロットされたデータを x 軸のデータ範囲に沿って配置する位置を指定します。
上— x 軸の範囲の最大値をもつ信号を整列します。中央— 最小値と最大値の間の中央に信号を配置します。下— x 軸の範囲の最小値をもつ信号を整列します。
スタイルのプロパティ
[スタイル] ダイアログ ボックスを開くには、スコープ メニューから [表示] 、 [スタイル]を選択します。
Figure color — ウィンドウの背景色
黒 (既定値) | 色
スコープの背景色。
Plot type — 信号のプロット方法
自動 (Scope の既定の設定) | ライン (Time Scope の既定の設定) | 階段状プロット | ステム
[自動] を選択すると、プロット タイプは、連続信号の場合は線グラフ、離散信号の場合は階段状グラフ、Simulink メッセージ信号の場合はステム グラフになります。
Axes colors — 個々の表示の背景と座標軸の色
黒 (既定値) | 色
最初のカラー パレットでは、座標軸 (表示) の背景色を選択します。2 番目のカラー パレットでは、グリッドとラベルの色を選択します。
Preserve colors for copy to clipboard — 色を変更せずにスコープをコピー
off (既定値) | on
スコープのコピー時に表示されている色をそのまま使用するかどうかを指定します。
[ファイル] 、 [クリップボードにコピー] を選択すると、ソフトウェアによってスコープの色がプリンター用 (背景色が白、ラインを表示) に変更されます。表示された色のままスコープをコピーして貼り付けるには、このチェック ボックスをオンにします。
Properties for line — 変更するライン
チャネル 1 (既定値)
ライン スタイル プロパティを設定するアクティブなラインを選択します。
Visible — ライン表示
on (既定値) | off
Line — ライン スタイル
実線 (既定のスタイル) | 0.75 (既定の幅) | 黄色 (既定の色)
Marker — データ点のマーカー スタイル
None (既定値) | マーカー形状
ブロックの特性
拡張機能
参考
ブロック
System object
トピック
- 対話によるモデルのシミュレーション (Simulink)
- シミュレーションのステップ実行 (Simulink)
- 一般的な Scope ブロックの相互作用 (Simulink)
- フローティング スコープおよびスコープ ビューアー タスク (Simulink)
- スコープの [トリガー] パネル (Simulink)
- [カーソルの測定] パネル (Simulink)
- スコープの [信号の統計] パネル (Simulink)
- スコープの [バイレベル測定] パネル (Simulink)
- [ピークの検出] の測定値のパネル (Simulink)
- プログラムによる Scope ブロックの制御 (Simulink)
