Package org.noise_planet.noisemodelling.jdbc

Class DelaunayReceiversMaker

java.lang.Object

org.noise_planet.noisemodelling.jdbc.GridMapMaker

org.noise_planet.noisemodelling.jdbc.DelaunayReceiversMaker

public class DelaunayReceiversMaker
extends GridMapMaker

Create input receivers built from Delaunay for contructing a NoiseMap rendering. SQL syntax is compatible with H2 and PostGIS.

Author:

Nicolas Fortin, SU Qi

Field Summary

Fields inherited from class org.noise_planet.noisemodelling.jdbc.GridMapMaker

bodyBarrier, buildingTableParameters, closeReceiverReflectionWallDistance, computeHorizontalDiffraction, computeVerticalDiffraction, demTable, geometryFactory, gridDim, groundSurfaceSplitSideLength, gs, mainEnvelope, maximumPropagationDistance, maximumReflectionDistance, MINIMAL_BUFFER_RATIO, receiverHasSeaLevelZCoordinates, soilTableName, sound_lvl_field, soundReflectionOrder, sourceHasSeaLevelZCoordinates, sourcesTableName, verbose

Constructor Summary

Constructors

Constructor	Description
DelaunayReceiversMaker(String buildingsTableName, String sourcesTableName)	Create constructor DelaunayReceiversMaker

Method Summary

Modifier and Type	Method	Description
void	computeDelaunay(LayerDelaunay cellMesh, org.locationtech.jts.geom.Envelope mainEnvelope, int cellI, int cellJ, double maxSrcDist, Collection<org.locationtech.jts.geom.Geometry> sources, double minRecDist, double maximumArea, double buildingBuffer, List<Building> buildings)	Delaunay triangulation of Sub-Domain
void	fetchCellSource(Connection connection, org.locationtech.jts.geom.Envelope fetchEnvelope, boolean doIntersection, List<org.locationtech.jts.geom.Geometry> sourceGeometries)	Fetch source geometries and power
void	generateReceivers(Connection connection, int cellI, int cellJ, String receiverTableName, String trianglesTableName, AtomicInteger receiverPK)
static void	generateResultTable(Connection connection, String receiverTableName, String trianglesTableName, AtomicInteger receiverPK, List<org.locationtech.jts.geom.Coordinate> vertices, org.locationtech.jts.geom.GeometryFactory geometryFactory, List<Triangle> triangles, int cellI, int cellJ, int gridDim, boolean exportTrianglesGeometries)
double	getBuildingBuffer()
org.locationtech.jts.geom.Envelope	getComputationEnvelope(Connection connection)	Retrieves the computation envelope based on data stored in the database tables.
double	getEpsilon()
String	getExceptionDumpFolder()
double	getGeometrySimplificationDistance()
double	getMaximumArea()
double	getMinimalSourceGeometriesDistanceToComputeCell()
double	getReceiverHeight()
long	getReceiversCount()
double	getRoadWidth()
boolean	hasSourcesNearEnvelope(Connection connection, org.locationtech.jts.geom.Envelope fetchEnvelope, double minimalDistance)	Check if there is at least one source geometry near the envelope
boolean	isExportTrianglesGeometries()
boolean	isIsoSurfaceInBuildings()
void	run(Connection connection, String verticesTableName, String triangleTableName, org.h2gis.api.ProgressVisitor progressVisitor)	Executes the Delaunay triangulation process for a grid of subdomains.
void	setBuildingBuffer(double buildingBuffer)	Do not add receivers closer to specified distance
void	setEpsilon(double epsilon)
void	setExceptionDumpFolder(String exceptionDumpFolder)
void	setExportTrianglesGeometries(boolean exportTrianglesGeometries)
void	setGeometrySimplificationDistance(double geometrySimplificationDistance)
void	setIsoSurfaceInBuildings(boolean isoSurfaceInBuildings)
void	setMaximumArea(double maximumArea)
void	setMinimalSourceGeometriesDistanceToComputeCell(double minimalSourceGeometriesDistanceToComputeCell)	Do not evaluate a computation cell if there is no source geometries at least at x meters from the cell envelope.
void	setReceiverHeight(double receiverHeight)
void	setRoadWidth(double roadWidth)	Set the buffer around the roads where no receivers will be placed.

Methods inherited from class org.noise_planet.noisemodelling.jdbc.GridMapMaker

getBuildingsTableName, getBuildingTableParameters, getCellEnv, getCellEnv, getCellHeight, getCellWidth, getCloseReceiverReflectionWallDistance, getDemTable, getGeometryFactory, getGridDim, getGroundSurfaceSplitSideLength, getGs, getHeightField, getMainEnvelope, getMaximumPropagationDistance, getMaximumReflectionDistance, getSoilTableName, getSound_lvl_field, getSoundReflectionOrder, getSourcesTableName, getWallAbsorption, initialize, isComputeHorizontalDiffraction, isComputeVerticalDiffraction, isReceiverHasAbsoluteZCoordinates, isSourceHasAbsoluteZCoordinates, isVerbose, iszBuildings, setBodyBarrier, setCloseReceiverReflectionWallDistance, setComputeHorizontalDiffraction, setComputeVerticalDiffraction, setDemTable, setGridDim, setGroundSurfaceSplitSideLength, setGs, setHeightField, setMainEnvelope, setMaximumPropagationDistance, setMaximumReflectionDistance, setReceiverHasAbsoluteZCoordinates, setSoilTableName, setSound_lvl_field, setSoundReflectionOrder, setSourceHasAbsoluteZCoordinates, setVerbose, setWallAbsorption, setzBuildings

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Details

DelaunayReceiversMaker

public DelaunayReceiversMaker(String buildingsTableName,
 String sourcesTableName)

Create constructor DelaunayReceiversMaker

Parameters:

buildingsTableName - Buildings table

sourcesTableName - Source table name

Method Details

isExportTrianglesGeometries

public boolean isExportTrianglesGeometries()

Returns:

True if triangle geometries are exported

setExportTrianglesGeometries

public void setExportTrianglesGeometries(boolean exportTrianglesGeometries)

Parameters:

exportTrianglesGeometries - Set true in order to export triangle geometries

isIsoSurfaceInBuildings

public boolean isIsoSurfaceInBuildings()

Returns:

True if isosurface will be placed into buildings

setIsoSurfaceInBuildings

public void setIsoSurfaceInBuildings(boolean isoSurfaceInBuildings)

Parameters:

isoSurfaceInBuildings - Set true in order to place isosurface in buildings

run

public void run(Connection connection,
 String verticesTableName,
 String triangleTableName,
 org.h2gis.api.ProgressVisitor progressVisitor)
         throws SQLException

Executes the Delaunay triangulation process for a grid of subdomains. Each subdomain is handled independently and includes the generation of receivers and triangles based on the given configuration.

Parameters:

connection - The database connection used to interact with the data.

verticesTableName - The name of the database table where the vertices will be stored.

triangleTableName - The name of the database table where the triangles will be stored.

Throws:

SQLException - Thrown if a database access error or other SQL-related error occurs.

getExceptionDumpFolder

public String getExceptionDumpFolder()

Returns:

When an exception occur, this folder with receiver the input data

setExceptionDumpFolder

public void setExceptionDumpFolder(String exceptionDumpFolder)

Parameters:

exceptionDumpFolder - When an exception occur, this folder with receiver the input data

getBuildingBuffer

public double getBuildingBuffer()

Returns:

Do not add receivers closer to specified distance

setBuildingBuffer

public void setBuildingBuffer(double buildingBuffer)

Do not add receivers closer to specified distance

Parameters:

buildingBuffer - Distance in meters

computeDelaunay

public void computeDelaunay(LayerDelaunay cellMesh,
 org.locationtech.jts.geom.Envelope mainEnvelope,
 int cellI,
 int cellJ,
 double maxSrcDist,
 Collection<org.locationtech.jts.geom.Geometry> sources,
 double minRecDist,
 double maximumArea,
 double buildingBuffer,
 List<Building> buildings)
                     throws LayerDelaunayError

Delaunay triangulation of Sub-Domain

Parameters:

cellMesh - Final mesh target

mainEnvelope - Global envelope

cellI - I cell index

cellJ - J cell index

maxSrcDist - Maximum propagation distance

minRecDist - Minimal distance receiver-source

maximumArea - Maximum area of triangles

Throws:

LayerDelaunayError - if an error occurs during the Delaunay triangulation process.

getComputationEnvelope

public org.locationtech.jts.geom.Envelope getComputationEnvelope(Connection connection)
                                                          throws SQLException

Retrieves the computation envelope based on data stored in the database tables.

Specified by:

getComputationEnvelope in class GridMapMaker

Parameters:

connection - the database connection.

Returns:

the computation envelope containing the bounding box of the data stored in the specified tables.

Throws:

SQLException - if a database access error occurs.

getEpsilon

public double getEpsilon()

getGeometrySimplificationDistance

public double getGeometrySimplificationDistance()

setGeometrySimplificationDistance

public void setGeometrySimplificationDistance(double geometrySimplificationDistance)

generateResultTable

public static void generateResultTable(Connection connection,
 String receiverTableName,
 String trianglesTableName,
 AtomicInteger receiverPK,
 List<org.locationtech.jts.geom.Coordinate> vertices,
 org.locationtech.jts.geom.GeometryFactory geometryFactory,
 List<Triangle> triangles,
 int cellI,
 int cellJ,
 int gridDim,
 boolean exportTrianglesGeometries)
                                throws SQLException

Throws:

SQLException

setEpsilon

public void setEpsilon(double epsilon)

Parameters:

epsilon - Merge points that are closer that this epsilon value

fetchCellSource

public void fetchCellSource(Connection connection,
 org.locationtech.jts.geom.Envelope fetchEnvelope,
 boolean doIntersection,
 List<org.locationtech.jts.geom.Geometry> sourceGeometries)
                     throws SQLException

Fetch source geometries and power

Parameters:

connection - Active connection

fetchEnvelope - Fetch envelope

doIntersection - Truncate geometris

sourceGeometries - List to feed

Throws:

SQLException - if a database access error occurs

generateReceivers

public void generateReceivers(Connection connection,
 int cellI,
 int cellJ,
 String receiverTableName,
 String trianglesTableName,
 AtomicInteger receiverPK)
                       throws SQLException,
LayerDelaunayError,
IOException

Throws:

SQLException

LayerDelaunayError

IOException

getRoadWidth

public double getRoadWidth()

setRoadWidth

public void setRoadWidth(double roadWidth)

Set the buffer around the roads where no receivers will be placed. If this value is equal to 0m, the roads will not be integrated into the triangulation So you can exclude cells with setMinimalSourceGeometriesDistanceToComputeCell(double) and not use the road buffer.

Parameters:

roadWidth - Road width in meters

getMinimalSourceGeometriesDistanceToComputeCell

public double getMinimalSourceGeometriesDistanceToComputeCell()

Returns:

Do not evaluate a computation cell if there is no source geometries at least at x meters from the cell envelope

setMinimalSourceGeometriesDistanceToComputeCell

public void setMinimalSourceGeometriesDistanceToComputeCell(double minimalSourceGeometriesDistanceToComputeCell)

Do not evaluate a computation cell if there is no source geometries at least at x meters from the cell envelope. Evaluated on run(Connection, String, String, ProgressVisitor) It is ignored if it is NaN or if source table name is not provided or does not exists

Parameters:

minimalSourceGeometriesDistanceToComputeCell - Distance in meters

hasSourcesNearEnvelope

public boolean hasSourcesNearEnvelope(Connection connection,
 org.locationtech.jts.geom.Envelope fetchEnvelope,
 double minimalDistance)
                               throws SQLException

Check if there is at least one source geometry near the envelope

Parameters:

connection - Active connection

fetchEnvelope - Fetch envelope

minimalDistance - Minimal distance from envelope

Returns:

True if there is at least one source geometry near the envelope

Throws:

SQLException - if a database access error occurs

getMaximumArea

public double getMaximumArea()

setMaximumArea

public void setMaximumArea(double maximumArea)

getReceiverHeight

public double getReceiverHeight()

setReceiverHeight

public void setReceiverHeight(double receiverHeight)

getReceiversCount

public long getReceiversCount()