Create/Modify General State Equation
Ribbon menu → Elemens tab → System Elements container → Create/Modify General State Equation 
or
(Classic) Build → System Elements → General State Equation → New/Modify
Lets you represent a subsystem that has well defined inputs (u), internal states (x), and a set of well defined outputs (y).
Learn about:
For the option: | Do the following: |
|---|---|
Tips on Entering Object Names in Text Boxes. | |
General State Equation | Enter the name of the GSE. |
Solver ID | Assign a unique ID number to the GSE. See Adams Solver ID. |
U Array (Inputs) | Specify the array element that defines the input variables for the GSE. The U array is optional. When not specified, there are no system inputs. The number of inputs to the GSE is inferred from the number of variables in the U array. |
Y Array (Outputs) | Specify the array element that defines the output variables for the GSE. |
User Function Parameters | Specifies the parameters that are to be passed to the User-written subroutines that define the constitutive equations of a GSE, viz., Equations (1), (2), and (3). Three user subroutines are associated with a GSE: ■GSE_DERIV is called to evaluate fc() in Equations 1. ■GSE_UPDATE is called to evaluate fd() in Equations 2. ■GSE_OUTPUT is called to evaluate g() in Equations 3. See the Subroutines section of the Adams Solver online help. |
Interface Function Names | If you specify a user function, enter function names to use other than the standard names GSE_DERIV, GSE_UPDATE, and GSE_OUTPUT. |
STATICS_ONLY | When included (or set to On) will only activate GSE for statics. During dynamics the GSE will be inactive if set, and this should speed up the Solver solution during dynamics since less number of states are being solved. |
States | Set to: ■None (No options appear) |
If you selected Continuous or Sampled, the following options appear: | |
X Array (Continous) | Enter the array element that defines the continuous states for the GSE. The array element must be of the X type, and it cannot be used in any other linear state equation, general state equation, or transfer function. |
IC Array (Continous) | Enter the array element that specifies the initial conditions for the continuous states in the system. When you do not specify an IC array for a GSE, all the continuous states are initialized to zero. |
Static Hold | Indicate whether or not the continuous GSE states are permitted to change during static and Quasi-static simulations. |
If you selected Discrete or Sampled, the following options appear: | |
X Array (Discrete) | Enter the array element that is used to access the discrete states for the GSE. It must be of the X type, and it cannot be used in any other linear state equation, general state equation, or transfer function. |
IC Array (Discrete) | Enter the array element that specifies the initial conditions for the discrete states in the system. The array is optional. The array element must be of the IC type. When you do not specify an IC array for a GSE, all the discrete states are initialized to zero. |
First Sample Time | Specify the Simulation time at which the sampling of the discrete states is to start. All discrete states before the first sample time are defined to be at the initial condition specified. The default is zero. |
Sample Function/Sample User Parameters | Specify the sampling period associated with the discrete states of a GSE. This tells Adams Solver to control its step size so that the discrete states of the GSE are updated at: last_sample_time + sample_period In cases where an expression for the sampling period is difficult to write, you can specify it in a user-written subroutine GSE_SAMP. Adams Solver will call this function at each sample time to find out the next sample period. Select the More button  to display the Function Builder and build an expression. See Function Builder and the Adams View Function Builder online help. |
 | Add any comments about the GSE to help you manage and identify it. See Comments. |