RESULTS

The RESULTS statement creates a results file that includes all the simulation output from Adams Solver (FORTRAN). The results file can be either unformatted (binary) or formatted (ASCII).

Format

Arguments

 
COMMENT=c
Specifies a title for the results file generated by a RESULTS statement. The entire comment must be on one line. Because the COMMENT argument can be only eighty characters long at most, the title can be from seventy-two characters long (if you do not abbreviate COMMENT=) to seventy-six characters long (if you abbreviate COMMENT= to COM=). Blank spaces and all alphanumeric characters can be used. However, the comma (,), the semicolon (;), the ampersand (&), and the exclamation point (!) cannot be used. COMMENT defaults to a blank line.
DECIMALPLACES=i
This argument is only available with XRF.

Specifies how many digits are written after the decimal point for real numbers. The default value is 17 decimal places (full precision for recovery of double-precision numbers).
FORMATTED
Specifies that the results file is to be a formatted (text) file. The default is an unformatted (binary) file. The formatted results file contains Adams Solver (FORTRAN) output in plain text that you can read. You cannot examine an unformatted results file directly. Although the unformatted results file is not user-readable, it is generally preferred for several reasons. The unformatted file is smaller, contains more precise data, and is much quicker for Adams Solver (FORTRAN) to write and for a postprocessor to read. A formatted file is useful only when you wish to examine the data directly, or when transferring the file between computer systems with incompatible binary formats.
NOACCELERATIONS
Specifies that the results file is not to include part accelerations. the default is a results file that includes part accelerations.
NOAPPLIEDFORCES
Specifies that the results file is not to include applied forces. The default is a results file that includes applied forces.
NODATASTRUCTURES
Specifies that the results file is not to include results from data structures such as variables, plant inputs, plant outputs and user-defined requests. The default is a results file that contains results from data structures.
NODISPLACEMENTS
Specifies that the results file is not to include part displacements. The default is a results file that includes part displacements.
NOFLOATINGMARKERS
Specifies that the results file is not to include results for floating markers. The default is a results file that contains results for floating markers.
NOLINEAR
Specifies that the results file is not to include results from linear analyses. The default is a results file that contains results from linear analyses.
NOREACTIONFORCES
Specifies that the results file is not to include constraint reaction forces. The default is a results file that includes constraint reaction forces.
NOREQUESTS
Specifies that the results file not include request output. The default is a results file that includes user-defined request, in the case of a classic results file, or all request data (in the case of an XML-formatted results file (XRF)).
NOSYSTEMELEMENTS
Specifies that the results file is not to include results for system modeling elements such as user-defined differential equations, linear state equations, general state equations, and transfer functions. The default is a results file that contains results for system modeling elements.
NOTIRES
Specifies that the results file is not to include results for tires. The default is a results file that contains results for tires.
NOVELOCITIES
Specifies that the results file is not to include part velocities. The default is a results file that includes part velocities.
ROUNDOFF
This argument is only available with XRF.

Enables the roundoff feature for real numbers (the default is disabled). The SIGNIFICANTFIGURES argument controls the actual numbers of digits retained during rounding off.
SCIENTIFICNOTATION=i1,i2
This argument is only available with XRF.
Specifies the boundaries at which the format for real numbers switches from a fixed point format to scientific notation. The values are exponents for the base ten. The default values are -4 and 5, meaning that any number less than or equal to 1.0E-04 or greater than or equal to 1.0E+05 will be written in scientific notation.
SIGNIFICANTFIGURES=i
This argument is only available with XRF.

Specifies how many significant figures of a real number are retained during round off (when round off is enabled). The default is to use ten significant figures.

This number is distinct from the number of places actually printed for a real number, which the DECIMALPLACES argument controls.
Note: SIGNIFICANTFIGURES includes digits to the left and right of the decimal point.
TRAILINGZEROS
This argument is only available with XRF.

Specifies that trailing zeros are printed for real numbers. The default is not to print trailing zeros. When enabled, all the digits after the decimal point will be printed, whether they are zero or not. When disabled, any zeros at the end of the fractional part of the number will be dropped, leaving the last digit as a non-zero digit.
XRF
Specifies the format of the results file to be XML. XML (Extensibile Markup Language) is an industry-standard format facilitating structured data representation and web communication.

XRF will produce an XML-formatted results file even if the FORMATTED parameter has not been specified.
ZEROTHRESHOLD=r
This argument is only available with XRF.

Specifies the zero threshold value for numbers being written to an output file. If a number has an absolute value smaller than the zero threshold value, then it will be written out as zero. This value is independent of units.

Extended Definition

The RESULTS statement creates a results file that includes selections of output from an Adams Solver (FORTRAN) simulation. This all-purpose file can contain all the simulation output from Adams Solver (FORTRAN). The results file can contain any combination of the following information:
Displacements - Displacements of the BCS with respect to ground and resolved in the ground coordinate system (GCS).
Velocities - Velocities of the the BCS with respect to ground and resolved in the GCS.
Accelerations - Accelerations of the BCS with respect to ground and resolved in the GCS.
Reaction forces - Forces on the I marker required to enforce each constraint, resolved in the GCS.
Applied forces - Forces on the I marker applied by Adams Solver (FORTRAN) force elements, resolved in the GCS.
Data structures - Values computed for data structures such as variables, plant inputs, plant outputs, and requests defined by expressions in the dataset or by a user-written REQSUB.
System elements - Inputs, outputs, state variables, and state derivatives defined by system modeling elements such as user-written differential equations, linear state equations, general state equations, and transfer functions.
Tires - Displacements, velocities, accelerations, forces, and other information about tires.
Floating markers - Displacements of floating markers.
Linear - Eigenvectors, eigenvalues, and state matrices computed by a linear analysis invoked by the LINEAR command.
 
Tip:  
The title specified in the COMMENT argument helps identify the results file. If you do not include the COMMENT argument in the RESULTS statement, Adams Solver (FORTRAN) uses a blank line for the title of the results file.
Because results files can contain all the information generated by Adams Solver (FORTRAN) during a simulation, they may become quite large. The NO... arguments should be used to remove unwanted output and conserve disk space.
Caution:  
The NODATASTRUCTURES argument has superseded the old NOUSERRESULTS argument and the NOSYSTEMELEMENTS argument has superseded the old NODIFF argument.

Examples

RESULTS/FORMATTED, NODATASTRUCTURES, NOSYSTEMELEMENTS

RESULTS/NODISPLACEMENTS, NOVELOCITIES
,NOACCELERATIONS, NODATASTRUCTURES
,NOSYSTEMELEMENTS, NOLINEAR
,NOFLOATINGMARKERS, NOTIRES
See other Output available.