*SetLocalUserInterfaceDLL()

Specifies the local subroutine files for an ADAMS general state equation.

Syntax

*SetLocalUserInterfaceDLL( varname, local_deriv_iface_dll, 
                                              local_output_iface_dll, 
                                              local_update_iface_dll, 
                                              local_samp_iface_dll)

Arguments

varname
The variable name of the state equation.
Data type: variable
local_deriv_iface_dll
Alternate subroutine file having function for continuous states and its partial derivatives (GSE_DERIV).
Data type: string
local_output_iface_dll
Alternate file name for an output function and its partial derivatives (GSE_OUTPUT).
Data type: string
local_update_iface_dll
Alternate file name for a discrete states function and its partial derivatives (GSE_UPDATE).
Data type: string
local_samp_iface_dll
Alternate file name for a sampling period subroutine (GSE_SAMP).
Data type: string

Example

*SolverVariable( sv_1, "Input 1" )
 *SetSolverVariable( sv_1, EXPR, `VX(1, 2, 3)`, OFF )
 *SolverVariable( sv_2, "Input 2" )
 *SetSolverVariable( sv_2, EXPR, `STEP(TIME, 0, 1, 5, 200)`, OFF )
 *SolverVariable( sv_3, "Input 3" )
 *SetSolverVariable( sv_3, LIN, 1+1, OFF )
 *SolverArray( u_array, "Input Array", U, sv_1, sv_2, sv_3 )
 *SolverArray( ic_array, "ICD Array", IC )
 *SolverArray( icd_array, "ICD Array", IC )
 *SetSolverArray( icd_array, VALUE, 2, 0.0, 2.5) 
 *SetSolverArray( ic_array, VALUE, 4, 0.0, 3.4, 
b_0.mass, 
b_0.Izz ) 
*GeneralStateEquation( gse_0, "My Controller", 3, 
u_array, ic_array , icd_array )
 *SetGeneralStateEquation(gse_0, USER, `USER(500, 
{frc_cont.i.idstring}, 
{frc_cont.j.idstring})`
)
 *SetContinuousStates( gse_0, 4, )
*SetDiscreteStates(gse_0, LIN, 2, 0.5, )
 *SetLocalUserInterfaceDLL( gse_0 , "mygsederiv", 
"mygseoutput", 
mygseupdate", 
"mygsesamp")
 *ActionReactionForce(frc_cont, "Control Force", LOA, b_0, 
B_Ground, p_cont, P_Global_Origin )
 *SetForce( frc_cont, EXPR, ARYVAL({gse_0.y_array.idstring}, 2)`

Context

*BeginMdl()

*DefineAnalysis()

*DefineSystem()

*DefineAssembly()

*BeginContext()

Comments

This statement can be used to specify subroutine file names for ADAMS general state equations. This statement is not applicable for MotionSolve.

This statement writes out the INTERFACE argument in the GSE statement.

If local subroutine files are not used, the solver will use the default subroutine file provided at the solver run command line. If local functions are not specified through the *SetLocalUserInterfaceFuncName() statement, the solver will search for the following default functions: GSE_DERIV, GSE_OUTPUT, GSE_UPDATE, and GSE_SAMP.