www.kxcad.net Home > CAE Index > ANSYS Index > Release 11.0 Documentation for ANSYS
The ANSYS program writes results from a harmonic high-frequency electromagnetic analysis to the magnetics results file, Jobname.RMG. Results include the data listed below, many of which vary harmonically at the operating frequency (or frequencies) for which the measurable quantities can be computed as the real solution times cosine (ωt) minus the imaginary solution times sine (ωt). ω is the angular frequency. For more details, see the Theory Reference for ANSYS and ANSYS Workbench.
Primary data: Nodal DOFs (AX)
Derived data:
Nodal electric field (EX, EY, EZ, ESUM)
Nodal magnetic field intensity (HX, HY, HZ, HSUM)
Nodal conducting current density (JCX, JCY, JCZ, JSUM)
Joule heat rate per unit volume (JHEAT)
Element Poynting vector (PX, PY, PZ)
Element dissipated power Pd (if it exists)
Element stored time-average energy
Element specific absorption rate (SAR) (if it exists)
and so on
Additional data are available. See the Elements Reference for details.
You can review analysis results in POST1, the general postprocessor. In general, the results are out-of-phase with the input loads. The solution is calculated and stored in terms of real and imaginary components as detailed above.
Use POST1 to review results over the entire model at specific frequencies. For viewing results over a range of frequencies, use the time-history postprocessor, POST26.
To choose a postprocessor, use one of the following:
| Command(s): | /POST1 or /POST26 |
| GUI: | Main Menu> General Postproc Main Menu> TimeHist Postpro |
You will find the following commands (listed below) helpful in postprocessing analysis results:
Table 4.8 Postprocessing Commands
| Task | Command(s) |
|---|---|
| Select the real solution | SET,1,1,,0 |
| Select the imaginary solution | SET,1,1,,1 |
| Print electric or magnetic field at corner nodes [1,3] | PRNSOL,EF (or H or JC) |
| Print electric field at corner nodes[1,3] | PRVECT,EF |
| Print Poynting vector at element centroid[1,3] | PRVECT,P |
| Print magnetic field at corner nodes[1,3] | PRVECT,H |
| Print conducting current at corner nodes[1,3] | PRVECT,JC |
| Print electric or magnetic field at element nodes[3] | PRESOL,EF (or H or JC) |
| Print Joule heat density[2,4] | PRESOL,JHEAT |
| Create element table item for centroid electric field[3], X component. (Issue similar commands for Y, Z, and SUM components.) | ETABLE,Lab,EF,X |
| Create element table item for centroid magnetic field[3], X component. (Issue similar commands for Y, Z, and SUM components.) | ETABLE,Lab,H,X |
| Create element table item for centroid conducting current[3], X component. (Issue similar commands for Y, Z, and SUM components.) | ETABLE,Lab,JC,X |
| Create element table item for Joule heat density[2,4] | ETABLE,Lab,JHEAT |
| Print the indicated element table item(s) | PRETAB,Lab,... |
See the Theory Reference for ANSYS and ANSYS Workbench for more information on the notation. The ETABLE command lets you view less frequently-used items. The HF119 and HF120 descriptions in the Elements Reference discuss these items.
You can view most of these items graphically. To do so, substitute plotting commands or GUI paths (see the individual commands for the appropriate GUI paths) for the commands whose names begin with "PL" (for example, use PLNSOL instead of PRNSOL, as illustrated below):
Table 4.9 Plotting Commands
| For this command... | Substitute this command... |
| PRNSOL | PLNSOL |
| PRVECT | PLVECT |
| PRESOL | PLESOL |
| PRETAB | PLETAB |
You also can plot element table items. See the Basic Analysis Guide for more information.
The ANSYS Parametric Design Language (APDL) also contains commands that may be useful in postprocessing, and results processing purposes. For more information about the APDL, see the Guide to ANSYS User Programmable Features.
The following two sections discuss some typical POST1 operations for calculating the near and far-fields and parameters for high-frequency devices. For a complete description of all postprocessing functions, see the Basic Analysis Guide.
Postprocessing commands are available for calculating the near or far electromagnetic fields beyond the FEA computational domain. The commands HFNEAR, PRHFFAR, and PLHFFAR use the surface equivalence principle to determine the fields. The surface equivalence principle states that equivalent currents can exactly represent the electromagnetic fields exterior to the surface. Refer to Surface Equivalence Principle in the Theory Reference for ANSYS and ANSYS Workbench for more information.
Use of near and far-field commands requires that an equivalent source surface be defined in the preprocessor. See Equivalent Source Surface for details.
You can calculate either the near electric field (Lab = EF, default) or the near magnetic field (Lab = H) beyond the FEA computational domain using one of the following:
| Command(s): | HFNEAR |
| GUI: | Main Menu> General Postproc> List Results> Field Extension>
Near Field Main Menu> General Postproc> Path Operations> Map onto Path> HF Near Field |
You can obtain the near electric field or near magnetic field at a point (X, Y, Z) in a coordinate system or along a path. When determining the field at a point, you specify a coordinate value in the global or a local coordinate system. You also specify a global coordinate system for the output vector. When determining the field along a path, you define a path using the PATH command and you set VAL to PATH. All previous path items are cleared before HFNEAR executes.
To use HFNEAR, you must first define an equivalent current source surface in the preprocessor. You must issue the HFSYM command to account for symmetry planes in the modeled region.
Far fields and far field parameters are essential for scattering analysis and antenna design. This section describes some useful POST1 operations for these analyses.
Far Electromagnetic Field
To plot far fields, use one of the following:
| Command(s): | PLHFFAR |
| GUI: | Main Menu> General Postproc> List Results> Field Extension> Far Field |
To print far fields, use one of the following:
| Command(s): | PRHFFAR |
| GUI: | Main Menu> General Postproc> List Results> Field Extension> Far Field |
You can display the magnitude or the Cartesian or spherical components of the far electromagnetic field.
Radar Cross Section (RCS) and Normalized Radar Cross Section (RCSN)
The bistatic scattering cross section (radar cross section), measures the scattering characteristics of a target for an incident plane wave. The radar cross section (RCS) depends on the dimensions and material properties of the object and the wavelength and incident angle of the plane wave. It is also a function of the polarization of the incident wave. You can calculate the RCS for the pth component of the scattered field for a q-polarized incident plane wave where p and q represent the φ and θ spherical components, respectively.
The RCS can be normalized by the wavelength in a 2-D analysis and the wavelength squared in a 3-D analysis.
To plot RCS or RCSN, use one of the following:
| Command(s): | PLHFFAR |
| GUI: | Main Menu> General Postproc> List Results> Field Extension> RCS (or RCS Normalized) |
To print RCS or RCSN, use one of the following:
| Command(s): | PRHFFAR |
| GUI: | Main Menu> General Postproc> List Results> Field Extension> RCS (or RCS Normalized) |
To plot RCS or RCSN, use one of the following:
| Command(s): | PLHFFAR |
| GUI: | Main Menu> General Postproc> List Results> Field Extension> RCS (or RCS Normalized) |
Using PLHFFAR or PRHFFAR, you can calculate a 3-D RCS for radar echo area, φ-φ polarization, φ-θ polarization, θ-φ polarization, or θ-θ polarization. You can calculate a 2-D RCS using a 3-D computational model. You extrude a 2-D model a distance Δz in the z direction to generate a 3-D numerical model. You can use PLHFFAR or PRHFFAR to calculate a 2-D RCS for a TE or TM incident plane wave.
Refer to High-Frequency Electromagnetic Field Simulation in the Theory Reference for ANSYS and ANSYS Workbench for more information on RCS.
Antenna Parameters
You can obtain various antenna design parameters (for example, radiation pattern, radiation power, directive gain, directivity, power gain and radiation efficiency) based on the far field results. Refer to High-Frequency Electromagnetic Field Simulation in the Theory Reference for ANSYS and ANSYS Workbench for definitions of these parameters.
To print antenna parameters, use one of the following:
| Command(s): | PRHFFAR |
| GUI: | Main Menu> General Postproc> List Results> Field Extension> Antenna> Pattern (or Direct Gain, Rad Power, Power Gain, Efficiency) |
To plot antenna parameters, use one of the following:
| Command(s): | PLHFFAR |
| GUI: | Main Menu> General Postproc> List Results> Field Extension> Antenna> Pattern (or Direct Gain) |
You can display Cartesian or polar components of the antenna radiation pattern and direct gain.
Before issuing PLHFFAR or PRHFFAR, you need to flag a virtual equivalent current source surface using Lab = MXWF on the SF command in the preprocessor before solution. See Equivalent Source Surface for details. You must issue the HFSYM command if there is a symmetry plane in the modeled region. When calculating antenna parameters, use the HFANG command to define the spatial angles if the radiation space is not the entire spherical domain.
Phased Array Antenna
Before calculating far field or antenna parameters, you need to define the characteristics of a phased array antenna using one of the following:
| Command(s): | HFARRAY |
| GUI: | Main Menu> General Postproc> List Results> Field Extension>
Far Field Main Menu> General Postproc> List Results> Field Extension> Antenna> Pattern (or Direct Gain) Main Menu> General Postproc> Plot Results> Field Extension> Far Field Main Menu> General Postproc> Plot Results> Field Extension> Antenna> Pattern (or Direct Gain) |
The total field of a phased array antenna is equal to the product of an array factor and the unit cell field.
Etotal = AF (Eunit cell)
Refer to High-Frequency Electromagnetic Field Simulation in the Theory Reference for ANSYS and ANSYS Workbench for the definition of Array Factor.
You must account for symmetry planes in the modeled domain for postprocessing near or far electromagnetic fields beyond the computational domain. To do so, use one of the following:
| Command(s): | HFSYM |
| GUI: | Main Menu> General Postproc> List Results> Field Extension>
Near Field Main Menu> General Postproc> Path Operations> Map onto Path> HF Near Field Main Menu> General Postproc> Plot Results> Field Extension> Far Field (or RCS, RCS Normalized) Main Menu> General Postproc> Plot Results> Field Extension> Antenna> Pattern (or Direct Gain) Main Menu> General Postproc> List Results> Field Extension> Far Field (or RCS, RCS Normalized) Main Menu> General Postproc> List Results> Field Extension> Antenna> Pattern (or Direct Gain, Rad Power, Power Gain, Efficiency) |
The HFSYM command accounts for PEC or PMC symmetry planes that coincide with the X-Y, Y-Z or Z-X planes of the global or a local Cartesian coordinate system. It applies the image principle on the symmetric part of the computational domain to represent the radiation effect of the partial equivalent current source beyond the modeled domain. HFSYM accounts for the radiation that would be present if the entire structure was modeled. If there is a PEC or PMC symmetry plane, you must issue the HFSYM command before issuing HFNEAR, PLHFFAR or PRHFFAR. Although a PMC symmetry plane is a natural boundary condition in a finite element analysis, it must be defined by the HFSYM command.
You can specify the radiation space when calculating antenna parameters. To do so, use one of the following:
| Command(s): | HFANG |
| GUI: | Main Menu> General Postproc> Plot Results> Field Extension>
Antenna> Direct Gain Main Menu> General Postproc> List Results> Field Extension> Antenna> Direct Gain (or Rad Power, Power Gain, Efficiency) |
The HFANG command defines the radiation space of an antenna in terms of the type of antenna. For example, the solid angle of a dipole antenna is determined by φε[ 0,360°] and θε[ 0,180°] and (Figure 4.25: "Solid Angle - Dipole Antenna"), while the solid angle of a monopole antenna above ground plane is associated with φε[ 0,360°] and θε[ 0,90°] (Figure 4.26: "Solid Angle - Monopole Antenna above Ground Plane"). If the electromagnetic wave is not radiated into the entire space, you must issue the HFANG command before issuing the PLHFFAR or PRHFFAR command.
A phased array antenna is approximated by an infinite array of unit cells with periodic boundary conditions. When you calculate the antenna parameters of the entire array based on the solution of the unit cell , only half a radiation space should be defined (that is, φε[ 0,360°] and θε[ 0,90°]).
After you have solved a high-frequency problem, you often need to calculate some circuit parameters for the underlying device. You can calculate the following parameters:
Scattering matrix parameters (S-parameters) of the equivalent network
Input power, reflected power, dissipated power, and transmitted power
Voltage, current and characteristic impedance of the equivalent network
This section illustrates the basic steps you need to do to calculate parameters for high-frequency devices.
You can calculate scattering parameters between a driven port (Port i) and a matched port (Port j) using one of the following:
| Command(s): | SPARM |
| GUI: | Main Menu> General Postproc> Elec&Mag Calc> S-Parameters |
SPARM returns two S-parameters: Sii and Sji, where i represents the driven port and j is the matched port. For a multi-port network, the S-parameters are defined as follows where a and b are the normalized incoming voltage wave and the normalized outgoing voltage wave, respectively.
Figure 4.27 Multi-port Network
The condition aj = 0 indicates a matched port. In your model, you should use an absorbing boundary condition, such as PML or a port with the IMPD option, to truncate the computational domain. It represents the matched ports of the equivalent network.
When the distance from the extraction plane to the reference plane is defined by the HFPORT command, the S-parameter phase shift is calibrated automatically. To de-embed the existing S-parameter data with Touchstone format, use the HFDEEM command.
For a multi-port device, you issue multiple commands to retrieve the required S-parameter matrix terms. The SPARM macro will output the magnitude and phase angle of the S-parameters.
To calculate the voltage reflection coefficient (REFLC), standing wave ratio (VSWR), and return loss (RL) in a COAX fed device, use one of the following:
| Command(s): | REFLCOEF |
| GUI: | Main Menu> General Postproc> Elec&Mag Calc> Port> Refl Coeff |
To calculate the input power, reflected power, return loss, and power reflection coefficient for a driven port, use one of the following:
| Command(s): | HFPOWER |
| GUI: | Main Menu> General Postproc> Elec & Mag Calc> Element Based> Power |
If you define a matching output port, the HFPOWER macro can also calculate the transmitted power, insertion loss, and power transmission coefficient. For lossy materials and conducting surfaces, you can also use it to calculate the time-averaged dissipated power (from surface impedance or shielding boundary conditions). To calculate dissipated power in a region, you must select the elements that are associated with the lossy material or the conducting surfaces.
For a periodic structure that is used as a frequency selective surface, you need to specify input and output ports. You can then calculate the reflection and transmission coefficients, power reflection and transmission coefficients, and return and insertion loss using one of the following:
| Command(s): | FSSPARM |
| GUI: | Main Menu> General Postproc> Elec & Mag Calc> Port> FSS Parameters |
Voltage is defined as the line integral of the projection of electric field along the path.

To calculate it you need to define a path from the central conductor to the ground as shown in the following figure for a coaxial waveguide (a), a microstrip line (b), and a coplanar waveguide (c).
Figure 4.28 Voltage Paths for Transmission Lines

You first define the path using the following commands or GUI paths:
| Command(s): | PATH, PPATH |
| GUI: | Main Menu> General Postproc> Path Operations> Define Path>
Path Status> Defined Paths Main Menu> General Postproc> Path Operations> Define Path> By Nodes (or By Location) |
You then calculate the voltage using one of the following:
| Command(s): | EMF |
| GUI: | Main Menu> General Postproc> Elec & Mag Calc> Path Based> EMF |
The EMF command macro stores the results as the EMF parameter. All path items clear after EMF executes.
Current is defined as the line integral of the magnetic field H along a closed path containing the inner conductor:

To calculate it you need to define a closed current path contain the central conductor as shown in the following figure for a coaxial waveguide (a), a microstrip line (b), and a coplanar waveguide (c).
Figure 4.29 Current Paths for Transmission Lines

After defining the current path using PATH or PPATH, you calculate the current using one of the following:
| Command(s): | MMF |
| GUI: | Main Menu> General Postproc> Elec & Mag Calc> Path Based> MMF |
A counter clockwise ordering of points on the PPATH command will yield the correct sign for MMF. The MMF command macro stores the results as the MMF parameter. All path items clear after MMF executes.
Characteristic impedance is defined as:

To calculate the impedance, you calculate both the EMF (voltage drop) and the MMF (current). The IMPD macro calculates the complex impedance at the specified location. You must define the voltage and current paths before issuing IMPD. The impedance calculation can work with a symmetry sector of a model. For example, if you model only 10 degrees of a coax cable, you can supply a multiplier term on the MMF (current) calculation to account for a full model.
To invoke the IMPD macro, use one of the following:
| Command(s): | IMPD |
| GUI: | Main Menu> General Postproc> Elec & Mag Calc> Path Based> Impedance |
You can plot scattering, admittance, or impedance parameters on a Smith chart. A Touchstone file provides the input parameters and their type.
To convert and plot any input parameter type to a specified output parameter type, use one of the following:
| Command(s): | PLSCH |
| GUI: | Main Menu> General Postproc> Plot Results> Smith Chart |
You can use one of the following to convert and list scattering, admittance, or impedance parameters input by a Touchstone file:
| Command(s): | PRSYZ |
| GUI: | Main Menu> General Postproc> Plot Results> SYZ conversion |
You can also use the PRSYZ command to renormalize S-parameters based on a new port characteristic impedance. The renormalized S-parameters are output to a new Touchstone file jobname_Sparm.snp.
You can use of the following to convert and plot scattering, admittance, or impedance parameters as a function of frequency.
| Command(s): | PLSYZ |
| GUI: | Main Menu> General Postproc> Plot Results> SYZ parameters |
You can also use the PLSYZ command to plot reflection loss, insertion loss, isolation loss, and voltage standing wave ratio.
For more information on Touchstone files, see Starting the Solution. For an example problem, see Postprocessing Scattering, Admittance, and Impedance Parameters.
Macromodels are essential for efficient subsystem and system level simulation and the prediction of complex system performance. They can be generated in terms of equivalent circuits that are compatible with system level simulators such as SPICE. The electromagnetic behavior of a multiport component can be approximated by terms of rational functions and the equivalent circuits can be subsequently synthesized. A system level simulation can then be performed by inserting the macromodel into the system level simulator as illustrated in the following flowchart.
Figure 4.31 Signal Integrity Design Flow

To create a SPICE macromodel, you first generate a Touchstone file from either a high-frequency full-wave electromagnetic solution or the measurement of a high-frequency structure. You can use the SPSWP command to generate the Touchstone file. You then generate the macromodel using the SPICE command.
The following are important points to remember when you are creating a SPICE macromodel.
Selecting Bandwidth of Validity
If all components in the system are linear and the objective is to perform a frequency-domain sweep for the overall system over a specified bandwidth, then the bandwidth of validity should be greater than the specified bandwidth of interest. However, if a transient simulation is of interest (either linear or nonlinear), the effective frequency bandwidth is controlled by both the bandwidth of the excitation waveform and the time step used for the numerical integration in SPICE. You should then use the attributes of the excitation waveform to define the bandwidth of validity for the synthesized equivalent circuit. For example, assume a trapezoidal pulse waveform and let Tmin denote the shortest time feature in the waveform. The shorter of the rise and fall times of the pulse would then correspond to Tmin. Anticipating that the transient simulator will attempt to sample accurately Tmin, the recommended bandwidth of validity would be fBWV = 5/Tmin.
Selecting Number of Frequencies for the Electromagnetic Response Calculation
Simulation cost is increased by the spatial over sampling necessary to ensure model fidelity and accurate resolution of the spatial distribution of the field. This is especially true when the structure exhibits strong resonance behavior. Thus, it is highly desirable to keep the number of sampling frequency points reasonably small. The rational interpolation algorithm for subsequent enhancement of the data set makes a coarse frequency sampling possible in the full-wave simulation of a component. A maximum of 501 frequency points can be generated by the rational interpolation algorithm using sampling frequency points obtained from the full-wave solver. Instead of the rational interpolation algorithm, you may use Variational Technology to perform a frequency sweep with the required sampling frequency points.
Selecting Convergence Criteria of the Synthesized Equivalent Circuit
Starting with order 2, the number of poles is increased adaptively by 10 until the convergence criteria are reached or the convergence procedure becomes ripple. Because of the coupling between ports, the synthesis procedure may not always converge to the desired criteria by increasing the number of poles. Futhermore, the admittance response generated by the synthesized passive equivalent circuit may not be accurate if the variations in magnitude are small over the frequency range. If the convergence criteria are not reached, it is strongly recommended that you check the admittance response of the synthesized passive equivalent circuit before performing a transient analysis. You should run SPICE over the frequency range and compare your results with those in the file filename_pade_Y.snp. The touchstone file filename_pade_Y.snp contains admittance parameters generated by rational interpolation over the frequency range, based on sampling data.
The generated equivalent circuit is a subcircuit (SUBCKT in SPICE nomenclature) consisting of a set of nested SUBCKTs. The main SUBCKT, and the only one called, is named NPORT 1 2 3 4 … Nodes 1 and 2 define port 1, nodes 3 and 4 define port 2, etc. Hence, there are 2M nodes for an M-port component. All elements in a synthesized subcircuit are standard elements in SPICE. Therefore, total compatibility is expected with most SPICE based circuit simulators.
For more information, refer to RLCG Synthesized Equivalent Circuit of an M-port Full Wave Electromagnetic Structure in the Theory Reference for ANSYS and ANSYS Workbench. For example problems, see SPICE Synthesized Equivalent Circuit for a Line-fed Microstrip Patch Antenna and SPICE Synthesized Equivalent Circuit for a T-type Transmission Line Network
You can apply the Inverse Fast Fourier Transform (IFFT) to frequency domain S-parameters to obtain time domain reflection (TDR) and time domain transmission (TDT) waveforms and an impedance profile. The PLTD command performs these transformations and displays the time domain results. You can also use the PLTD command to display the total waveform. The total waveform at an input port is equal to the sum of the incident wave and reflected waves.
Step and impulse input signal options are available (PLTD command, Lab = STEP or IMPU). The signal propagates through a transmission line at a velocity vp and arrives at the far end at a time TD = d/vp, where d is the transmission line length. A reflected signal arrives at the TDR output port at t = 2TD. The maximum frequency of the frequency domain S-parameter data determines the time step of the Fast Fourier Transform (FFT). To capture the transient signal variations, at least 5 time steps are required for the signal rise time. It should be noted that the impulse signal behaves as a periodic signal after using the FFT.
See TDR Display of Shorted Single-Ended Uniform Transmission Line for an example problem.