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:
- lab
str
Plot the maximum pressure or sound pressure level:
SPHERE
- on the spherical structurePATH
- along the path
- opt
str
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).
- kcn
str
KCN is the coordinate system reference number. It may be 0 (Cartesian) or any previously defined local coordinate system number (>10). Defaults to 0.
- val1
str
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.- val2
str
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.- val3
str
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.- val4
str
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.- val5
str
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.- val6
str
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.- val7
str
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.- val8
str
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.- val9
str
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.
- lab
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.