Skip to content

[GH-2678] Add SVG visuals for 21 geometry processing functions (Phase 3)#2683

Merged
jiayuasu merged 2 commits intomasterfrom
fix/issue-2678-processing-visuals
Mar 4, 2026
Merged

[GH-2678] Add SVG visuals for 21 geometry processing functions (Phase 3)#2683
jiayuasu merged 2 commits intomasterfrom
fix/issue-2678-processing-visuals

Conversation

@jiayuasu
Copy link
Member

@jiayuasu jiayuasu commented Mar 4, 2026

Add SVG visuals for geometry processing functions

Part of #2678 — Phase 3 (Geometry Processing)

Summary

Adds conceptual SVG illustrations for 21 geometry processing functions across all 3 doc variants (SQL, Flink, Snowflake).

Functions covered

Category Functions
Construction ST_BuildArea, ST_Polygonize
Point result ST_Centroid, ST_GeometricMedian, ST_LabelPoint, ST_PointOnSurface
Hull / Envelope ST_ConvexHull, ST_ConcaveHull, ST_OrientedEnvelope
Simplification ST_Simplify, ST_SimplifyPreserveTopology, ST_SimplifyVW, ST_SimplifyPolygonHull, ST_ReducePrecision
Triangulation ST_DelaunayTriangles, ST_TriangulatePolygon, ST_VoronoiPolygons
Circle ST_MaximumInscribedCircle, ST_MinimumBoundingCircle, ST_MinimumBoundingRadius
Generation ST_GeneratePoints

Changes

  • 21 new SVG files in docs/image/ST_<Name>/
  • 62 doc files updated (21 SQL + 20 Flink + 21 Snowflake)
    • ST_MaximumInscribedCircle is not available in Flink

Visual style

Consistent with Phase 1 (Predicates, PR #2681) and Phase 2 (Overlays, PR #2682):

  • Blue = input geometry (dashed outline where appropriate)
  • Green = result geometry (solid)
  • Category-specific rendering: point markers for centroid-type functions, circle approximation for bounding circle functions, etc.

Functions skipped (already have images)

ST_Buffer, ST_Snap, ST_ApproximateMedialAxis, ST_StraightSkeleton

@jiayuasu
Add SVG visuals for 21 geometry processing functions
6e2a0df 
Add conceptual SVG illustrations for geometry processing functions
in the Sedona documentation. Each function gets one SVG showing the
input geometry and the resulting geometry highlighted.

Functions covered:
- ST_BuildArea, ST_Centroid, ST_ConcaveHull, ST_ConvexHull
- ST_DelaunayTriangles, ST_GeneratePoints, ST_GeometricMedian
- ST_LabelPoint, ST_MaximumInscribedCircle, ST_MinimumBoundingCircle
- ST_MinimumBoundingRadius, ST_OrientedEnvelope, ST_PointOnSurface
- ST_Polygonize, ST_ReducePrecision, ST_Simplify
- ST_SimplifyPolygonHull, ST_SimplifyPreserveTopology, ST_SimplifyVW
- ST_TriangulatePolygon, ST_VoronoiPolygons

Changes:
- 21 new SVG files in docs/image/ST_<Name>/
- 62 doc files updated (21 SQL + 20 Flink + 21 Snowflake)
  (ST_MaximumInscribedCircle not in Flink)

Part of: #2678
@github-actions github-actions bot added the docs label Mar 4, 2026
@jiayuasu jiayuasu requested a review from Copilot March 4, 2026 20:22
@jiayuasu jiayuasu changed the title Add SVG visuals for 21 geometry processing functions [GH-2678] Add SVG visuals for 21 geometry processing functions (Phase 3) Mar 4, 2026
Copilot AI reviewed Mar 4, 2026
View reviewed changes
Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Adds conceptual SVG diagrams for Geometry Processing functions and embeds them into the SQL, Flink, and Snowflake documentation variants as part of the ongoing doc-visuals effort for Sedona.

Changes:

  • Added 21 new SVG illustration files under docs/image/ST_<Name>/.
  • Embedded those SVGs into the corresponding Geometry-Processing markdown docs across SQL/Flink/Snowflake variants.
  • Kept visuals consistent with prior phases’ style (input vs result coloring and simple conceptual shapes).

Reviewed changes

Copilot reviewed 62 out of 83 changed files in this pull request and generated 6 comments.

Show a summary per file
File Description
docs/image/ST_VoronoiPolygons/ST_VoronoiPolygons.svg New SVG illustration for ST_VoronoiPolygons.
docs/image/ST_TriangulatePolygon/ST_TriangulatePolygon.svg New SVG illustration for ST_TriangulatePolygon.
docs/image/ST_SimplifyVW/ST_SimplifyVW.svg New SVG illustration for ST_SimplifyVW.
docs/image/ST_SimplifyPreserveTopology/ST_SimplifyPreserveTopology.svg New SVG illustration for ST_SimplifyPreserveTopology.
docs/image/ST_SimplifyPolygonHull/ST_SimplifyPolygonHull.svg New SVG illustration for ST_SimplifyPolygonHull.
docs/image/ST_Simplify/ST_Simplify.svg New SVG illustration for ST_Simplify.
docs/image/ST_ReducePrecision/ST_ReducePrecision.svg New SVG illustration for ST_ReducePrecision.
docs/image/ST_Polygonize/ST_Polygonize.svg New SVG illustration for ST_Polygonize.
docs/image/ST_PointOnSurface/ST_PointOnSurface.svg New SVG illustration for ST_PointOnSurface.
docs/image/ST_OrientedEnvelope/ST_OrientedEnvelope.svg New SVG illustration for ST_OrientedEnvelope.
docs/image/ST_MinimumBoundingRadius/ST_MinimumBoundingRadius.svg New SVG illustration for ST_MinimumBoundingRadius.
docs/image/ST_MinimumBoundingCircle/ST_MinimumBoundingCircle.svg New SVG illustration for ST_MinimumBoundingCircle.
docs/image/ST_MaximumInscribedCircle/ST_MaximumInscribedCircle.svg New SVG illustration for ST_MaximumInscribedCircle.
docs/image/ST_LabelPoint/ST_LabelPoint.svg New SVG illustration for ST_LabelPoint.
docs/image/ST_GeometricMedian/ST_GeometricMedian.svg New SVG illustration for ST_GeometricMedian.
docs/image/ST_GeneratePoints/ST_GeneratePoints.svg New SVG illustration for ST_GeneratePoints.
docs/image/ST_DelaunayTriangles/ST_DelaunayTriangles.svg New SVG illustration for ST_DelaunayTriangles.
docs/image/ST_ConvexHull/ST_ConvexHull.svg New SVG illustration for ST_ConvexHull.
docs/image/ST_ConcaveHull/ST_ConcaveHull.svg New SVG illustration for ST_ConcaveHull.
docs/image/ST_Centroid/ST_Centroid.svg New SVG illustration for ST_Centroid.
docs/image/ST_BuildArea/ST_BuildArea.svg New SVG illustration for ST_BuildArea.
docs/api/sql/Geometry-Processing/ST_VoronoiPolygons.md Embed new SVG into SQL doc page for ST_VoronoiPolygons.
docs/api/sql/Geometry-Processing/ST_TriangulatePolygon.md Embed new SVG into SQL doc page for ST_TriangulatePolygon.
docs/api/sql/Geometry-Processing/ST_SimplifyVW.md Embed new SVG into SQL doc page for ST_SimplifyVW.
docs/api/sql/Geometry-Processing/ST_SimplifyPreserveTopology.md Embed new SVG into SQL doc page for ST_SimplifyPreserveTopology.
docs/api/sql/Geometry-Processing/ST_SimplifyPolygonHull.md Embed new SVG into SQL doc page for ST_SimplifyPolygonHull.
docs/api/sql/Geometry-Processing/ST_Simplify.md Embed new SVG into SQL doc page for ST_Simplify.
docs/api/sql/Geometry-Processing/ST_ReducePrecision.md Embed new SVG into SQL doc page for ST_ReducePrecision.
docs/api/sql/Geometry-Processing/ST_Polygonize.md Embed new SVG into SQL doc page for ST_Polygonize.
docs/api/sql/Geometry-Processing/ST_PointOnSurface.md Embed new SVG into SQL doc page for ST_PointOnSurface.
docs/api/sql/Geometry-Processing/ST_OrientedEnvelope.md Embed new SVG into SQL doc page for ST_OrientedEnvelope.
docs/api/sql/Geometry-Processing/ST_MinimumBoundingRadius.md Embed new SVG into SQL doc page for ST_MinimumBoundingRadius.
docs/api/sql/Geometry-Processing/ST_MinimumBoundingCircle.md Embed new SVG into SQL doc page for ST_MinimumBoundingCircle.
docs/api/sql/Geometry-Processing/ST_MaximumInscribedCircle.md Embed new SVG into SQL doc page for ST_MaximumInscribedCircle.
docs/api/sql/Geometry-Processing/ST_LabelPoint.md Embed new SVG into SQL doc page for ST_LabelPoint.
docs/api/sql/Geometry-Processing/ST_GeometricMedian.md Embed new SVG into SQL doc page for ST_GeometricMedian.
docs/api/sql/Geometry-Processing/ST_GeneratePoints.md Embed new SVG into SQL doc page for ST_GeneratePoints.
docs/api/sql/Geometry-Processing/ST_DelaunayTriangles.md Embed new SVG into SQL doc page for ST_DelaunayTriangles.
docs/api/sql/Geometry-Processing/ST_ConvexHull.md Embed new SVG into SQL doc page for ST_ConvexHull.
docs/api/sql/Geometry-Processing/ST_ConcaveHull.md Embed new SVG into SQL doc page for ST_ConcaveHull.
docs/api/sql/Geometry-Processing/ST_Centroid.md Embed new SVG into SQL doc page for ST_Centroid.
docs/api/sql/Geometry-Processing/ST_BuildArea.md Embed new SVG into SQL doc page for ST_BuildArea.
docs/api/flink/Geometry-Processing/ST_VoronoiPolygons.md Embed new SVG into Flink doc page for ST_VoronoiPolygons.
docs/api/flink/Geometry-Processing/ST_TriangulatePolygon.md Embed new SVG into Flink doc page for ST_TriangulatePolygon.
docs/api/flink/Geometry-Processing/ST_SimplifyVW.md Embed new SVG into Flink doc page for ST_SimplifyVW.
docs/api/flink/Geometry-Processing/ST_SimplifyPreserveTopology.md Embed new SVG into Flink doc page for ST_SimplifyPreserveTopology.
docs/api/flink/Geometry-Processing/ST_SimplifyPolygonHull.md Embed new SVG into Flink doc page for ST_SimplifyPolygonHull.
docs/api/flink/Geometry-Processing/ST_Simplify.md Embed new SVG into Flink doc page for ST_Simplify.
docs/api/flink/Geometry-Processing/ST_ReducePrecision.md Embed new SVG into Flink doc page for ST_ReducePrecision.
docs/api/flink/Geometry-Processing/ST_Polygonize.md Embed new SVG into Flink doc page for ST_Polygonize.
docs/api/flink/Geometry-Processing/ST_PointOnSurface.md Embed new SVG into Flink doc page for ST_PointOnSurface.
docs/api/flink/Geometry-Processing/ST_OrientedEnvelope.md Embed new SVG into Flink doc page for ST_OrientedEnvelope.
docs/api/flink/Geometry-Processing/ST_MinimumBoundingRadius.md Embed new SVG into Flink doc page for ST_MinimumBoundingRadius.
docs/api/flink/Geometry-Processing/ST_MinimumBoundingCircle.md Embed new SVG into Flink doc page for ST_MinimumBoundingCircle.
docs/api/flink/Geometry-Processing/ST_LabelPoint.md Embed new SVG into Flink doc page for ST_LabelPoint.
docs/api/flink/Geometry-Processing/ST_GeometricMedian.md Embed new SVG into Flink doc page for ST_GeometricMedian.
docs/api/flink/Geometry-Processing/ST_GeneratePoints.md Embed new SVG into Flink doc page for ST_GeneratePoints.
docs/api/flink/Geometry-Processing/ST_DelaunayTriangles.md Embed new SVG into Flink doc page for ST_DelaunayTriangles.
docs/api/flink/Geometry-Processing/ST_ConvexHull.md Embed new SVG into Flink doc page for ST_ConvexHull.
docs/api/flink/Geometry-Processing/ST_ConcaveHull.md Embed new SVG into Flink doc page for ST_ConcaveHull.
docs/api/flink/Geometry-Processing/ST_Centroid.md Embed new SVG into Flink doc page for ST_Centroid.
docs/api/flink/Geometry-Processing/ST_BuildArea.md Embed new SVG into Flink doc page for ST_BuildArea.
docs/api/snowflake/vector-data/Geometry-Processing/ST_VoronoiPolygons.md Embed new SVG into Snowflake doc page for ST_VoronoiPolygons.
docs/api/snowflake/vector-data/Geometry-Processing/ST_TriangulatePolygon.md Embed new SVG into Snowflake doc page for ST_TriangulatePolygon.
docs/api/snowflake/vector-data/Geometry-Processing/ST_SimplifyVW.md Embed new SVG into Snowflake doc page for ST_SimplifyVW.
docs/api/snowflake/vector-data/Geometry-Processing/ST_SimplifyPreserveTopology.md Embed new SVG into Snowflake doc page for ST_SimplifyPreserveTopology.
docs/api/snowflake/vector-data/Geometry-Processing/ST_SimplifyPolygonHull.md Embed new SVG into Snowflake doc page for ST_SimplifyPolygonHull.
docs/api/snowflake/vector-data/Geometry-Processing/ST_Simplify.md Embed new SVG into Snowflake doc page for ST_Simplify.
docs/api/snowflake/vector-data/Geometry-Processing/ST_ReducePrecision.md Embed new SVG into Snowflake doc page for ST_ReducePrecision.
docs/api/snowflake/vector-data/Geometry-Processing/ST_Polygonize.md Embed new SVG into Snowflake doc page for ST_Polygonize.
docs/api/snowflake/vector-data/Geometry-Processing/ST_PointOnSurface.md Embed new SVG into Snowflake doc page for ST_PointOnSurface.
docs/api/snowflake/vector-data/Geometry-Processing/ST_OrientedEnvelope.md Embed new SVG into Snowflake doc page for ST_OrientedEnvelope.
docs/api/snowflake/vector-data/Geometry-Processing/ST_MinimumBoundingRadius.md Embed new SVG into Snowflake doc page for ST_MinimumBoundingRadius.
docs/api/snowflake/vector-data/Geometry-Processing/ST_MinimumBoundingCircle.md Embed new SVG into Snowflake doc page for ST_MinimumBoundingCircle.
docs/api/snowflake/vector-data/Geometry-Processing/ST_MaximumInscribedCircle.md Embed new SVG into Snowflake doc page for ST_MaximumInscribedCircle.
docs/api/snowflake/vector-data/Geometry-Processing/ST_LabelPoint.md Embed new SVG into Snowflake doc page for ST_LabelPoint.
docs/api/snowflake/vector-data/Geometry-Processing/ST_GeometricMedian.md Embed new SVG into Snowflake doc page for ST_GeometricMedian.
docs/api/snowflake/vector-data/Geometry-Processing/ST_GeneratePoints.md Embed new SVG into Snowflake doc page for ST_GeneratePoints.
docs/api/snowflake/vector-data/Geometry-Processing/ST_DelaunayTriangles.md Embed new SVG into Snowflake doc page for ST_DelaunayTriangles.
docs/api/snowflake/vector-data/Geometry-Processing/ST_ConvexHull.md Embed new SVG into Snowflake doc page for ST_ConvexHull.
docs/api/snowflake/vector-data/Geometry-Processing/ST_ConcaveHull.md Embed new SVG into Snowflake doc page for ST_ConcaveHull.
docs/api/snowflake/vector-data/Geometry-Processing/ST_Centroid.md Embed new SVG into Snowflake doc page for ST_Centroid.
docs/api/snowflake/vector-data/Geometry-Processing/ST_BuildArea.md Embed new SVG into Snowflake doc page for ST_BuildArea.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

@jiayuasu
Fix image placement splitting Introduction sentences
081d0ac 
Move SVG image references after the complete Introduction paragraph
for ST_LabelPoint and ST_SimplifyPreserveTopology across all 3 doc
variants (SQL, Flink, Snowflake).
@jiayuasu jiayuasu requested a review from Copilot March 4, 2026 20:46
Copilot AI reviewed Mar 4, 2026
View reviewed changes
Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Copilot reviewed 62 out of 83 changed files in this pull request and generated no new comments.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

@jiayuasu jiayuasu merged commit 77c29df into master Mar 4, 2026
13 checks passed
This was referenced Mar 4, 2026
Merged
Merged
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

Copilot code review Copilot Copilot left review comments

Assignees

No one assigned

Labels

docs

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

2 participants

@jiayuasu