.. _calculations_decibel:

Decibel Calculation Service
===========================

CalcDecibelService gives access to the DECIBEL module.
It only contains two function, ``CalcDecibelService.GetDecibelCalc(Handle)`` for getting a decibel calculation and
``CalcDecibelService.SetDecibelCalc(Calc_decibel)`` for passing it back to windPRO.
The decibel calculation object can be modified and passed back to windPRO.
With the general calculation service data and reports can be extracted from the decibel calculations.

Many options for noice calculations are controlled by the Noise Sensitive Area (NSA) object.
Check out the :ref:`objects_nsa` to learn more about using this feature.

.. list-table:: DecibelCalcType and corresponding names in windPRO
    :widths: 25 25
    :header-rows: 1

    * - Name
      - Integer
    * - Danish 2007
      - 10
    * - Danish 2011 and 2015
      - 16
    * - Danish 2019
      - 23
    * - Danish Codes
      - 0
    * - Danish Low frequency 2011 and 2015
      - 13
    * - Danish low frequency
      - 24
    * - Dutch 2011
      - 15
    * - Dutch 1999
      - 7
    * - Finland low frequency
      - 19
    * - German Codes VDI 2714 (outdated)
      - 1
    * - IL-HR-13-01 (Netherlands)
      - 3
    * - ISO 9613-2 Finland
      - 18
    * - ISO 9613-2 France
      - 11
    * - ISO 9613-2 General
      - 9
    * - ISO 9613-2 German (Interimsverfahren)
      - 22
    * - ISO 9613-2 Germany
      - 2
    * - ISO 9613-2 Norway (Outdated)
      - 12
    * - ISO 9613-2 Poland
      - 17
    * - ISO 9613-2 United Kingdom
      - 8
    * - Norwegian 2012
      - 20
    * - Old Swedish codes
      - 4
    * - Swedish 2009
      - 14
    * - Swedish, Jan 2002, Land
      - 5
    * - Swedish, Jan 2002, Water
      - 6

Properties of the calculation object can be found here :ref:`TApiCalcDecibel <TApiCalcDecibel>`.
Find below and example that gets data from a decibel calculation and exports the data (also including ZVI and shadow flickr calculations).

.. literalinclude:: ../../../python/examples/fromDocs/calculations/decibel_shadow_zvi_calculation.py