机构设计和机构动力学 > 机构动力学 > 自定义载荷 > 关于函数及其自变量值
  
关于函数及其自变量值
调用自定义载荷函数时会附带许多自变量，可有选择地将这些自变量添加到函数定义中。下文提供了每一函数的自变量的详细说明。
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。