System Modelerは，さまざまなファイル形式を使う．完全なリストは，System Modelerのファイル形式のページを参照されたい．

シミュレーション設定ファイル

シミュレーション設定ファイル(.sim)は，エクスペリメントの設定，初期値，パラメータ値をシミュレーションに渡すために使われる．このファイルはXMLファイルであり，有効なタグのいくつかがこの章で説明されている．[read-only]（リードオンリー）という印が付いている属性は，ユーザが変えるべきものではない．これらの属性は，モデルについての情報を伝えるだけのものである．例として，IntroductoryExamples.HelloWorldモデルの簡約されたシミュレーション設定ファイルを以下に示す．

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE simulation SYSTEM "simulation_settings.dtd">
<simulation version="1.1" name="HelloWorld 1" start="0.0" end="10" stepSize="0" outputSteps="2000" tolerance="1e-6" method="dassl" filePath="HelloWorld.exe" resultFilePath="HelloWorld.mat" unitsPath="HelloWorld_units.json">
  <model name="IntroductoryExamples.HelloWorld" description="" numOfVariables="2">
    <variable name="x" equationBound="1.0" initType="exact" type="Real" kind="STATE" />
    <variable name="der(x)" initType="calc" direction="BIDIR" type="Real" kind="DERIVATIVE" description="Derivative of x" />
  </model>
  <Options>
    <Option name="Solver">
      <OptionValue name="MaxStepSize" value="0" />
      <OptionValue name="EventDetection" value="true" />
      <OptionValue name="NonLinearSolverTolerance" value="1e-12" />
      <OptionValue name="MaxNoInternalSteps" value="0" />
    </Option>
    <Option name="CheckMinMax">
      <OptionValue name="enable" value="false" />
    </Option>
    <Option name="StopAtSteadyState">
      <OptionValue name="enable" value="false" />
    </Option>
    <Option name="SyncWithRealTime">
      <OptionValue name="enable" value="false" />
    </Option>
    <Option name="InputVariableDataFile">
      <OptionValue name="FilePath" value="" />
    </Option>
    <Option name="OutputSettings">
      <OptionValue name="StoreStates" value="true" />
      <OptionValue name="StoreDerivatives" value="true" />
      <OptionValue name="StoreAlgebraics" value="true" />
      <OptionValue name="StoreParameters" value="true" />
      <OptionValue name="StoreConstants" value="false" />
      <OptionValue name="StoreProtected" value="true" />
      <OptionValue name="StoreEventPoints" value="true" />
    </Option>
  </Options>
  <ExternalLibraries>
  </ExternalLibraries>
</simulation>

要素のシミュレーション

simulation要素のコンテンツは，model要素でなければならないが，Options要素を含むこともできる．simulation要素の属性は，基本のエクスペリメント設定を示すものである．

属性

• version .simファイル形式のバーション．

• name シミュレーションの表示名．

• start シミュレーションの開始時間を指定する．

• end シミュレーションの終了時間を指定する．

• stepSize ソルバからの出力点間の区間の長さを指定する．設定される場合には，outputStepsはゼロに等しくなければならない．

• outputSteps ソルバが生成する出力区間の数を指定する．Automaticを得るためには，これを-1に設定する．代りにstepSizeを使う場合には，0に設定する．

• tolerance それぞれのソルバのステップに使われる局所的な許容範囲を指定する．

• method 動的な系を解決するために使われるソルバを指定する（可能な値には，dasslとcvodesが含まれる）．

• method Specifies the solver used to solve the dynamic system (possible values include dassl and cvodes).

• filePath 実行可能なシミュレーションへのパス．

• resultFilePath 結果ファイルへの経路．

• unitsPath モデルの測定単位の設定を説明するファイルへのパス．

要素のモデル

model要素のコンテンツは，属性numOfVariablesによって指定されるvariable要素の数でなければならない．

属性

• name [read-only]（リードオンリー） モデル名．

• description [read-only]（リードオンリー） モデルについての記述．

• numOfVariables [read-only] モデル内のvariable要素の数．

要素変数

variable要素にはコンテンツはない．すべての情報が属性として保存される．

属性

• name [read-only]（リードオンリー） 変数名．

• value 変数の初期化のための値．これが与えられた場合には，モデルのデフォルトの初期化より優先される．initTypeがcalcである変数には当てはまらない．

• initType [read-only]（リードオンリー） valueが変数の初期化に影響を与える度合（exact，approx，calcのいずれか）．

• equationBound [read-only]（リードオンリー） 使用可能な場合に，モデルのデフォルトの変数の初期化を記述する式．通常valueはデフォルトの初期化をオーバーライドする．

• type [read-only]（リードオンリー） 変数のタイプ（可能な値には，Real，Integer，Boolean，Stringが含まれる）．

• kind [read-only]（リードオンリー） 変数の種類を指定する（可能な値には，STATEとPARAMが含まれる）．

• direction [read-only]（リードオンリー） 変数の因果関係（モデルへの外部入力はINPUTになる）．

• unit [read-only]（リードオンリー） 変数の測定単位．

• description [read-only]（リードオンリー） 変数についての記述．

要素のオプション

Options要素には，1つあるいは複数のOption要素が含まれなければならない．

要素のオプション

Option要素には，1つあるいは複数のOptionValue要素が含まれなければならない．有効なオプション名には以下が含まれる．

• Solver 有効なOptionValueの名前には以下が含まれる．
• MaxStepSize
• EventDetection
• NonLinearSolverTolerance
• MaxNoInternalSteps

• CheckMinMax 有効なOptionValueの名前：
• enable

• StopAtSteadyState 有効なOptionValueの名前：
• enable

• SyncWithRealTime 有効なOptionValueの名前：
• enable

• InputVariableDataFile 有効なOptionValueの名前：
• FilePath

• OutputSettings 有効なOptionValueの名前には以下が含まれる．
• StoreStates
• StoreDerivatives
• StoreAlgebraics
• StoreParameters
• StoreConstants
• StoreProtected
• StoreEventPoints

属性

• name このOptionの名前．

要素のOptionValue

属性

• name このOptionValueの名前．

• value このOptionValueの値．