Adams 2022.3 Adams Acoustics User Guide
Adams 2022.3 Adams Acoustics User Guide
3
Adams Acoustics User's Guide
Americas Europe, Middle East, Africa
5161 California Ave, Suite 200 Am Moosfeld 13
University Research Park 81829 Munich, Germany
Irvine, CA 92617 Telephone: (49) 89 431 98 70
Telephone: (714) 540-8900 Email: [email protected]
Email: [email protected]
Japan Asia-Pacific
KANDA SQUARE 16F 100 Beach Road
2-2-1 Kanda Nishikicho, Chiyoda-ku #16-05 Shaw Tower
Tokyo 101-0054, Japan Singapore 189702
Telephone: (81)(3) 6275 0870 Telephone: 65-6272-0082
Email: [email protected] Email: [email protected]
Worldwide Web
www.mscsoftware.com, www.hexagon.com
Support
https://simcompanion.hexagon.com/
Disclaimer
This documentation, as well as the software described in it, is furnished under license and may be used only in accordance with the
terms of such license.
Hexagon reserves the right to make changes in specifications and other information contained in this document without prior notice.
The concepts, methods, and examples presented in this text are for illustrative and educational purposes only, and are not intended
to be exhaustive or to apply to any particular engineering problem or design. Hexagon assumes no liability or responsibility to any
person or company for direct or indirect damages resulting from the use of any information contained herein.
User Documentation: Copyright © 2022 Hexagon AB and/or its subsidiaries. All Rights Reserved.
This notice shall be marked on any reproduction of this documentation, in whole or in part. Any reproduction or distribution of this
document, in whole or in part, without the prior written consent of Hexagon is prohibited.
This software may contain certain third-party software that is protected by copyright and licensed from third party licensors. Additional
terms and conditions and/or notices may apply for certain third party software. Such additional third party software terms and
conditions and/or notices may be set forth in documentation and/or at http://www.mscsoftware.com/thirdpartysoftware (or successor
website designated by Hexagon from time to time). Portions of this software are owned by Siemens Product Lifecycle Management,
Inc. © Copyright 2022.
The Hexagon logo, Hexagon, MSC, MSC Adams, MD Adams, and Adams are trademarks or registered trademarks of Hexagon AB
and/or its subsidiaries in the United States and/or other countries. FLEXlm and FlexNet Publisher are trademarks or registered
trademarks of Flexera Software. Parasolid is a registered trademark of Siemens Product Lifecycle Management, Inc. All other
trademarks are the property of their respective owners.
ADAM:V2022.3:Z:Z:Z:DC-ATCS
Documentation Feedback
At Hexagon Manufacturing Intelligence, we strive to produce the highest quality documentation and
welcome your feedback. If you have comments or suggestions about our documentation, write to us at:
[email protected].
Please include the following information with your feedback:
Document name
Release/Version number
Chapter/Section name
Topic title (for Online Help)
Brief description of the content (for example, incomplete/incorrect information, grammatical
errors, information that requires clarification or more details and so on).
Your suggestions for correcting/improving documentation
You may also provide your feedback about Hexagon Manufacturing Intelligence documentation by
taking a short 5-minute survey at: http://msc-documentation.questionpro.com.
Note: The above mentioned e-mail address is only for providing documentation specific
feedback. If you have any technical problems, issues, or queries, please contact Technical
Support.
Contents
Adams Acoustics User Guide
Overlap. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62
Start and End Frequencies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62
Far Field . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62
Microphones. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62
Grey Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63
Analysis set-up. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63
Order of Infinite Elements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63
Gap Tolerance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63
Output Map . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63
Multiple Flexible Bodies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64
Computational Time . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64
viii Adams Acoustics User Guide
Welcome to Adams Acoustics 1
If you have multiple versions of Actran installed, you designate the one to be used with Adams Acoustics by
specifying the available Actran installation as follows:
4 Adams Acoustics
Actran Version Compatibility
Licensing
Adams Acoustics requires either one of the following licenses:
Actran Entry Adams: Covers all features to run the Acoustics plugin
Actran VI and Actran Acoustic License: Together, these cover all features of the "Actran Entry for Adams"
license and give additional post-processing features, meshing features and enable all Actran Acoustic features.
For example:
Manual creation and editing of acoustic meshes in Actran VI
Displaying 3D maps in Actran VI
Additional features of Actran VI
Loading the Acoustics Plugin 5
Alternatively, the Acoustics plugin can be loaded with the Plugin Manager, in the menu Tools/Plugin
Manager:
6 Adams Acoustics
Setup and Run of Acoustics Analyses 7
Common Setup
Note: The Frequency domain simulation is also starting from Adams time domain
simulation.
Common Setup
The following part of the dialog box is common to both Time domain and Frequency domain simulations.
8 Adams Acoustics
Common Setup
1. Mesh
2. Results Content
3. DFT
4. Environment
5. Far Field
6. Analysis Setup
Mesh Tab
The Mesh Tab allows creation of the acoustic mesh utilized for the acoustic radiation of the vibrating
structure. The inputs are described below. See the Mesh section of the Appendix for more details.
• Automatic mesh: This option can be chosen to automatically generate the acoustic mesh. In most
of the cases mesh creation will be successful. In case that the Automatic mesh is not successful,
one should manually create the shrinkwrap mesh and supply that here.
2. Mesh File: Browse for and specify the mesh file if either "Mesh already provided" or "Shrinkwrap
provided" are chosen for Mesh Type.
3. Maximum Frequency: Defines the maximal frequency that should be supported by the acoustic
mesh. The higher the frequency, the finer the acoustic mesh will become because the acoustic
wavelength will be used for the mesh criteria.
4. Elements per Wavelength: Defines how many elements will be generated per minimal wavelength.
The smallest wavelength is defined by the Maximum Frequency. The process is using quadratic mesh.
Default value: 4
5. Distance from Structure: Defines the distance of the shrinkwrap to the structure.
0.0 to 1 cm are good choices depending on the size and complexity of the structure. Default value is
0.0.
6. Fill hole size (% of structure size): Defines which holes will be filled by the automatic mesh
generation algorithm. Please note that if all holes are not filled, the shrinkwrap might enter inside the
structure. This should be absolutely avoided. See Edit button for checking the shrinkwrap with
Actran VI.
7. Acoustic volume scaling: A factor '?' used to define the limit of the computational domain around
the structure. The limit is a sphere whose diameter 'D' is the following:
D= * (maximum dimension of the structure)
8. Use Hexa mesh: Activates the usage of hexahedral elements in the volume mesh. If the volume mesh
generation fails, try de-activating this option. Default: activated.
9. Select: This button opens an additional dialog box (see below) to select acoustic mesh files
individually.
Dialog to select the acoustic mesh files individually:
10. Create: This button creates the acoustic mesh if the "Automatic mesh" or "Shrinkwrap provided"
options are chosen for Mesh Type.
12 Adams Acoustics
Advanced Setup for Time Domain Simulation
11. Show: This button displays the acoustic mesh in Adams View:
Visualized acoustic mesh:
12. Edit: This Button opens the shrinkwrap mesh in Actran VI. Please note that for mesh modifications,
an Actran VI license is necessary, the "Actran Entry for Adams" license is not sufficient for this option.
13. Status: This button displays the current status of the meshes in the info window.
Note that an Actran Time Domain analysis cannot be submitted if no mesh is available for the analysis.
Setup and Run of Acoustics Analyses 13
Advanced Setup for Time Domain Simulation
In the results content tab, the post-processing content is defined. The inputs are described below.
1. Output Format: Defines the output format of the results. Images, ascii-format and both can be
chosen.
2. Overall Acoustic Pressure (3D Plots): Plots the time dependent results of each microphone in a
waterfall diagram.
3. Acoustic Pressure at microphone(s): Creates the acoustic pressure results for each microphone
defined in Microphone for Post on the Far Field tab.
4. Audio File: Creates a wave-file for each microphone defined in Microphone for Post on the Far Field
tab.
5. SPL over time at microphone(s): Creates the Sound Pressure Level (SPL) per time period in a time
dependent plot.
6. Refreshing Rate: The time period (in seconds) over which the Sound Pressure Level SPL is integrated.
7. SPL output in dBA: Applies the A-weighting function to acoustic results expressed in dB.
14 Adams Acoustics
Advanced Setup for Time Domain Simulation
The Discrete Fourier Transformation (DFT) tab contains the properties for the transformation of time
domain signals into frequency domain results. The inputs are described below. See the Discrete Fourier Transform
(DFT) section of the Appendix for more details.
1. Discrete Fourier Transform Output: Activates the transformation of time results to frequency
domain
2. Time Windowing: Defines the form of the window. While Rectangular window will apply a constant
factor of 1 (thus no window) to the sampled time signal, other window types will apply factors from
[0,1] to the sampled time signal. Options are Triangular, Hamming, Hanning, Blackman and
Blackman Harris. For example, the Hanning windowing is defined by the formula with n the number
or the
2n
w n = 0.5 – 0.5 cos -------------- 0 n M – 1
M – 1
sample points, M the quantity of sample points in the window and w the window function
3. Time Interval: Defines the length of each time interval where the DFT is applied
4. Overlap of Time Interval: Defines the percentage of the overlap of the subsequent time interval.
5. Start Frequency: defines the first computed frequency in the DFT. Default value is defined by the
period of the time interval.
6. End Frequency: defines the last frequency to be computed during the DFT. Note that the time step
length influences the maximal frequency that can be computed, through the Nyquist criterion.
Setup and Run of Acoustics Analyses 15
Advanced Setup for Time Domain Simulation
Environment Tab
The Environment tab defines the properties of ambient fluid surrounding the structure:
1. Acoustic Environment: Allows to automatically define the properties of the Air at a given
temperature. Following properties are influenced by the temperature defined.
2. Speed of Sound in m/s
3. Fluid Density in kg/m³
The Far Field Tab defines the position of the microphones and the properties of the infinite elements. The
inputs are described below. See the Far Field section of the Appendix for more details.
1. Order of Infinite Elements: Defines the number of interpolation points for each infinite element,
which is used to model non-reflecting boundary conditions and the acoustic radiation outside of the
finite element mesh. Default value is 10.
2. Microphone Table File: Defines the position of the microphones; the default position is based on the
ISO3744 and can be found in the installation folder
"<top_dir>\acoustics\examples\ISO3744_meter.mic"
3. Radius of Infinite Elements: Defines the coordinate system of the infinite elements.
4. Center of Infinite Elements: Defines the location of the center of the infinite elements.
5. Scale Factor of Microphones: Scales the coordinates of the microphone positions.
6. Microphone for Post: Select the microphones used for additional post-processing output; the button
"All" will select all microphones
7. Show Microphones: This button is enabled after the acoustic mesh is generated and displays all the
micro-phones available as yellow or red spheres (the red ones indicate microphones selected for extra
post-processing results)
8. Overwrite defaults: Radius of Infinite Elements, Center of Infinite Elements and Scale Factor for
Microphones all have automatic defaults. This "Overwrite defaults" button allows users to change
those inputs. For instance, the user can change the distance of the microphones from structure by
modifying the scaling factor for microphones.
In the Analysis Setup tab, the following parameters are defined. See the Analysis set-up section of the Appendix
for more details.
1. Gap Tolerance: Defines the tolerance parameter to couple the shrinkwrap with the structural acoustic
surfaces. Default value is twice the distance specified in Mesh tab, which can be used in other cases as
well.
If distance is 0.0, Gap Tolerance is set to 0.01 m.
2. Output Map: Allows user to create an acoustic 3D map in time domain.
Please note that:
• To open the map in Actran VI the license for Actran VI is needed, the "Actran Entry for Adams"
license is not sufficient.
• Asking for maps may increase computational time significantly.
• Default value is 'No'.
3. Output Maps Steps: Specifies the time steps of the output map. Please note that an output map can
demand a lot of hard drive space thus removing steps from the output could be important. Maps are
output at each time step for value=1, every two steps for value=2 and so on.
4. Memory: Memory dedicated to the calculation. Quantity depends on the size of the acoustic mesh.
Unit is MB.
3. Analysis parameters
4. Environment
5. Far Field
6. Analysis Setup
Mesh Tab
The Mesh Tab allows creating the acoustic mesh utilized for the acoustic radiation of the vibrating structure.
The inputs are described below. See the Mesh section of the Appendix for more details.
2. Mesh File: Browse for and specify the mesh file if either "Mesh already provided" or "Shrinkwrap
provided" are chosen for Mesh Type
3. Elements per Wavelength: Defines how many elements will be generated per smallest wavelength.
Default value: 4
4. Distance from Structure: Defines the distance of the shrinkwrap to the structure.
0.0 to 1 cm are good choices depending on the size and complexity of the structure. Default value is
0.0
5. Fill hole size (% of structure size): Defines which holes will be filled by the automatic mesh
generation algorithm. Please note that if all holes are not filled, the shrinkwrap might enter inside the
structure. This should be absolutely avoided. See Edit button for checking the shrinkwrap.
6. Select: This button opens an additional dialog box (see below) to select acoustic mesh files
individually.
Dialog to select the acoustic mesh files individually:
7. Create: This button will create the acoustic mesh if the "Automatic mesh" or "Shrinkwrap provided"
options are chosen for Mesh Type.
8. Show: This button displays the acoustic mesh in Adams View:
Visualized acoustic mesh (shrinkwrap) and microphones:
20 Adams Acoustics
Advanced Setup for Frequency Domain Simulation
In the results content tab, the post-processing content is defined. The inputs are described below.
1. Output Format: Defines the output format of the results. Images, ascii-format and both can be
chosen.
2. SPL over time at microphone: Creates the Sound Pressure Level (SPL) per time period in a time
dependent plot.
3. SPL output in dBA: Applies the A weighting function to acoustic results expressed in dB.
22 Adams Acoustics
Advanced Setup for Frequency Domain Simulation
The Discrete Fourier Transformation (DFT) section contains the properties for the transformation of
vibrations of the flexible body from time domain into frequency domain. The inputs are described below. See
the Discrete Fourier Transform (DFT) section of the Appendix for more details.
1. Time Windowing: Defines the form of the window. While Rectangular windows will apply a
constant factor of 1 (thus no window) to the sampled time signal, other window types will apply
factors from [0,1] to the sampled time signal. Options are Triangular, Hamming, Hanning,
Blackman and Blackman Harris. For example, the Hanning windowing is defined by the formula:
2n
w n = 0.5 – 0.5 cos -------------- 0 n M – 1
M – 1
with n the number or the sample points, M the quantity of sample points in the window and w the
window function.
2. Time Interval: Defines the length of each time interval where the DFT is applied.
3. Overlap of Time Interval: Defines the percentage of the overlap of the subsequent time interval.
The inputs to the Analysis Parameter section are described below:
4. Frequency range: Defines the frequencies of the Frequency domain calculation:
• Start and Step: These frequencies define the first computed frequency and the frequency step.
Default values are defined by the period of the time interval (see the Discrete Fourier Transform (DFT)
section in the Appendix).
• End: This frequency defines the last frequency to be computed. Note that the time step length
influences the maximal frequency that can be computed, through the Nyquist criterion.
Setup and Run of Acoustics Analyses 23
Advanced Setup for Frequency Domain Simulation
5. Number of Radiation frequencies for Green analysis: Defines the number of frequencies used for the
first step (Radiation) of the Green analysis. Default value is 4. More frequencies may be required for
better accuracy when dealing with complex geometries and high frequencies.
6. Number of bands for adaptive volume mesh: Defines the number of frequency ranges used for the
adaptive mesh. Default value: 6
7. Use Hexa mesh: Activates the usage of hexahedral elements in the volume mesh. If the volume mesh
generation fails, try de-activating this option. Default: activated.
8. Relative thickness for adaptive PML: Defines the thickness of the PML for each frequency band. The
value provided corresponds to the number of acoustic wavelengths at the lower limit of each
frequency band. Default value: 1
Environment Tab
The Environment tab defines the properties of ambient fluid surrounding the structure:
1. Acoustic Environment: Allows to automatically define the properties of the Air at a given
temperature. Following properties are influenced by the temperature defined:
2. Speed of Sound in m/s
3. Fluid Density in kg/m³
24 Adams Acoustics
Advanced Setup for Frequency Domain Simulation
The Far Field Tab defines the position of the microphones and the properties of the infinite elements. The
inputs are described below. See the Far Field section of the Appendix for more details.
1. Order of the Infinite Elements: Defines the number of interpolation points for each infinite element,
which is used to model nonreflecting boundary conditions and the acoustic radiation outside of the
finite element mesh. Default value is 10.
2. Microphone Table File: Defines the position of the microphones; the default position is based on the
ISO3744 and can be found in the installation folder
"<top_dir>\acoustics\examples\ISO3744_meter.mic"
3. Translation Center of Microphones: Defines the center location of the microphones. Default value:
center of gravity of the flexible body.
4. Scale Factor of Microphones: Scales the coordinates of the microphone positions
5. Microphone for Post: Select the microphones used for additional post-processing output; the button
"All" will select all microphones
6. Hide: Hides microphone placement
7. Overwrite defaults: Radius of Infinite Elements, Center of Infinite Elements and Scale Factor for
Microphones all have automatic defaults. This "Overwrite defaults" button allows users to change
those inputs. For instance, the user can change the distance of the microphones from structure by
modifying the scaling factor for microphones.
Setup and Run of Acoustics Analyses 25
Advanced Setup for Frequency Domain Simulation
In the Analysis Setup tab, the following parameters are defined. See the Analysis set-up section of the Appendix
for more details.
1. Gap Tolerance: Defines the tolerance parameter to couple the shrinkwrap with the structural acoustic
surfaces. Default value is twice the distance specified in Mesh tab, which can be used in other cases as
well. If distance is 0.0, Gap Tolerance is set to 0.01 m.
2. Output Map: Allows the user to create an acoustic 3D map in time domain. Please note that to open
the map in Actran VI the license for Actran VI is needed, the "Actran Entry for Adams" license is not
sufficient. Note that asking for maps may increase computational time significantly. Default value is
'No'.
3. Output Maps Steps: Specifies the time steps of the output map. Please note that an output map can
demand a lot of hard drive space thus removing steps from the output could be important. Maps are
output at each time step for value=1, every two steps for value=2 and so on.
4. Memory: Memory dedicated to the calculation. Quantity depends on the size of the acoustic mesh.
Unit is MB.
26 Adams Acoustics
Advanced Setup for Frequency Domain Simulation
Post Processing and Results 27
Sound Pressure Level and Sound Power Level
In Adams PostProcessor
Acoustics Dialog
In Adams PostProcessor click on the "Acoustics" menu, then the Generate Acoustic Analysis Plots button to
launch the post processing dialog for acoustics analyses.
28 Adams Acoustics
In Adams PostProcessor
Note: 1. Generation of .wav files is only available for time domain simualtion
2. Tip for getting good audible .wav file: The quality of the DFT can be reassured
with the Nyquist criteria, fmax = 1/(2 t), with t the time step and fmax the
maximal computed frequency for the DFT. However, for an audio file of high
quality the Nyquist criteria is not sufficient. It is suggested to have 5 to 20 times
more time steps for the same maximal frequency, thus 1/(20 t)
Manual Import: This is primarily for users wanting to generate plots for acoustic simulations from
the preceding "Adams2Actran" toolkit form MSC Services. It can also be used, though, as a means
to generate plots from acoustic simulations not currently in session. Click this button to browse for
an .a2ac file corresponding to an acoustics analysis.
OK/Apply: This will launch automated plotting of the selected acoustics analysis. The automated
plots that get generated are described in the following sections.
Sound Pressure Level (SPL) vs. Frequency across Time Slices at Each Microphone (page name:
"acoustics_time_DFT_mic_#") - a page/plot is created for each microphone selected on the Far Field
Tab.
Sound Pressure Level (SPL) vs. Frequency at Each Time Interval (page name: "
acoustics_time_SPL_per_time_interval_mic_40#") - a page/plot is created for each microphone
selected on the Far Field Tab.
30 Adams Acoustics
In Adams PostProcessor
Overall Sound Power Level (SWL) vs. Time (page name: "acoustics_freq_overall_SWL")
Sound Power Level (SWL) vs. Frequency per Time Interval (page name:
"acoustics_freq_SWL_per_time_interval") - a separate curve is plotted for each time interval use
from the Adams analysis
Post Processing and Results 33
In Adams PostProcessor
Sound Pressure Level (SPL) vs. Frequency across Time Slices at Microphone (page name:
"acoustics_freq_SPL_at_mic#") - #") - a page/plot is created for each microphone selected on the Far
Field Tab.
.mdf: modal deformation file (MDF) output from Adams to be used as in input to Actran describing
the motion of the flexible body during the Adams analysis.
.finished: used by software for job status, no user consumption intended
.par: file containing all parameters defined by the user in the Acoustics plugin interface in Adams
View. This file is used by Actran as input to create meshes, analysis, run, post-processing. See
content of run_adac.bat file for advanced usage.
*.log: status logs from the Actran processes that performed the meshing, solving and generation of
the plots on disk
.a2ac: "Adams to Actran" file; this can be used to manually launch the automated plot generation in
the Adams PostProcessor Acoustics Dialog.
run_adac.bat: batch file used by Windows to launch the Actran jobs
.mic: file specified by the user to define the locations in space of the microphones. The default is
"ISO3744_meter.mic" included with the installation. See the Far Field Tab section for more
information.
dump: Directory Output by Actran time domain simulation. Used for Actran restart (not applicable
for current Adams/Actran usage).
.edat: Actran analysis input file. Contains all parameters to run the Actran simulation. Can be
opened in Actran VI.
.plt: Actran results file. Contains local and global indicators. Can be open in Actran PLTViewer and
WaterfallViewer for post-processing.
POINT_*: folders containing image files (.png) of all the microphone-specific plots generated by Actran and
containing text files (.txt) of the raw data used to create them. Note: these same data are plotted via the
Post Processing and Results 37
Output Files on Disk
automated process launched from Adams PostProcessor, but these Actran-generated plot images have
formatting differences in some cases. For example, the Sound Pressure Level (SPL) vs. Frequency across Time
Slices in this folder is a 2D colormap whereas in Adams Post Processor it is plotted as a 3D surface.
.edat: Actran analysis input file used to compute the Discrete Fourier Transform of Time domain
results.
.plt: Actran results file of Discrete Fourier Transform. Contains results in frequency domain for all
microphones requested by user.
micros_pa.txt: Time domain pressure at all microphones requested by user. Used as input for DFT.
ALL: folder containing image files (.png) of the non-microphone-number-specific plots generated
by Actran and containing text files (.txt) of the raw data used to create them. Note these same data
are plotted via the automated process launched from Adams PostProcessor, but these Actran-generated
plot images have formatting differences in some cases.
POINT_*: folders containing image files (.png) of all the microphone-specific plots generated by
Actran and containing text files (.txt) of the raw data used to create them. Note these same data are
plotted via the automated process launched from Adams PostProcessor, but these Actran-generated
plot images have formatting differences in some cases. Also included in this folder is the .wav sound
file for the give microphone.
38 Adams Acoustics
Output Files on Disk
This folder contains the Finite Element (FE) files generated by the automated pre-processing done for the
acoustics analysis. This folder is generated if the "Export FE Data" checkbox is selected on Adams Acoustics
dialog common area.
.bdf: structural mesh generated from input .mnf.
.mnf: The Adams modal neutral file used for the flexible body that was the subject of the acoustics
analysis
acoustic_mesh.bdf: mesh file containing the acoustic mesh (shrinkwrap, volume mesh and infinite
domain)
acoustic_mesh_header.bdf: contains acoustic mesh parameters for setup of the infinite elements (far
field)
shrinkwrap.bdf: mesh which couples the structure (Adams flexible body) to the acoustic volume
mesh
skin_mesh.bdf: skin mesh of the structure (MNF) generated by Adams Flex that is used to generate
the shrinkwrap.bdf
Post Processing and Results 39
Output Files on Disk
This folder contains many files and sub-folders of statistics about the Actran solver job and the environment
on which it was run. These may be useful in conversations with MSC technical support in diagnosing any
issues with the acoustics analysis.
40 Adams Acoustics
Output Files on Disk
.mdf : modal deformation file (MDF) output from Adams to be used as in input to Actran
describing the motion of the flexible body during the Adams analysis.
.finished: used by software for job status, no user consumption intended
.par: file containing all parameters defined by the user in the Acoustics plugin interface in Adams
View. This file is used by Actran as input to create meshes, analysis, run, post-processing. See
content of run_adac.bat file for advanced usage.
*.log: status logs from the Actran processes that performed the meshing, solving and generation of
the plots on disk
.a2ac: "Adams to Actran" file; this can be used to manually launch the automated plot generation in
the Adams PostProcessor Acoustics Dialog.
run_adac.bat: batch file used by Windows to launch the Actran jobs
.mic: file specified by the user to define the locations in space of the microphones. The default is
"ISO3744_meter.mic" included with the installation. See the Far Field Tab section for more
information.
Post Processing and Results 41
Output Files on Disk
actran_exterior_acoustic_DB: adaptive meshes created for Finite Element simulation. Meshes are
ordered by frequency range as per requested in Analysis parameters Tab 6.
actran_green_DB.naf: Actran Green analysis database. Can be used manually for Restart capabilities
if only MDF file is changing.
.edat: Actran analysis input file. Contains all parameters to run the Actran simulation. Can be
opened in Actran VI.
.plt: Actran results file. Contains local and global indicators. Can be open in Actran PLTViewer and
WaterfallViewer for post-processing.
SPL: stores Sound Pressure Level results from the Acoustics analysis. This folder contains subfolders
each containing image files (.png) of all the microphone-specific plots generated by Actran and
containing text files (.txt) of the raw data used to create them. Note these same data are plotted via
the automated process launched from Adams PostProcessor, but these Actran-generated plot images
have formatting differences in some cases.
SWL: stores Sound Power Level results from the Acoustics analysis. These are images (.png) of the
non-microphone-number-specific plots generated by Actran and containing text files (.txt) of the
raw data used to create them. Note these same data are plotted via the automated process launched
from Adams PostProcessor, but these Actran-generated plot images have formatting differences in
some cases.
42 Adams Acoustics
Output Files on Disk
This folder contains the Finite Element (FE) files generated by the automated pre-processing done for the
acoustics analysis. This folder is generated if the "Export FE Data" checkbox is selected on Adams Acoustics
dialog common area.
.mnf: The Adams modal neutral file used for the flexible body that was the subject of the acoustics
analysis
acoustic_mesh.bdf: mesh file containing the acoustic mesh (shrinkwrap, volume mesh and infinite
domain)
acoustic_mesh_header.bdf: contains acoustic mesh parameters for setup of the infinite elements (far
field)
shrinkwrap.bdf: mesh which couples the structure (Adams flexible body) to the acoustic volume
mesh
skin_mesh.bdf: skin mesh of the structure (MNF) generated by Adams Flex that is used to generate
the shrinkwrap.bdf
Post Processing and Results 43
Output Files on Disk
This folder contains many files and sub-folders of statistics about the Actran solver job and the environment
on which it was run. These may be useful in conversations with MSC technical support in diagnosing any
issues with the acoustics analysis.
44 Adams Acoustics
Output Files on Disk
Dialog Box - F1 Help 45
Actran Analysis Submission
Common Setup
Structural mesh
Modes in MNF format
OK Starts the acoustic simulation and closes the dialog
Apply Starts the acoustic simulation and keeps the dialog open
Cancel Closes the dialog
46 Adams Acoustics
Actran Analysis Submission
Advanced Setup
Mesh Tab
The Mesh Tab allows creation of the acoustic mesh utilized for the acoustic radiation of the vibrating
structure. The inputs are described below. See the Mesh section of the Appendix for more details.
Default value: 4
Distance from Structure Defines the distance of the shrinkwrap to the structure.
0.0 to 1 cm are good choices depending on the size and complexity of the
structure. Default value is 0.0
Fill hole size (% of structure Defines which holes will be filled by the automatic mesh generation
size) algorithm. Please note that if all holes are not filled, the shrinkwrap might
enter inside the structure. This should be absolutely avoided. See Edit
button for checking the shrinkwrap.
Dialog Box - F1 Help 47
Actran Analysis Submission
Acoustic Mesh
Header dat file
Shrinkwrap Mesh
Create This button will create the acoustic mesh if the "Automatic mesh" or
"Shrinkwrap provided" options are chosen for Mesh Type.
Show This button displays the acoustic mesh in Adams View.
Edit This Button opens the shrinkwrap mesh in Actran VI. Please note that for
mesh modifications, an Actran VI license is necessary, the "Actran Entry
for Adams" license is not sufficient for this option.
Status This button displays the current status of the meshes in the info window.
Results Content
Output Format Defines the output format of the results. Images, ascii-format and both
can be chosen.
Overall Acoustic Pressure (3D Plots the time dependent results of each microphone in a waterfall
Plots) diagram.
Acoustic Pressure at Creates the acoustic pressure results for each microphone defined in
microphone(s) Microphone for Post on the Far Field tab.
Audio File Creates a wave-file for each microphone defined in Microphone for Post
on the Far Field tab.
48 Adams Acoustics
Actran Analysis Submission
Results Content
SPL over time at Creates the Sound Pressure Level (SPL) per time period in a time
microphone(s) dependent plot.
Refreshing Rate The time period (in seconds) over which the Sound Pressure Level SPL is
integrated.
SPL output in dBA Applies the A weighting function to acoustic results expressed in dB.
2n
w n = 0.5 – 0.5 cos -------------- 0 n M – 1
M – 1
sample points, M the quantity of sample points in the window and w the
window function
Time Interval Defines the length of each time interval where the DFT is applied
Overlap of Time Interval Defines the percentage of the overlap of the subsequent time interval.
Start Frequency Defines the first computed frequency in the DFT. Default value is
defined by the period of the time interval
End Frequency Defines the last frequency to be computed during the DFT. Note that the
time step length influences the maximal frequency that can be computed,
through the Nyquist criterion.
Environment Tab
The Environment tab defines the properties of ambient fluid surrounding the structure.
Dialog Box - F1 Help 49
Actran Analysis Submission
Environment
Acoustic Environment Allows to automatically define the properties of the Air at a given
temperature. Following properties are influenced by the temperature
defined.
Speed of Sound The speed of sound is the distance travelled per unit of time by a sound
wave propagating through an elastic medium (m/sec)
Fluid Density The mass of the fluid per unit volume (kg/m*3)
Far Field
Order of Infinite Elements Defines the number of interpolation points for each infinite element,
which is used to model nonreflecting boundary conditions and the
acoustic radiation outside of the finite element mesh. Default value is 10.
Microphone Table File Defines the position of the microphones; the default position is based on
the ISO3744 and can be found in the installation folder
"<top_dir>\acoustics\examples\ISO3744_meter.mic"
Radius of Infinite Elements Defines the coordinate system of the infinite elements.
Center of Infinite Elements Defines the location of the center of the infinite elements.
Scale Factor Microphones Scales the coordinates of the microphone positions.
Show Microphones This button is enabled after the acoustic mesh is generated and displays
all the microphones available as yellow or red spheres (the red ones
indicate microphones selected for extra post-processing results).
Microphone for post Select the microphones used for additional post-processing output; the
button "All" will select all microphones.
Overwrite defaultss Radius of Infinite Elements, Center of Infinite Elements and Scale Factor
for Microphones all have automatic defaults. This "Overwrite defaults"
button allows users to change those inputs. For instance the, user can
change the distance of the microphones from structure by modifying the
scaling factor for microphones.
Analysis Setup
Gap Tolerance Defines the tolerance parameter to couple the shrinkwrap with the
structural acoustic surfaces. Default value is twice the distance specified
in Mesh tab, which can be used in other cases as well. If distance is 0.0,
Gap Tolerance is set to 0.01 m.
Output Map Allows the user to create an acoustic 3D map in time domain. Please note
that to open the map in Actran VI the license for Actran VI is needed, the
"Actran Entry for Adams" license is not sufficient. Note that asking for
maps may increase computational time significantly. Default value is
'No'.
Output Map Steps Specifies the time steps of the output map. Please note that an output
map can demand a lot of hard drive space thus removing steps from the
output could be important. Maps are output at each time step for
value=1, every two steps for value=2 and so on.
Memory Memory dedicated to the calculation. Quantity depends on the size of the
acoustic mesh. Unit is MB.
Common Setup
Structural mesh
Modes in MNF format
OK Starts the acoustic simulation and closes the dialog
Apply Starts the acoustic simulation and keeps the dialog open
Cancel Closes the dialog
52 Adams Acoustics
Actran Analysis Submission, Frequency Domain
Advanced Setup
Mesh Tab
The Mesh Tab allows creation of the acoustic mesh utilized for the acoustic radiation of the vibrating
structure. The inputs are described below. See the Mesh section of the Appendix for more details.
Default value: 4
Distance from Structure Defines the distance of the shrinkwrap to the structure.
0.0 to 1 cm are good choices depending on the size and complexity of the
structure. Default value is 0.0
Fill hole size (% of structure Defines which holes will be filled by the automatic mesh generation
size) algorithm. Please note that if all holes are not filled, the shrinkwrap might
enter inside the structure. This should be absolutely avoided. See Edit
button for checking the shrinkwrap.
Select This button opens an additional dialog box (see below) to select acoustic
mesh files individually.
Results Content
Output Format Defines the output format of the results. Images, ascii-format and both
can be chosen.
SPL over time at Creates the Sound Pressure Level (SPL) per time period in a time
microphone(s) dependent plot.
SPL output in dBA Applies the A weighting function to acoustic results expressed in dB.
2n
w n = 0.5 – 0.5 cos -------------- 0 n M – 1
M – 1
sample points, M the quantity of sample points in the window and w the
window function
Time Interval Defines the length of each time interval where the DFT is applied
Overlap of Time Interval Defines the percentage of the overlap of the subsequent time interval.
Frequency range Defines the frequencies of the Frequency domain calculation:
(Start/Step/End)
Start/Step: These frequencies define the first computed
frequency and the frequency step. Default values are defined by
the period of the time interval (see the Discrete Fourier Transform
(DFT) section in the Appendix).
End: This frequency defines the last frequency to be computed.
Note that the time step length influences the maximal frequency
that can be computed, through the Nyquist criterion.
Number of Radiation Defines the number of frequencies used for the first step (Radiation) of
frequencies for Green analysis the Green analysis. Default value is 4. More frequencies may be required
for better accuracy when dealing with complex geometries.
Number of bands for adaptive Defines the number of frequency ranges used for the adaptive mesh.
volume mesh Default value: 6
Use Hexa mesh Activates the usage of hexahedral elements in the volume mesh. If the
volume mesh generation fails, try de-activating this option. Default:
activated.
Relative thickness for adaptive Defines the thickness of the PML for each frequency band. The value
PML provided corresponds to the number of acoustic wavelengths at the lower
limit of each frequency band. Default value: 1
Environment Tab
The Environment tab defines the properties of ambient fluid surrounding the structure.
Dialog Box - F1 Help 55
Actran Analysis Submission, Frequency Domain
Environment
Acoustic Environment Allows to automatically define the properties of the Air at a given
temperature. Following properties are influenced by the temperature
defined.
Speed of Sound The speed of sound is the distance travelled per unit of time by a sound
wave propagating through an elastic medium (m/sec)
Fluid Density The mass of the fluid per unit volume (kg/m*3)
Far Field
Order of Infinite Elements Defines the number of interpolation points for each infinite element,
which is used to model nonreflecting boundary conditions and the
acoustic radiation outside of the finite element mesh. Default value is 10.
Microphone Table File Defines the position of the microphones; the default position is based on
the ISO3744 and can be found in the installation folder
"<top_dir>\acoustics\examples\ISO3744_meter.mic"
Translation Center of Defines the center location of the microphones. Default value: center of
Microphones gravity of the flexible body.
Scale Factor Microphones Scales the coordinates of the microphone positions.
Microphone for post Select the microphones used for additional post-processing output; the
button "All" will select all microphones.
Show Microphones This button is enabled after the acoustic mesh is generated and displays
all the microphones available as yellow or red spheres (the red ones
indicate microphones selected for extra post-processing results).
Overwrite defaultss Radius of Infinite Elements, Center of Infinite Elements and Scale Factor
for Microphones all have automatic defaults. This "Overwrite defaults"
button allows users to change those inputs. For instance the, user can
change the distance of the microphones from structure by modifying the
scaling factor for microphones.
Analysis Setup
Gap Tolerance Defines the tolerance parameter to couple the shrinkwrap with the
structural acoustic surfaces. Default value is twice the distance specified
in Mesh tab, which can be used in other cases as well. If distance is 0.0,
Gap Tolerance is set to 0.01 m.
Output Map Allows the user to create an acoustic 3D map in time domain. Please note
that to open the map in Actran VI the license for Actran VI is needed, the
"Actran Entry for Adams" license is not sufficient. Note that asking for
maps may increase computational time significantly. Default value is
'No'.
Output Map Steps Specifies the time steps of the output map. Please note that an output
map can demand a lot of hard drive space thus removing steps from the
output could be important. Maps are output at each time step for
value=1, every two steps for value=2 and so on.
Memory Memory dedicated to the calculation. Quantity depends on the size of the
acoustic mesh. Unit is MB.
Note: Tip for getting good audible .wav file: The quality of the DFT
can be reassured with the Nyquist criteria, fmax = 1/(2 t),
with t the time step and fmax the maximal computed
frequency for the DFT. However, for an audio file of high
quality the Nyquist criteria is not sufficient. It is suggested to
have 5 to 20 times more time steps for the same maximal
frequency, thus 1/(20 t).
Manual Import This is primarily for users wanting to generate plots for acoustic
simulations from the preceding "Adams2Actran" toolkit form MSC
Services. It can also be used, though, as a means to generate plots from
acoustic simulations not currently in session. Click this button to browse
for an .a2ac file corresponding to an acoustics analysis.
Ok/Apply This will launch automated plotting of the selected acoustics analysis.
The automated plots that get generated are described in the following
sections.
Cancel Click to close the dbox.
58 Adams Acoustics
Generate Acoustic Analysis Plots
Appendix 59
Adams Simulation
Appendix
Adams Simulation
Mesh
Maximum Frequency
The maximum frequency depends on the time step size t . The maximal frequency f max is computed
with f max = 1 2t , the Nyquist criterion.
Shrinkwrap Mesh
The shrinkwrap mesh is the mesh surrounding the structure without sharing the nodes with the structural
mesh. The shrinkwrap of the tuning fork (from the Getting Started Using Adams Acoustics tutorial) surrounds the
fork entirely (grey surface), as shown:
Fill Holes
In cases where the surface of the flexible body is not entirely closed, the shrinkwrap will not create a surface
around the structure but will enter inside the opening. If the shrinkwrap enters in the structure, the result of
the acoustic radiation will be wrong. Thus, this must be avoided. Therefore, the fill holes feature is
automatically executed prior to the automatic meshing. The button "Edit" in the mesh tab opens Actran VI
and loads the Shrinkwrap surface. This allows users to check whether the shrinkwrap enters in the flexible
body. Please note that for the "Edit" button to work an Actran VI license is needed, an "Adams Entry License
for Actran" is not sufficient.
62 Adams Acoustics
Discrete Fourier Transform (DFT)
Overlap
Overlap is the percentage intersection of each subsequent time window. Thus when a nonzero overlapping is
defined, the number of time windows will increase.
Minimum frequency is set by default equal to the inverse of the time interval used for DFT purpose: f min
= 1/t
Far Field
Microphones
By default, the microphone list of the ISO3744 is used. A custom microphone list can be written, in a simple
text file, each line contains the id of the microphone followed by its coordinates, with e.g.
# this is a comment
1 -0.990 0.15
2 0.5 -0.86 0.15
Lines with comments have to start with #. The path to the new microphone file has to be given in the Far
Field tab.
Appendix 63
Analysis set-up
Grey Values
An important value to be changed is the scaling factor which scales the coordinates of the microphone by the
given factor. If "1" is entered, no scaling is used.
Analysis set-up
Gap Tolerance
By default the Gap tolerance is twice the Distance defined in the Mesh tab. The Gap tolerance takes care that
the coupling between the shrinkwrap and the structure surface is accurate. As rule of thumb twice the distance
between the structure surface and the shrinkwrap can be used. The coupling quality can be evaluated in
Actran VI, please do the Advanced Tuning Fork tutorial in the Getting Started Using Adams Acoustics guide to see
how mapping can be tested in Actran VI, or contact the Actran support, [email protected] for further
information. Please note that an Actran VI license is necessary to do the visualization of the coupling quality,
the Actran entry for Adams License is not sufficient.
Output Map
An output map is a 3D visualization of the acoustic mesh for each computed time step. The "Output Map
Step" defines at which time step the results are output in the map. A value of "2" skips every 2nd step, "3"
outputs the result at every 3rd step and so on.
64 Adams Acoustics
Multiple Flexible Bodies
Output map image from the tuning fork tutorial in the Getting Started with Adams Acoustics Guide.
Important: Actran VI license is necessary to visualize of the output map, the "Actran Entry for
Adams License" is not sufficient.
Computational Time
Some suggestions to reduce the computational time of an acoustics analysis:
Reduce the order of infinite elements to a minimum (for example, 5). Be sure to check that the
results are not changing due to this.
Reduce the size of the acoustic mesh to a minimum
Appendix 65
Multiple Flexible Bodies