ansys.mapdl.core.Mapdl.prfar#

Mapdl.prfar(lab='', option='', var1b='', var1e='', nvar1='', var2b='', var2e='', nvar2='', val1='', val2='', val3='', val4='', val5='', ldstep='', substep='', freqb='', freqe='', printtype='', logopt='', **kwargs)#

Prints acoustic far field parameters.

Mechanical APDL Command: PRFAR

Parameters:
labstr

Parameters to print:

  • PRES - Acoustic parameters

  • PROT - Acoustic parameters with the y-axis rotated extrusion (not valid for 2D elements)

  • PLAT - Acoustic parameters radiated by a vibrating structural panel (not valid for 2D elements)

optionstr

Print option, based on the specified print parameter type:

This command contains some tables and extra information which can be inspected in the original documentation pointed above.

var1bstr

Starting and ending values for the first variable associated with PrintType as described below.

When PrintType = blank (default) or SPHR: Starting and ending phi (φ) angles (in degrees) in the spherical coordinate system. Defaults to 0.

When PrintType = PLXY: Starting and ending x value in the Cartesian coordinate system. Defaults to 0.

When PrintType = PLYZ: Starting and ending y value in the Cartesian coordinate system. Defaults to 0.

When PrintType = PLXZ: Starting and ending x value in the Cartesian coordinate system. Defaults to 0.

var1estr

Starting and ending values for the first variable associated with PrintType as described below.

When PrintType = blank (default) or SPHR: Starting and ending phi (φ) angles (in degrees) in the spherical coordinate system. Defaults to 0.

When PrintType = PLXY: Starting and ending x value in the Cartesian coordinate system. Defaults to 0.

When PrintType = PLYZ: Starting and ending y value in the Cartesian coordinate system. Defaults to 0.

When PrintType = PLXZ: Starting and ending x value in the Cartesian coordinate system. Defaults to 0.

nvar1str

Number of divisions between the starting and ending VAR1 values for data computations. Defaults to 0.

var2bstr

Starting and ending values for the second variable associated with PrintType as described below.

When PrintType = blank (default) or SPHR: Starting and ending theta (θ) angles (in degrees) in the spherical coordinate system. Defaults to 0 for a 3D model and 90 for a 2D extrusion model.

When PrintType = PLXY: Starting and ending y value in the Cartesian coordinate system. Defaults to 0.

When PrintType = PLYZ: Starting and ending z value in the Cartesian coordinate system. Defaults to 0.

When PrintType = PLXZ: Starting and ending z value in the Cartesian coordinate system. Defaults to 0.

var2estr

Starting and ending values for the second variable associated with PrintType as described below.

When PrintType = blank (default) or SPHR: Starting and ending theta (θ) angles (in degrees) in the spherical coordinate system. Defaults to 0 for a 3D model and 90 for a 2D extrusion model.

When PrintType = PLXY: Starting and ending y value in the Cartesian coordinate system. Defaults to 0.

When PrintType = PLYZ: Starting and ending z value in the Cartesian coordinate system. Defaults to 0.

When PrintType = PLXZ: Starting and ending z value in the Cartesian coordinate system. Defaults to 0.

nvar2str

Number of divisions between the starting and ending VAR2 values for data computations. Defaults to 0.

val1str

VAL1 is additional input. Its meaning depends on the PrintType argument as described below.

When PrintType = blank (default) or SPHR: Radius of the sphere surface.

When PrintType = PLXY: Fixed z value for an X-Y plane in the Cartesian coordinate system. Defaults to 0.

When PrintType = PLYZ: Fixed x value for a Y-Z plane in the Cartesian coordinate system. Defaults to 0.

When PrintType = PLXZ: Fixed y value for an X-Z plane in the Cartesian coordinate system, Defaults to 0.

val2str

When Option = SPLC or SPAC: Reference rms sound pressure. Defaults to 2x10 -5 Pa.

When Option = PWL: Reference sound power. Defaults to 1x10 -12 watts.

val3str

When Lab = PRES: Thickness of 2D model extrusion in the z direction (no default).

When Lab = PROT: Angle of the y-axis rotated extrusion model (no default)

val4str

When Lab = PLAT: Mass density of acoustic fluid.

val5str

When Lab = PLAT: Sound speed in acoustic fluid.

ldstepstr

Specified load step. Defaults to the load step number specified on the Set displays command, or defaults to 1 if Set displays has not been issued.

  • n - Load step number.

  • ALL - All load steps.

substepstr

Specified substep. Defaults to the substep number specified on the Set displays command, or defaults to ALL (all substeps at the specified load step) if Set displays has not been issued.

  • n - Substep number.

  • ALL - All substeps.

freqbstr

Frequency value representing one of the following:

  • Beginning frequency of the frequency range ( FREQB to FREQE ) for the defined load step(s) and substeps ( SUBSTEP = ALL). If a SUBSTEP value is specified, FREQB is invalid.

  • Central frequency of octave bands, used when LogOpt = OB1, OB2, OB3, OB6, OB12, or OB24 and FREQE is blank.

freqestr

Ending frequency of the frequency range ( FREQB to FREQE ) for the defined load step(s) and substeps ( SUBSTEP = ALL). If blank, FREQE is set to FREQB. If a SUBSTEP value is specified, FREQE is invalid.

printtypestr

Print out far-field parameters on a plane or sphere (used when Option = SUMC, PHSC, SPLC, SPAC, DGCT, PSCT, or TSCT). No default.

  • PLXY - On an X-Y plane.

  • PLYZ - On a Y-Z plane.

  • PLXZ - On an X-Z plane.

  • SPHR - On a sphere surface.

logoptstr

Octave bands (used only when Option = SPLC, SPAC, or PWL) :

  • OB0 - Narrow bands (default).

  • OB1 - Octave bands.

  • OB2 - 1/2 octave bands.

  • OB3 - 1/3 octave bands.

  • OB6 - 1/6 octave bands.

  • OB12 - 1/12 octave bands.

  • OB24 - 1/24 octave bands.

Notes

Warning

This function contains specificities regarding the argument definitions. Please refer to the command documentation for further explanations.

The prfar command prints pressure far fields and far field parameters as determined by the equivalent source principle. Use this command to print pressure and acoustic parameters. See the hfsym command for the model symmetry and the hfang command for spatial radiation angles.

Printing acoustic parameters radiated by a vibrating structural panel ( Lab = PLAT) is supported by elements SOLID185, SOLID186, SOLID187, SHELL181, SHELL281, and SOLSH190. The vibration surface of the panel must be flagged by the sf,MXWF command.