Reference: String

Model ElementReference_Stringは、MotionSolveでユーザー定義のテキスト文字列を定義します。文字列は任意の長さにすることができます。出力可能なASCII文字のみを含める必要があります。

説明

Reference_Stringは主にユーザー定義サブルーチン内で使用されます。これらは、ファイル名、メッセージ、ブロック名、およびDLL名をユーザー定義のサブルーチンに渡すためによく使用されます。

ユーザー定義のサブルーチン内では、Reference_Stringにアクセスするために、MotionSolveユーティリティサブルーチンGTSTRGが使用されます。Reference_String自体のIDは、パラメータとしてユーザー定義のサブルーチンに渡すことができます。

フォーマット

<Reference_String
  id                  = "ID Number"
  label               = "Name of the string"
 {     
  string              = "The string itself" >
 |
  usrsub_dll_name     = valid_path_name
  usrsub_param_string = "USER([[par_1[,...][,par_n]])"
  usrsub_fnc_name     = "custom_fnc_name" >
 |
  script_name         = valid_path_name
  interpreter         = "PYTHON" | "MATLAB"
  usrsub_param_string = "USER([[par_1[,...][,par_n]])
  usrsub_fnc_name     = "custom_fnc_name" >
 }
/>

属性

id: 要素識別番号（整数 > 0）。この番号は、すべてのReference_String要素の中で一意です。
label: Reference_String要素の名前。
string: 格納する文字列を指定します。
usrsub_dll_name: ユーザーサブルーチンを含むDLLまたは共有ライブラリのパスと名前を指定します。MotionSolveはこの情報を使用して、実行時にDLL内のユーザーサブルーチンを読み込みます。
usrsub_param_string: データファイルからユーザー定義のサブルーチンString_Readに渡されるパラメータのリスト。この属性は、すべてのタイプのユーザーサブルーチンおよびスクリプトに共通です。
usrsub_fnc_name: ユーザーサブルーチンString_Readの代替名を指定します。
script_name: usrsub_fnc_nameで指定されたルーチンを含むユーザー作成スクリプトのパスと名前を指定します。
interpreter: ユーザースクリプトが記述されたインタープリタ型言語を指定します。有効な選択肢は、MATLABまたはPYTHONです。

例

下の例は、Reference_Stringを使用して、VARSUBに渡すことのできるファイル名を定義する方法を示しています。Reference_StringのIDが、どのようにパラメータとしてユーザー定義のVARSUBに渡されるのかに注意してください。これによりVARSUBの実装が一般化されます。

<Reference_String 
   id                  = "1101"
   label               = "Name of string"
   string              = "/staff/gates/test/tire_data.xml" >
/>

Reference_Stringsは、任意のユーザー定義のサブルーチンで使用できます。

Reference: String

説明

フォーマット

属性

例

コメント