[GEOMETRY-33] Region API

• Type: Improvement
• Status: Closed
• Priority: Major
• Resolution: Done
• Fix Version/s: 1.0
• Assignee: Unassigned
• Reporter: Matt Juntunen
• Created: 16/Dec/18 14:22
• Updated: 03/Jan/20 16:44
• Resolved: 25/Nov/19 12:48

Description

The following updates should be made to the overall Region API:

• Rename IntervalsSet, PolygonsSet, and PolyhedronsSet to Region1D, Region2D, and Region3D, the reason being that each class can represent the full space, which is decidedly not an interval, polygon, or polyhedron. Also, the term "set", implies that they are collections of objects, which is not the case.
• Create builder APIs for constructing regions in each dimension. Ex:

  Region3D region = Region3D.builder()
      .add(plane1)
      .add(plane2)
      .build();
  

• Absorb RegionFactory functionality into the Region interface or make the utility methods static.

Issue Links

• is required by: GEOMETRY-34 SubHyperplane Optimized Implementations
• requires: GEOMETRY-32 BSPTree Updates