Wolfram言語ホームページ »

ファイル形式—シミュレーション設定ファイル(.sim)

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.0" name="HelloWorld 1" start="0.0" end="10" stepSize="0" outputSteps="2000" tolerance="1e-6" method="dassl" filePath="sme_1400057199_22750.exe" resultFilePath="sme_1400057199_22750.mat">

  <model name="IntroductoryExamples.HelloWorld" description="" numOfVariables="2">
    <variable name="der(x)" value="1.0" defaultValue="1.0" type="Real" kind="DERIVATIVE" direction="BIDIR" unit="" index="0" description="Derivative of x" equationBound="" protected="false" final="false"/>
    <variable name="x" value="1.0" defaultValue="1.0" type="Real" kind="STATE" direction="BIDIR" unit="" index="0" description="" equationBound="" protected="false" final="false"/>
  </model>
<Options>
<Option name="Solver">
<OptionValue name="MaxStepSize" value="0">
</OptionValue>
<OptionValue name="EventHysteresisEpsilon" value="1e-10">
</OptionValue>
<OptionValue name="EventDetection" value="true">
</OptionValue>
<OptionValue name="NonLinearSolverTolerance" value="1e-12">
</OptionValue>
<OptionValue name="MaxNoInternalSteps" value="0">
</OptionValue>
</Option>
<Option name="CheckMinMax">
<OptionValue name="enable" value="false">
</OptionValue>
</Option>
<Option name="StopAtSteadyState">
<OptionValue name="enable" value="false">
</OptionValue>
</Option>
<Option name="SyncWithRealTime">
<OptionValue name="enable" value="false">
</OptionValue>
</Option>
<Option name="InputVariableDataFile">
<OptionValue name="FilePath" value="">
</OptionValue>
</Option>
<Option name="OutputSettings">
<OptionValue name="StoreToFile" value="true">
</OptionValue>
<OptionValue name="StoreStates" value="true">
</OptionValue>
<OptionValue name="StoreDerivatives" value="true">
</OptionValue>
<OptionValue name="StoreAlgebraics" value="true">
</OptionValue>
<OptionValue name="StoreParameters" value="true">
</OptionValue>
<OptionValue name="StoreConstants" value="false">
</OptionValue>
<OptionValue name="StoreProtected" value="true">
</OptionValue>
<OptionValue name="StoreEventPoints" value="true">
</OptionValue>
<OptionValue name="StoreSimulationLog" value="false">
</OptionValue>
</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がある．

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

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

要素のモデル

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

属性

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

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

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

要素変数

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

属性

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

• value 変数の値．

• defaultValue [read-only]（リードオンリー） Modelicaコードでの変数のもとの値．

• type [read-only]（リードオンリー） 変数(Real, Integer, Boolean, String)のタイプ．

• kind [read-only]（リードオンリー） 変数の種類(VARIABLE, STATE, DUMMY_DER, DUMMY_STATE, DISCRETE, PARAM, CONSTANT, DERIVATIVE)を指定する．

• direction [read-only]（リードオンリー） 変数(BIDIR, INPUTDIR, OUTPUTDIR)の方向．

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

• index [read-only]（リードオンリー） 内部使用．

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

• equationBound [read-only]（リードオンリー） 変数の開始値を計算するのに使用される方程式（useEquationがtrueに設定されている場合）．

• useEquation 境界方程式を使って変数の開始値を計算するべきかどうか，あるいは値の属性を使うべきかどうかを示す．

• protected [read-only]（リードオンリー） 変数が保護されているかどうかを指定するフラグ．

• final [read-only]（リードオンリー） 変数に最終的な修飾子が含まれているかどうかを指定するフラグ．

要素のオプション

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

要素のオプション

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

• Solver 有効なOptionValueの名前：
• MaxStepSize
• EventHysteresisEpsilon
• EventDetection
• NonLinearSolverTolerance
• MaxNoInternalSteps

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

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

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

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

• OutputSettings 有効なOptionValueの名前：
• StoreToFile
• StoreStates
• StoreDerivatives
• StoreAlgebraics
• StoreParameters
• StoreConstants
• StoreProtected
• StoreEventPoints
• StoreSimulationLog

属性

• name このOptionの名前．

要素のOptionValue

属性

• name このOptionValueの名前．

• value このOptionValueの値．