Package org.noise_planet.noisemodelling.propagation

Class AttenuationParameters

java.lang.Object
org.noise_planet.noisemodelling.propagation.AttenuationParameters
public class AttenuationParameters extends Object
Data input for a propagation Path process.
Author:
Pierre Aumond

  • Field Details

    • K_0

      public static final double K_0
      See Also:

    • Pref

      public static final double Pref
      See Also:

    • Kref

      public static final double Kref
      See Also:

    • FmolO

      public static final double FmolO
      See Also:

    • FmolN

      public static final double FmolN
      See Also:

    • KvibO

      public static final double KvibO
      See Also:

    • KvibN

      public static final double KvibN
      See Also:

    • K01

      public static final double K01
      See Also:

    • a8

      public static final double a8

    • freq_lvl

      protected List<Integer> freq_lvl
      Frequency bands values, by third octave

    • freq_lvl_exact

      protected List<Double> freq_lvl_exact

    • freq_lvl_a_weighting

      protected List<Double> freq_lvl_a_weighting

    • DEFAULT_WIND_ROSE

      public static final double[] DEFAULT_WIND_ROSE

    • temperature

      public double temperature
      Temperature in celsius

    • celerity

      public double celerity
      Represents the default speed of sound in air under standard conditions, measured in meters per second. The value is typically used as a constant for computations requiring the speed of sound. Standard conditions assume a temperature of 15°C at sea level atmospheric pressure.

    • humidity

      public double humidity
      Represents the relative humidity in percentage, ranging from 0 to 100. This variable is utilized in various calculations related to atmospheric attenuation and sound propagation.

    • pressure

      public double pressure
      Standard atmosphere atm (Pa)

    • alpha_atmo

      public double[] alpha_atmo

    • defaultOccurrence

      public double defaultOccurrence

    • gDisc

      public boolean gDisc

    • prime2520

      public boolean prime2520

    • windRose

      public double[] windRose
      probability occurrence favourable condition

  • Constructor Details

    • AttenuationParameters

      public AttenuationParameters()

    • AttenuationParameters

      public AttenuationParameters(boolean thirdOctave)

    • AttenuationParameters

      public AttenuationParameters(AttenuationParameters other)
      Copy constructor
      Parameters:
      other -

    • AttenuationParameters

      public AttenuationParameters(List<Integer> freq_lvl, List<Double> freq_lvl_exact, List<Double> freq_lvl_a_weighting)
      Parameters:
      freq_lvl - Frequency values for column names
      freq_lvl_exact - Exact frequency values for computations
      freq_lvl_a_weighting - A weighting values

  • Method Details

    • init

      protected void init()

    • getFrequencies

      public List<Integer> getFrequencies()

    • setFrequencies

      public void setFrequencies(List<Integer> freq_lvl)

    • getFrequenciesExact

      public List<Double> getFrequenciesExact()

    • getFrequenciesAWeighting

      public List<Double> getFrequenciesAWeighting()

    • setHumidity

      public AttenuationParameters setHumidity(double humidity)
      Set relative humidity in percentage.
      Parameters:
      humidity - relative humidity in percentage. 0-100

    • setPressure

      public AttenuationParameters setPressure(double pressure)

    • getWindRose

      public double[] getWindRose()

    • setWindRose

      public void setWindRose(double[] windRose)

    • getTemperature

      public double getTemperature()

    • getCelerity

      public double getCelerity()

    • getHumidity

      public double getHumidity()

    • getPressure

      public double getPressure()

    • isPrime2520

      public boolean isPrime2520()

    • isgDisc

      public boolean isgDisc()

    • setgDisc

      public void setgDisc(boolean gDisc)

    • getDefaultOccurrence

      public double getDefaultOccurrence()
      Returns:
      Default favourable probability (0-1)

    • setDefaultOccurrence

      public void setDefaultOccurrence(double defaultOccurrence)
      Parameters:
      defaultOccurrence - Default favourable probability (0-1)

    • setGDisc

      public AttenuationParameters setGDisc(boolean gDisc)

    • setPrime2520

      public AttenuationParameters setPrime2520(boolean prime2520)

    • setTemperature

      public AttenuationParameters setTemperature(double temperature)
      Parameters:
      temperature - Temperature in ° celsius

    • getAtmoCoeffArray

      public static double[] getAtmoCoeffArray(List<Double> freq_lvl, double temperature, double pressure, double humidity)

    • getAlpha_atmo

      public double[] getAlpha_atmo()
      get the atmospheric attenuation coefficient in dB/km at the nominal centre frequency for each frequency band, in accordance with ISO 9613-1.
      Returns:
      alpha_atmo

    • getRoseIndex

      public static int getRoseIndex(org.locationtech.jts.geom.Coordinate receiver, org.locationtech.jts.geom.Coordinate source)
      get the rose index to search the mean occurrence p of favourable conditions in the direction of the path (S,R):
      Parameters:
      receiver -
      source -
      Returns:
      rose index

    • getRoseIndex

      public static int getRoseIndex(double angle)
      The north slice is the last array index not the first one Ex for slice width of 20°: - The first column 20° contain winds between 10 to 30 ° - The last column 360° contains winds between 350° to 360° and 0 to 10° get the rose index to search the mean occurrence p of favourable conditions in the direction of the angle:
      Returns:
      rose index

    • getCoefAttAtmosCnossos

      public static double getCoefAttAtmosCnossos(double freq, double humidity, double pressure, double T_kel)
      Parameters:
      freq - Frequency (Hz)
      humidity - Humidity %
      pressure - Pressure in pascal
      T_kel - Temperature in kelvin
      Returns:
      Atmospheric absorption dB/km

    • getCoefAttAtmos

      public static double getCoefAttAtmos(double frequency, double humidity, double pressure, double T_kel)
      Compute AAtm
      Parameters:
      frequency - Frequency (Hz)
      humidity - Humidity %
      pressure - Pressure in pascal
      T_kel - Temperature in kelvin
      Returns:
      Atmospheric absorption dB/km

    • getCoefAttAtmosSpps

      public static double getCoefAttAtmosSpps(double frequency, double humidity, double pressure, double tempKelvin)
      This function calculates the atmospheric attenuation coefficient of sound in air ISO 9613-1:1993(F)
      Parameters:
      frequency - acoustic frequency (Hz)
      humidity - relative humidity (in %) (0-100)
      pressure - atmospheric pressure (in Pa)
      tempKelvin - Temperature in Kelvin (in K)
      Returns:
      atmospheric attenuation coefficient (db/km)

    • getAlpha

      public static double getAlpha(double frequency, double temperature, double pressure, double humidity)
      ISO-9613 p1
      Parameters:
      frequency - acoustic frequency (Hz)
      temperature - Temperative in celsius
      pressure - atmospheric pressure (in Pa)
      humidity - relative humidity (in %) (0-100)
      Returns:
      Attenuation coefficient dB/KM

    • writeToDatabase

      public void writeToDatabase(Connection connection, String tableName, String period) throws SQLException
      Writes the attenuation parameters to an H2 database table. If the specified table does not exist, it will create the table. Then it inserts or merges the data into the table for the given period.
      Parameters:
      connection - the database connection to the H2 instance
      tableName - the name of the table in the database
      period - the time period for which the parameters are being saved
      Throws:
      SQLException - if a database access error occurs

    • readFromDatabase

      public static void readFromDatabase(ResultSet rs, Map<String,AttenuationParameters> cnossosParametersPerPeriod) throws SQLException
      Reads attenuation parameters from a database ResultSet and populates a map with these parameters for different periods.
      Parameters:
      rs - the ResultSet object containing the query results with attenuation parameters
      cnossosParametersPerPeriod - a map to store the attenuation parameters indexed by the corresponding period
      Throws:
      SQLException - if a database access error occurs or if the wind rose array length does not match the expected default length

    • convertSqlArrayToDoubleArray

      public static double[] convertSqlArrayToDoubleArray(Array array) throws SQLException
      Converts a java.sql.Array to a double[] array.
      Parameters:
      array - the SQL Array containing double values
      Returns:
      a double[] array or an empty array if the input is null
      Throws:
      SQLException - if a database access error occurs