3.4. Incident Wave Source

An acoustic Incident Wave Source excitation condition is used to create an incident wave.

Analysis Types

The acoustic Incident Wave Source excitation condition is available for Coupled Field Harmonic and Harmonic Acoustics analyses.

Important:

This excitation is not supported if the Solution Method property (Analysis Settings) is set to Krylov.
When you select the Back Enclosed Loudspeaker option for the Wave Type property, the Pressure setting for the Excitation Type property is not supported.

Common Characteristics

This section describes the characteristics of the boundary condition, including the application requirements, support limitations, and loading definitions and values.

Dimensional Types

3D Simulation: Supported.
2D Simulation: Not Supported.

Topology: No topology selection is made for the Incident Wave Source. Its location is defined using the Source Origin X/Y/Z coordinates.

Loading Data Definition: The Incident Wave Source excitation condition is defined as a constant.

Boundary Condition Application

To apply an Incident Wave Source:

On the Environment Context tab: select Acoustic Excitations > Incident Wave Source. Or, right-click the Environment tree object or click in the Geometry window and select Insert > Acoustics > Incident Wave Source.
Define Wave Type, Excitation Type.
Define Incident Wave Location. Options include Wave Type other than Planar Wave.
Define Pressure Amplitude for Excitation Type = Pressure.
Define Velocity Amplitude for Excitation Type = Velocity.
Define the Material Assignment property (Base Medium). A selection fly-out menu is provided.

Details View Properties

The selections available in the Details view are described below.

Category	Fields/Options/Description
Definition	Type: Read-only field that describes the object - Incident Wave Source. Wave Type: This property provides the following options. Planar Wave Monopole Dipole Back Enclosed Loudspeaker Bare Loudspeaker Incident Wave Location: This property provides the following options. Outside The Model Inside The Model Read-only for Wave Type = Planar Wave and selects the Outside The Model option. Excitation Type: This property provides the following options. Pressure Velocity Specification of the following inputs are required based on Wave Type and Excitation Type. Pressure Amplitude: Input available for Excitation Type = Pressure to specify excitation pressure amplitude. Velocity Amplitude: Input available for Excitation Type = Velocity to specify excitation velocity amplitude. Phase Angle: Input to specify the phase angle Angle Phi (From X Axis Toward Y Axis): Input available for Wave Type = Planar Wave. Angle Theta (From Z Axis Toward X Axis): Input available for Wave Type = Planar Wave. Radius of Pulsating Sphere: Input available for Wave Type = Monopole, Dipole, Back Enclosed Loudspeaker, and Bare Loudspeaker. The Radius must be greater or equal to zero. Specification of the following inputs are required for Wave Type = Dipole and Bare Loudspeaker. Dipole Length X Component of Unit Dipole Vector Y Component of Unit Dipole Vector Z Component of Unit Dipole Vector Calculate Incident Power: This property provides the options No and Yes. Port Selection: Select a port from drop-down list of available valid ports. Suppressed: Include (No - default) or exclude (Yes) the boundary condition.
Base Medium	Material Assignment: Select a material to define material properties (Mass Density and Speed of Sound) of the Base Medium. Mass Density: Read-only field whose value is updated based on the selected Material Assignment. Speed of Sound: Read-only field whose value is updates based on the selected Material Assignment.
Location	When you set Wave Type to either Monopole, Dipole, Back Enclosed Loudspeaker, and Bare Loudspeaker, define location of wave source using the following properties: Source Origin X: Input field. Source Origin Y: Input field. Source Origin Z: Input field. Source Location: Geometry Selection button.

Category

Fields/Options/Description

Definition

Type: Read-only field that describes the object - Incident Wave Source.

Wave Type: This property provides the following options.

Planar Wave
Monopole
Dipole
Back Enclosed Loudspeaker
Bare Loudspeaker

Incident Wave Location: This property provides the following options.

Outside The Model
Inside The Model
Read-only for Wave Type = Planar Wave and selects the Outside The Model option.

Excitation Type: This property provides the following options.

Pressure
Velocity

Specification of the following inputs are required based on Wave Type and Excitation Type.

Pressure Amplitude: Input available for Excitation Type = Pressure to specify excitation pressure amplitude.
Velocity Amplitude: Input available for Excitation Type = Velocity to specify excitation velocity amplitude.
Phase Angle: Input to specify the phase angle
Angle Phi (From X Axis Toward Y Axis): Input available for Wave Type = Planar Wave.
Angle Theta (From Z Axis Toward X Axis): Input available for Wave Type = Planar Wave.
Radius of Pulsating Sphere: Input available for Wave Type = Monopole, Dipole, Back Enclosed Loudspeaker, and Bare Loudspeaker. The Radius must be greater or equal to zero.

Specification of the following inputs are required for Wave Type = Dipole and Bare Loudspeaker.

Dipole Length
X Component of Unit Dipole Vector
Y Component of Unit Dipole Vector
Z Component of Unit Dipole Vector

Calculate Incident Power: This property provides the options No and Yes.

Port Selection: Select a port from drop-down list of available valid ports.

Suppressed: Include (No - default) or exclude (Yes) the boundary condition.

Base Medium

Material Assignment: Select a material to define material properties (Mass Density and Speed of Sound) of the Base Medium.

Mass Density: Read-only field whose value is updated based on the selected Material Assignment.

Speed of Sound: Read-only field whose value is updates based on the selected Material Assignment.

Location

When you set Wave Type to either Monopole, Dipole, Back Enclosed Loudspeaker, and Bare Loudspeaker, define location of wave source using the following properties:

Source Origin X: Input field.
Source Origin Y: Input field.
Source Origin Z: Input field.
Source Location: Geometry Selection button.

Mechanical APDL References and Notes

The Mechanical APDL command AWAVE is used to apply the Incident Wave Source excitation condition. Refer to the Analytic Incident Wave Sources section in the Mechanical APDL Acoustic Analysis Guide for more information.

API Reference

See the Incident Wave Source section of the ACT API Reference Guide for specific scripting information.