From faea9ddb0b70431c6f88b2325d080bb737a9d576 Mon Sep 17 00:00:00 2001 From: Martin Davis Date: Mon, 13 May 2024 09:46:53 -0700 Subject: [PATCH] Javadoc --- .../jts/operation/relateng/NodeSections.java | 2 +- .../jts/operation/relateng/PolygonNodeConverter.java | 11 +++++------ 2 files changed, 6 insertions(+), 7 deletions(-) diff --git a/modules/core/src/main/java/org/locationtech/jts/operation/relateng/NodeSections.java b/modules/core/src/main/java/org/locationtech/jts/operation/relateng/NodeSections.java index 8101f35a97..9ee4a5c50b 100644 --- a/modules/core/src/main/java/org/locationtech/jts/operation/relateng/NodeSections.java +++ b/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 polySections = collectPolygonSections(sections, i); List nsConvert = PolygonNodeConverter.convert(polySections); diff --git a/modules/core/src/main/java/org/locationtech/jts/operation/relateng/PolygonNodeConverter.java b/modules/core/src/main/java/org/locationtech/jts/operation/relateng/PolygonNodeConverter.java index a1d1225e24..079e30023e 100644 --- a/modules/core/src/main/java/org/locationtech/jts/operation/relateng/PolygonNodeConverter.java +++ b/modules/core/src/main/java/org/locationtech/jts/operation/relateng/PolygonNodeConverter.java @@ -21,13 +21,12 @@ * 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. *

* The input node sections are assumed to have canonical orientation @@ -35,7 +34,7 @@ * The arrangement of shells and holes must be topologically valid. * Specifically, the node sections must not cross or be collinear. *

- * 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.