Virtual broom (plugin) - Revision history

Daniel at 10:23, 22 October 2017

2017-10-22T10:23:49Z

← Older revision		Revision as of 12:23, 22 October 2017
Line 53:		Line 53:
	Anytime, and whatever the chosen mode, it is possible to undo the last selection (i.e. last broom position) or the last 10 steps thanks to the two dedicated buttons ('Undo' and 'Undo 10 steps').		Anytime, and whatever the chosen mode, it is possible to undo the last selection (i.e. last broom position) or the last 10 steps thanks to the two dedicated buttons ('Undo' and 'Undo 10 steps').

	=== Delete the points ===		== Delete the points ==

	Before closing the tool, you must choose whether you want to deleted the selected (red) points or keep them. Choose the right mode thanks to the 'remove the selected points' checkbox, and then click on 'Apply' (to apply the operation and keep the plugin opened - ''you can then start sweeping the broom on another part of the cloud'') or directly on 'Validate' to apply the operation (if any is pending) and close the plugin.		Before closing the tool, you must choose whether you want to deleted the selected (red) points or keep them. Choose the right mode thanks to the 'remove the selected points' checkbox, and then click on 'Apply' (to apply the operation and keep the plugin opened - ''you can then start sweeping the broom on another part of the cloud'') or directly on 'Validate' to apply the operation (if any is pending) and close the plugin.

	'''The plugin doesn't modify the original cloud. It always creates a new cloud.'''		'''The plugin doesn't modify the original cloud. It always creates a new cloud.'''

			== Broom stuck ==

			When the plugin loses the 'track' of the broom and can't stick the broom to the surface anymore (for instance when it is hangs an empty area and there's not enough points 'inside' the yellow part - or when there's too much noise), the broom will get stuck and the plugin will display a warning message (in the bottom left part). In this case, you can try to move the plugin back to 'safety', but it is generally more simple to hit the 'Undo' button once or twice.

Daniel: /* Setup the broom dimensions */

2017-10-22T10:17:32Z

Setup the broom dimensions

← Older revision		Revision as of 12:17, 22 October 2017
Line 26:		Line 26:
	* length: the distance between the two picked points by default. Can be changed afterward. Warning: the longer the broom will be, the slower the tool might be, and the more issues you might have if the surface is curved. To clean a road for instance, the width of one or two car lines should be sufficient.		* length: the distance between the two picked points by default. Can be changed afterward. Warning: the longer the broom will be, the slower the tool might be, and the more issues you might have if the surface is curved. To clean a road for instance, the width of one or two car lines should be sufficient.
	* width: the width of the broom. 20% of the length by default. If the width is too small, the plugin might no be able to stick to the surface correctly (especially in case of a noisy surface)		* width: the width of the broom. 20% of the length by default. If the width is too small, the plugin might no be able to stick to the surface correctly (especially in case of a noisy surface)
	* thickness: the thickness of the broom. This is mainly used by the plugin to stick to the surface. In the default mode (cleaning), the points falling inside the broom won't be deleted. Therefore it is good to make the broom as thin as possible. However, especially for noisy or curved surfaces, the plugin won't be able to stick the broom to the surface correctly if the broom is too thin...		* thickness: the thickness of the broom. This is mainly used by the plugin to stick to the surface. In the default mode (cleaning), the points falling inside the broom won't be deleted. Therefore it is good to make the broom as thin as possible. However, especially for noisy or curved surfaces, the plugin won't be able to stick the broom to the surface correctly if the broom is too thin... '''It is sometimes a good idea to use two different brooms''' (first, a thick broom with a high selection volume, and then a much thinner broom with a low selection volume).

	The second important set of settings concern the selection volume (red):		The second important set of settings concern the selection volume (red):

Daniel at 10:06, 22 October 2017

2017-10-22T10:06:50Z

← Older revision		Revision as of 12:06, 22 October 2017
Line 1:		Line 1:
	== Introduction ==		= Introduction =

	The Virtual Broom plugin allows the user to clean (or segment) a point cloud semi-automatically... as one would use a broom on a (flat) surface.		The Virtual Broom plugin allows the user to clean (or segment) a point cloud semi-automatically... as one would use a broom on a (flat) surface.

Daniel: /* Usage */

2017-10-22T10:06:34Z

Usage

← Older revision		Revision as of 12:06, 22 October 2017
Line 5:		Line 5:
	[[File:qBroom_plugin.JPG\|center]]		[[File:qBroom_plugin.JPG\|center]]

	== Usage ==		= Usage =

	Just highlight a point cloud and start the plugin (with the plugin icon or the 'Plugin > CEA Virtual Broom' menu entry).		Just highlight a point cloud and start the plugin (with the plugin icon or the 'Plugin > CEA Virtual Broom' menu entry).
Line 13:		Line 13:
	Then the plugin dedicated dialog will appear. It has its own 3D view in which the point cloud is displayed. Standard mouse interactions can be used (left button: rotate the view / right button: pan the view).		Then the plugin dedicated dialog will appear. It has its own 3D view in which the point cloud is displayed. Standard mouse interactions can be used (left button: rotate the view / right button: pan the view).

	=== Position the broom ===		== Position the broom ==

	The first thing to do is to position the 'virtual' broom on the surface you wish to clean.		The first thing to do is to position the 'virtual' broom on the surface you wish to clean.
Line 21:		Line 21:
	''Note: it may be easier to pick the two points when looking at the surface from above.''		''Note: it may be easier to pick the two points when looking at the surface from above.''

	=== Setup the broom dimensions ===		== Setup the broom dimensions ==

	The virtual broom (yellow) automatically sticks to the cloud. You can change its dimensions thanks to the 'broom dimensions' parameters (on the left):		The virtual broom (yellow) automatically sticks to the cloud. You can change its dimensions thanks to the 'broom dimensions' parameters (on the left):
Line 32:		Line 32:
	* height: the height of the selection volume. This volume has the same horizontal extents as the broom box, but if the selection volume is not 'inside', its height can be modified as the user prefers (to catch all the noise, or on the contrary to avoid catching points above a given altitude). Of course the bigger the selection volume will be, the slower the tool might be.		* height: the height of the selection volume. This volume has the same horizontal extents as the broom box, but if the selection volume is not 'inside', its height can be modified as the user prefers (to catch all the noise, or on the contrary to avoid catching points above a given altitude). Of course the bigger the selection volume will be, the slower the tool might be.

	=== Moving the broom ===		== Moving the broom ==

	Once correctly setup, the broom can be displaced over the surface in two different modes:		Once correctly setup, the broom can be displaced over the surface in two different modes.
	* manual: by default, the user is supposed to manually displace the broom. Left click on the broom, keep the mouse button pressed, and then move the broom. The broom should stick to the surface, and the points falling inside the selection volume will be colored in red by default. Now all you need is time, as with a real broom ;)
	* automated: for simple surfaces such as roads, it is possible to automate the process by drawing a rectangle over the surface in which the broom will be automatically 'swept'. Look at the surface from above, change the zoom so as to see the whole area to clean, and click on the automate button. The plugin will ask you to pick two corners of the (rectangular) area to be cleaned. Actually these are two corners on the same side of the rectangle. Then you'll be able to change the width of the rectangle interactively by moving the mouse, and you can fix it by clicking a last time on the left mouse button. Once defined, the plugin will automatically sweep the broom inside the defined area.

	[File:QBroom_automate.jpg\|center]		=== Manual mode ===

			By default, the user is supposed to manually 'sweep' the broom. Left click on the broom, keep the mouse button pressed, and then move the broom. The broom should stick to the surface, and the points falling inside the selection volume will be colored in red by default. Now all you need is time, as with a real broom ;)

			Note: the 'stick to the cloud' checkbox allows you to enabled or disable the automatic broom 'sticking'. Disabling it might be a little tricky ;

			=== Automated mode ===

			For simple surfaces such as roads, it is possible to automate the process by drawing a rectangle over the surface in which the broom will be automatically 'swept'. Look at the surface from above, change the zoom so as to see the whole area to clean, and click on the automate button. The plugin will ask you to pick two corners of the (rectangular) area to be cleaned. Actually these are two corners on the same side of the rectangle. Then you'll be able to change the width of the rectangle interactively by moving the mouse, and you can fix it by clicking a last time on the left mouse button. Once defined, the plugin will automatically sweep the broom inside the defined area.

			[[File:QBroom_automate.jpg\|center]]
			[[File:QBroom_automate_result.jpg\|center]]

			=== Undo ===

			Anytime, and whatever the chosen mode, it is possible to undo the last selection (i.e. last broom position) or the last 10 steps thanks to the two dedicated buttons ('Undo' and 'Undo 10 steps').

			=== Delete the points ===

			Before closing the tool, you must choose whether you want to deleted the selected (red) points or keep them. Choose the right mode thanks to the 'remove the selected points' checkbox, and then click on 'Apply' (to apply the operation and keep the plugin opened - ''you can then start sweeping the broom on another part of the cloud'') or directly on 'Validate' to apply the operation (if any is pending) and close the plugin.

			'''The plugin doesn't modify the original cloud. It always creates a new cloud.'''

Daniel at 09:58, 22 October 2017

2017-10-22T09:58:39Z

← Older revision		Revision as of 11:58, 22 October 2017
Line 9:		Line 9:
	Just highlight a point cloud and start the plugin (with the plugin icon or the 'Plugin > CEA Virtual Broom' menu entry).		Just highlight a point cloud and start the plugin (with the plugin icon or the 'Plugin > CEA Virtual Broom' menu entry).

	This will display the first time a disclaimer about the author of the plugin (Wesley Grimes, [https://cea-az.com/ Collision Engineering Associates, Inc.], USA). Then the plugin dedicated dialog will appear.		This will display the first time a disclaimer about the author of the plugin (Wesley Grimes, [https://cea-az.com/ Collision Engineering Associates, Inc.], USA). This project is independent from CloudCompare, therefore don't hesitate to make donations if you find this plugin useful.

			Then the plugin dedicated dialog will appear. It has its own 3D view in which the point cloud is displayed. Standard mouse interactions can be used (left button: rotate the view / right button: pan the view).

	=== Position the broom ===		=== Position the broom ===
Line 16:		Line 18:

	Click on the 'Reposition' button, then pick two points on the (flat) surface so that the plugin can determine the with of the broom and it's initial position and orientation. Once two points have been picked, you'll see a yellow rectangular box representing the 'virtual' broom and a red box representing the space above the broom in which points will be removed (''or 'selected' if you want to work the opposite way'').		Click on the 'Reposition' button, then pick two points on the (flat) surface so that the plugin can determine the with of the broom and it's initial position and orientation. Once two points have been picked, you'll see a yellow rectangular box representing the 'virtual' broom and a red box representing the space above the broom in which points will be removed (''or 'selected' if you want to work the opposite way'').

			''Note: it may be easier to pick the two points when looking at the surface from above.''

			=== Setup the broom dimensions ===

	The virtual broom (yellow) automatically sticks to the cloud. You can change its dimensions thanks to the 'broom dimensions' parameters (on the left):		The virtual broom (yellow) automatically sticks to the cloud. You can change its dimensions thanks to the 'broom dimensions' parameters (on the left):
Line 23:		Line 29:

	The second important set of settings concern the selection volume (red):		The second important set of settings concern the selection volume (red):
	* mode: you can select		* mode: you can delete (or 'select') the points above / below / above and below / or inside the broom box itself.
			* height: the height of the selection volume. This volume has the same horizontal extents as the broom box, but if the selection volume is not 'inside', its height can be modified as the user prefers (to catch all the noise, or on the contrary to avoid catching points above a given altitude). Of course the bigger the selection volume will be, the slower the tool might be.

			=== Moving the broom ===

			Once correctly setup, the broom can be displaced over the surface in two different modes:
			* manual: by default, the user is supposed to manually displace the broom. Left click on the broom, keep the mouse button pressed, and then move the broom. The broom should stick to the surface, and the points falling inside the selection volume will be colored in red by default. Now all you need is time, as with a real broom ;)
			* automated: for simple surfaces such as roads, it is possible to automate the process by drawing a rectangle over the surface in which the broom will be automatically 'swept'. Look at the surface from above, change the zoom so as to see the whole area to clean, and click on the automate button. The plugin will ask you to pick two corners of the (rectangular) area to be cleaned. Actually these are two corners on the same side of the rectangle. Then you'll be able to change the width of the rectangle interactively by moving the mouse, and you can fix it by clicking a last time on the left mouse button. Once defined, the plugin will automatically sweep the broom inside the defined area.

			[File:QBroom_automate.jpg\|center]

Daniel: /* Introduction */

2017-10-22T09:35:26Z

Introduction

← Older revision		Revision as of 11:35, 22 October 2017
Line 1:		Line 1:
	== Introduction ==		== Introduction ==

	The Virtual Broom plugin allows to clean (or segment) a point cloud semi-automatically... as one would use a broom on a (flat) surface.		The Virtual Broom plugin allows the user to clean (or segment) a point cloud semi-automatically... as one would use a broom on a (flat) surface.

	[[File:qBroom_plugin.JPG\|center]]		[[File:qBroom_plugin.JPG\|center]]

Daniel: Created page with "== Introduction == The Virtual Broom plugin allows to clean (or segment) a point cloud semi-automatically... as one would use a broom on a (flat) surface. File:qBroom_plug..."

2017-10-22T09:31:32Z

Created page with "== Introduction == The Virtual Broom plugin allows to clean (or segment) a point cloud semi-automatically... as one would use a broom on a (flat) surface. File:qBroom_plug..."

New page

== Introduction ==

The Virtual Broom plugin allows to clean (or segment) a point cloud semi-automatically... as one would use a broom on a (flat) surface.

[[File:qBroom_plugin.JPG|center]]

== Usage ==

Just highlight a point cloud and start the plugin (with the plugin icon or the 'Plugin > CEA Virtual Broom' menu entry).

This will display the first time a disclaimer about the author of the plugin (Wesley Grimes, [https://cea-az.com/ Collision Engineering Associates, Inc.], USA). Then the plugin dedicated dialog will appear.

=== Position the broom ===

The first thing to do is to position the 'virtual' broom on the surface you wish to clean.

Click on the 'Reposition' button, then pick two points on the (flat) surface so that the plugin can determine the with of the broom and it's initial position and orientation. Once two points have been picked, you'll see a yellow rectangular box representing the 'virtual' broom and a red box representing the space above the broom in which points will be removed (''or 'selected' if you want to work the opposite way'').

The virtual broom (yellow) automatically sticks to the cloud. You can change its dimensions thanks to the 'broom dimensions' parameters (on the left):
* length: the distance between the two picked points by default. Can be changed afterward. Warning: the longer the broom will be, the slower the tool might be, and the more issues you might have if the surface is curved. To clean a road for instance, the width of one or two car lines should be sufficient.
* width: the width of the broom. 20% of the length by default. If the width is too small, the plugin might no be able to stick to the surface correctly (especially in case of a noisy surface)
* thickness: the thickness of the broom. This is mainly used by the plugin to stick to the surface. In the default mode (cleaning), the points falling inside the broom won't be deleted. Therefore it is good to make the broom as thin as possible. However, especially for noisy or curved surfaces, the plugin won't be able to stick the broom to the surface correctly if the broom is too thin...

The second important set of settings concern the selection volume (red):
* mode: you can select