You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@sedona.apache.org by ji...@apache.org on 2026/02/07 21:43:23 UTC

(sedona) branch fix/1612-intersection-docs created (now 20139c0b03)

This is an automated email from the ASF dual-hosted git repository.

jiayu pushed a change to branch fix/1612-intersection-docs
in repository https://gitbox.apache.org/repos/asf/sedona.git


      at 20139c0b03 [GH-1612] Add TopologyException workaround note to ST_Intersection docs

This branch includes the following new commits:

     new 20139c0b03 [GH-1612] Add TopologyException workaround note to ST_Intersection docs

The 1 revisions listed above as "new" are entirely new to this
repository and will be described in separate emails.  The revisions
listed as "add" were already present in the repository and have only
been added to this reference.



(sedona) 01/01: [GH-1612] Add TopologyException workaround note to ST_Intersection docs

Posted by ji...@apache.org.
This is an automated email from the ASF dual-hosted git repository.

jiayu pushed a commit to branch fix/1612-intersection-docs
in repository https://gitbox.apache.org/repos/asf/sedona.git

commit 20139c0b039e45bd862e2312a68056a5b1f2cb20
Author: Jia Yu <ji...@apache.org>
AuthorDate: Sat Feb 7 13:36:54 2026 -0800

    [GH-1612] Add TopologyException workaround note to ST_Intersection docs
---
 docs/api/flink/Function.md                 |  9 +++++++++
 docs/api/snowflake/vector-data/Function.md |  7 +++++++
 docs/api/sql/Function.md                   | 10 ++++++++++
 3 files changed, 26 insertions(+)

diff --git a/docs/api/flink/Function.md b/docs/api/flink/Function.md
index d74552617f..019f91fed2 100644
--- a/docs/api/flink/Function.md
+++ b/docs/api/flink/Function.md
@@ -2136,6 +2136,15 @@ Format: `ST_Intersection (A: Geometry, B: Geometry)`
 
 Since: `v1.5.0`
 
+!!!note
+    If you encounter a `TopologyException` with the message "found non-noded intersection", try enabling the OverlayNG algorithm by adding the following JVM flag:
+
+    ```
+    -Djts.overlay=ng
+    ```
+
+    The OverlayNG algorithm is more robust than the legacy overlay implementation in JTS and handles many edge cases that would otherwise cause errors.
+
 Example:
 
 ```sql
diff --git a/docs/api/snowflake/vector-data/Function.md b/docs/api/snowflake/vector-data/Function.md
index 28eb433c3b..dd769d4dea 100644
--- a/docs/api/snowflake/vector-data/Function.md
+++ b/docs/api/snowflake/vector-data/Function.md
@@ -1535,6 +1535,13 @@ Introduction: Return the intersection geometry of A and B
 
 Format: `ST_Intersection (A:geometry, B:geometry)`
 
+!!!note
+    If you encounter a `TopologyException` with the message "found non-noded intersection", this is a known issue with the legacy overlay implementation in JTS. The OverlayNG algorithm resolves this. To enable it, add the following JVM flag:
+
+    ```
+    -Djts.overlay=ng
+    ```
+
 SQL example:
 
 ```sql
diff --git a/docs/api/sql/Function.md b/docs/api/sql/Function.md
index 9c61520f6d..c6c5d7cb24 100644
--- a/docs/api/sql/Function.md
+++ b/docs/api/sql/Function.md
@@ -2266,6 +2266,16 @@ Format: `ST_Intersection (A: Geometry, B: Geometry)`
 
 Since: `v1.0.0`
 
+!!!note
+    If you encounter a `TopologyException` with the message "found non-noded intersection", try enabling the OverlayNG algorithm by setting the following Spark configuration:
+
+    ```
+    spark.driver.extraJavaOptions=-Djts.overlay=ng
+    spark.executor.extraJavaOptions=-Djts.overlay=ng
+    ```
+
+    The OverlayNG algorithm is more robust than the legacy overlay implementation in JTS and handles many edge cases that would otherwise cause errors.
+
 SQL Example
 
 ```sql