from abaqusConstants import *
from .Interaction import Interaction
from ..Region.Region import Region
[docs]class IncidentWave(Interaction):
"""The IncidentWave object defines incident wave interactions for acoustic and coupled
acoustic-structural analyses.
The IncidentWave object is derived from the Interaction object.
Notes
-----
This object can be accessed by:
.. code-block:: python
import interaction
mdb.models[name].interactions[name]
The corresponding analysis keywords are:
- INCIDENT WAVE INTERACTION
"""
def __init__(self, name: str, createStepName: str, sourcePoint: Region, standoffPoint: Region,
surface: Region, interactionProperty: str, definition: SymbolicConstant = PRESSURE,
amplitude: str = '', imaginaryAmplitude: str = '', surfaceNormal: tuple = (),
initialDepth: float = None, referenceMagnitude: float = None,
detonationTime: float = None, magnitudeFactor: float = 1):
"""This method creates an IncidentWave object.
Notes
-----
This function can be accessed by:
.. code-block:: python
mdb.models[name].IncidentWave
Parameters
----------
name
A String specifying the repository key.
createStepName
A String specifying the name of the step in which the IncidentWave object is created.
sourcePoint
A Region object specifying the incident wave source point.
standoffPoint
A Region object specifying the incident wave standoff point.This argument is not valid
when *definition*=CONWEP.
surface
A Region object specifying the surface defining the incident wave interaction. In
problems involving fluid/surface boundaries, both the fluid surface and the solid
surface comprising the boundary must have an incident wave interaction specified.
interactionProperty
A String specifying the IncidentWaveProperty object associated with this interaction.
definition
A SymbolicConstant specifying the type of incident wave to be defined. The value must be
PRESSURE for linear perturbation steps. An Explicit step is required when the value is
set to CONWEP. Possible values are PRESSURE, ACCELERATION, UNDEX, and CONWEP. The
default value is PRESSURE.
amplitude
A String specifying the name of the Amplitude object that defines the fluid pressure
time history at the standoff point, if *definition*=PRESSURE. If
*definition*=ACCELERATION, then this string specifies the name of the Amplitude object
that defines the fluid particle acceleration time history at the standoff point. This
member can be specified only if *definition*=PRESSURE or ACCELERATION. The default value
is an empty string.
imaginaryAmplitude
A String specifying the name of the Amplitude object that defines the imaginary
component of the fluid pressure time history at the standoff point. This member is
applicable only for linear perturbation steps and if *definition*=PRESSURE. The default
value is an empty string.
surfaceNormal
A sequence of three Floats specifying the X, Y, and Z components of the direction cosine
of the fluid surface normal.This argument is valid only when *definition*=UNDEX.
initialDepth
None or a Float specifying the initial depth of the UNDEX bubble. The default value is
None.This argument is valid only when *definition*=UNDEX.
referenceMagnitude
A Float specifying the reference magnitude.This argument is not valid when
*definition*=CONWEP.
detonationTime
A Float specifying the time of detonation, given in total time.This argument is valid
only when *definition*=CONWEP.
magnitudeFactor
A Float specifying the magnitude scale factor. The default value is 1.0.This argument is
valid only when *definition*=CONWEP.
Returns
-------
An IncidentWave object.
"""
super().__init__()
pass
[docs] def setValues(self, definition: SymbolicConstant = PRESSURE, amplitude: str = '',
imaginaryAmplitude: str = '', surfaceNormal: tuple = (), initialDepth: float = None,
referenceMagnitude: float = None, detonationTime: float = None,
magnitudeFactor: float = 1):
"""This method modifies the IncidentWave object.
Parameters
----------
definition
A SymbolicConstant specifying the type of incident wave to be defined. The value must be
PRESSURE for linear perturbation steps. An Explicit step is required when the value is
set to CONWEP. Possible values are PRESSURE, ACCELERATION, UNDEX, and CONWEP. The
default value is PRESSURE.
amplitude
A String specifying the name of the Amplitude object that defines the fluid pressure
time history at the standoff point, if *definition*=PRESSURE. If
*definition*=ACCELERATION, then this string specifies the name of the Amplitude object
that defines the fluid particle acceleration time history at the standoff point. This
member can be specified only if *definition*=PRESSURE or ACCELERATION. The default value
is an empty string.
imaginaryAmplitude
A String specifying the name of the Amplitude object that defines the imaginary
component of the fluid pressure time history at the standoff point. This member is
applicable only for linear perturbation steps and if *definition*=PRESSURE. The default
value is an empty string.
surfaceNormal
A sequence of three Floats specifying the X, Y, and Z components of the direction cosine
of the fluid surface normal.This argument is valid only when *definition*=UNDEX.
initialDepth
None or a Float specifying the initial depth of the UNDEX bubble. The default value is
None.This argument is valid only when *definition*=UNDEX.
referenceMagnitude
A Float specifying the reference magnitude.This argument is not valid when
*definition*=CONWEP.
detonationTime
A Float specifying the time of detonation, given in total time.This argument is valid
only when *definition*=CONWEP.
magnitudeFactor
A Float specifying the magnitude scale factor. The default value is 1.0.This argument is
valid only when *definition*=CONWEP.
"""
pass