ansys.mapdl.core.Mapdl.set#
- Mapdl.set(lstep='', sbstep='', fact='', kimg='', time='', angle='', nset='', order='', **kwargs)#
Defines the data set to be read from the results file.
Mechanical APDL Command: SET
Note
From version 0.64 you can use the methods
to_list
andto_array
on the object returning frommapdl.set("list")
.- Parameters:
- lstep
str
Load step number of the data set to be read (defaults to 1):
N
- Read load stepN
.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.PREVIOUS
- Read the previous data set (Sbstep
andTIME
are ignored). If at the first data set, the last data set will be read as the previous.NEAR
- Read the data set nearest toTIME
(Sbstep
is ignored). IfTIME
is blank, read the first data set.LIST
- Scan the results file and list a summary of each load step. (KIMG
,TIME
,ANGLE
, andNSET
are ignored.)
- sbstep
str
Substep number (within
Lstep
). Defaults to the last substep of the load step (except in a buckling or modal analysis). For a buckling ( antype,BUCKLE) or modal ( antype ,MODAL) analysis,Sbstep
corresponds to the mode number. SpecifySbstep
= LAST to store the last substep for the specified load step (that is, issue a Set displays,Lstep
,LAST command).If
Lstep
= LIST,Sbstep
= 0 or 1 lists the basic step information.Sbstep
= 2 also lists the basic step information, but includes the load step title, and labels imaginary data sets if they exist.- fact
str
Scale factor applied to data read from the file. If zero (or blank), a value of 1.0 is used. A nonzero factor excludes non-summable items.
Harmonic velocities or accelerations can be calculated from the displacement results from a modal ( antype,MODAL) or harmonic ( antype,HARMIC) analysis. 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) 2 d.If
Lstep
= LIST in an analysis using rezoning,Fact
across all rezoning data sets is listed.- kimg
str
Used only with complex results (harmonic and complex modal analyses).
0 or REAL
- Store the real part of complex solution (default).1, 2 or IMAG
- Store the imaginary part of a complex solution.3 or AMPL
- Store the amplitude4 or PHAS
- Store the phase angle. The angle value, expressed in degrees, will be between -180° and +180°.
- time
str
Time-point identifying the data set to be read. For a harmonic analyses, time corresponds to the frequency.
For a buckling analysis, time corresponds to the load factor.
Used only in the following cases: If
Lstep
= NEAR, read the data set nearest toTIME
. If bothLstep
andSbstep
are zero (or blank), read data set at time =TIME
.Do not use
TIME
to identify the data set to be read if you used the arc-length method ( arclen ) in your solution.If
TIME
is between two solution time points in the results file, a linear interpolation occurs between the two data sets (except in cases where rezoning or selected results output ( osresult ) is used).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 will be used.If
TIME
is between two solution time points and bothLstep
andSbstep
are zero (or blank), no interpolation is performed for the prcint / plcint commands. (That is, for results generated by the cint command, only the data set associated with the lower of the solution time points is used.)- angle
str
For harmonic elements (
PLANE25
,PLANE75
,PLANE78
,PLANE83
, andSHELL61
),ANGLE
specifies the circumferential location (0.0 to 360°) used when reading from the results file. The harmonic factor (based on the circumferential angle) is applied to the displacements and element results, and to the applied constraints and loads which overwrites any values existing in the database. IfANGLE
= NONE, all harmonic factors are set to 1 and postprocessing yields the solution output.When using
ANGLE
= NONE withMODE
> 0, the combined stresses and strains are not valid.The default value of
ANGLE
is 0.0; however if the Set displays command is not used, the effective default is NONE.For full harmonic analyses with the amplitude option (
KIMG
= 3 or AMPL),ANGLE
is the prescribed phase angle at which the amplitude is computed.- nset
str
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 displays,LIST.- order
str
Key to sort the harmonic index results. This option applies to cyclic symmetry buckling and modal analyses only, and is valid only when
Lstep
= FIRST, LAST, NEXT, PREVIOUS, NEAR or LIST.ORDER
- Sort the harmonic index results in ascending order of eigenfrequencies or buckling load multipliers.(blank)
- No sorting takes place.
- lstep
Notes
Defines the data set to be read from the results file into the database. Various operations may also be performed during the read operation. The database must have the model geometry available (or use the resume command before the Set displays command to restore the geometry from
Jobname.DB
). Values for applied constraints ( d ) and loads ( f ) in the database will be replaced by their corresponding values on the results file, if available. (See the description of the outres command.) In a single load step analysis, these values are usually the same, except for results from harmonic elements. (See the description of theANGLE
value above.)In an interactive run, the sorted list (
ORDER
option) is also available for results-set reading via a GUI pick option.You can postprocess results without issuing a Set displays command if the solution results were saved to the database file (
Jobname.db
). A distributed-memory parallel simulation, however, can only postprocess using the results file (for example,Jobname.rst
) and cannot use theJobname.db
file since no solution results are written to the database. Therefore, you must issue a Set displays command or a rescombine command before postprocessing in a distributed- memory parallel run.When postprocessing amplitudes or phases (
KIMG
= AMPL or PHAS):The only appropriate coordinate system is the solution coordinate system ( rsys,SOLU). For layered elements, a layer ( layer ) must also be specified. When displaying the displacement amplitudes, use a contour display ( plnsol command). Because a deformed shape display ( pldisp command) could lead to a non-physical shape, the displacement scaling is off by default ( slashdscale,,OFF).
The conversion is not valid for averaged results, derived results (such as principal stress/strain, equivalent stress/strain, and USUM), or summed results obtained using fsum, nforce, prnld, and prrfor.
Cyclic symmetry and multistage cyclic symmetry analysis results are not supported.
Coupled-field analysis results are supported when
KIMG
= AMPL, but they are not supported whenKIMG
= PHAS.
Issuing expand in a Cyclic Symmetry Modal Analysis#
After issuing expand,
Nrepeat
in a cyclic symmetry modal analysis, subsequent Set displays commands read data from the results file and expand them toNrepeat
sectors.Issuing msopt,EXPAND in a Multistage Cyclic Symmetry Analysis#
When issuing msopt,EXPAND in a multistage cyclic symmetry analysis, subsequent Set displays commands read the data set from the specified results file and expand the nodes and elements to the stages and sectors specified via msopt,EXPAND.