ユーザー定義の路面モデル

路面データファイルにurmのファイル拡張子がある場合、COSIN/roadは路面評価ルーチンが提供されており、以下の動的に読み込み可能なライブラリにコンパイルされたと見なします：

• Windowsではurm.dll

  LINUXおよびUNIXではそれぞれliburm.soおよびliburm.sl

ライブラリには、以下の形式を持つCまたはC++関数が含まれている必要があります：

extern void urm (int ti, double t, double x, double y, double*z, double*vx, double*vy, double*vz, double*mu, int*ier, char*file);

このルーチンのみが持つタスクは、以下を提供することです：

• 路面高さz
• 路面の速度v_x、v_y、v_z
• 摩擦修正係数

これらすべては以下の関数となります：

• 時間 t
• 位置 x、y

動作パラメータの意味は以下のとおりです：

以下に、そのようなC関数の最も単純な例のリストを示します。コード（urm.c）は、FTire/libダウンロードのサブフォルダーsdkに含まれます。

/* place-holder for user-defined road model (URM) */

#include <stdio.h>

extern void urm (int ti, double t, double x, double y,
                 double*z, double*vx, double*vy, double*vz, double*mu, int*ier, char*file) {

  static int first=1;

  if (first) {
    printf("\nthis is the demo user road model, using data file %s..\n",file);
    first=0;
  }

  /* terminate road model */
  if (t>=0.9e60) {
    return;
  }

  *z=0.0;
  if (x>1.0 && x<1.2) *z=0.02;
  *vx=0.0;
  *vy=0.0;
  *vz=0.0;
  *mu=1.0;
  *ier=0;
}