*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.
- local_deriv_iface_dll
- Alternate subroutine file having function for continuous states and its partial derivatives (GSE_DERIV).
- local_output_iface_dll
- Alternate file name for an output function and its partial derivatives (GSE_OUTPUT).
- local_update_iface_dll
- Alternate file name for a discrete states function and its partial derivatives (GSE_UPDATE).
- local_samp_iface_dll
- Alternate file name for a sampling period subroutine (GSE_SAMP).
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
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.