Javadoc

modules/core/src/main/java/org/locationtech/jts/operation/relateng/NodeSections.java

@@ -70,7 +70,7 @@ public RelateNode createNode() {
     while (i < sections.size()) {
       int blockSize = 1;
       NodeSection ns = sections.get(i);
-      //-- are there multiple polygon sections incident at node?
+      //-- if there multiple polygon sections incident at node convert them to maximal-ring structure 
       if (ns.isArea() && hasMultiplePolygonSections(sections, i)) {
         List<NodeSection> polySections = collectPolygonSections(sections, i);
         List<NodeSection> nsConvert = PolygonNodeConverter.convert(polySections);

modules/core/src/main/java/org/locationtech/jts/operation/relateng/PolygonNodeConverter.java

@@ -21,21 +21,20 @@
  * Converts the node sections at a polygon node where
  * a shell and one or more holes touch, or two or more holes touch.
  * This converts the node topological structure from
- * the OGC "touching-rings" model to the equivalent "self-touch"
- * (AKA "inverted/exverted ring") model.
- * In that model the converted NodeSection corners enclose area 
+ * the OGC "touching-rings" (AKA "minimal-ring") model to the equivalent "self-touch"
+ * (AKA "inverted/exverted ring" or "maximal ring") model.
+ * In the "self-touch" model the converted NodeSection corners enclose areas 
  * which all lies inside the polygon
  * (i.e. they does not enclose hole edges).
- * This allows a simple area-additive semantics to be used
- * in {@link RelateNode}
+ * This allows {@link RelateNode} to use simple area-additive semantics 
  * for adding edges and propagating edge locations.
  * <p>
  * The input node sections are assumed to have canonical orientation
  * (CW shells and CCW holes).
  * The arrangement of shells and holes must be topologically valid.
  * Specifically, the node sections must not cross or be collinear.
  * <p>
- * This also supports multiple shell-shell touches 
+ * This supports multiple shell-shell touches 
  * (including ones containing holes), and hole-hole touches, 
  * This generalizes the relate algorithm to support
  * both the OGC model and the self-touch model.