set#

SetUp.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 and to_array on the object returning from mapdl.set("list").

Parameters:
lstepstr

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 and TIME are ignored).

  • LAST - Read the last data set ( Sbstep and TIME are ignored).

  • NEXT - Read the next data set ( Sbstep and TIME 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 and TIME are ignored). If at the first data set, the last data set will be read as the previous.

  • NEAR - Read the data set nearest to TIME ( Sbstep is ignored). If TIME is blank, read the first data set.

  • LIST - Scan the results file and list a summary of each load step. ( KIMG, TIME, ANGLE, and NSET are ignored.)

sbstepstr

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. Specify Sbstep = 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.

factstr

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, if Fact = 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.

kimgstr

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 amplitude

  • 4 or PHAS - Store the phase angle. The angle value, expressed in degrees, will be between -180° and +180°.

timestr

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 to TIME. If both Lstep and Sbstep 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 both Lstep and Sbstep 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.)

anglestr

For harmonic elements ( PLANE25, PLANE75, PLANE78, PLANE83, and SHELL61 ), 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. If ANGLE = NONE, all harmonic factors are set to 1 and postprocessing yields the solution output.

When using ANGLE = NONE with MODE > 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.

nsetstr

Data 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 Set displays,LIST.

orderstr

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.

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 the ANGLE 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 the Jobname.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 when KIMG = 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 to Nrepeat 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.