APPEND, LSTEP, SBSTEP, FACT, KIMG, TIME, ANGLE, NSET
Reads data from the results file and appends it to the
database.
LSTEPLoad step number of the data set to be read. Defaults
to 1. If FIRST, ignore SBSTEP and TIME and read the first data set. If LAST, ignore SBSTEP and TIME and read
the last data set. If NEXT, ignore SBSTEP and TIME and read the next data set.
If already at the last data set, the next set is the first data set.
If NEAR, ignore SBSTEP and read the data
set nearest to TIME. If TIME is blank, read the first data set. If LIST, scan the results file
to produce a summary of each load step (FACT, KIMG, TIME and ANGLE are ignored).
SBSTEPSubstep number (within LSTEP) (defaults to last substep of load step). For the Buckling (ANTYPE,BUCKLE) or Modal (ANTYPE,MODAL)
analysis, the substep corresponds to the mode number (defaults to
first mode). If LSTEP = LIST, SBSTEP = 0 or 1 will list the basic load step information;
SBSTEP = 2 will also list the load step
title, and label the imaginary data sets if they exist.
FACTScale factor applied to data read from the file.
If zero (or blank), a value of 1.0 is used. Harmonic velocities or
accelerations may be calculated from the displacement results from
a modal or harmonic (ANTYPE,HARMIC) analyses.
If FACT = VELO, the harmonic velocities
(v) are calculated from the displacements (d) at a particular frequency
(f) according to the relationship v = 2 πfd. Similarly, if FACT = ACEL, the harmonic accelerations (a) are calculated
as a = (2 πf)2d.
KIMGUsed only with results from complex analyses:
0 | — | Store real part of complex solution. |
1 | — | Store imaginary part. |
TIMETime-point identifying the data set to be read. For
harmonic analyses, time corresponds to the frequency. For the buckling
analysis, time corresponds to the load factor. Used only in the following
cases: If LSTEP is NEAR, read the data
set nearest to TIME. If both LSTEP and SBSTEP are zero
(or blank), read data set at time = TIME. If TIME is between two solution time
points on the results file, a linear interpolation is done between
the two data sets. Solution items not written to the results file
[OUTRES] for either data set will result in a null
item after data set interpolation. If TIME is beyond the last time point on the file, the last time point is
used.
ANGLECircumferential location (0° to 360°). Defines the circumferential location for the harmonic calculations used when reading from the results file. The harmonic factor (based on the circumferential angle) is applied to the harmonic elements (PLANE25, PLANE75, PLANE78, PLANE83, and SHELL61) of the load case. See the Mechanical APDL Theory Reference for details. Note that factored values of applied constraints and loads will overwrite any values existing in the database.
NSETData set number of the data set to be read. If a
positive value for NSET is entered, LSTEP, SBSTEP, KIMG, and TIME are ignored.
Available set numbers can be determined by APPEND,LIST. To determine if data sets are real or imaginary, issue APPEND,LIST,2 which labels imaginary data sets.
Reads a data set from the results file and appends it to the existing data in the database for the selected model only. The existing database is not cleared (or overwritten in total), allowing the requested results data to be merged into the database. Various operations may also be performed during the read operation. The database must have the model geometry available (or used the RESUME command before the APPEND command to restore the geometry from File.DB).