APPEND
APPEND, LSTEP
, SBSTEP
, FACT
, KIMG
, TIME
, ANGLE
, NSET
Reads data from the results file and appends it to the
database.
LSTEP
Load step number of the data set to be read. Defaults to 1. If FIRST, ignore
SBSTEP
andTIME
and read the first data set. If LAST, ignoreSBSTEP
andTIME
and read the last data set. If NEXT, ignoreSBSTEP
andTIME
and read the next data set. If already at the last data set, the next set is the first data set. If NEAR, ignoreSBSTEP
and read the data set nearest toTIME
. IfTIME
is blank, read the first data set. If LIST, scan the results file to produce a summary of each load step (FACT
,KIMG
,TIME
andANGLE
are ignored).SBSTEP
Substep 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). IfLSTEP
= 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.FACT
Scale 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, ifFACT
= ACEL, the harmonic accelerations (a) are calculated as a = (2 πf)2d.KIMG
Used only with results from complex analyses:
0
—
Store real part of complex solution.
1
—
Store imaginary part.
TIME
Time-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 toTIME
. If bothLSTEP
andSBSTEP
are zero (or blank), read data set at time =TIME
. IfTIME
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. IfTIME
is beyond the last time point on the file, the last time point is used.ANGLE
Circumferential 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.
NSET
Data set number of the data set to be read. If a positive value for
NSET
is entered,LSTEP
,SBSTEP
,KIMG
, andTIME
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.
Notes
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).