OUTPUT
The OUTPUT command redefines and/or lists the data for an OUTPUT statement.
Format
Arguments
ASCALE=r1[,r2] | Rescales the translational and the rotational accelerations Adams Solver (FORTRAN) outputs. Define r1 to scale the translational accelerations, and define r2 to scale the rotational accelerations. Both r1 and r2 default to 1.0. |
AZERO | Respecifies that output accelerations less than r in magnitude are to be set equal to zero. The value of r must be greater than zero. The value of r defaults to 1.0E-7 for output in scientific notation and to 0.001 for output in fixed-point notation. |
CHART | Reproduces x-y charts of the request data for the Tabular Output file. |
DSCALE=r1[,r2] | Rescales the translational and the rotational displacements Adams Solver (FORTRAN) outputs. Define r1 to scale the translational displacements, and define r2 to scale the rotational displacements. Both r1 and r2 default to 1.0. |
DZERO | Respecifies that output displacements less than r in magnitude are to be set equal to zero. The value of r must be greater than zero. The value of r defaults to 1.0E-7 for output in scientific notation and to 0.001 for output in fixed-point notation. |
FIXED | Reformats numerical output in fixed-point notation. Any values that are too small or too large for fixed-point notation are output in scientific notation. |
FSCALE=r1[,r2] | Rescales the translational and the rotational forces Adams Solver (FORTRAN) outputs. Define r1 to scale the translational forces, and define r2 to scale the rotational forces. Both r1 and r2 default to 1.0. |
FZERO | Respecifies that output forces less than r in magnitude are to be set equal to zero. The value of r must be greater than zero. The value of r defaults to 1.0E-7 for output in scientific notation and to 0.001 for output in fixed-point notation. |
GRSAVE | Resaves graphics output in the Graphics file so that you can use a postprocessor to display graphics. |
LIST | Lists the current values of the data in the OUTPUT statement. |
NOCHART | Stops producing x-y charts of the request data for the Tabular Output file. |
NOFIXED | Reformats numerical output in scientific notation. |
NOGRSAVE | Stops saving graphics output in the Graphics file. |
NOOSFORMAT | Stops writing output-step-request tables to the Tabular Output file during a dynamic, kinematic, or quasi-static equilibrium analysis. If you specify OSFORMAT, Adams Solver (FORTRAN) outputs an output-step-request table at each output time step. Whether you specify NOOSFORMAT or OSFORMAT, Adams Solver (FORTRAN) always outputs an output step request table when a static equilibrium analysis is requested. |
NOPRINT | Suppresses printing of all time-response-request tables. If you specify PRINT, Adams Solver (FORTRAN) prints these tables (one table for each request) in the Tabular Output file after the simulation is complete. |
NOREQSAVE | Stops saving request output in the Request file. |
NOSEPARATOR | Respecifies that Adams Solver (FORTRAN) is not to write separators to the request, graphics, results, and tabular output files when you modify the model topology in the middle of a simulation. You can change the model topology by using interactive commands to activate an element, deactivate an element, change a marker position, or change the type or point of application of a force or constraint during a simulation. When this happens, by default Adams Solver (FORTRAN) writes a separator and new header to the request, graphics, results, and tabular output files. Adams Solver (FORTRAN) then writes subsequent simulation output after the new headers. This ensures that the changes are correctly reflected in the output files, but it creates two sets of output that cannot be plotted or animated continuously. The NOSEPARATOR argument prevents Adams Solver (FORTRAN) from breaking up the files by creating a continuous set of output that can be plotted and animated from beginning to end. Note: This output may be misleading because the Graphics file does not include the effects of any changes in marker, force, or constraint positions during the simulation. While the part motions are correct, the force, joint, and marker graphics remain in their original positions, even if you move them during the simulation. |
NOTELETYPE | Indicates that Adams Solver (FORTRAN) is to format tabular output for printers with 132 columns per line, rather than for printers with 72 columns per inch. |
NOYPR | Restarts outputting rotational values in psi, theta, and phi coordinates, rather than in yaw, pitch, and roll coordinates. If during the course of a simulation this argument is used on an OUTPUT command after using the YPR argument on the OUTPUT command/statement, the output is part in yaw, pitch, and roll coordinates and part in psi, theta, and phi coordinates. Output in mixed coordinates is confusing and is not recommended. |
OSFORMAT | Rewrites output-step-request (OS) tables to the tabular output file immediately after completion of each output step for dynamic, kinematic, or quasi-static equilibrium simulation. If OSFORMAT is specified, Adams Solver (FORTRAN) outputs an OS table at each output time step during simulation. When a static equilibrium analysis is requested, Adams Solver (FORTRAN) always outputs an OS table whether NOOSFORMAT or OSFORMAT is specified. Use OSFORMAT to view the values of all requests at a particular output time or to provide printed output in cases where the simulation might not run to completion. A simulation may not run to completion because the model or user-written subroutines are not fully debugged. OSFORMAT might provide information useful in debugging the model or the user-written subroutines. |
PRINT | Reprints time-response-request tables (one table for each request) in the tabular output file after the simulation is complete. Time-response-request tables list all of the values for a single request. There is one line in the table for each output time step; the lines are in ascending order of time. |
REQSAVE | Resaves the request output in the Request file so you can use a postprocessor to display x-y plots. |
SEPARATOR | Respecifies that Adams Solver (FORTRAN) is to write separators to the Request, Graphics, Results, and Tabular Output files when you modify the model topology in the middle of a simulation. SEPARATOR is the default. See NOSEPARATOR for the effects of removing the separators. |
TELETYPE | Indicates that Adams Solver (FORTRAN) is to format tabular output for printers with 72 columns per line rather than for printers with 132 columns per line. |
VSCALE=r1[,r2] | Rescales the translational and the rotational velocities Adams Solver (FORTRAN) outputs. Define r1 to scale the translational velocities, and define r2 to scale the rotational velocities. Both r1 and r2 default to 1.0. |
VZERO | Respecifies that output velocities less than VZERO in magnitude are to be set equal to zero. The value of r must be greater than zero. The value of r defaults to 1.0E-7 for output in scientific notation and to 0.001 for output in fixed-point notation. |
YPR | Outputs rotational values in yaw, pitch, and roll coordinates, rather than in psi, theta, and phi coordinates (Euler angles). NOYPR is the default. If during the course of a simulation this argument is used on an OUTPUT command after using an OUTPUT command/statement without the YPR argument or after using an OUTPUT command with the NOYPR argument, the output is part in psi, theta, and phi coordinates and part in yaw, pitch, and roll coordinates. |
Extended Definition
Like the OUTPUT statement, the OUTPUT command controls the generation of the request file and graphics file, in addition to the form, format, coordinates, filtering, and scaling of request data in the tabular output file.
Forms of Request Data in the Tabular Output File
■X-y charts of the request data for the tabular output file - The output is in the same order as the requests are in the dataset. The information about each request (including those created by an MREQUEST command/statement) is in two parts.The left side of the first part contains a table of simulation time and the translational information output by the request, and the right side contains a plot of the translational information against time. The left side of the second part contains a table of simulation time and the rotational information output by the request, and the right side contains a plot of the rotational information against time. (The column titles can vary according to the type of request information and other arguments on the OUTPUT command/statement.)
These plots differ in two important ways from plots created with Adams Solver (FORTRAN) or most postprocessors. First, time is along the vertical axis in the chart plots and request data is along the horizontal axis. Second, the chart plots are normalized; that is, each curve is scaled independently of the others from the highest value to the lowest value for that curve. Therefore, use care when comparing curves to one another. You can compare the shapes but not the magnitudes of the curves.
These plots differ in two important ways from plots created with Adams Solver (FORTRAN) or most postprocessors. First, time is along the vertical axis in the chart plots and request data is along the horizontal axis. Second, the chart plots are normalized; that is, each curve is scaled independently of the others from the highest value to the lowest value for that curve. Therefore, use care when comparing curves to one another. You can compare the shapes but not the magnitudes of the curves.
■Time-response-request tables - A time-response-request table lists all values for a single request throughout the simulation. There is one line in the table for each output time step; the lines are in ascending order of time.
■Output-step-request (OS) table — An OS table lists the values of all requests at each output time step. There is a line for each output time step, followed by one line for each request.
Forms of Request Data in the Tabular Output File
■Columns per line
■72 columns
■132 columns
■Numerical notation of request data in the Tabular Output file
■Fixed-point - Fixed-point notation expresses a decimal or an integer number without an exponent.
■Scientific - Scientific notation expresses a number as a value between 1 and 10 (the mantissa) multiplied by the appropriate power of 10 (the exponent). Adams Solver (FORTRAN) uses E between the mantissa and the exponent, and may use a decimal number as the value.
Coordinates of Rotational Request Data in the Tabular Output File
■Yaw, pitch, and roll angles
■Psi, theta, and phi angles
Scales for Request Data in the Tabular Output File
■Scale for displacements
■Scale for velocities
■Scale for accelerations
■Scale for forces
Filters for Request Data in the Tabular Output File
■Zero filter for displacements
■Zero filter for velocities
■Zero filter for accelerations
■Zero filter for forces
Caution: | ■TELETYPE or CHART cannot be used in conjunction with the OSFORMAT argument because the OSFORMAT argument prints records 132 characters wide and because CHART prints information next to a plot. ■The ICSAVE and NOICSAVE arguments and the .icf file have been discontinued. The SAVE and RELOAD commands replace the OUTPUT/ICSAVE and EXECUTION/ICSTART arguments. |
See other Output available.