slwebview

R2026b

Web ビューへの Simulink モデルのエクスポート

ページ内をすべて折りたたむ

構文

slwebview
filename = slwebview(sysname)
filename = slwebview(folder)
filename = slwebview(sysname,Name=Value)

説明

slwebview は、レポート エクスプローラーの [Web ビュー] ダイアログ ボックスを開きます。

filename = slwebview(sysname) は、サブシステム system_name およびその子システムをファイル filename にエクスポートします。サブシステムを含むモデルが開いている必要があります。

例

filename = slwebview(folder) は、指定したフォルダー内のすべてのモデルをエクスポートします。サブフォルダー内のモデルを含めるには、RecurseFolderを参照してください。

filename = slwebview(sysname,Name=Value) は、1 つ以上の名前と値の引数で指定された追加オプションを提供します。

例

例

すべて折りたたむ

sldemo_fuelsys モデルを開きます。

openExample("sldemo_fuelsys")

Engine Gas Dynamics サブシステムと、それを含むシステムを Web ビューにエクスポートします。このサブシステムに含まれるサブシステムはエクスポートしません。

fuelsys_web_view = slwebview("sldemo_fuelsys/Engine Gas Dynamics", ...
    SearchScope="CurrentAndAbove")

Engine_Gas_Dynamics フォルダーに移動して、webview.html を開きます。

Web view showing the Engine Gas Dynamics subsystem.

詳細については、Web ビューの表示とナビゲーションを参照してください。

sldemo_fuelsys モデルを開きます。

openExample("sldemo_fuelsys")

モデルを Web ビューにエクスポートします。エクスポートにモデル参照を含めます。

fuelsys_web_view = slwebview("sldemo_fuelsys", ...
    FollowModelReference=true)

sldemo_fuelsys フォルダーに移動して、webview.html を開きます。詳細については、Web ビューの表示とナビゲーションを参照してください。

fuel_rate_control ブロックをクリックしてブロック プロパティを表示します。ブロックをダブルクリックして参照モデルを表示します。

Web view showing the sldemo_fuelsys model.

入力引数

すべて折りたたむ

Web ビュー ファイルにエクスポートするシステム。システムへのパス、またはサブシステム、ブロック線図、チャート、サブチャートへのハンドルを含む文字ベクトルまたは string スカラーとして指定します。既定では、この関数は sysname システムの子システムもエクスポートします。sysname を基準としてエクスポートする他のシステムを指定するには、名前と値の引数 SearchScope を使用します。

例: "sysname"

1 つ以上のモデル ファイルが含まれるファイル フォルダーへのパス。文字ベクトルまたは string スカラーとして指定します。この関数は、フォルダー内のすべてのモデルをエクスポートします。

データ型: char | string

名前と値の引数

すべて折りたたむ

オプションの引数のペアを Name1=Value1,...,NameN=ValueN として指定します。ここで、Name は引数名で、Value は対応する値です。名前と値の引数は他の引数の後に指定しなければなりませんが、ペアの順序は重要ではありません。

R2021a より前では、コンマを使用して名前と値をそれぞれ区切り、Name を引用符で囲みます。

例: htmlFileName = slwebview(gcs,LookUnderMasks="all",... FollowLinks=true) マスクされたブロックの内容とライブラリ リンクを含め、現在のシステムを含むモデルの階層構造のすべてのレイヤーを Web ビューにエクスポートします。

sysname システムを基準とした、エクスポート対象のシステム。次の値のいずれかとして指定します。

  • "CurrentAndBelow" — sysname で指定された Simulink® システムまたは Stateflow® チャート、およびそれに含まれるシステムまたはチャートをエクスポートします。

  • "Current" — sysname で指定された Simulink システムまたは Stateflow チャートのみをエクスポートします。

  • "CurrentAndAbove" — sysname で指定された Simulink システムまたは Stateflow チャート、およびそれを含むシステムまたはチャートをエクスポートします。

  • "All" — sysname で指定されたシステムまたはチャートを含んでいるモデル内にある、すべての Simulink システムまたは Stateflow チャートをエクスポートします。

データ型: char | string

R2026b 以降

指定したシステムを、エクスポートした Web ビューの最上位ルートとして扱うかどうか。true (1) または false (0) として指定します。また、"on" (true と同等) または "off" (false と同等) も指定できます。指定に関する詳細は次の通りです。

  • true — 関数は、指定したシステムを最上位ルートとして扱います。生成された Web ビューには、先祖サブシステム、またはエクスポートされていないシステムのプレースホルダーは含まれません。

  • false — 関数は、Web ビューに先祖システムを含めます。

この引数を使用するには、SearchScope を "CurrentAndBelow" に設定します。

データ型: logical

マスクされたブロックをエクスポートするかどうか。次のいずれかの値として指定します。

  • "none" — 関数は、マスクされたブロックを Web ビューにエクスポートしません。Web ビューには、エクスポートしたサブシステム内のマスクされたブロックが含まれていますが、マスクされたブロックの内容は含まれません。

  • "all" — 関数は、マスクされたすべてのブロックの内容をエクスポートします。

データ型: char | string

データ型: logical

参照モデルをエクスポートするかどうか。true (1) または false (0) として指定します。また、"on" (true と同等) または "off" (false と同等) も指定できます。指定に関する詳細は次の通りです。

  • true — 関数は、参照モデルを Web ビューにエクスポートします。

  • false — 関数は、参照モデルを Web ビューにエクスポートしません。エクスポートされたシステムにはモデル参照ブロックが含まれていますが、参照モデルを開くことはできません。

データ型: logical

R2024b 以降

参照サブシステムをエクスポートするかどうか。true (1) または false (0) として指定します。また、"on" (true と同等) または "off" (false と同等) も指定できます。指定に関する詳細は次の通りです。

  • true — 関数は、参照サブシステムを Web ビューにエクスポートします。

  • false — 関数は、参照サブシステムを Web ビューにエクスポートしません。

データ型: logical

サブフォルダー内のモデルをエクスポートするかどうか。true (1) または false (0) として指定します。また、"on" (true と同等) または "off" (false と同等) も指定できます。指定に関する詳細は次の通りです。

  • true — 関数は、最上位フォルダーとサブフォルダー内のモデルをエクスポートします。

  • false — 関数は、最上位フォルダー内のモデルのみをエクスポートします。

この引数は、folder を入力引数として指定した場合にのみ適用されます。

データ型: logical

アーキテクチャ モデルで定義されている動作コンポーネントを含めるかどうか。true (1) または false (0) として指定します。また、"on" (true と同等) または "off" (false と同等) も指定できます。指定に関する詳細は次の通りです。

  • true — 生成される Web ビューに動作コンポーネントを含めます。

  • false — 生成される Web ビューに動作コンポーネントを含めません。

データ型: logical

ユーザー メモを含めるかどうか。true (1) または false (0) として指定します。また、"on" (true と同等) または "off" (false と同等) も指定できます。指定に関する詳細は次の通りです。

  • true — 生成される Web ビューにユーザー メモを含めます。

  • false — 生成される Web ビューにユーザー メモを含めません。

データ型: logical

MATLAB Function ブロックまたはStateflow チャート内の MATLAB 関数をエクスポートするかどうか。true (1) または false (0) として指定します。また、"on" (true と同等) または "off" (false と同等) も指定できます。指定に関する詳細は次の通りです。

  • true — 関数は、サポートする MATLAB 関数と Stateflow チャートを Web ビューにエクスポートします。

  • false — 関数は、サポートする MATLAB 関数と Stateflow チャートを Web ビューにエクスポートしません。

データ型: logical

R2026a 以降

Web ビューにエクスポートするバリアント サブシステム。次の値のいずれかとして指定します。

値説明
"All"関数は、すべてのバリアント内のサブシステムをエクスポートします。
"Active"関数は、アクティブなバリアント内のサブシステムをエクスポートします。
"ActivePlusCode"

関数は、次の項目内のサブシステムをエクスポートします。

  • アクティブなバリアント

  • コード バリアント

  • アクティベーションのタイミングが [起動] であるバリアント (R2026b 以降)

データ型: char | string

R2026b 以降

ブロック線図のサムネイルを含む [すべて表示] ナビゲーション タブを含めるかどうか。true (1) または false (0) として指定します。また、"on" (true と同等) または "off" (false と同等) も指定できます。指定に関する詳細は次の通りです。

  • true — 生成される Web ビューに [すべて表示] タブとブロック線図のサムネイルを含めます。

  • false — 生成される Web ビューに [すべて表示] タブもブロック線図のサムネイルも含めません。

データ型: logical

R2026b 以降

Web ビューにプロパティ インスペクターを含めるかどうか。true (1) または false (0) として指定します。また、"on" (true と同等) または "off" (false と同等) も指定できます。指定に関する詳細は次の通りです。

  • true — 生成される Web ビューにプロパティ インスペクターを含めます。

  • false — 生成される Web ビューにプロパティ インスペクターを含めません。

データ型: logical

Web ビューに含めるオプションのビュー。以下の値のいずれかまたは両方を含む cell 配列として指定します。

  • "requirements"

  • "coverage"

"requirements" オプションを含めると、Web ビューには、モデル内のリンクに関する要件およびリンク データが含まれます。その後、要件リンクをもつモデル要素を強調表示できます。

モデル要件とカバレッジ データを Web ビューに含めるを参照してください。

データ型: cell

Web ビューの出力パッケージの名前。文字ベクトルまたは string スカラーとして指定します。PackageName の既定値はモデル名です。

データ型: char | string

Web ビュー パッケージのエクスポート先とするパス。文字ベクトルまたは string スカラーとして指定します。生成された Web ビュー パッケージをモデルと同じフォルダーに保存するには、PackageFolder を $model に設定します。PackageFolder の既定値は現在の作業フォルダーです。

データ型: char | string

Web ビュー パッケージのファイル タイプ。次のいずれかの値として指定します。3 つの値はすべて、同じ内容の出力を生成します。

  • "both" — 関数は、.zip 拡張子をもつ ZIP ファイルと、解凍されているファイルのフォルダーの両方を作成します。

  • "zipped" — 関数は、.zip 拡張子をもつ ZIP ファイルを作成します。

  • "unzipped" — 関数は、ファイルのフォルダーを作成します。

データ型: char | string

Web ビューのエクスポート後に Web ブラウザーで Web ビューを表示するかどうか。true (1) または false (0) として指定します。また、"on" (true と同等) または "off" (false と同等) も指定できます。指定に関する詳細は次の通りです。

  • true — 関数は、Web ビューのエクスポート時に Web ブラウザーで Web ビューを表示します。

  • false — 関数は、Web ビューのエクスポート時に Web ブラウザーで Web ビューを表示しません。

データ型: logical

モデルをインクリメンタルにエクスポートするかどうか。true (1) または false (0) として指定します。また、"on" (true と同等) または "off" (false と同等) も指定できます。指定に関する詳細は次の通りです。

  • true — 関数は、slwebview の最後の使用から変更されていない最上位モデルのキャッシュされた Web ビューを再利用します。

    FollowModelReference または FollowSubsystemReference も true に設定されている場合、関数は、slwebview の最後の使用から変更されていない参照モデルまたはサブシステムのキャッシュされた Web ビューも再利用します。

  • false — 関数は、実行したときに Web ビューを生成します。

関数は、モデルに未保存の構造的な変更がある場合にのみ Web ビューを再生成します。たとえば、関数は、ブロックの名前を変更するかブロック パラメーターを変更した場合には Web ビューを再生成しますが、ベース ワークスペースで調整可能な変数を変更した場合には再生成しません。Web ビューを強制的に再生成するには、この名前と値の引数を false に設定するか、または現在のシミュレーション キャッシュ フォルダーにあるモデルのシミュレーション キャッシュ ファイルを削除します。

ヒント

slwebview は、現在のシミュレーション キャッシュ フォルダーに Web ビューをキャッシュします。既存の Web ビューを再利用するには、Web ビューのエクスポート用のシミュレーション キャッシュ フォルダーを指定します。シミュレーション キャッシュ フォルダーの設定の詳細については、シミュレーション ターゲットの場所の制御を参照してください。

データ型: logical

R2026b 以降

エクスポート中にグラフィカルな進行状況バーを表示するかどうか。true (1) または false (0) として指定します。また、"on" (true と同等) または "off" (false と同等) も指定できます。指定に関する詳細は次の通りです。

  • true — 関数は、エクスポート中にグラフィカルな進行状況バーを表示します。

  • false — 関数は、エクスポート中にグラフィカルな進行状況バーを表示しません。

データ型: logical

R2026b 以降

エクスポート中に進行状況メッセージを表示するかどうか。次のいずれかの値として指定します。

  • true — 関数は、エクスポート中に進行状況メッセージを表示します。名前と値の引数 Verbosity が、メッセージの詳細レベルを決定します。

  • false — 関数は、Verbosity 設定にかかわらず、エクスポート時に進行状況メッセージを表示しません。

データ型: logical

R2026b 以降

エクスポート時の出力の詳細レベル。次のいずれかの値として指定します。

  • "silent" — 関数は、エクスポート時に進行状況メッセージを表示しません。

  • "normal" — 関数は、エクスポートのフェーズに関する情報を表示します。

  • "detailed" — 関数は、エクスポート プロセス中にエクスポートのフェーズとブロック線図名に関する情報を出力します。

  • "debug" — 関数は、エクスポート プロセス中にエクスポート フェーズ、ブロック線図名、および内部診断に関する情報を出力します。

メモ

Verbose を false に設定した場合、Verbosity の設定には効果はありません。

データ型: char | string

出力引数

すべて折りたたむ

Web ビュー ファイルの名前。文字ベクトルまたは string スカラーとして返されます。ZIP 出力では、filename は .zip ファイルへのパスです。解凍済みフォルダーでは、filename は webview.html エントリポイント ファイルへのパスです。

ヒント

  • Web ビューとはモデルの対話型表現の 1 つで Web ブラウザーで表示できます。Web ビューを階層に従ってナビゲートし、特定のサブシステムを調べてブロックや信号のプロパティを確認することができます。Web ビューを使用して、Simulink をインストールしていないユーザーとモデルを共有することが可能です。詳細については、モデルの Web ビューの作成と使用を参照してください。

  • Linux® マシンで -batch スタートアップ オプションを使用して MATLAB を実行しているときに Web ビューを生成するには、次のようにします。

    1. Linux シェル ファイルを作成します。

    2. シェル ファイルで、モデルを開いて Web ビューを生成するコマンドを変数に保存します。複数のコマンドをセミコロンで区切って入力できます。

    3. シェル ファイルで、xvfb-run を使用して、-batch 起動オプションで MATLAB を実行し、コマンドを実行します。xvfb-run の詳細については、Ubuntu Web サイトの xvfb-run を参照してください。

    4. シェル ファイルを MATLAB パス上のフォルダーに保存します。

    5. Linux ターミナルで、シェル ファイルが含まれるフォルダーに移動します。

    6. シェル ファイルを実行します。

    この例のコードでは、モデル myModel に対して slwebview を実行する Linux Bash シェルを定義します。

    #!/bin/bash

MATLAB_COMMANDS="open_system("myModel.slx"); 
slwebview("myModel.slx");"
xvfb-run matlab -batch "$MATLAB_COMMANDS exit;"

  • すべての要件とリンク データを別個のペインにリストする Web ビューを作成するには、slwebview_req (Requirements Toolbox) 関数を使用します。

バージョン履歴

R2006a で導入

すべて展開する

参考

(Simulink Coverage) | (Requirements Toolbox)

トピック