SimDiffのご使用前に、ソフトウェアに付属するフラッシュデモをご覧なることをお勧めします。SimDiff ProとSimDiff LTの2つのデモがあり、下記のリンクよりご覧いただけます：

SimDiff Proデモムービー
SimDiff LTデモムービー

SimDiffを使用中は、当書を手軽な参考書としてお使い頂けます。モニター上のSimDiffの側に置けるように小さく作ってあります。

構成

当マニュアルは、SimDiffを使って実行できる様々なタスクの説明により構成されています。例えば、２つのモデルの差分をどのように検出するか、差分をどのように監査するかなどの説明が含まれています。

一般的に説明の各ステップには、SimDiffの主画面のどの部分に注目するべきかを表示する図が付いています。図中の青く塗られた部分と緑色に塗られた部分は、それぞれ記述されたアクションを実行する場所と結果を表示する場所を示しています。例えば：

1. 4 センターパネルの差分をクリックすると、選択された差分の属性変更が下方の中央パネルに表示されます。

テキスト様式

説明     標準
スクリーン要素     青色
メニュー     メニュー ▷メニューアイテム

1. 1　EnSoftから送信されたメール、もしくはSimDiffインストールCDのインストーラーを作動させます。インストーラーファイルは、SimDiff-3.x.x-install.exeフォーマットにて指定されています。
2. 2 画面上の説明に従って下さい。
3. 3 初めてSimDiffを起動する場合は、ライセンスキー又はライセンスサーバー情報の入力が必要となります。

1. 1 比較する１つ目のモデルを選択して下さい｡
2. 2 比較する２つ目のモデルを選択して下さい｡
3. 3 ｢差分｣ボタンをクリックして下さい。
4. 4 センターパネルの差分をクリックすると、選択された差分の属性変更が下方の中央パネルに表示されます。
5. 5 ｢差分を表示｣ボタンをクリックするとSimulink内にハイライトされた差分が表示されます。

注釈：選択したモデルの右側にのアイコンが表示されている場合は、そのモデルはClearCaseレポジトリに保管されています。それをクリックしてどのバージョンの差分を検出するかを変更して下さい。

SimDiffは、Simulinkモデルの表示等の特定のタスクを実行するために、MATLABオートメーションサーバーに接続します。MATLABを必要とする作業の開始時に、インストレーションが設定されていない場合、作業を続行する前に、SimDiffは、SimDiffが使える1つ以上のMATLABのインストレーションをユーザーに要求します。SimDiffが使用できるMATLABのインストレーションのリストは、設定メニューでいつでも設定することができます:

1. 1 ファイル▷設定▷MATLABを開いて下さい。
2. 2 SimDiffにMATLABインストレーションを自動検索させるには、自動検出ボタンを使用するか、または、手動でインストレーションをブラウズ・追加するには、追加ボタンを使用して下さい。
3. 3 ｢OK｣をクリックして下さい。

注釈：

• 有効欄は、SimDiffが最後に実行した試みにおいてMATLABへの接続に成功したかを表示します。SimDiffは、更新ボタンによって更新されるまでは、無効なインストレーションへの接続を試みることをしません。
• 特定の場合には、制限のあるユーザーアカウントでは、SimDiffがMATLABに接続できない場合があります。これは、大抵の場合において、1つ以上のMATLABのインストレーションのあるコンピューターに起こります。
• Windows Vista以上においては、ユーザーアカウント制御（UAC）がイネーブルの場合、アドミニストレーターの特権が必要な時には、UACプロンプトが現れます。特権が認められない場合には、接続に失敗します。
• 互換性問題により、SimDiffは、Windows Vista以上における MATLAB R14SP1以下に接続することができません。
• MATLABへの接続を要求する機能には、注釈があります:当機能は、MATLABが必要となります。

ブロックの差分は、Simulinkモデルでは色付きで表示されます。Stateflowのオブジェクトの差分のラベルには接頭語（変更の場合は「c_」、追加の場合は「a_」、削除の場合は「d_」）が付いています。これは、Stateflowが色付きのオブジェクトを現在サポートしていないためです。

注釈：

• 当機能は、MATLABが必要となります

1. 1 色の付いた四角部の１つをクリックして下さい：
   追加部分、変更部分、削除部分、点滅色
2. 2 お好みの色を選らんで下さい。
3. 3 ｢差分｣ボタンをクリックして下さい。

注釈： 点滅色の変更する場合は、｢差分｣ボタンをクリックする必要がありません。即座に適用されます。

モデルによっては、ライブラリ参考資料ブロックが含まれている場合があります。デフォルトでは、SimDiffは.mdlファイル内の情報の差分だけを検出します－この場合、参考資料ブロックであり参照ブロックではありません。SimDiffを使って参照ブロックの差分を望む場合は、下記の説明に従って下さい。

1. 1 ライブラリリンクの下にあるインラインをチェックオフして下さい。
2. 2 ｢ディレクトリ｣をクリックして、ライブラリディレクトリダイアログボックスを開きます｡
3. 3 のボタンでライブラリディレクトリを加えてください。ディレクトリは各モデルによって相違する場合もあれば同じ場合もあります。
4. 4 ｢OK｣をクリックして下さい。次回｢差分｣をクリックする時は、SimDiffはMATLABに参照ブロックインラインを伴うモデルを作成させます。

注釈：

• 当機能は、MATLABが必要となります
• ライブラリディレクトリは相対的又は絶対的です。

シミュレーション中に、モデルがMATLABベースワークスペース変数を使用する場合があります。SimDiffによるワークスペース変数の比較を望まれる場合は、下記の通りに従って下さい。

1. 1 ファイル▷設定▷差分を開いて下さい。
2. 2 Base (MATLAB) Workspaceをチェックします。
3. 3 [オプション] .m設定スクリプトファイルを指定し、モデルを読み込む前にMATLABパスの設定等のワークスペースの初期化を行います。
4. 4 OKをクリックして下さい。その後の差分では、Base (MATLAB) Workspaceの差分が表示されます。

注釈：

• 当機能は、MATLABが必要となります
• SimDiffでは、属性パネルにおけるワークスペース変数値の表示を選択できます。ストリング、ベクトル、2次元マトリックスとセル配列を含むほぼ全ての変数タイプの実際の値が表示されます。他のタイプについては、実際の値ではなくタイプが表示されます。

Simulinkにおいて差分を表示する場合において、SimDiffは差分を効果的に読み取れるようにSimulink画面を位置付けます。モデル１の全画面が一箇所に表示され、モデル２の全画面が他の場所に表示されます。

1. 1 ファイル▷設定▷表示を開いて下さい。
2. 2 ｢画面の位置を設定｣ボタンをクリックして下さい。
3. 3 画面を望む位置に置いて下さい。
4. 4 ｢OK｣をクリックして下さい。｢OK｣をクリックして下さい。次回｢差分｣をクリックする時には、画面が新しい位置に表示されます。

SimDiffは、モデルのサブシステムの差分を許可し、それ以外を無視します。

1. 1 比較する１つ目のモデルを選択して下さい｡
2. 2 ｢選択｣をクリックして、選択可能なサブシステムダイアログボックスを開いて下さい｡
3. 3 ツリーから差分するサブシステムを選択して下さい。
4. 4 ｢OK｣をクリックして下さい。
5. 5 ２つ目のモデルに関しても、１〜４を繰り返します。
6. 6 ｢差分｣ボタンをクリックして下さい。

注釈：サブシステムの選択をクリアするには、サブシステムの名前の横にあるをクリックして下さい。

モデル階層パネルは、両モデルのサブシステムの統一されたツリーを表示します。変更・追加・削除されたサブシステムは、ハイライト色により色付けされ、名前が変更されたサブシステムは、太字で表示されます。

1. 1 モデル階層の要素を選択すると、そのサブシステムの差分のみが差分リストに表示されます。
2. 2 ｢選択されたサブシステムのみの差分を表示する｣又は｢選択されたサブシステム中の全差分を表示する｣のオプションを選択すると、その要素下の要素が表示されます。

1. 1 ｢カラムを選択する｣ボタンをクリックすると、表示したいカラムを選択することができます。
2. 2 カラムの見出しをクリックし、望む位置にドラッグすることによりカラムを移動することができます。

ブロック又はラインが変更されたかの決定時に、特定の属性を無視するようにSimDiffを設定できます。特定ブロックやラインタイプ又は全ブロックやラインタイプの属性を無視できます。

1. 1 属性フィルタ・エディタダイアログボックスを開いて下さい。
2. 2 要素がStateflow要素の場合、Stateflowタブに切り替えます。
3. 3 左の欄にあるブロック又はラインのタイプを選択して下さい。
4. 4 右の欄にある属性名を選択して下さい。
5. 5 ｢保存｣をクリックして".af"ファイルにフィルタを保存して下さい。次回の差分では、そのファイルで指定された属性が無視されます。

注釈：

• 特定のブロックタイプ又はラインタイプだけではなく、モデル中の全ブロックまたはラインから属性をフィルタするには、特別なタイプである[全てのブロックの属性]、[全てのライン属性]、[全てのStateflowオブジェクト属性]、 及び [全てのトランジション属性]を 使用できます。
• 属性名の最後に共通というテキストが表示された場合、その属性は全ブロック又はラインに共通しています。それ以外は、各ブロックタイプ又はラインタイプに特定の属性となっています。
• インポートを選択し、属性を含む".mdl"ファイルを選択すると、独自の属性及び登録されていないMATLABの属性をエディタにインポートできます。

この機能は、SimDiff Proでのみ実行可能です。

1. 1 差分を再検査後、差分の左側にあるチェックボックスをクリックして下さい。差分を照合したユーザー名と日時をSimDiffが入力します。
2. 2 必要であれば、コメントを書き込めます。
3. 3 それを終えると、HTMLレポートの作成ができます。その説明については、次のセクションを参考にして下さい。

この機能は、SimDiff Proでのみ実行可能です。

1. 1 ファイル▷HTMLレポートをエキスポートするを開いて下さい。.
2. 2 HTMLレポートの保存先を選択して下さい｡
3. 3 MATLABを使って画面キャプチャを作成するか等、エクスポートオプションを選択します。
4. 4 ｢OK｣をクリックして下さい。

注釈：

• MatlabはHTMLレポートの作成には必要ありませんが、サブシステムの画面コピーの作成にはMATLABが必要となります。
• カスタムのヘッダー画像やCSS等の追加HTMLレポートオプションは、SimDiffの設定において選択できます。

1. 1 スタート▷全てのプログラム▷SimDiff ▷ClearCase用のEnSoft MDL統合ツールを実行して下さい。
2. 2 ClearCaseをインストールするディレクトリを選択して下さい。
3. 3 SimDiff をインストールするディレクトリを選択して下さい。
4. 4 ｢インストール｣又は｢アップデート｣ボタンをクリックして下さい。
5. 5 VOB構成タブを選択して下さい。
6. 6 MDLファイルが含まれているVOBを選択して下さい。複数のVOBを選択するには、最初のVOBをクリックした後、CTRLキーを押しながら各VOBをクリックします。
7. 7 ｢選択したVOBにインストール/アップデート｣ボタンをクリックして下さい。

注釈：詳細に関しましては、スタート▷全てのプログラム ▷EnSoft ▷SimDiff ▷ClearCase用のEnSoft MDL統合ツール ▷ユーザーマニュアルにある統合ツールドキュメントをご参照下さい。

リポジトリクライアントのほとんどは、特定のファイルタイプを差分する外部ツールの指定を許可しています。詳細は、リポジトリクライアントの文書を参照して下さい。

数多くのクライアントでは、実行するためのコマンドを入力することが要求されます。SimDiffで使用されるのコマンド：
C:\Program Files\EnSoft\SimDiff\simdiffgui.exe MDL1 MDL2
（明確なSimDiffインストレーションのパスを使って下さい。）

MDL1とMDL2をクライアントの適切なシンタックスに置き換えてます。例えば、CM Synergyの場合、MDL1とMDL2をそれぞれ%1と%2に置き換えます。

Simulinkが開く事を防ぐモデル名にリポジトリクライアントが無効な文字を加えた場合は、SimDiffが自動的にそれらを取り除きます。

一つの要素が追加/削除された場合、デフォルトとしてSimDiffは、その要素が追加/削除されたものとして表示しますが、その差分リストには下階層は表示されません。これを変更するには、下記の説明に従って下さい:

1. 1 ファイル ▷設定 ▷差分を開いて下さい。
2. 2 追加/削除された親要素に含まれる要素を表示するを選択して下さい。
3. 3 OKをクリックして下さい。

MATLABからSimDiffを作動させることができるようになりました。APIの使用法の説明書に関しましては、MATLABにhelp simdiffと入力して下さい。SimDiff APIのご使用の際には、この説明書に従って下さい。

1. 1 システムパスにSimDiffインストレーションディレクトリを追加して下さい。インストレーションディレクトリとは、simdiff.exeとsimdiff gui.exeファイルを含むディレクトリのことをいいます。
2. 2 MATLABパスにSimDiffインストレーションディレクトリを追加して下さい。まず、MATLABを開きます。そして、ファイル ▷ パスを設定をクリックして下さい。 最後に、Add Folderをクリックして、SimDiffインストレーションディレクトリをMATLABパスに追加します。

注釈：

• 当機能は、MATLABが必要となります

1. 1 support@ensoftcorp.comまでメールを送って下さい｡
2. 2 一般的質問の場合には、メール本体に質問を入力して下さい。
3. 3 SimDiffの作動中にエラーが発生した場合は、SimDiffログを添付して下さい。
   ログの開き方：スタート▷全てのプログラム▷SimDiff▷SimDiffログ
   都合の良い場所に保存して、メールに添付して下さい｡