ansys.mapdl.core.Mapdl.anharm#
- Mapdl.anharm(nfram='', delay='', ncycl='', nperiod='', cms_antype='', cms_modopt='', **kwargs)#
Produces an animated sequence of time-harmonic results or complex mode shapes.
Mechanical APDL Command: ANHARM
- Parameters:
- nfram
str
Number of frame captures per cycle. Defaults to 12.
- delay
str
Time delay (seconds) during animation. Defaults to 0.1 seconds.
- ncycl
str
Number of animation cycles. Defaults to 5. Not available in the GUI.
- nperiod
str
Period number for the second set of frames showing the decay or growth of a mode shape. Only applies to complex mode shape animation. Defaults to 1, animating the decay or growth on the first period. Issue -1 to animate without decay or growth.
- cms_antype
str
Analysis type performed in the CMS use pass. No default.
MODAL
- Modal analysisHARMIC
- Harmonic analysis
- cms_modopt
str
Mode extraction method selected in the CMS use pass. No default.
UNSYM
- Unsymmetric matrixDAMP
- Damped systemQRDAMP
- Damped system using QR algorithm
- nfram
Notes
anharm invokes a Mechanical APDL macro which produces an animated sequence of:
Time-harmonic results in the case of a harmonic analysis ( antype,HARMIC)
Complex mode shapes in the case of a modal analysis ( antype,MODAL).
In both cases, the results are those of the last plot action (for example, plnsol,B,SUM).
The animation converts the complex solution variables (real and imaginary sets) into time varying results over one period. For example, if
NFRAM
= 12, then the frame captures are in increments of 30 degree phase angles.A second set of
NFRAM
frames will be generated for damped eigenmodes from complex eigensolvers to visualize any exponential decay or growth of the oscillations. The second set generated will display frames from the period number specified byNPERIOD
.In a CMS analysis, the anharm command can be used after the CMS expansion pass or the use pass. To use anharm after the expansion pass, you must indicate whether a modal analysis or a harmonic analysis was performed in the CMS use pass by setting
CMS_ANTYPE
to either MODAL or HARMIC. If the use pass was a modal analysis, you must also set theCMS_MODOPT
field to indicate the mode extraction method that was used (UNSYM, DAMP, or QRDAMP). IfCMS_MODOPT
= QRDAMP, it is assumed thatCPXMOD
was set to ON in the modopt command to request complex eigenmodes. If the anharm command is used after the use pass, it is not necessary to set theCMS_ANTYPE
orCMS_MODOPT
arguments.For more information about complex results postprocessing, see POST1 and POST26 - Complex Results Postprocessing