Difference between revisions of "Compass (plugin)"

From CloudCompareWiki
Jump to navigation Jump to search
Line 15: Line 15:
 
*Lightness - traces follow light points in the cloud. This is good for light-coloured structures such as veins.
 
*Lightness - traces follow light points in the cloud. This is good for light-coloured structures such as veins.
 
*RGB - traces avoid colour contrasts, following points with a similar colour to the start and end points.
 
*RGB - traces avoid colour contrasts, following points with a similar colour to the start and end points.
*Curvature - traces follow points on ridges and valleys. This can be good for fracture traces with high relief but can be slow and sensitive to noise. For better performance, use the ''[[Curvature]]'' and ''[Gaussian filter]'' tools to create a scalar field which highlights areas of high curvature, then use the ''Inverse Scalar Field'' cost function.
+
*Curvature - traces follow points on ridges and valleys. This can be good for fracture traces with high relief but can be slow and sensitive to noise. For better performance, use the ''[[Curvature]]'' and ''[Gaussian filter,http://www.cloudcompare.org/doc/wiki/index.php?title=Scalar_fields%5CGaussian_filter]'' tools to create a scalar field which highlights areas of high curvature, then use the ''Inverse Scalar Field'' cost function.
 
*Gradient - traces follow colour boundaries such as lithological contacts. Note that this can be slow and is very sensitive to noise. For better performance, use the ''Gradient'' tool and ''Inverse Scalar Field'' cost function as described above.
 
*Gradient - traces follow colour boundaries such as lithological contacts. Note that this can be slow and is very sensitive to noise. For better performance, use the ''Gradient'' tool and ''Inverse Scalar Field'' cost function as described above.
 
*Distance - traces take the shortest path. I'm not sure what this is good for.
 
*Distance - traces take the shortest path. I'm not sure what this is good for.

Revision as of 20:40, 12 January 2017

Introduction

ccCompass is a structural geology toolbox for the interpretation and analysis of virtual outcrop models. It can be used to digitise and measure both exposed surfaces and intersection traces of fractures, bedding, cleavages or other foliations and lineations. The plugin comprises three tools, one for measuring surfaces, one for traces and one for lineations. These roughly correspond to the functionality of a good field geologist (armed with a trusty compass and notebook), but require less beer and sunscreen. They are described in detail below.

Plane Tool: Measure surface orientations

The plane tool is used to measure the orientations of fully exposed planar structures, such as joint or bedding surfaces. When it is activated, a red circle is shown in the 3D window. On picking a point in the virtual outcrop model (left-click), a plane is fitted to all points sitting within the circle (using least squares), giving an orientation estimate. The circle radius can be changed with alt-scroll weel. Note that for this to work correctly, Cloud Compare needs to be using orthographic projection (Display->Toggle Centered Perspective).

Trace Tool: Digitise and measure traces and contacts

The trace tool allows rapid computer-assisted digitisation of fracture traces and lithological contacts. It uses a least-cost path algorithm to 'follow' fracture traces and contacts between user defined start and end points. To use, select the tool and then left click the start and end of a fracture you would like to digitise/measure. The tool will then try to find a fracture trace that links these points. Generally this works remarkably well, though if the desired result is not achieved, intermediate 'waypoints' can be added (also using left click) to modify the trace. To finish a segment click 'Accept' (green tick).

The results of this tool depend on the cost function used by the least-cost path algorithm. A variety of these have been implemented, and can be activated by clicking the algorithm dropdown (calculator icon). Note that cost functions can be used simultaneously. The different cost functions that have been implemented are:

  • Darkness [default] - traces follow dark points in the cloud. This is good for fracture traces defined by shadow.
  • Lightness - traces follow light points in the cloud. This is good for light-coloured structures such as veins.
  • RGB - traces avoid colour contrasts, following points with a similar colour to the start and end points.
  • Curvature - traces follow points on ridges and valleys. This can be good for fracture traces with high relief but can be slow and sensitive to noise. For better performance, use the Curvature and [Gaussian filter,http://www.cloudcompare.org/doc/wiki/index.php?title=Scalar_fields%5CGaussian_filter] tools to create a scalar field which highlights areas of high curvature, then use the Inverse Scalar Field cost function.
  • Gradient - traces follow colour boundaries such as lithological contacts. Note that this can be slow and is very sensitive to noise. For better performance, use the Gradient tool and Inverse Scalar Field cost function as described above.
  • Distance - traces take the shortest path. I'm not sure what this is good for.
  • Scalar Field - traces follow low values in the active (displayed) scalar field. Use this to implement custom cost functions.
  • Inverse Scalar Field - traces follow high values in the active (displayed) scalar field. Use this to implement custom cost functions.

When using this tool it is important to note that its performance (i.e. speed) scales with trace length. Hence, it can be used with large point clouds if trace lengths are kept small (though long traces can be quickly digitised as multiple segments). Asking the tool to find long traces may result in system crashes.

A plane is fitted to each trace (using least squares) when it is finalized (green tick), though note that this plane is rejected if points on the trace are approximately co-linear. Furthermore, if the point cloud being interpreted has previously calculated point normals, best-fit planes are also rejected if they fall within 10 degrees of the average surface orientation along the trace. Plane fitting can be enabled/disabled in the algorithm menu (calculator icon).

Lineation Tool: Measure lineations

This tool measures the trend and plunge of a (straight) line between two points. Left-click selects points (as above).

Exporting data

Interpretation generated using this tool is represented internally by Cloud Compare as planes and polygons, and so can be natively stored in CC's .bin files. For ease of use, a save tool has also been included. This tool exports plane and trace data to .csv files, from which data can be easily imported into other software packages for further analysis. Polylines created by the Trace and Lineation tools can also be exported as shapefiles through the normal Save dialog in Cloud Compare.

Further Reading and Citation

If you found this tool useful, please cite Thiele et al., 2017. The publication also contains a more detailed description of the methods employed by this plugin.

Thiele, ST., Grose, L., Samsu, A., Micklethwaite, S. & Cruden, S., 2017, 'ccCompass: A computer-assisted approach to structural interpretation of point clouds', Journal TBA