VoxFall (plugin) - Revision history

Ioannis: /* Overview */

2025-04-02T15:50:55Z

Overview

← Older revision		Revision as of 17:50, 2 April 2025
Line 11:		Line 11:
	[[File:VoxFall_grid.jpg\|center]]		[[File:VoxFall_grid.jpg\|center]]

	While VoxFall is a simple unified rockfall detection framework, it is recommended to read the original article by [https://~~iaeg~~.~~info/wp-content/uploads/2024~~/10/03.~~-Emerging-Technologies-and-Applications-in-Engineering-Geology-and-Geotechnics~~.~~pdf~~ Farmakis et al. (2025)].		While VoxFall is a simple unified rockfall detection framework, it is recommended to read the original article by [https://doi.org/10.1016/j.enggeo.2025.108045 Farmakis et al. (2025)].

	= Using VoxFall =		= Using VoxFall =

Ioannis: /* Output options */

2025-03-26T09:11:16Z

Output options

← Older revision		Revision as of 11:11, 26 March 2025
Line 38:		Line 38:

	You can choose to generate additional outputs:"		You can choose to generate additional outputs:"
			*'''Generate report (CSV):''' Generates a CSV inventory listing all the detected volumes with their attribute columns.
	*'''Export meshes:''' Exports the mesh of the voxel assembly for each cluster.		*'''Export meshes:''' Exports the mesh of the voxel assembly for each cluster.
	*'''Loss/gain:''' A scalar field defining whether a cluster represents material loss or gain from Mesh #1 to Mesh #2. Loss = -1 and gain = 1, to ease multiplications with the ''volume (m3)'' scalar field.		*'''Loss/gain:''' A scalar field defining whether a cluster represents material loss or gain from Mesh #1 to Mesh #2. Loss = -1 and gain = 1, to ease multiplications with the ''volume (m3)'' scalar field.

Ioannis: /* Model properties */

2025-03-26T09:05:58Z

Model properties

← Older revision		Revision as of 11:05, 26 March 2025
Line 21:		Line 21:
	== Model properties ==		== Model properties ==

	The user has to define the ''voxel size'' and the ''~~azimuth~~'' ~~of the occupancy grid~~.		The user has to define the ''voxel size'' and the orientation of the occupancy grid by means of the model's ''dip'' and ''dip direction''.

	Since VoxFall is a non-parametric method and the results are only controlled by the quality of the input data, these two parameters are directly corresponding to input model properties.		Since VoxFall is a non-parametric method and the results are only controlled by the quality of the input data, these two parameters are directly corresponding to input model properties.

	*'''Voxel size:''' The registration error defines the ''voxel size'' (resolution), and each point in its distribution defines the probability of eliminating false positives (e.g., mean error=50%, max error=100%). A value corresponding to the LoD 95% is recommended.		*'''Voxel size:''' The registration error defines the ''voxel size'' (resolution), and each point in its distribution defines the probability of eliminating false positives (e.g., mean error=50%, max error=100%). A value corresponding to the LoD 95% is recommended.
	*'''~~Azimuth~~:''' The slope model's dip direction in degrees		*'''Dip:''' The slope model's dip angle in degrees [0-90]
			*'''Dip direction:''' The slope model's dip direction (azimuth) in degrees [0-360]

			The '''auto''' option computes the ''dip'' and ''dip direction'' parameters by fitting a plane to the input model.

	== Output options ==		== Output options ==

Ioannis: Created page with "= Overview = The VoxFall plugin is a simple and efficient way to detect and quantify rockfall events as discrete blocks directly between two 3D models. File:VoxFall_produc..."

2025-03-08T17:46:37Z

Created page with "= Overview = The VoxFall plugin is a simple and efficient way to detect and quantify rockfall events as discrete blocks directly between two 3D models. File:VoxFall_produc..."

New page

= Overview =

The VoxFall plugin is a simple and efficient way to detect and quantify rockfall events as discrete blocks directly between two 3D models.

[[File:VoxFall_product.jpg|center|frame]]

VoxFall does not rely on any distance computation between two models while is free from scale parameters associated to normals, spatial clustering, and cluster shape reconstruction.

The method treats the two input models as a single scene and applies two steps: 1) '''fitting an occupancy voxel grid''' of a resolution defined by the registration error; 2) '''empty space clustering''' and volume computation based on voxel adjacency.

[[File:VoxFall_grid.jpg|center]]

While VoxFall is a simple unified rockfall detection framework, it is recommended to read the original article by [https://iaeg.info/wp-content/uploads/2024/10/03.-Emerging-Technologies-and-Applications-in-Engineering-Geology-and-Geotechnics.pdf Farmakis et al. (2025)].

= Using VoxFall =

Select the two mesh models you want to compare and call: '''Plugins -> VOXFALL'''

[[File:VoxFall_dialog.JPG|center]]

== Model properties ==

The user has to define the ''voxel size'' and the ''azimuth'' of the occupancy grid.

Since VoxFall is a non-parametric method and the results are only controlled by the quality of the input data, these two parameters are directly corresponding to input model properties.

*'''Voxel size:''' The registration error defines the ''voxel size'' (resolution), and each point in its distribution defines the probability of eliminating false positives (e.g., mean error=50%, max error=100%). A value corresponding to the LoD 95% is recommended.
*'''Azimuth:''' The slope model's dip direction in degrees

== Output options ==

VoxFall by default exports a point cloud, representing the center of each voxel in the whole occupancy grid, with three scalar fields: ''Cluster ID'', ''Volume (m3)'' and ''Uncertainty (m3)'' of volume estimations for each detected cluster.

You can filter the grid by using the ''Cluster ID'' scalar field. VoxFall clusters are assigned IDs > 0, surface model is assigned -1, and the rest of the grid is 0.

You can choose to generate additional outputs:"
*'''Export meshes:''' Exports the mesh of the voxel assembly for each cluster.
*'''Loss/gain:''' A scalar field defining whether a cluster represents material loss or gain from Mesh #1 to Mesh #2. Loss = -1 and gain = 1, to ease multiplications with the ''volume (m3)'' scalar field.