Mechanism Design 與 Mechanism Dynamics > 機構動態 > 自訂負載 > 關於函數與其引數值
  
關於函數與其引數值
在調用自訂負載函數時要使用一些引數，您可視需要選擇性地將這些引數加入到函數定義中。以下為各函數之引數的詳細說明。
CLUSEREvalCustomLoad
int CLUSEREvalCustomLoad (char* CustomLoadName, char* ForceName, double CurrentTime, double* value);
輸入
CustomLoadName
自訂負載的名稱
ForceName
使用自訂負載之執行馬達或外部力的名稱。
CurrentTime
分析的目前時間。
Value
自訂負載應用程式傳回之自訂負載的值。
0 表示成功。任何非零的值均意味著自訂負載發生錯誤，分析將不會繼續進行。
CLEvalMeasure
extern int CLevalMeasure (char*meaName, double* MeasureValue);
輸入
MeaName
要計算之量測的名稱。該量測必須存在於模型中，且必須是一個方位或速度量測。
輸出：
MeasureValue
目前時間的量測值。
返回：
0 表示成功。1 表示量測不存在或是量測並非方位或速度量測。
CLUSERDefineInit
int CLUSERDefineInit (char* CustomLoadName, char* ForceName);
輸入
CustomLoadName
自訂負載的名稱。
ForceName
使用自訂負載之執行馬達或外部力的名稱。
返回：
0 表示成功。任何非零的值即代表自訂負載發生錯誤，不會定義該負載。
CLUSERRunInit
int CLUSERRunInit (char* CustomLoadName, char* ForceName);
輸入：
CustomLoadName
自訂負載的名稱。
ForceName
使用自訂負載之執行馬達或外部力的名稱。
返回：
0 表示成功。任何非零的值即代表自訂負載發生錯誤，不會定義該負載。
CLUSERGetStateVariablesSize
int CLUSERGetStateVariablesSize (char* CustomLoadName, char* forceName, int* size);
輸入：
CustomLoadName
自訂負載的名稱。
ForceName
使用自訂負載之執行馬達或外部力的名稱
輸出：
Size
狀態變數向量的大小。
返回：
0 表示成功。任何非零的值即代表此自訂負載並未使用狀態變數。
CLUSERInitStateVariables
int CLUSERInitStateVariables (char* CustomLoadName, char* forceName, double* StateVar);
輸入：
CustomLoadName
自訂負載的名稱。
ForceName
使用自訂負載之執行馬達或外部力的名稱
輸出：
StateVar
初始狀態變數值的向量。記憶體是由 Mechanism Design 分配的。
返回：
0 表示成功。任何非零的值均意味著自訂負載發生錯誤，分析將不會繼續進行。
CLUSERGetStateVariableDerivatives
int CLUSERGetStateVariableDerivatives (char* CustomLoadName, char* forceName, double CurrentTime, double* StateVar);
輸入：
CustomLoadName
自訂負載的名稱。
ForceName
使用自訂負載之執行馬達或外部力的名稱
CurrentTime
分析的目前時間。
輸出：
StateVar
此時狀態變數數值的向量。記憶體是由 Mechanism Design 分配的。
返回：
0 表示成功。任何非零的值均意味著自訂負載發生錯誤，分析將不會繼續進行。
CLEvalStateVariables
int CLevalStateVariables (char* CustomLoadName, char*  forceName, int numElem, double* stateVarArray);
輸入：
CustomLoadName
自訂負載的名稱。
ForceName
使用自訂負載之執行馬達或外部力的名稱
NumElem
狀態變數陣列中值的數目。
輸出：
StateVarArray
此時狀態變數數值的向量。記憶體是由 Mechanism Design 分配的。
返回：
0 表示成功。