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:
nframstr

Number of frame captures per cycle. Defaults to 12.

delaystr

Time delay (seconds) during animation. Defaults to 0.1 seconds.

ncyclstr

Number of animation cycles. Defaults to 5. Not available in the GUI.

nperiodstr

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_antypestr

Analysis type performed in the CMS use pass. No default.

  • MODAL - Modal analysis

  • HARMIC - Harmonic analysis

cms_modoptstr

Mode extraction method selected in the CMS use pass. No default.

  • UNSYM - Unsymmetric matrix

  • DAMP - Damped system

  • QRDAMP - Damped system using QR algorithm

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 by NPERIOD.

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 the CMS_MODOPT field to indicate the mode extraction method that was used (UNSYM, DAMP, or QRDAMP). If CMS_MODOPT = QRDAMP, it is assumed that CPXMOD 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 the CMS_ANTYPE or CMS_MODOPT arguments.

For more information about complex results postprocessing, see POST1 and POST26 - Complex Results Postprocessing