subset#
- Mapdl.subset(lstep='', sbstep='', fact='', kimg='', time='', angle='', nset='', **kwargs)#
Reads results for the selected portions of the model.
APDL Command: SUBSET
- Parameters:
- lstep
Load step number of the data set to be read (defaults to 1):
- N
Read load step N.
- FIRST
Read the first data set (
SBSTEP
andTIME
are ignored).- LAST
Read the last data set (
SBSTEP
andTIME
are ignored).- NEXT
Read the next data set (
SBSTEP
andTIME
are ignored). If at the last data set, the first data set will be read as the next.- NEAR
Read the data set nearest to
TIME
(SBSTEP
is ignored). IfTIME
is blank, read the first data set.- LIST
Scan the results file and list a summary of each load step. (
FACT
,KIMG
,TIME
andANGLE
are ignored.)
- sbstep
Substep number (within Lstep). For the buckling (
ANTYPE,BUCKLE
) analysis or the modal (ANTYPE,MODAL
) analysis, the substep corresponds to the mode number. Defaults to last substep of load step (except forANTYPE,BUCKLE or MODAL
). IfLstep = LIST, SBSTEP = 0 or 1
lists the basic step information, whereasSBSTEP = 2
also lists the load step title, and labels 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 (
ANTYPE,MODAL
) or harmonic (ANTYPE,HARMIC
) analyses. IfFACT = 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 both Lstep 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, use the last time point.- angle
Circumferential location (0.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
, andSHELL61
) 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*SET,LIST
.
Notes
Reads a data set from the results file into the database for the selected portions of the model only. Data that has not been specified for retrieval from the results file by the
INRES
command will be listed as having a zero value. Each time that theSUBSET
command is issued, the data currently in the database will be overwritten with a new set of data. Various operations may also be performed during the read operation. The database must have the model geometry available (or used the RESUME command before theSUBSET
command to restore the geometry fromFile.DB
).