#############################################################
##                                                         ##
## Copyright (c) 2007-2017 by The University of Queensland ##
## Centre for Geoscience Computing                         ##
## http://earth.uq.edu.au/centre-geoscience-computing   ##
##                                                         ##
## Primary Business: Brisbane, Queensland, Australia       ##
## Licensed under the Open Software License version 3.0    ##
## http://www.apache.org/licenses/LICENSE-2.0              ##
##                                                         ##
#############################################################

Current Status of the CSG based volumes
---------------------------------------

The CSG based volumes, i.e. UnionVol, DifferenceVol and IntersectionVol are currently an 
experimental feature and may not always works as expected. While most basic operations do
work there are some things which are either not sufficiently tested or actually known not
to work. See below.

Known issues:
-------------

general: 
- cascading CSG operations is not well tested and may lead to unexpected results
- using volumes with internal fitting surfaces, i.e. BoxWithJointSet or CylinderWithJointSet is untested,
  the CSG operation may have unexpected effects on the joint set

DifferenceVol:
- if the difference would result in an empty volume, i.e the 1st volume is fully contained in the 2nd volume,
the calculation will not terminate

IntersectionVol:
- if the intersection is empty, i.e. the two volumes are disjoint, the calculation will not terminate 