ドキュメンテーション

最新のリリースでは、このページがまだ翻訳されていません。 このページの最新版は英語でご覧になれます。

Scope, Time Scope

シミュレーション中に生成される信号を表示

  • ライブラリ:
  • Simulink / Commonly Used Blocks

    Simulink / Sinks

説明

Simulink® Scope ブロックと DSP System Toolbox™ Time Scope ブロックには、時間領域信号が表示されます。

この 2 つのブロックの機能は同じですが、既定の設定が異なります。Time Scope は、離散時間処理用に最適化されています。Scope は、一般的な時間領域シミュレーション用に最適化されています。並べて比較する場合は、Simulink スコープと DSP System Toolbox 時間スコープを参照してください。

発振器機能:

  • トリガー - イベントの発生時に反復信号を同期し表示を一時停止するトリガーを設定します。

  • カーソルの測定 - 縦方向のカーソルと横方向のカーソルを使用して信号値を測定します。

  • 信号の統計 - 選択した信号の最大値、最小値、ピーク間の差、平均値、中央値および RMS 値が表示されます。

  • ピークの検出 - 最大値を表示し、それが発生した x 軸の値を表示します。

  • バイレベル測定 - 遷移、オーバーシュート、アンダーシュート、サイクルを測定します。

[ピークの検出]、[バイレベル測定]、および [信号の統計] を使用するには、Simscape™ または DSP System Toolbox のライセンスをもっていなければなりません。

Scope 表示機能:

  • シミュレーション制御 — [実行][ステップを進める]、および [ステップを戻す] のツール バー ボタンを使用して Scope ウィンドウからモデルをデバッグします。

  • 複数の信号 — 複数の入力端子を使用して、同じ y 軸 (表示領域) に複数の信号をプロットします。

  • 複数の y 軸 (表示領域) — 複数の y 軸を表示します。y 軸はすべて x 軸と共通の時間範囲をもっています。

  • パラメーターの変更 - シミュレーションの実行前および実行中にスコープ パラメーターの値を変更します。

  • 軸のオートスケーリング - シミュレーションの実行中または終了時に軸をオートスケールします。座標軸の上部と下部に余白をとります。

  • シミュレーション後にデータを表示 - Scope がシミュレーションの開始時に閉じている場合でも、シミュレーション中にスコープ データがスコープに書き込まれます。その結果、シミュレーション中に Scope を開くと、Scope には接続された入力信号のシミュレーション結果が表示されます。

Scope のプログラムによる制御については、プログラムによる Scope ブロックの制御を参照してください。

制限

  • ライブラリでは Scope ブロックを使用しないでください。ロックされたリンクをもつライブラリ ブロック内またはロックされたライブラリに Scope ブロックを置いた場合、Simulink ではスコープ ウィンドウを開こうとするとエラーが表示されます。ライブラリ ブロックから内部データを表示するには、出力端子をライブラリ ブロックに追加してから、端子をモデル内の Scope ブロックに接続します。

  • Scope ブロックは、定数信号に接続されたときに 1 つの点をプロットする場合があります。

端子

入力

すべて展開する

可視化する信号を接続します。最大 96 の入力端子をもつことができます。入力信号には次の特性があります。

  • タイプ — 連続 (サンプル ベース) または離散 (サンプル ベースとフレーム ベース)。

  • データ型 — Simulink でサポートされるすべてのデータ型。Simulink でサポートされているデータ型を参照してください。

  • 次元 — スカラー、1 次元 (ベクトル)、2 次元 (行列) または多次元 (配列)。次元に応じて 1 つの信号内に複数のチャネルを表示します。信号の次元および出力信号の次元の決定を参照してください。

バス サポート

非バーチャル バス信号とバス信号の配列を Scope ブロックに接続できます。バス信号を表示するには、ノーマルまたはアクセラレータのシミュレーション モードを使用します。Scope ブロックに、各バス要素信号がバスに表示される順序で上から下に表示されます。入れ子にされたバス要素はフラットにされます。

Scope ブロックで非バーチャル バス信号をログに記録するには、[保存形式] ブロック パラメーターを [データセット] に設定します。バーチャル バス信号をログに記録する場合は、任意の [保存形式] を使用できます。

データ型: single | double | int8 | int16 | int32 | uint8 | uint16 | uint32 | Boolean | fixed point | enumerated | bus
複素数のサポート: あり

プロパティ

すべて展開する

コンフィギュレーション プロパティ

[コンフィギュレーション プロパティ] ダイアログ ボックスでは、スコープの表示に関するさまざまなプロパティを制御します。スコープ メニューで [表示][コンフィギュレーション プロパティ] を選択します。

メイン

シミュレーションの開始時にスコープ ウィンドウを開く場合は、このチェック ボックスをオンにします。

プログラムでの使用

OpenAtSimulationStart を参照してください。

ブロック名に加えてブロック パスを表示するには、このチェック ボックスをオンにします。

Scope ブロックの入力端子の数。整数で指定します。入力端子の最大数は 96 です。

プログラムでの使用

NumInputPorts を参照してください。

表示の数と配置を指定します。最大レイアウトは、16 行 16 列です。

レイアウト グリッドを 4 行 4 列を超えて拡張する場合は、ダイアログ ボックス内をクリックしてドラッグします。最大 16 行 16 列です。

表示数が端子の数と等しい場合、各端子の信号が異なる表示領域に表示されます。表示数が端子数よりも少ない場合、追加の端子の信号は最後の表示領域に表示されます。複数の列および行を含むレイアウトの場合、端子は下方向にマップされてから横方向にマップされます。

プログラムでの使用

LayoutDimensions を参照してください。

スコープ表示の更新間の時間間隔を指定します。このプロパティはフローティング スコープとスコープ ビューアーには適用されません。

プログラムでの使用

SampleTime を参照してください。

  • チャネルとしての要素 (サンプル ベース) - 各要素を固有のサンプルとして処理します。

  • チャネルとしての列 (フレーム ベース) - 複数の時間間隔の値をグループとして、チャネルの信号値を処理します。フレームベースの処理は、離散入力信号についてのみ利用できます。

プログラムでの使用

FrameBasedProcessing を参照してください。

  • 自動 - タイトル, TitleタイトルTitleプロパティとY ラベル, Y-labelY ラベルY-labelプロパティが指定されていない場合、すべてのプロットを最大化します。

  • オン - すべてのプロットを最大化します。[タイトル] および [Y ラベル] の値は非表示になります。

  • オフ - プロットを最大化しません。

プログラムでの使用

MaximizeAxes を参照してください。

時間

プログラムでの使用

TimeSpan を参照してください。

表示可能な x 軸の範囲を超えてデータを表示する方法を指定します。

このオプションの効果は、大きなモデルまたは小さいステップ サイズでプロットが遅い場合にのみ確認できます。

  • ラップ — データを左から右に全画面で描画し、画面を消去した後でデータの描画を左から再開します。

  • スクロール — 新しいデータが右に描画されるにしたがってデータを左に移動します。このモードはグラフィックスの負荷が高いので実行速度に影響が出る場合があります。

プログラムでの使用

TimeSpanOverrunAction を参照してください。

  • メトリクス時間範囲, Time span時間範囲Time spanの長さに基づいて時間の単位を表示します。

  • — 時間を秒単位で表示します。

  • なし — 時間の単位を表示しません。

プログラムでの使用

TimeUnits を参照してください。

実数または実数のベクトルとして指定される、指定された時間値で x 軸をオフセットします。

複数のチャネルをもつ入力信号の場合、次のようにスカラーまたはベクトルを入力できます。

  • スカラー — 入力信号のすべてのチャネルを同じ時間値でオフセットします。

  • ベクトル — チャネルを個別にオフセットします。

プログラムでの使用

TimeDisplayOffset を参照してください。

x 軸 (時間) ラベルの表示方法を指定します。

  • すべて — x 軸ラベルをすべての y 軸に表示します。

  • なし — ラベルを表示しません。[なし] を選択すると、[時間軸ラベルの表示] チェック ボックスもオフになります。

  • 下部表示のみ — 下部の y 軸に x 軸ラベルを表示します。

依存関係

このプロパティをアクティブにするには、次を設定します。

アクティブな表示, Active displayアクティブな表示Active displayプロパティで、影響を受ける表示を決定します。

プログラムでの使用

TimeAxisLabels を参照してください。

アクティブな表示で x 軸ラベルを表示するには、このチェック ボックスをオンにします。

依存関係

このプロパティをアクティブにするには、時間軸ラベル, Time-axis labels時間軸ラベルTime-axis labels[すべて] または [下部表示のみ] に設定します。

アクティブな表示, Active displayアクティブな表示Active displayプロパティで、影響を受ける表示を決定します。

プログラムでの使用

ShowTimeAxisLabel を参照してください。

表示

選択された表示。このプロパティを使用して、スタイル プロパティおよび軸固有のプロパティを変更したときに影響される表示を制御します。

列方向の配置インデックスに対応する正の整数を使用して目的の表示を指定します。複数の列と行をもつレイアウトの場合、表示番号は下方向にマップされてから横方向にマップされます。

プログラムでの使用

アクティブな表示, Active displayアクティブな表示Active displayを参照してください。

表示領域のタイトル。文字ベクトルまたは string として指定します。既定値の %<SignalLabel> では、入力信号名がタイトルに使用されます。

依存関係

アクティブな表示, Active displayアクティブな表示Active displayプロパティで、影響を受ける表示を決定します。

プログラムでの使用

Title を参照してください。

信号の凡例の表示を切り替えます。凡例に示される名前はモデルの信号名です。複数のチャネルをもつ信号の場合は、信号名の後にチャネル インデックスが追加されます。連続信号の場合は名前の前に直線が示され、離散信号の場合は階段状の線が示されます。

凡例から、表示可能な信号を制御できます。この制御は、[スタイル] プロパティで可視性を変更するのと同じです。スコープの凡例で、信号名をクリックしてスコープの信号を非表示にします。信号を表示するには、信号名を再度クリックします。1 つの信号のみを表示するには、信号名を右クリックし、他のすべての信号を非表示にします。すべての信号を表示するには、Esc キーを押します。

依存関係

アクティブな表示, Active displayアクティブな表示Active displayプロパティで、影響を受ける表示を決定します。

プログラムでの使用

ShowLegend を参照してください。

グリッド ラインを表示するにはこのチェック ボックスをオンにします。

依存関係

アクティブな表示, Active displayアクティブな表示Active displayプロパティで、影響を受ける表示を決定します。

プログラムでの使用

ShowGrid を参照してください。

  • オン — 振幅と位相のプロットを表示します。信号が実数の場合、振幅として信号の絶対値をプロットします。位相は、正の値の場合は 0 度、負の値の場合は 180 度になります。この機能は、複素数値の入力信号の場合に役に立ちます。入力が実数値の信号である場合、このチェック ボックスをオンにすると、振幅について信号の絶対値が返されます。

  • オフ — 信号プロットを表示します。信号が複素数の場合、実数部と虚数部を同じ y 軸にプロットします。

依存関係

アクティブな表示, Active displayアクティブな表示Active displayプロパティで、影響を受ける表示を決定します。

プログラムでの使用

PlotAsMagnitudePhase を参照してください。

y 軸の最小値を実数として指定します。

調整可能: Yes

依存関係

[信号を振幅および位相としてプロット] を選択すると、このプロパティは振幅プロットにのみ適用されます。位相プロットの y 軸の範囲は常に [-180 180] です。

アクティブな表示, Active displayアクティブな表示Active displayプロパティで、影響を受ける表示を決定します。

プログラムでの使用

YLimits を参照してください。

y 軸の最大値を実数として指定します。

調整可能: Yes

依存関係

[信号を振幅および位相としてプロット] を選択すると、このプロパティは振幅プロットにのみ適用されます。位相プロットの y 軸の範囲は常に [-180 180] です。

アクティブな表示, Active displayアクティブな表示Active displayプロパティで、影響を受ける表示を決定します。

プログラムでの使用

YLimits を参照してください。

y 軸に表示するテキストを指定します。信号の単位を表示するには、ラベルに (%<SignalUnits>) を追加します。シミュレーションの開始時に、Simulink は (%SignalUnits) を信号に関連付けられている単位と置き換えます。

例: m/s の単位を使用する速度信号の場合は、Velocity (%<SignalUnits>) を入力します。

依存関係

[信号を振幅および位相としてプロット] を選択する場合、このプロパティは適用されません。y 軸には Magnitude および Phase のラベルが付きます。

アクティブな表示, Active displayアクティブな表示Active displayプロパティで、影響を受ける表示を決定します。

プログラムでの使用

YLabel を参照してください。

ログ

信号をプロットおよび保存する前にバッファー データの値を制限することを指定します。データ値はシミュレーションの最後の時点から取得されます。このプロパティを使用するには、テキスト ボックスに正の整数を入力してデータ値の数も指定しなければなりません。

  • オン — 各信号に対して指定された数のデータ値を保存します。信号がフレーム ベースの場合、バッファー データ値の数は、指定されたデータ値の数にフレーム サイズが乗算された数です。

    [終了時間]inf に設定されたシミュレーションの場合は、[データ点の制限] を選択することを検討してください。

    サンプル時間が短い場合などに、このパラメーターを選択すると、信号のプロットに効果を与える時間が、シミュレーション全体の時間範囲よりも短くなる可能性があります。スコープで信号の一部がプロットされる場合は、保存するデータ値の数を増やすことを検討してください。

  • オフ — すべてのデータ値を保存してプロットします。[データ点の制限] をオフにすると、大量のデータを生成するシミュレーションまたは使用可能なメモリが十分にないシステムでメモリ不足エラーが発生する可能性があります。

依存関係

このプロパティを有効にするには、ワークスペースにデータのログを作成, Log data to workspaceワークスペースにデータのログを作成Log data to workspaceを選択します。

このプロパティは、スコープでプロットされるデータ値および保存されたデータ値を、変数名, Variable name変数名Variable nameで指定された MATLAB® 変数に制限します。

プログラムでの使用

DataLoggingLimitDataPoints および DataLoggingMaxPoints を参照してください。

  • オン — N 番目のデータ点ごとにスコープ データをプロットおよびログ記録 (保存) します。ここで N はテキスト ボックスに入力される間引き係数です。値 1 はすべてのデータ値をバッファーします。

  • オフ — すべてのスコープ データ値を保存します。

依存関係

このプロパティを有効にするには、ワークスペースにデータのログを作成, Log data to workspaceワークスペースにデータのログを作成Log data to workspaceを選択します。

このプロパティは、スコープでプロットされるデータ値および保存されたデータ値を、変数名, Variable name変数名Variable nameで指定された MATLAB 変数に制限します。

プログラムでの使用

DataLoggingDecimateData および DataLoggingDecimation を参照してください。

ログ記録を有効にし、[変数名][保存形式] および [間引き] プロパティを有効にするには、このチェック ボックスをオンにします。このプロパティはフローティング スコープとスコープ ビューアーには適用されません。

Scope ブロックを使用して MATLAB ワークスペースに信号を保存する例については、Floating Scope ブロックを使用したシミュレーション データの保存を参照してください。

プログラムでの使用

DataLogging を参照してください。

MATLAB ワークスペースにスコープ データを保存する変数名を文字ベクトルまたは string として指定します。このプロパティはフローティング スコープとスコープ ビューアーには適用されません。

依存関係

このプロパティを有効にするには、ワークスペースにデータのログを作成, Log data to workspaceワークスペースにデータのログを作成Log data to workspaceを選択します。

プログラムでの使用

DataLoggingVariableName を参照してください。

MATLAB ワークスペースにデータを保存する変数形式を選択します。このプロパティはフローティング スコープとスコープ ビューアーには適用されません。

  • データセット — データセット オブジェクトとしてデータを保存します。[データセットの信号形式] コンフィギュレーション パラメーターを使用して、データセット オブジェクトを選択します。この形式は、可変サイズのデータ、MAT ファイルのログ、エクスターナル モードのアーカイブには対応していません。Simulink.SimulationData.Dataset を参照してください。

  • 時間付き構造体 — 関連付けられた時間情報をもつ構造体としてデータを保存します。

  • 構造体 — 構造体としてデータを保存します。

  • 配列 — 関連付けられた時間情報をもつ配列としてデータを保存します。この形式は可変サイズ データをサポートしません。

依存関係

このプロパティを有効にするには、ワークスペースにデータのログを作成, Log data to workspaceワークスペースにデータのログを作成Log data to workspaceを選択します。

プログラムでの使用

DataLoggingSaveFormat を参照してください。

座標軸スケーリングのプロパティ

[座標軸のスケーリング] ダイアログで、スコープの座標軸の範囲を制御します。[座標軸スケーリングのプロパティ] を開くには、スコープ メニューで、[ツール][座標軸のスケーリング][座標軸スケーリングのプロパティ] を選択します。

プログラムでの使用

AxesScaling を参照してください。

シミュレーション中に y 軸の範囲限界値を増やすことはできますが、減らすことはできません。

依存関係

このプロパティを使用するには、座標軸のスケーリング, Axes scaling座標軸のスケーリングAxes scaling 座標軸のスケーリング, Axes scaling座標軸のスケーリングAxes scaling[自動] に設定します。

y 軸の自動スケーリングを遅らせる場合は、このプロパティを設定します。

依存関係

このプロパティを使用するには、座標軸のスケーリング, Axes scaling座標軸のスケーリングAxes scaling 座標軸のスケーリング, Axes scaling座標軸のスケーリングAxes scaling[N 回の更新後] に設定します。

プログラムでの使用

AxesScalingNumUpdates を参照してください。

  • オン — シミュレーションが停止したときに座標軸をスケーリングします。

  • オフ — 座標軸を継続的にスケーリングします。

依存関係

このプロパティを使用するには、座標軸のスケーリング, Axes scaling座標軸のスケーリングAxes scaling 座標軸のスケーリング, Axes scaling座標軸のスケーリングAxes scaling[自動] に設定します。

データのプロットに使用される y 軸の範囲の割合を指定します。このプロパティを 100 に設定すると、プロットされたデータでは y 軸の範囲全体が使用されます。

Y 軸の [データ範囲] が 100% 未満に設定されている場合に、プロットしたデータを y 軸のデータ範囲のどこに配置するか指定します。

  • — 最大値が y 軸の範囲の一番上になるように信号を配置します。

  • 中央 — 信号を最小値と最大値の間の中央に配置します。

  • — 最小値が y 軸の範囲の一番下になるように信号を配置します。

すべての信号値に適合するように x 軸の範囲をスケーリングします。[座標軸のスケーリング] が [Auto] に設定されている場合に、データ バッファー内のすべての信号ではなく、現在の座標軸内にあるデータのみがスケーリングされます。

データをプロットする x 軸の範囲の割合を指定します。たとえば、このプロパティを 100 に設定すると、プロットされたデータでは x 軸の範囲全体が使用されます。

X 軸の [データ範囲] が 100% 未満に設定されている場合に、プロットしたデータを x 軸のデータ範囲のどこに配置するか指定します。

  • — 最大値が x 軸の範囲の一番上になるように信号を配置します。

  • 中央 — 信号を最小値と最大値の間の中央に配置します。

  • — 最小値が x 軸の範囲の一番下になるように信号を配置します。

スタイル プロパティ

[スタイル] ダイアログ ボックスを開くには、スコープ メニューで [表示][スタイル] を選択します。

スコープの背景色。

[自動] を選択すると、プロット タイプは、連続信号の場合は線グラフ、離散信号の場合は階段状グラフ、Simulink メッセージ信号の場合はステム グラフになります。

最初のカラー パレットで座標軸 (表示領域) の背景色を選択します。2 番目のカラー パレットでグリッドとラベルの色を選択します。

コピーする際にスコープの表示された色を使用するかどうかを指定します。

[ファイル][クリップボードにコピー] を選択すると、スコープの色がプリンターに合わせて変更されます (白い背景色、線を表示)。表示された色でスコープをコピーし貼り付ける場合は、このチェック ボックスをオンにします。

ラインのスタイル プロパティを設定するアクティブなラインを選択します。

プロットの信号を表示または非表示にします。

依存関係

アクティブな表示, Active displayアクティブな表示Active displayおよびラインのプロパティ, Properties for lineラインのプロパティProperties for lineの値によって、影響を受けるラインが決まります。

ラインのスタイル、幅、色を選択します。

依存関係

アクティブな表示, Active displayアクティブな表示Active displayおよびラインのプロパティ, Properties for lineラインのプロパティProperties for lineの値によって、影響を受けるラインが決まります。

マーカー形状を選択します。

依存関係

アクティブな表示, Active displayアクティブな表示Active displayおよびラインのプロパティ, Properties for lineラインのプロパティProperties for lineの値によって、影響を受けるラインが決まります。

ブロックの特性

データ型

double | single | Boolean | base integer | fixed point | enumerated | bus[a]

直接フィードスルー

なし

多次元信号

あり

可変サイズの信号

あり

ゼロクロッシング検出

なし

[a] バーチャル バスはサポートされません。非バーチャル バスは、ノーマル モードおよびアクセラレータ モードのシミュレーションでのみサポートされます。非バーチャル バスのデータ ログはデータセット形式でのみサポートされます

拡張機能

PLC コード生成
Simulink® PLC Coder™ を使用して構造化テキスト コードを生成します。

固定小数点の変換
Fixed-Point Designer™ を使用して浮動小数点アルゴリズムを固定小数点に変換します。

R2015b で導入