MotionSolveモデルでのCD-Tireの使用

ユーザー定義の路面を定義して使用するには、以下のプロセスに従います：

1. 一連のユーザー路面のソースファイルをコンパイルしてリンクすることで、user road dllを作成します。
2. GFORCEユーザーパラメータリストでユーザー路面オプション（1100）を選択します。

   <Force_Vector_TwoBody
      id                  = "20"
      label               = "CDTire2"
      type                = "ForceAndTorque"
      i_marker_id         = "1621"
      j_floating_marker_id= "2305"
      ref_marker_id       = "7"
      usrsub_param_string = "USER(838,1611,1612,1613,1614,2303,2200,2,4,1,1,20,21,1100,21)"
      usrsub_dll_name     = "cdtire"
      usrsub_fnc_name     = "gfosub"
   />

3. 使用する路面ファイルに対応する適切なユーザー路面ファイル名の文字列を定義します。

   <Reference_String
      id                  = "25"
      label               = "CDTire2_roadfile_root"
      string              = "./prop_files/cdt_data/road_data/rsm1_"
   />

   ユーザー路面ファイルがCDTireによって開かれ、そのファイル入出力単位が引数としてユーザー路面DLLエントリ関数に渡されます。

4. dll_nameと関数名が２つのコロン（::）で区切られたユーザー路面DLL関数名を定義します。

   <Reference_String
      id                  = "16"
      label               = "CDTire1_user_road_dll_fname"
      string              = "cdt_zbuser::ZB1100"
   />

   上記のコードは、ユーザーDLL“cdt_zbuser.dll”を読み込んで“ZB1100”関数を呼び出すサンプルモデルに相当します。例えば、DLLが使用できないことやZB1100エクスポートシンボルの欠落に起因して、この読み込みと呼び出しが失敗すると、このプロセスは停止します。

ユーザーDLLのコンパイルとリンクは、ユーザー路面のシミュレーションを正常に実行するうえで重要な手順です。これを実現するには、ユーザー路面関数を記述する必要があります。ユーザー関数はCDTireによって呼び出されるので、定義済みの署名が必要です。

SUBROUTINE ZB1100( X, Y, Z, MUE, IBINIT, INSTANCE, IUNIT, OUNIT, IERR )

CDTire DLLはユーザー路面DLLを呼び出しますが、ユーザー路面関数に次の引数があることを想定しています。

INPUTS: X, Y ....... Road coordinates relative to P5 marker in [mm]
        IBINIT ..... Initialization flag ( =0 init, <>0 eval )
        INSTANCE ... CDTire instance number ( PAR(8) of GFORCE )
        IUNIT ...... FORTRAN unit of road data file, already open
        OUNIT ...... FORTRAN unit of road log  file, already open
 
OUTPUTS: Z ......... Road surface height in [mm] at (X,Y) relative P5
         MUE ....... Friction coefficient of road surface at (X,Y)
         IERR ...... Error flag ( =0 success, <>0 stop calculation )