Adams Basic Package > Adams View > View Command Language > output_control > output_control set output

output_control set output

OUTPUT controls the generation of request, graphics, and initial conditions files. In addition, it controls the form, format, coordinates, filtering, and scaling of request data in the tabular output file. Specifically, OUTPUT controls the following:
1. 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 data set. The information about each request (including those created by an MREQUEST) 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.
These plots differ in two important ways from plots you create with the Adams PLOT command, or the Adams View XY_PLOT command. 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 from 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 output-step-request 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.
2. Formats of request data in the tabular output file
■Columns per line - 72 columns per line or - 132 columns per line
■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 or
♦Scientific--Scientific notation expresses a number as the appropriate power of 10 (the exponent). Adams uses E between the mantissa and the exponent, and may use a decimal number as the value.
3. Coordinates of rotational request data in the tabular output file
■Yaw, pitch, and roll or
■Psi, theta, and phi
4. Scales for request data in the tabular output file
■Scale for displacements
■Scale for velocities
■Scale for accelerations
■Scale for forces
5. 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

Format:

 
output_control set output
model_name =
String
chart =
on/off
reqsave =
on/off
dacsave =
on/off
matsave =
on/off
rpcsave =
on/off
print =
on/off
fixed =
on/off
osformat =
on/off
ypr =
on/off
separator =
on/off
icsave =
on/off
teletype =
on/off
grsave =
on/off
dscale =
real
dzero =
real
vscale =
real
vzero =
real
ascale =
real
azero =
real
fscale =
real
fzero =
real
loads =
none/dac/nastran/generic/rpc/ansys/abaqus/marc
modal_deformation =
none/generic/nastran/dac/punch/rpc/ansys/femfat
nodal_deformation =
none/generic/nastran/ansys/abaqus
stress =
none/dac/generic/rpc
strain =
none/dac/generic/rpc

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.
chart
On/off
Specifies that Adams will produce x-y charts of the request data in the tabular output file. If you do not specify CHART=ON, Adams does not produce charts of the request data for the tabular output file. A value of ON for this parameter will produce a chart, and a value of OFF will not produce a chart.
reqsave
On/off
Specifies that Adams will save request output in the request file so that you can use Adams View to display x-y plots. If you do not specify REQSAVE=ON, Adams does not save the request output in the request file. The default value for this parameter is OFF.
dacsave
On/off
Specifies that Adams will save request data to DAC formatted files. If you do not specify DACSAVE=ON, Adams does not save request data to DAC files. The default values for this parameter is OFF.
matsave
On/off
Specifies that Adams will save request data to MAT formatted file. A MAT file is a MATLAB® formatted file. If you do not specify MATSAVE=ON, Adams does not save request data to MAT file. The default values for this parameter is OFF.
rpcsave
On/off
Specifies that Adams will save request data to an RPC3 formatted file. If you do not specify RPCSAVE=ON, Adams does not save request data to RPC3 file. The default values for this parameter is OFF.
print
On/off
Specifies whether or not Adams will print time-response-request tables in the Adams Tabular Output File. If you specify ON, Adams will write tables for each request and mrequest in your model. If you specify OFF, Adams will not write the tables.
fixed
On/off
Specifies numerical output in fixed-point notation format. A value of FIXED=ON will force output to fixed-point notation. Any values that are too small or too large for fixed-point notation are output in scientific notation. If you specify FIXED=OFF, Adams formats numerical output in scientific notation.
osformat
On/off
Specifies that output-step-request (OS) tables will be written to the tabular output file immediately after completion of each output step for dynamic, kinematic, or quasi-static equilibrium analysis. If you specify OSFORMAT=ON, Adams outputs an output-step-request (OS) table at each output time step during simulation. If you specify OSFORMAT=OFF, Adams does not output request data in this form for these analysis types.
ypr
On/off
Specifies that rotational values are to be OUTPUT in yaw, pitch, and roll coordinates, rather than in psi, theta, and phi coordinates.
separator
On/off
Specifies whether or not Adams will write separators to the Request, Graphics, Results, and Tabular Output Files when you modify the model topology in the middle of a simulation.
icsave
On/off
Specifies that the state vector at every output time step will be saved.
teletype
On/off
Specifies Adams to format tabular output for printers with 72 columns per line, rather than for printers with 132 columns per line (this is done with the value TELETYPE=ON). A value of TELETYPE=OFF instructs Adams to format tabular output in 132 columns.
grsave
On/off
Specifies that Adams is to save graphic output in a graphics file. This file can then be read into Adams View, and the graphics can be displayed. A value of GRSAVE=ON will instruct Adams to write graphics data to the graphics file. If GRSAVE=OFF is specified, Adams does not save graphics output.
dscale
Real
Specifies the scale factor applied to translational and rotational displacements Adams outputs. Dscale accepts two REAL numbers(r1, r2). Define r1 to scale the translational displacements. Define r2 to scale the rotational displacements. Both r1 and r2 default to 1.0.
dzero
Real
Specifies that output displacements less than the value of this parameter, in magnitude, are to be set equal to zero. The value of DZERO must be greater than zero. The value of DZERO defaults to 1.0E-07 in scientific notation and to 0.001 in fixed-point notation.
vscale
Real
Specifies scale factors to apply to the translational and rotational velocities Adams outputs. VSCALE accepts two REAL numbers(r1, r2). Define r1 to scale the translational velocities. Define r2 to scale the rotational velocities. Both r1 and r2 default to 1.0.
vzero
Real
Specifies that output velocities less than the value of this parameter, in magnitude, are to be set equal to zero. The value of VZERO must be greater than zero. The value of VZERO defaults to 1.0E-07 for output in scientific notation and to 0.001 for output in fixed-point notation.
ascale
Real
Specifies a scale factor which is applied to the translational and the rotational accelerations that Adams outputs.
Azero
Real
Specifies that output accelerations that have a magnitude less than the value of this parameter are to be set equal to zero. The value given must be greater than zero. The value defaults to 1.0E-07 for output in scientific notation and to 0.001 for output in fixed-point notation.
fscale
Real
Specifies a scale factor which is applied to the translational and the rotational forces Adams outputs. FSCALE accepts two REAL numbers (r1, r2. Define r1 to scale the translational forces. Define r2 to scale the rotational forces. Both r1 and r2 default to 1.0E+00 in scientific notation and to 1.0 in fixed-point notation.
fzero
Real
Specifies that output forces less than the value of this parameter, in magnitude, are to be set equal to zero. The value of FZERO must be greater than zero. The value of FZERO defaults to 1.0E-07 for output in scientific notation and to 0.001 for output in fixed-point notation.
loads
none/dac/nastran/generic/rpc/ansys/abaqus/marc
modal_deformation
none/generic/nastran/dac/punch/rpc/ansys/femfat
nodal_deformation
none/generic/nastran/ansys/abaqus
stress
none/dac/generic/rpc
strain
none/dac/generic/rpc

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.
You need not separate multiple model picks by commas.
2. When you request a static equilibrium analysis, Adams always outputs an output-step-request (OS) table whether or not you specify OSFORMAT=ON. 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.
3. For ypr, first Adams rotates about the z-axis, then about the new negative y-axis (y'), and then about the second new x-axis (x"). If you specify YPR=OFF, Adams outputs rotational values in psi, theta, and phi coordinates.
4. You can change the model topology by adding Adams commands to your ACF file 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.
If you specify SEPARATOR=ON (this is the default) the analysis information will be read into Adams View, one analysis for each block of output between the separators.
If you specify SEPARATOR=OFF the analysis information will be read into Adams View as a single analysis. This allows you to plot or animate the analysis from beginning to end.
5. Adams uses a special format to output this information to the initial conditions file so that a subsequent simulation can be restarted at any time in the current simulation. When a subsequent simulation is performed using the same data set, the mid-simulation conditions from the previous analysis can be accessed and used as the initial conditions for the current analysis. Adams prompts the user for the name of the initial conditions file if the ICSAVE parameter is set to ON. When a simulation is restarted, Adams searches the initial conditions file for the time closest to the time specified in the EXECUTION command, and then replaces the state vector in the model with that from the initial conditions file. If ICSAVE=OFF is specified, Adams does not save initial conditions in the initial conditions file.
6. ASCALE accepts two REAL numbers(r1, r2). Define r1 to scale the translational accelerations. Define r2 to scale the rotational accelerations. These numbers are multiplied by the accelerations in Adams, therefore, a scale factor between 0.0 and 1.0 scales the accelerations down, a scale factor greater than 1.0 scales the accelerations up. Negative scale factors change the sign of the accelerations. Both r1 and r2 default to 1.0.

Tips:

1. If your simulation has many output steps, or you have many requests and mrequests, specifying OFF for print parameter will result in a much smaller Tabular Output File and conserve disk space.