Simulink.exportToVersion

Simulink の前のバージョンで使用するためのモデル、ライブラリ、またはプロジェクトのエクスポート

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

構文

exported_file = Simulink.exportToVersion(modelname,target_filename,version)
exported_file = Simulink.exportToVersion(modelname,target_filename,version,Name=Value)
exported_project = Simulink.exportToVersion(proj,zipfilename,version)
exported_project = Simulink.exportToVersion(proj,zipfilename,version,Name=Value)

説明

exported_file = Simulink.exportToVersion(modelname,target_filename,version) は、指定された以前の Simulink® version で読み込み可能な形式でモデルまたはライブラリ modelname を target_filename という名前のファイルにエクスポートします。

システムが、指定された Simulink のバージョンでサポートされない機能を含む場合、このコマンドはその機能を削除し、サポートされていないブロックを黄色い空のマスク サブシステムで置き換えます。そのため、変換されたシステムは異なる結果を出力する可能性があります。

save_system の ExportToVersion は、この機能のレガシ オプションで、これもサポートされています。

例

exported_file = Simulink.exportToVersion(modelname,target_filename,version,Name=Value) は、1 つ以上の名前と値の引数として追加のオプションを指定します。

例

exported_project = Simulink.exportToVersion(proj,zipfilename,version) は、指定された以前の Simulink version で読み込み可能な形式でプロジェクト proj を ZIP ファイル zipfilename にエクスポートします。プロジェクトに要件リンク ファイルまたは要件ファイルが含まれている場合、Simulink.exportToVersion はリンクを更新して新たにエクスポートされたファイルを指すようにします。

例

exported_project = Simulink.exportToVersion(proj,zipfilename,version,Name=Value) は、1 つ以上の Name=Value 引数で指定された条件を使用してプロジェクトをエクスポートします。この構文は、参照プロジェクトや不足しているファイルをエクスポートするために使用できます。

R2025a より前のリリースでは、63 文字を超えるファイル名はサポートされません。63 文字を超えるファイル名を含むプロジェクトを R2025a より前のリリースにエクスポートしようとすると、名前が長いプロジェクト ファイルがリストされます。以前のリリースにエクスポートする前に、名前を短くし、プロジェクト内のそのファイル名へのすべての参照を置き換えてください。

例

例

すべて折りたたむ

現在の最上位システムを取得してエクスポートします。

 Simulink.exportToVersion(bdroot,"mymodel.slx","R2014b");

現在の最上位システムを取得してエクスポートし、ライブラリ ブロックへのリンクを保存済みファイルのライブラリ ブロックのコピーと置き換えます。

Simulink.exportToVersion(bdroot,"mymodel.slx",...
                         "R2014b",BreakUserLinks=true);

現在の最上位プロジェクトを取得してエクスポートします。

openExample('simulink/AirframeProjectWithReferencesExample')
proj = currentProject;
Simulink.exportToVersion(proj,"myzipfilename","R2019a");

現在の最上位プロジェクトとすべての参照プロジェクトをエクスポートします。

Simulink.exportToVersion(proj,"myzipfilename","R2019a",IncludeReferences=true);

入力引数

すべて折りたたむ

エクスポートするモデル。ファイル拡張子のない文字ベクトルまたは string スカラーとして指定します。モデルは読み込み済みで、未修正でなければなりません。ターゲットのファイルはモデル ファイルと同じファイルにすることはできません。

データ型: char | string

エクスポートされるファイル名。文字ベクトルまたは string スカラーとして指定します。ターゲットのファイルはモデル ファイルと同じファイルにすることはできません。

例: 'mymodel.slx'

データ型: char | string

エクスポートするプロジェクト。matlab.project.Project オブジェクトとして指定します。currentProject を使用して、現在読み込まれているプロジェクトからプロジェクト オブジェクトを作成します。

エクスポートされるプロジェクトを含む ZIP ファイル名。文字ベクトルまたは string スカラーとして指定します。

例: 'myzipfile.zip'

データ型: char | string

MATLAB の大文字小文字を区別しないリリース名。文字ベクトルまたは string スカラーとして指定します。この MATLAB リリース名は、以前の Simulink バージョンを指定します。Simulink.exportToVersion は、指定された以前の Simulink バージョンで読み込み可能な形式でシステムをエクスポートします。最大で 7 年間分の以前のリリースにモデルをエクスポートできます。現在のバージョンはエクスポートできません。

モデル ファイルの形式として、接尾辞 _MDL または _SLX を使用して SLX または MDL を指定できます。形式を指定しない場合、既定のモデル ファイル形式でエクスポートされます。プロジェクトをエクスポートする場合、モデルのファイル形式は指定できません。

例: 'R2015B'

データ型: char | string

名前と値の引数

すべて折りたたむ

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

例: Simulink.exportToVersion(bdroot,"mymodel.slx",... "R2014b",BreakUserLinks=true);

プロンプトまたはメッセージ ダイアログ ボックスを許可します。ダイアログ ボックス内に出力プロンプトまたはメッセージを表示するか、コマンド ラインでメッセージのみを表示するかどうかを示す論理値として指定します。たとえば、ファイルを書き込み可能にするように指示するプロンプトや、エクスポートされたバージョンについてのメッセージなどです。プロンプトを許可する場合は、true または on に設定します。

参照プロジェクトを以前のリリースにエクスポートするオプション。数値または logical 1 (true) または 0 (false) として指定します。

true の場合、Simulink.exportToVersion は最上位プロジェクトおよびすべての参照プロジェクトを以前のリリースにエクスポートし、参照を ZIP ファイルに含めます。ZIP ファイルを解凍すると、参照プロジェクトのコピーが作成され、最上位プロジェクトにリンクされます。

false の場合、Simulink.exportToVersion は最上位プロジェクトのみを以前のリリースにエクスポートします。Simulink.exportToVersion は参照への既存の絶対リンクと相対リンクを保持します。解凍時に作業中のプロジェクトでは、参照は同じ絶対パスと相対パスに存在する必要があります。

プロジェクトに参照がない場合、引数は無視されます。

プロジェクトを以前のリリースにエクスポートするときに不足しているプロジェクト ファイルを無視するオプション。数値または logical 1 (true) または 0 (false) として指定します。

true の場合、Simulink.exportToVersion はエクスポート処理中に不足しているプロジェクト ファイルに関するエラーを発行しません。

false の場合、Simulink.exportToVersion はプロジェクトで不足しているファイルを検出するとエラーを発行します。

出力引数

すべて折りたたむ

エクスポートされるファイルのパス。指定された前の Simulink バージョンで読み込み可能な形式で返されます。

エクスポートされるプロジェクトを含む ZIP ファイルのパス。指定された以前の Simulink バージョンで読み込み可能な形式で返されます。

制限

Simulink.exportToVersion は以前のリリースへの外部テスト ハーネスのエクスポートをサポートしません。

  • 外部テスト ハーネスをもつモデルの場合、Simulink.exportToVersion は自動的にそれらを内部テスト ハーネスに変換します。

  • 外部テスト ハーネスをもつモデルが含まれるプロジェクトの場合、Simulink.exportToVersion はプロジェクトをエクスポートし、テスト ハーネスを不足しているファイルとしてレポートします。

バージョン履歴

R2016a で導入

すべて展開する

参考

トピック