output_control set debug
Allows you to output data for debugging your data set. You can instruct Adams toprint out information using the following parameters:
Format:
output_control set debug |
|---|
model_name = | model_name |
eprint = | on/off |
verbose = | on/off |
topology = | on/off |
dof = | on/off |
Example:
output_control set debug & |
|---|
model_name = | model_1 & |
eprint = | on & |
verbose = | off & |
topology = | on & |
dof = | on |
Description:
Parameter | Value Type | Description |
|---|
model_name | String | Specifies the model to be modified. You use this parameter to identify the existing model to be affected with this command. |
eprint | On/Off | Specifies that a block of information will be printed for each kinematic, static, or dynamic step. |
verbose | On/Off | Specifies that Adams will output additional information in the diagnostic messages and send it to the screen during an analysis. |
jmdump | On/Off | Specifies that the Jacobian matrix will be dumped after each iteration. JMDUMP is useful only when you request a dynamic analysis. |
reqdump | On/Off | Specifies that data from the REQUEST and MREQUEST statements is to be output at each iteration. |
rhsdump | On/Off | Specifies that data from the YY array (state vector), the RHS array (error terms), and the DELTA array (increment to state vector) is to be dumped at each iteration. |
dump | On/Off | Specifies that Adams will write the internal representation of your data set in the tabular output file after Adams reads and checks the input. |
topology | On/Off | Specifies that Adams will print topological data in the message file. |
dof | On/Off | Specifies that a degree-of-freedom table will be printed in the tabular output file. |
Extended Definition:
1. You may identify a model by typing its name or by picking it from the screen.
If the model is not visible on the screen, you must type the name. You may also find it convenient to type the name even if the model is displayed. You must separate multiple model names by commas. If the model is visible in one of your views, you may identify it by picking on any of the graphics associated with it.
2. The “eprint” information helps you to monitor the simulation process and to locate the source of the error if there is a problem.
Each step consists of two phases:
a. A forward step in time (dynamic predictor).
b. The solution of the equations of motion (dynamic corrector).
For the first phase, Adams prints three or four pieces of information. The information includes the following:
■The step number. This is a running count of the number of steps taken and can be used as a measure of how hard Adams is working.
■For dynamics, the order of the predictor. This corresponds to the order of the polynomial Adams uses to predict the solution at the end of the integration step.
■The value of time at the beginning of the step.
■The size of the step.
For the second phase, Adams prints out the cumulative number of iterations and a table of information about the iterations. The cumulative number of iterations is a running count of the iterations needed to solve the equations of motion and can be used as a measure of how many computations Adams is performing. The table contains information about the maximum equation error and maximum variable change for each iteration. For each iteration, Adams prints out seven or eight pieces of the following information:
The iteration number. This will be the one at the beginning of each step and will increment by one until Adams converges to a solution or exceeds the maximum allowable number of iterations.
The absolute value of the largest equation error. Each equation should have an error value close to zero. This number is an indicator of how far Adams is from a solution. It should decrease after every iteration.
The data set element associated with the largest equation error.
For the above data set element, the equation that has the largest equation error.
The absolute value of the largest change in a variable. The final iteration should not need to change variables very much. This number is an indicator of how far Adams needs to change variables to approach. The data set element associated with the absolute value of the largest change in a variable.
For the above data set element, the variable with the largest change.
If Adams has updated the Jacobian, YES appears under the new Jacobian header.
3. Information such as the name of the subroutine from which Adams sends each diagnostic, explanations, and possible remedies (when available) will be output
4. Adams can generate topological data from the information in your data set about the relationship between parts and constraints (except for couplers and user-defined constraints), such as joints. An understanding of this topological data will help you find constraint errors in you model, but it is not essential to an understanding of Adams. You can use the topological data generated by Adams to chart the connections between parts and constraints in the model.This alerts you to over constrained loops and immobile loops. A value of ON instructs Adams to print this data in the message file. The default value is OFF.
5. The dof table tells whether or not each of the six components of motion (i.e. translation along the x-axis, the y-axis, and the z-axis and rotation about the x-axis, the y-axis, and the z-axis) is constrained for each part. These are the degrees of freedom as input, not the degrees of freedom after Adams removes redundant constraints.
Cautions:
1. Adams always outputs VERBOSE information to the message file regardless of the setting of the VERBOSE parameter.
2. The dump facility essentially maps the equations and variables in your system and provides their numeric codes.
Tips:
1. If you do not include the VERBOSE argument, Adams outputs only severities and basic error messages to the screen.