Welcome to Adams/Solver Subroutines - Kxcad.net

Welcome to Adams/Solver Subroutines
nsize An integer variable that gives the number of parameters that the function
fncnam requires. Its value is dependent on the function name. See the table
above for the number of parameters that function fncnam requires.
Output Arguments
errflg A logical variable that returns as true if an error occurred during your call
to SYSARY.
nstates An integer variable that returns the number of values Adams/Solver has
put in states. Note that an integer variable must be used here for
Adams/Solver to return the number of states. The value returned in this
variable is as defined in the table above.
states A double-precision array whose size depends on the fncnam (see the table
above) that contains the values that SYSARY returns. When the iflag
argument in the user subroutine is true or when input errors are found,
states contains zeros.
Extended Definition
SYSARY returns a set of system states or stores the dependencies of the user value on the set of system
states. You can use the system state values to compute the instantaneous values of a user-defined
function; Adams/Solver uses the dependency on state variables to create the matrix of partial derivatives
(Jacobian) of the system states with respect to the Adams/Solver state variables. Adams/Solver uses the
Jacobian matrix in several analysis computations.
When called from a force evaluation subroutine or from VARSUB, SYSARY returns the current
predicted values of the state. SENSUB is called only after a completed integration state, so SYSARY
returns the converged values when called from SENSUB. REQSUB is called at output steps and, like
SENSUB, SYSARY returns the converged values when called from REQSUB. Therefore, the values
returned from SYSARY are the current values of the state; whether they are the predicted values, or the
corrected values, depends on where you are when calling SYSARY.
You should use SYSFNC (see SYSFNC) to access a single system state corresponding to one modeling
element.
Where SYSFNC evaluates one Adams/Solver function, SYSARY evaluates several with one call. For
example, to evaluate DX(12,10,99), DY(12,10,99) and DZ(12,10,99), you call SYSARY with:
• fncnam='TDISP'
• ipar(1)=12
• ipar(2)=10
• ipar(3)=99
• nsize=3
97