ansys.mapdl.core.Mapdl.plnear#

Mapdl.plnear(lab='', opt='', kcn='', val1='', val2='', val3='', val4='', val5='', val6='', val7='', val8='', val9='', **kwargs)#

Plots the pressure in the near zone exterior to the equivalent source surface.

Mechanical APDL Command: PLNEAR

Parameters:
labstr

Plot the maximum pressure or sound pressure level:

  • SPHERE - on the spherical structure

  • PATH - along the path

optstr
  • PSUM - Maximum complex pressure for acoustics.

  • PHAS - Phase angle of complex pressure for acoustics.

  • SPL - Sound pressure level for acoustics.

  • SPLA - A-weighted sound pressure level for acoustics (dBA).

kcnstr

KCN is the coordinate system reference number. It may be 0 (Cartesian) or any previously defined local coordinate system number (>10). Defaults to 0.

val1str

For LAB = SPHERE:

  • VAL1 - Radius of spherical surface in spherical coordinate system.

  • VAL2 - Starting φ angle (degree) in the spherical coordinate system. Defaults to 0.

  • VAL3 - Ending φ angle (degree) in the spherical coordinate system. Defaults to 0.

  • VAL4 - Number of divisions between the starting and ending φ angles for data computations. Defaults to 0.

  • VAL5 - Starting θ angle (degrees) in the spherical coordinate system. Defaults to 0 in 3D and 90 in 2D extension.

  • VAL6 - Ending θ angle (degrees) in the spherical coordinate system. Defaults to 0 in 3D and 90 in 2D extension.

  • VAL7 - Number of divisions between the starting and ending θ angles for data computations. Defaults to 0.

  • VAL8 - Reference rms sound pressure. Defaults to 2x10 -5 Pa.

  • VAL9 - Thickness of 2D model extension in z direction (defaults to 0).

For Lab = path, plnear computes the electric field or pressure for the path data points for the path currently defined by the path and ppath commands.

val2str

For LAB = SPHERE:

  • VAL1 - Radius of spherical surface in spherical coordinate system.

  • VAL2 - Starting φ angle (degree) in the spherical coordinate system. Defaults to 0.

  • VAL3 - Ending φ angle (degree) in the spherical coordinate system. Defaults to 0.

  • VAL4 - Number of divisions between the starting and ending φ angles for data computations. Defaults to 0.

  • VAL5 - Starting θ angle (degrees) in the spherical coordinate system. Defaults to 0 in 3D and 90 in 2D extension.

  • VAL6 - Ending θ angle (degrees) in the spherical coordinate system. Defaults to 0 in 3D and 90 in 2D extension.

  • VAL7 - Number of divisions between the starting and ending θ angles for data computations. Defaults to 0.

  • VAL8 - Reference rms sound pressure. Defaults to 2x10 -5 Pa.

  • VAL9 - Thickness of 2D model extension in z direction (defaults to 0).

For Lab = path, plnear computes the electric field or pressure for the path data points for the path currently defined by the path and ppath commands.

val3str

For LAB = SPHERE:

  • VAL1 - Radius of spherical surface in spherical coordinate system.

  • VAL2 - Starting φ angle (degree) in the spherical coordinate system. Defaults to 0.

  • VAL3 - Ending φ angle (degree) in the spherical coordinate system. Defaults to 0.

  • VAL4 - Number of divisions between the starting and ending φ angles for data computations. Defaults to 0.

  • VAL5 - Starting θ angle (degrees) in the spherical coordinate system. Defaults to 0 in 3D and 90 in 2D extension.

  • VAL6 - Ending θ angle (degrees) in the spherical coordinate system. Defaults to 0 in 3D and 90 in 2D extension.

  • VAL7 - Number of divisions between the starting and ending θ angles for data computations. Defaults to 0.

  • VAL8 - Reference rms sound pressure. Defaults to 2x10 -5 Pa.

  • VAL9 - Thickness of 2D model extension in z direction (defaults to 0).

For Lab = path, plnear computes the electric field or pressure for the path data points for the path currently defined by the path and ppath commands.

val4str

For LAB = SPHERE:

  • VAL1 - Radius of spherical surface in spherical coordinate system.

  • VAL2 - Starting φ angle (degree) in the spherical coordinate system. Defaults to 0.

  • VAL3 - Ending φ angle (degree) in the spherical coordinate system. Defaults to 0.

  • VAL4 - Number of divisions between the starting and ending φ angles for data computations. Defaults to 0.

  • VAL5 - Starting θ angle (degrees) in the spherical coordinate system. Defaults to 0 in 3D and 90 in 2D extension.

  • VAL6 - Ending θ angle (degrees) in the spherical coordinate system. Defaults to 0 in 3D and 90 in 2D extension.

  • VAL7 - Number of divisions between the starting and ending θ angles for data computations. Defaults to 0.

  • VAL8 - Reference rms sound pressure. Defaults to 2x10 -5 Pa.

  • VAL9 - Thickness of 2D model extension in z direction (defaults to 0).

For Lab = path, plnear computes the electric field or pressure for the path data points for the path currently defined by the path and ppath commands.

val5str

For LAB = SPHERE:

  • VAL1 - Radius of spherical surface in spherical coordinate system.

  • VAL2 - Starting φ angle (degree) in the spherical coordinate system. Defaults to 0.

  • VAL3 - Ending φ angle (degree) in the spherical coordinate system. Defaults to 0.

  • VAL4 - Number of divisions between the starting and ending φ angles for data computations. Defaults to 0.

  • VAL5 - Starting θ angle (degrees) in the spherical coordinate system. Defaults to 0 in 3D and 90 in 2D extension.

  • VAL6 - Ending θ angle (degrees) in the spherical coordinate system. Defaults to 0 in 3D and 90 in 2D extension.

  • VAL7 - Number of divisions between the starting and ending θ angles for data computations. Defaults to 0.

  • VAL8 - Reference rms sound pressure. Defaults to 2x10 -5 Pa.

  • VAL9 - Thickness of 2D model extension in z direction (defaults to 0).

For Lab = path, plnear computes the electric field or pressure for the path data points for the path currently defined by the path and ppath commands.

val6str

For LAB = SPHERE:

  • VAL1 - Radius of spherical surface in spherical coordinate system.

  • VAL2 - Starting φ angle (degree) in the spherical coordinate system. Defaults to 0.

  • VAL3 - Ending φ angle (degree) in the spherical coordinate system. Defaults to 0.

  • VAL4 - Number of divisions between the starting and ending φ angles for data computations. Defaults to 0.

  • VAL5 - Starting θ angle (degrees) in the spherical coordinate system. Defaults to 0 in 3D and 90 in 2D extension.

  • VAL6 - Ending θ angle (degrees) in the spherical coordinate system. Defaults to 0 in 3D and 90 in 2D extension.

  • VAL7 - Number of divisions between the starting and ending θ angles for data computations. Defaults to 0.

  • VAL8 - Reference rms sound pressure. Defaults to 2x10 -5 Pa.

  • VAL9 - Thickness of 2D model extension in z direction (defaults to 0).

For Lab = path, plnear computes the electric field or pressure for the path data points for the path currently defined by the path and ppath commands.

val7str

For LAB = SPHERE:

  • VAL1 - Radius of spherical surface in spherical coordinate system.

  • VAL2 - Starting φ angle (degree) in the spherical coordinate system. Defaults to 0.

  • VAL3 - Ending φ angle (degree) in the spherical coordinate system. Defaults to 0.

  • VAL4 - Number of divisions between the starting and ending φ angles for data computations. Defaults to 0.

  • VAL5 - Starting θ angle (degrees) in the spherical coordinate system. Defaults to 0 in 3D and 90 in 2D extension.

  • VAL6 - Ending θ angle (degrees) in the spherical coordinate system. Defaults to 0 in 3D and 90 in 2D extension.

  • VAL7 - Number of divisions between the starting and ending θ angles for data computations. Defaults to 0.

  • VAL8 - Reference rms sound pressure. Defaults to 2x10 -5 Pa.

  • VAL9 - Thickness of 2D model extension in z direction (defaults to 0).

For Lab = path, plnear computes the electric field or pressure for the path data points for the path currently defined by the path and ppath commands.

val8str

For LAB = SPHERE:

  • VAL1 - Radius of spherical surface in spherical coordinate system.

  • VAL2 - Starting φ angle (degree) in the spherical coordinate system. Defaults to 0.

  • VAL3 - Ending φ angle (degree) in the spherical coordinate system. Defaults to 0.

  • VAL4 - Number of divisions between the starting and ending φ angles for data computations. Defaults to 0.

  • VAL5 - Starting θ angle (degrees) in the spherical coordinate system. Defaults to 0 in 3D and 90 in 2D extension.

  • VAL6 - Ending θ angle (degrees) in the spherical coordinate system. Defaults to 0 in 3D and 90 in 2D extension.

  • VAL7 - Number of divisions between the starting and ending θ angles for data computations. Defaults to 0.

  • VAL8 - Reference rms sound pressure. Defaults to 2x10 -5 Pa.

  • VAL9 - Thickness of 2D model extension in z direction (defaults to 0).

For Lab = path, plnear computes the electric field or pressure for the path data points for the path currently defined by the path and ppath commands.

val9str

For LAB = SPHERE:

  • VAL1 - Radius of spherical surface in spherical coordinate system.

  • VAL2 - Starting φ angle (degree) in the spherical coordinate system. Defaults to 0.

  • VAL3 - Ending φ angle (degree) in the spherical coordinate system. Defaults to 0.

  • VAL4 - Number of divisions between the starting and ending φ angles for data computations. Defaults to 0.

  • VAL5 - Starting θ angle (degrees) in the spherical coordinate system. Defaults to 0 in 3D and 90 in 2D extension.

  • VAL6 - Ending θ angle (degrees) in the spherical coordinate system. Defaults to 0 in 3D and 90 in 2D extension.

  • VAL7 - Number of divisions between the starting and ending θ angles for data computations. Defaults to 0.

  • VAL8 - Reference rms sound pressure. Defaults to 2x10 -5 Pa.

  • VAL9 - Thickness of 2D model extension in z direction (defaults to 0).

For Lab = path, plnear computes the electric field or pressure for the path data points for the path currently defined by the path and ppath commands.

Notes

plnear uses the equivalent source principle to calculate the pressure in the near zone exterior to the equivalent source surface (flagged with the Maxwell surface flag in the preprocessor) for one of the following locations:

  • A spherical surface in the KCN coordinate system

  • A path defined by the path and ppath commands

To plot the pressure results for a path, use the plpagm or plpath commands. See the hfsym command for the model symmetry.

To retrieve saved equivalent source data, issue the Set displays, Lstep, Sbstep,,REAL command.