SUAVE  2.5.2
An Aerospace Vehicle Environment for Designing Future Aircraft
Noise Tools

Various functions that are used to calculate noise using the fidelity one level. More...

Functions

def SUAVE.Methods.Noise.Fidelity_One.Noise_Tools.atmospheric_attenuation.atmospheric_attenuation (dist)
 
def SUAVE.Methods.Noise.Fidelity_One.Noise_Tools.compute_noise.compute_noise (config, analyses, noise_segment, noise_settings)
 
def SUAVE.Methods.Noise.Fidelity_One.Noise_Tools.compute_noise_evaluation_locations.compute_ground_noise_evaluation_locations (settings, segment)
 
def SUAVE.Methods.Noise.Fidelity_One.Noise_Tools.compute_noise_evaluation_locations.compute_building_noise_evaluation_locations (settings, segment)
 
def SUAVE.Methods.Noise.Fidelity_One.Noise_Tools.dbA_noise.dbA_noise (SPL)
 
def SUAVE.Methods.Noise.Fidelity_One.Noise_Tools.decibel_arithmetic.pressure_ratio_to_SPL_arithmetic (p_pref_total)
 
def SUAVE.Methods.Noise.Fidelity_One.Noise_Tools.decibel_arithmetic.SPL_arithmetic (SPL, sum_axis=2)
 
def SUAVE.Methods.Noise.Fidelity_One.Noise_Tools.decibel_arithmetic.SPL_spectra_arithmetic (SPL)
 
def SUAVE.Methods.Noise.Fidelity_One.Noise_Tools.epnl_noise.epnl_noise (PNLT)
 
def SUAVE.Methods.Noise.Fidelity_One.Noise_Tools.generate_microphone_points.generate_ground_microphone_points (min_x, max_x, min_y, max_y, N_x, N_y)
 
def SUAVE.Methods.Noise.Fidelity_One.Noise_Tools.generate_microphone_points.generate_building_microphone_points (building_locations, building_dimensions, N_x, N_y, N_z)
 
def SUAVE.Methods.Noise.Fidelity_One.Noise_Tools.noise_certification_limits.noise_certification_limits (results, vehicle)
 
def SUAVE.Methods.Noise.Fidelity_One.Noise_Tools.noise_geometric.noise_geometric (noise_segment, analyses, config)
 
def SUAVE.Methods.Noise.Fidelity_One.Noise_Tools.noise_tone_correction.noise_tone_correction (SPL)
 
def SUAVE.Methods.Noise.Fidelity_One.Noise_Tools.pnl_noise.pnl_noise (SPL)
 
def SUAVE.Methods.Noise.Fidelity_One.Noise_Tools.print_airframe_output.print_airframe_output (SAE_Airframe_Noise_Outputs)
 
def SUAVE.Methods.Noise.Fidelity_One.Noise_Tools.print_engine_output.print_engine_output (SAE_Engine_Noise_Outputs)
 
def SUAVE.Methods.Noise.Fidelity_One.Noise_Tools.print_propeller_output.print_propeller_output (speed, nsteps, time, altitude, RPM, theta, dist, PNL, PNL_dBA)
 
def SUAVE.Methods.Noise.Fidelity_One.Noise_Tools.senel_noise.senel_noise (SPLt_dBA_max)
 
def SUAVE.Methods.Noise.Fidelity_One.Noise_Tools.SPL_harmonic_to_third_octave.SPL_harmonic_to_third_octave (SPL, f, settings)
 
def SUAVE.Methods.Noise.Fidelity_One.Propeller.compute_source_coordinates.compute_blade_section_source_coordinates (AoA, acoustic_outputs, rotors, mls, settings)
 

Detailed Description

Various functions that are used to calculate noise using the fidelity one level.

Function Documentation

◆ atmospheric_attenuation()

def SUAVE.Methods.Noise.Fidelity_One.Noise_Tools.atmospheric_attenuation.atmospheric_attenuation (   dist)
This calculates a the atmospheric attenuation of sound for each frequency band
as a function of the distance from the source to the observer. 

Assumptions:
   N/A

Source:
   SAE Model for a standard day.
    
Inputs:
    dist - Array with the distance vector from the aircraft (source) to the 
        microphone position (observer)                                              [m]

Outputs: 
    delta_spl - The delta sound pressure level to be reduced from the lossless SPL 
    condition                                                                       [dB]

Properties Used:
    None 

◆ compute_blade_section_source_coordinates()

def SUAVE.Methods.Noise.Fidelity_One.Propeller.compute_source_coordinates.compute_blade_section_source_coordinates (   AoA,
  acoustic_outputs,
  rotors,
  mls,
  settings 
)
This calculated the position vector from a point source to the observer 
        
Assumptions:
    N/A
 
Source:
    N/A  
 
Inputs:  
    AoA                            - aircraft angle ofattack                     [rad]
    acoustic_outputs               - outputs from propeller aerodynamic analysis [None]   
    mls                            - microphone locations                        [m]   
    rotors                         - rotors on network                           [None]  
    settings                       - noise calculation settings                  [None]
 
Outputs: 
    blade_section_position_vectors - position vector of rotor blade sections     [m]
 
Properties Used:
    N/A       

◆ compute_building_noise_evaluation_locations()

def SUAVE.Methods.Noise.Fidelity_One.Noise_Tools.compute_noise_evaluation_locations.compute_building_noise_evaluation_locations (   settings,
  segment 
)
This computes the relative locations on the surface in the computational domain where the 
propogated sound is computed.   
        
Assumptions: 
    Acoustic scattering is not modeled

Source:
    N/A  

Inputs:  
    settings.urban_canyon_microphone_locations          - array of microphone locations on a building(s)  [meters] 
    segment.conditions.frames.inertial.position_vector  - position of aircraft                            [boolean]                                     

Outputs: 
BM_THETA   - angle measured from building microphone in the x-z plane from microphone to aircraft 
BM_PHI     - angle measured from building microphone in the y-z plane from microphone to aircraft 
UCML       - building microphone locations
num_b_mic  - number of building microphones

Properties Used:
    N/A       

◆ compute_ground_noise_evaluation_locations()

def SUAVE.Methods.Noise.Fidelity_One.Noise_Tools.compute_noise_evaluation_locations.compute_ground_noise_evaluation_locations (   settings,
  segment 
)
This computes the relative locations on the surface in the computational domain where the 
propogated sound is computed. Vectors point from observer/microphone to aircraft/source  
        
Assumptions: 
    Acoustic scattering is not modeled

Source:
    N/A  

Inputs:  
    settings.ground_microphone_locations                - array of microphone locations on the ground  [meters] 
    segment.conditions.frames.inertial.position_vector  - position of aircraft                         [boolean]                                          

Outputs: 
GM_THETA   - angle measured from ground microphone in the x-z plane from microphone to aircraft 
GM_PHI     - angle measured from ground microphone in the y-z plane from microphone to aircraft 
GML        - ground microphone locations
num_gm_mic - number of ground microphones
 
Properties Used:
    N/A       

◆ compute_noise()

def SUAVE.Methods.Noise.Fidelity_One.Noise_Tools.compute_noise.compute_noise (   config,
  analyses,
  noise_segment,
  noise_settings 
)
This method computes the noise of a turbofan aircraft
        
Assumptions:
    N/A

Source:
    N/A 

Inputs:
    config.
    networks.turbofan     - SUAVE turbofan data structure               [None]
    output_file           - flag to write noise outout to file          [Boolean]
    output_file_engine    - flag to write engine outout to file         [Boolean]
    print_output          - flag to print outout to file                [Boolean]
    engine_flag           - flag to include engine in noise calculation [Boolean]
    
Outputs: 
    noise_sum                                                           [dB]

Properties Used:
    N/A 

◆ dbA_noise()

def SUAVE.Methods.Noise.Fidelity_One.Noise_Tools.dbA_noise.dbA_noise (   SPL)
This method calculates the A-weighted level from a 1/3 octave band noise spectra 
        
Assumptions:
    N/A

Source:
    N/A 

Inputs:
    SPL     - Sound Pressure Level in 1/3 octave band

Outputs: [dB]
    SPL_dbA - A-weighted Sound Pressure Level in dBA 

Properties Used:
    N/A 

◆ epnl_noise()

def SUAVE.Methods.Noise.Fidelity_One.Noise_Tools.epnl_noise.epnl_noise (   PNLT)
This method calculates de effective perceived noise level (EPNL) based on a
time history Perceived Noise Level with Tone Correction (PNLT).
 
Assumptions:
    N/A

Source:
    N/A

Inputs:
    PNLT - Perceived Noise Level with Tone Correction  [PNLdB]
 
 Outputs:
    EPNL - Effective Perceived Noise Level in          [EPNdB]
 
Properties Used:
    N/A  

◆ generate_building_microphone_points()

def SUAVE.Methods.Noise.Fidelity_One.Noise_Tools.generate_microphone_points.generate_building_microphone_points (   building_locations,
  building_dimensions,
  N_x,
  N_y,
  N_z 
)
This computes the absolute microphone/observer locations on the surface of rectilinear buildinsg. 
        
Assumptions:
    Microhpone locations are uniformly distributed on the surface

Source:
    N/A  

Inputs:  
    building_locations             - cartesian coordinates of the base of buildings                [meters]
    building_dimensions            - dimensions of buildings [length,width,height]                 [meters] 
    building_microphone_resolution - resolution of microphone array                                [unitless]
    N_x                            - discretization of points in x dimension on building surface   [meters]
    N_y                            - discretization of points in y dimension on building surface   [meters]
    N_z                            - discretization of points in z dimension on building surface   [meters]
    
Outputs: 
    building_mic_locations         - cartesian coordiates of all microphones defined on buildings  [meters]
                          

Properties Used:
    N/A       

◆ generate_ground_microphone_points()

def SUAVE.Methods.Noise.Fidelity_One.Noise_Tools.generate_microphone_points.generate_ground_microphone_points (   min_x,
  max_x,
  min_y,
  max_y,
  N_x,
  N_y 
)
This computes the absolute microphone/observer locations on level ground. 
        
Assumptions:
    None

Source:
    N/A  

Inputs:   
    min_x - minimum x coordinate of noise evaluation plane [meters]
    max_x - maximum x coordinate of noise evaluation plane [meters]
    min_y - minimum y coordinate of noise evaluation plane [meters]
    max_x - maximim y coordinate of noise evaluation plane [meters]
    N_x   - number of microphones on x-axis 
    N_y   - number of microphones on y-axis 

Outputs: 
    gm_mic_locations   - cartesian coordiates of all microphones defined  [meters] 

Properties Used:
    N/A       

◆ noise_certification_limits()

def SUAVE.Methods.Noise.Fidelity_One.Noise_Tools.noise_certification_limits.noise_certification_limits (   results,
  vehicle 
)
This computes the certification noise limits as a function of the aircraft weight [lbs] 
and number of engines for each segment.

Assumptions:
    None

Source:
    SAE 
    
Inputs:
    vehicle  - SUAVE type vehicle
    results

Outputs: Noise limits in EPNL
    noise_approach_limit  - Approach noise limit as a function of the landing weight, [EPNdB]
    noise_flyover_limit   - Flyover noise limit as a function of the takeoff weight,  [EPNdB]
    noise_sideline_limit  - Sideline noise limit as a function of the takeoff weight, [EPNdB]

Properties Used:
    None

◆ noise_geometric()

def SUAVE.Methods.Noise.Fidelity_One.Noise_Tools.noise_geometric.noise_geometric (   noise_segment,
  analyses,
  config 
)
This computes the geometric parameters for the noise tools: distance and emission angles for 
both polar and azimuthal angles.
 
Assumptions:
    For sideline condition we assume the maximum noise at takeoff occurs at 1000ft from the ground.     
    
Inputs:
    noise_segment    - SUAVE type vehicle                                                             [Unitless]
    analyses                                                                                          [Unitless]
    config                                                                                            [Unitless]
    mic_loc          - ground microphone index                                                        [meters]            

Outputs:
    noise_segment.
       dist  - Distance vector from the aircraft position in relation to the microphone coordinates,     [meters]
       theta - Polar angle emission vector relatively to the aircraft to the microphone coordinates,     [rad]
       phi   - Azimuthal angle emission vector relatively to the aircraft to the microphone coordinates, [rad]

Properties Used:
    None     

◆ noise_tone_correction()

def SUAVE.Methods.Noise.Fidelity_One.Noise_Tools.noise_tone_correction.noise_tone_correction (   SPL)
This method calculates de correction for spectral irregularities by means of
    a correction tone factor
    
Assumptions:
    None

Source:
    None 

Inputs:
    SPL                     - Sound Pressure Level in 1/3 octave band

Outputs: 
    tone_correction_max     - Maximum tone correction for a time history signal 
    
Properties Used:
    N/A     

◆ pnl_noise()

def SUAVE.Methods.Noise.Fidelity_One.Noise_Tools.pnl_noise.pnl_noise (   SPL)
This method calculates de Perceived Noise Level PNL from a 1/3 octave band noise spectra
 
Assumptions:
    None

Source:
    None
 
Inputs:
    SPL - Sound Pressure Level in 1/3 octave band  [dB]
   
Outputs:
    PNL - Perceived Noise Level                    [dB]
   
Properties Used:
    N/A    

◆ pressure_ratio_to_SPL_arithmetic()

def SUAVE.Methods.Noise.Fidelity_One.Noise_Tools.decibel_arithmetic.pressure_ratio_to_SPL_arithmetic (   p_pref_total)
This computes the total SPL given mutiple acoustic pressure ratios 
of one of mutiple sources

Assumptions:
    None

Source:
    None

Inputs:
    Pressure Ratios       [unitless]

Outputs: 
    Sound Pressure Level  [decibel]

Properties Used:
    N/A 

◆ print_airframe_output()

def SUAVE.Methods.Noise.Fidelity_One.Noise_Tools.print_airframe_output.print_airframe_output (   SAE_Airframe_Noise_Outputs)
This prints the airframe noise of a turbofan aircraft

Assumptions:
   N/A

Inputs: 
   SAE_Airframe_Noise_Outputs  - Airframe Noise Data Structure  

Outputs:  
    N/A
    
Properties Used:
    None 

◆ print_engine_output()

def SUAVE.Methods.Noise.Fidelity_One.Noise_Tools.print_engine_output.print_engine_output (   SAE_Engine_Noise_Outputs)
This prints the engine noise of a turbofan aircraft

Assumptions:
   N/A

Inputs: 
   SAE_Engine_Noise_Outputs  - Engine Noise Data Structure  

Outputs:  
    N/A
    
Properties Used:
    None 

◆ print_propeller_output()

def SUAVE.Methods.Noise.Fidelity_One.Noise_Tools.print_propeller_output.print_propeller_output (   speed,
  nsteps,
  time,
  altitude,
  RPM,
  theta,
  dist,
  PNL,
  PNL_dBA 
)
This prints the noise of a propeller aircraft using SAE noise analysis methods

Assumptions:
   N/A

Inputs:
speed     aircraft speed                     [m/s]
nsteps    numer of timesteps                 [unitless]
time      time                               [s]
altitude  aircraft altitude                  [m]
RPM       rpm of propeller                   [unitless]
theta     emission angle                     [rad]
dist      emission distance                  [m]
PNL       perceived noise level              [dB]
PNL_dBA   A -weighted perceived noise level  [dBa]

Outputs:  
    N/A
    
Properties Used:
    None 

◆ senel_noise()

def SUAVE.Methods.Noise.Fidelity_One.Noise_Tools.senel_noise.senel_noise (   SPLt_dBA_max)
This method calculates the effective perceived noise level (EPNL) based on a time history 
Perceived Noise Level with Tone Correction (PNLT).

Assumptions:
    None

Source:
    None  

Inputs:
    PNLT                     - Perceived Noise Level with Tone Correction [Unitless]

Outputs: 
    EPNL                     - Effective Perceived Noise Level            [EPNdB]
    
Properties Used:
    N/A     

◆ SPL_arithmetic()

def SUAVE.Methods.Noise.Fidelity_One.Noise_Tools.decibel_arithmetic.SPL_arithmetic (   SPL,
  sum_axis = 2 
)
This computes the total SPL from multiple sources 
using decibel arithmetic  

Assumptions:
    None

Source:
    None

Inputs:
    SPL  -  Sound Pressure Level        [dB]

Outputs: 
    SPL  -  Sound Pressure Level        [dB]

Properties Used:
    N/A 

◆ SPL_harmonic_to_third_octave()

def SUAVE.Methods.Noise.Fidelity_One.Noise_Tools.SPL_harmonic_to_third_octave.SPL_harmonic_to_third_octave (   SPL,
  f,
  settings 
)
This method converts the SPL spectrum from blade harmonic passing frequency
to thrid octave spectrum

Assumptions:
    N/A

Source: 

Inputs:
    SPL                    - sound pressure level                          [dB] 
    f                      - blade passing spectrum frequencies            [Hz]
    settings.    
        center_frequencies - center frequencies of the 1/3 octave spectrum [dB]  
        lower_frequencies  - lower frequencies of the 1/3 octave spectrum  [dB]
        upper_frequencies  - upper frequencies of the 1/3 octave spectrum  [dB]
    

Outputs:
    SPL_third_octave       - SPL in the 1/3 octave spectrum                [dB] 

Properties Used:
    N/A 

◆ SPL_spectra_arithmetic()

def SUAVE.Methods.Noise.Fidelity_One.Noise_Tools.decibel_arithmetic.SPL_spectra_arithmetic (   SPL)
This computes the total SPL spectra from multiple sources 
using decibel arithmetic  

Assumptions:
    None

Source:
    None

Inputs:
    SPL  -  Sound Pressure Level        [dB]

Outputs: 
    SPL  -  Sound Pressure Level        [dB]

Properties Used:
    N/A