.. DO NOT UPDATE THIS FILE!! .. This document has been automatically generated with noisemodelling-scripts/src/main/java/org/noise_planet/noisemodelling/webserver/script/GenerateFunctionsDocs.java Noise level from traffic ======================== Compute noise level directly from road traffic data Overview -------- ➑️ Computes Noise map from each period from the traffic flow rate and speed estimates (specific format, see input details). 🌍 Tables must be projected in a metric coordinate system (SRID). Use "Change_SRID" WPS Block if needed. βœ… The output table is RECEIVERS_LEVEL The output tables contain: * IDRECEIVER: an identifier (INTEGER, PRIMARY KEY) * IDSOURCE: an identifier of the source (INTEGER) if keepSource is true * THE_GEOM : the 3D geometry of the receivers (POINT) * PERIOD : time period ex. D, E, N, DEN (Varchar) * Lw63, Lw125, Lw250, Lw500, Lw1000, Lw2000, Lw4000, Lw8000, Laeq, Leq: noise level at receiver (REAL) Arguments --------- Mandatory inputs ~~~~~~~~~~~~~~~~ ``tableBuilding`` β€” *Buildings table name* 🏠 Name of the Buildings table The table must contain: * THE_GEOM : the 2D geometry of the building (POLYGON or MULTIPOLYGON) * HEIGHT : the height of the building (FLOAT) Type: ``String`` ``tableReceivers`` β€” *Receivers table name* Name of the Receivers table The table must contain: * PK : an identifier. It shall be a primary key (INTEGER, PRIMARY KEY) * THE_GEOM : the 3D geometry of the sources (POINT, MULTIPOINT) πŸ’‘ This table can be generated from the WPS Blocks in the "Receivers" folder Type: ``String`` ``tableRoads`` β€” *Roads table name* πŸ›£ Name of the Roads table, traffic can be provided here but are limited to DAY EVENING NIGHT periods This function recognize the following columns (* mandatory): * PK * : an identifier. It shall be a primary key (INTEGER, PRIMARY KEY) * LV_D TV_E TV_N : Hourly average light vehicle count (6-18h)(18-22h)(22-6h) (DOUBLE) * MV_D MV_E MV_N : Hourly average medium heavy vehicles, delivery vans > 3.5 tons, buses, touring cars, etc. with two axles and twin tyre mounting on rear axle count (6-18h)(18-22h)(22-6h) (DOUBLE) * HGV_D HGV_E HGV_N : Hourly average heavy duty vehicles, touring cars, buses, with three or more axles (6-18h)(18-22h)(22-6h) (DOUBLE) * WAV_D WAV_E WAV_N : Hourly average mopeds, tricycles or quads ≀ 50 cc count (6-18h)(18-22h)(22-6h) (DOUBLE) * WBV_D WBV_E WBV_N : Hourly average motorcycles, tricycles or quads > 50 cc count (6-18h)(18-22h)(22-6h) (DOUBLE) * LV_SPD_D LV_SPD_E LV_SPD_N : Hourly average light vehicle speed (6-18h)(18-22h)(22-6h) (DOUBLE) * MV_SPD_D MV_SPD_E MV_SPD_N : Hourly average medium heavy vehicles speed (6-18h)(18-22h)(22-6h) (DOUBLE) * HGV_SPD_D HGV_SPD_E HGV_SPD_N : Hourly average heavy duty vehicles speed (6-18h)(18-22h)(22-6h) (DOUBLE) * WAV_SPD_D WAV_SPD_E WAV_SPD_N : Hourly average mopeds, tricycles or quads ≀ 50 cc speed (6-18h)(18-22h)(22-6h) (DOUBLE) * WBV_SPD_D WBV_SPD_E WBV_SPD_N : Hourly average motorcycles, tricycles or quads > 50 cc speed (6-18h)(18-22h)(22-6h) (DOUBLE) * PVMT : CNOSSOS road pavement identifier (ex: NL05)(default NL08) (VARCHAR) * TEMP_D TEMP_E TEMP_N : Average day, evening, night temperature (default 20℃) (6-18h)(18-22h)(22-6h)(DOUBLE) * TS_STUD : A limited period Ts (in months) over the year where a average proportion pm of light vehicles are equipped with studded tyres (0-12) (DOUBLE) * PM_STUD : Average proportion of vehicles equipped with studded tyres during TS_STUD period (0-1) (DOUBLE) * JUNC_DIST : Distance to junction in meters (DOUBLE) * JUNC_TYPE : Type of junction (k=0 none, k = 1 for a crossing with traffic lights ; k = 2 for a roundabout) (INTEGER) * SLOPE : Slope (in %) of the road section. If the field is not filled in, the LINESTRING z-values will be used to calculate the slope and the traffic direction (way field) will be force to 3 (bidirectional). (DOUBLE) * WAY : Define the way of the road section. 1 = one way road section and the traffic goes in the same way that the slope definition you have used, 2 = one way road section and the traffic goes in the inverse way that the slope definition you have used, 3 = bi-directional traffic flow, the flow is split into two components and correct half for uphill and half for downhill (INTEGER) πŸ’‘ This table can be generated from the WPS Block "Import_OSM" Type: ``String`` Optional inputs ~~~~~~~~~~~~~~~ ``coefficientVersion`` β€” *Coefficient version* 🌧 Cnossos coefficient version (1 = 2015, 2 = 2020) Type: ``Integer`` Default: ``2`` ``confDiffHorizontal`` β€” *Diffraction on horizontal edges* Compute or not the diffraction on horizontal edges Type: ``Boolean`` Default: ``false`` ``confDiffVertical`` β€” *Diffraction on vertical edges* Compute or not the diffraction on vertical edges. Following Directive 2015/996, enable this option for rail and industrial sources only Type: ``Boolean`` Default: ``false`` ``confExportSourceId`` β€” *Separate receiver level by source identifier* Keep source identifier in output in order to get noise contribution of each noise source. When only the source geometry is given, the attenuation between each pair of "source-receiver" points is specified (commonly referred to as the "attenuation matrix") Type: ``Boolean`` Default: ``false`` ``confFavourableOccurrencesDefault`` β€” *Probability of occurrences* Comma-delimited string containing the probability ([0,1]) of occurrences of favourable propagation conditions. Follow the clockwise direction. The north slice is the last array index (nΒ°16 in the schema below) not the first one .. figure:: acoustics_parameters_confFavorableOccurrences.png :align: center :alt: Noise level from traffic Type: ``String`` Default: ``0.5, 0.5, 0.5, 0.5, 0.5, 0.5, 0.5, 0.5, 0.5, 0.5, 0.5, 0.5, 0.5, 0.5, 0.5, 0.5`` ``confHumidity`` β€” *Relative humidity* 🌧 Humidity for noise propagation (%) [0,100] Type: ``Double`` Default: ``70`` ``confMaxError`` β€” *Max Error (dB)* Threshold for excluding negligible sound sources in calculations.This parameter is ignored if no emission level is specified or if you set it to 0 dB. This parameter have a great impact on computation time. Type: ``Double`` Default: ``0.1`` ``confMaxReflDist`` β€” *Maximum source-reflexion distance* Maximum search distance of walls / facades from the "Source-Receiver" segment, for the calculation of specular reflections (meters). .. figure:: acoustics_parameters_confMaxReflDist.png :align: center :alt: Noise level from traffic Type: ``Double`` Default: ``50`` ``confMaxSrcDist`` β€” *Maximum source-receiver distance* Maximum distance between source and receiver (FLOAT, in meters). .. figure:: acoustics_parameters_confMaxSrcDist.png :align: center :alt: Noise level from traffic Type: ``Double`` Default: ``150`` ``confMinWallReflDist`` β€” *Ignore close reflections* Optional maximum receiver-to-wall distance (meters) below which reflection cut profiles are ignored. With regard to the population’s exposure to noise, it is recommended that the contribution due to reflection off the faΓ§ade wall of the building where the resident lives should be disregarded. If you have placed the receivers 0.1 m from the faΓ§ades, you can set this parameter to 0.2 m. This offset is set to ensure that the contribution from the nearby wall is ignored. Use 0 to keep all reflections. Type: ``Double`` Default: ``0`` ``confRaysName`` β€” *Export scene* Save each mnt, buildings and propagation rays into the specified table (ex:RAYS) or file URL (ex: file:///Z:/dir/map.kml) You can set a table name here in order to save all the rays computed by NoiseModelling. The number of rays has been limited in this script in order to avoid memory exception. πŸ›  Type: ``String`` ``confReflOrder`` β€” *Order of reflexion* Maximum number of reflections to be taken into account (INTEGER). 🚨 Adding 1 order of reflexion can significantly increase the processing time Type: ``Integer`` Default: ``1`` ``confTemperature`` β€” *Air temperature* 🌑 Air temperature (Β°C) Type: ``Double`` Default: ``15`` ``confThreadNumber`` β€” *Thread number* Number of thread to use on the computer (INTEGER). πŸ›  Type: ``Integer`` Default: ``0`` ``frequencyFieldPrepend`` β€” *Frequency field name* Frequency field name prepend. Ex. for 1000 Hz frequency the default column name is HZ1000 Type: ``String`` Default: ``HZ`` ``paramWallAlpha`` β€” *Wall absorption coefficient* Wall absorption coefficient [0,1] (between ``0`` : "fully reflective" and ``1`` : "fully absorbent")πŸ›  Type: ``Double`` ``tableDEM`` β€” *DEM table name* Name of the Digital Elevation Model (DEM) table The table must contain: * THE_GEOM : the 3D geometry of the sources (POINT, MULTIPOINT). πŸ’‘ This table can be generated from the WPS Block "Import_Asc_File" Type: ``String`` ``tableGroundAbs`` β€” *Ground absorption table name* Name of the surface/ground acoustic absorption table The table must contain: * THE_GEOM : the 2D geometry of the sources (POLYGON or MULTIPOLYGON) * G : the acoustic absorption of a ground (FLOAT between 0 : very hard and 1 : very soft) Type: ``String`` ``tablePeriodAtmosphericSettings`` β€” *Atmospheric settings table name for each time period* Name of the Atmospheric settings table The table must contain the following columns: * PERIOD : time period (VARCHAR PRIMARY KEY) * WINDROSE : probability of occurrences of favourable propagation conditions (ARRAY(16)) * TEMPERATURE : Temperature in celsius (FLOAT) * PRESSURE : air pressure in pascal (FLOAT) * HUMIDITY : air humidity in percentage (FLOAT) * GDISC : choose between accept G discontinuity or not (BOOLEAN) default true * PRIME2520 : choose to use prime values to compute eq. 2.5.20 (BOOLEAN) default false Type: ``String`` ``tableRoadsTraffic`` β€” *Roads traffic table name* πŸ›£ Name of the Roads traffic table per period This function recognize the following columns (* mandatory): * IDSOURCE * : an identifier. It shall be linked to the primary key of tableRoads (INTEGER) * PERIOD * : Time period, you will find this column on the output (VARCHAR) * LV : Hourly average light vehicle count (DOUBLE) * MV : Hourly average medium heavy vehicles, delivery vans > 3.5 tons, buses, touring cars, etc. with two axles and twin tyre mounting on rear axle count (DOUBLE) * HGV : Hourly average heavy duty vehicles, touring cars, buses, with three or more axles (DOUBLE) * WAV : Hourly average mopeds, tricycles or quads ≀ 50 cc count (DOUBLE) * WBV : Hourly average motorcycles, tricycles or quads > 50 cc count (DOUBLE) * LV_SPD : Hourly average light vehicle speed (DOUBLE) * MV_SPD : Hourly average medium heavy vehicles speed (DOUBLE) * HGV_SPD : Hourly average heavy duty vehicles speed (DOUBLE) * WAV_SPD : Hourly average mopeds, tricycles or quads ≀ 50 cc speed (DOUBLE) * WBV_SPD : Hourly average motorcycles, tricycles or quads > 50 cc speed (DOUBLE) * PVMT : CNOSSOS road pavement identifier (ex: NL05)(default NL08) (VARCHAR) * TS_STUD : A limited period Ts (in months) over the year where a average proportion pm of light vehicles are equipped with studded tyres (0-12) (DOUBLE) * PM_STUD : Average proportion of vehicles equipped with studded tyres during TS_STUD period (0-1) (DOUBLE) * JUNC_DIST : Distance to junction in meters (DOUBLE) * JUNC_TYPE : Type of junction (k=0 none, k = 1 for a crossing with traffic lights ; k = 2 for a roundabout) (INTEGER) * SLOPE : Slope (in %) of the road section. If the field is not filled in, the LINESTRING z-values will be used to calculate the slope and the traffic direction (way field) will be force to 3 (bidirectional). (DOUBLE) * WAY : Define the way of the road section. 1 = one way road section and the traffic goes in the same way that the slope definition you have used, 2 = one way road section and the traffic goes in the inverse way that the slope definition you have used, 3 = bi-directional traffic flow, the flow is split into two components and correct half for uphill and half for downhill (INTEGER) Type: ``String`` ``tableSourceDirectivity`` β€” *Source directivity table name* Name of the emission directivity table If not specified the default is train directivity of CNOSSOS-EU The table must contain the following columns: * DIR_ID : identifier of the directivity sphere (INTEGER) * THETA : [-90;90] Vertical angle in degree. 0Β° front 90Β° top -90Β° bottom (FLOAT) * PHI : [0;360] Horizontal angle in degree. 0Β° front 90Β° right (FLOAT) * LW63, LW125, LW250, LW500, LW1000, LW2000, LW4000, LW8000 : attenuation levels in dB for each octave or third octave (FLOAT) Type: ``String`` Output ------ ``result`` β€” *Created table* Name of the table containing the results of the computation. Can be used as input for another process. Type: ``String``