Appendix A. HBM Macros

All macros are found in the installation folder: Program Files\ANSYS Inc\v242\ansys\apdl.

Macro to Expand an HBM Solution by Combining Harmonics

You can expand the solution from an analysis solved with the harmonic balance method by combining harmonics using the the HBM_EXPA.mac macro.

The macro combines the results of each harmonic result file. The time signal is calculated by summing the computed harmonics at each frequency point using the following equation,

(1)

where

is displacement.
is 0th harmonic solution.
is the time-domain harmonic index.
is the number of harmonics (specified as NH on HROPT,HBM,NH).
The subscripts and denote real and complex values.
is the frequency.
is time.

The amplitude of the time signal is determined to plot the combined frequency-response curve (for example, see Figure 8.2: Frequency-Response Curve from Combined Harmonic Results.

Macros Used for HBM Cyclic Analysis

The following macros are used in an HBM cyclic analysis:

  • HBMCYCHIGET – computes all necessary spatial/time harmonic superelements

  • HBMCYCSEGEN – used with HBMCYCHIGET to generate a single stage cyclic superelement for each unique spatial harmonic index and the primary stage

  • HBMCYCSEIMPORT – used with HBMCYCHIGET to import all necessary time harmonic superelements in the use pass

  • HBMCYCMAPGET – used with HBMCYCHIGET to provide the mapping between any node from the primary stage and the corresponding nodes from higher harmonic stages.

  • HBMCYCEXPAND – used with HBMCYCMAPGET postprocess the sum of the harmonics to get the time response at a given frequency or the total amplitude or phase as a function of the frequency.