## Top 5 Recent Articles

##### ARTICLES CATEGORIES

- Algorithms (13)
- All (401)
- Biography (1)
- Blog (44)
- Business Requirements (1)
- Commentary (1)
- Customers (2)
- Data Models (1)
- Education (2)
- GeoRaptor (2)
- Image Processing (2)
- Import Export (5)
- Licensing (2)
- Linear Referencing (3)
- Manifold GIS (3)
- Mapping (1)
- MySQL Spatial (7)
- Networking and Routing (including Optimization) (3)
- Open Source (16)
- Oracle Spatial and Locator (177)
- PostGIS (33)
- Published Articles (1)
- Recommendations (1)
- Services (1)
- Software Change Log (1)
- Source Code (35)
- Space Curves (9)
- Spatial Database Functions (102)
- Spatial DB comparison (1)
- Spatial XML Processing (10)
- SQL Server Spatial (General) (83)
- SQL Server Spatial (LRS) (38)
- Standards (1)
- Stored Procedure (15)
- Tessellation or Gridding (9)
- Tools (2)
- Training (2)

# Oracle Spatial Centroid Shootout

**Centroid Shootout**

*(WARNING: I have completely re-written my centroid code since this article when I discovered that the algorithm I had been supplied by a third-party failed in one important case. Instead of fixing the existing algorithm I completely re-wrote it and have also added support for polygons and mutil-point geometries. I will edit all centroid related articles some time soon.)*

I get a lot of requests for help with the centroid function in my PL/SQL packages. It seems to be a universal need people have that is not met by Oracle Locator/Spatial. So I thought I would write a little article on the different centroid functions that are available in Oracle and compare them in a final image!

For all my tests I will use a “half moon” polygon in order to show the differences in the algorithms. An image of the polygon is included at the end of this article.

**1. MdSys.Sdo_Geom.Sdo_Centroid**

This is a standard mathematical weighted centroid that is part of Oracle. It has been subject to license restrictions in the past and is still subject to license restrictions for Locator users at 11g (see Appendix B: Oracle Locator). Regardless, let’s see how to use it and how good is its result.

gis@XE> SELECT mdsys.sdo_geom.sdo_centroid(poly,0.05) 2 FROM (select 3 mdsys.sdo_geometry(2003,null,null, 4 sdo_elem_info_array(1,1003,1), 5 sdo_ordinate_array( 69,9.5,206,86.5,397,185.5,553,189.5,698,143.5,920,-7.5,853,105.5,704,259.5,537,307.5,403,271.5,183,134.5,69,9.5) 6 ) as poly from dual) 7 / MDSYS.SDO_GEOM.SDO_CENTROID(POLY,0.05)(SDO_GTYPE, SDO_SRID, SDO_POINT(X, Y, Z), SDO_ELEM_INFO, SDO_ORDINATES) ------------------------------------------------------------------------------------------------------------- SDO_GEOMETRY(2001, NULL, SDO_POINT_TYPE(532.434696, 184.742483, NULL), NULL, NULL)

You can refer to the image at the end of this article to see where this point lies in relation to our polygon. But a quick check with sdo_geom.relate() will tell us the most critical information:

gis@XE> SELECT mdsys.sdo_geom.relate(poly,'mask=DETERMINE', 2 mdsys.sdo_geom.sdo_centroid(poly,0.05),0.05) 3 FROM (select 4 mdsys.sdo_geometry(2003,null,null, 5 sdo_elem_info_array(1,1003,1), 6 sdo_ordinate_array( 69,9.5,206,86.5,397,185.5,553,189.5,698,143.5,920,-7.5,853,105.5,704,259.5,537,307.5,403,271.5,183,134.5,69,9.5) 7 ) as poly from dual) 8 / MDSYS.SDO_GEOM.RELATE(POLY,'MASK=DETERMINE',MDSYS.SDO_GEOM.SDO_CENTROID(POLY,0.05),0.05) ---------------------------------------------------------------------------------------- DISJOINT

Not good.

**2. MdSys.ST_Polygon.ST_Centroid()**

Oracle’s little known SQL/MM compliant type library includes a ST_Centroid() as per the standard. There is no mention in the Oracle licensing that this is a restricted function for the SQL/MM type library.

gis@XE> SELECT mdsys.st_polygon(poly).ST_Centroid() 2 FROM (select 3 mdsys.sdo_geometry(2003,null,null, 4 sdo_elem_info_array(1,1003,1), 5 sdo_ordinate_array( 69,9.5,206,86.5,397,185.5,553,189.5,698,143.5,920,-7.5,853,105.5,704,259.5,537,307.5,403,271.5,183,134.5,69,9.5) 6 ) as poly from dual) 7 / MDSYS.ST_POLYGON(POLY).ST_CENTROID()(GEOM(SDO_GTYPE, SDO_SRID, SDO_POINT(X, Y, Z), SDO_ELEM_INFO, SDO_ORDINATES)) ----------------------------------------------------------------------------------------------------------------- ST_POINT(SDO_GEOMETRY(2001, NULL, SDO_POINT_TYPE(532.434696, 184.742483, NULL), NULL, NULL))

Where is this in relation to the polygon?

gis@XE> list 1 SELECT mdsys.st_polygon(poly).ST_Disjoint(mdsys.st_polygon(poly).ST_Centroid()) 2 FROM (select 3 mdsys.sdo_geometry(2003,null,null, 4 sdo_elem_info_array(1,1003,1), 5 sdo_ordinate_array( 69,9.5,206,86.5,397,185.5,553,189.5,698,143.5,920,-7.5,853,105.5,704,259.5,537,307.5,403,271.5,183,134.5,69,9.5) 6* ) as poly from dual) gis@XE> / MDSYS.ST_POLYGON(POLY).ST_DISJOINT(MDSYS.ST_POLYGON(POLY).ST_CENTROID()) ------------------------------------------------------------------------ 1

Again, a similar result (the centroid is not inside the polygon), as it is the same algorithm.

**3. MdSys.Sdo_Geom.Sdo_PointOnSurface()**

The sdo_geom package has a license restricted point-on-surface function.

gis@XE> SELECT mdsys.sdo_geom.SDO_PointOnSurface(poly,0.05) 2 FROM (select 3 mdsys.sdo_geometry(2003,null,null, 4 sdo_elem_info_array(1,1003,1), 5 sdo_ordinate_array( 69,9.5,206,86.5,397,185.5,553,189.5,698,143.5,920,-7.5,853,105.5,704,259.5,537,307.5,403,271.5,183,134.5,69,9.5) 6* ) as poly from dual) gis@XE> / MDSYS.SDO_GEOM.SDO_POINTONSURFACE(POLY,0.05)(SDO_GTYPE, SDO_SRID, SDO_POINT(X, Y, Z), SDO_ELEM_INFO, SDO_ORDINATES) ------------------------------------------------------------------------------------------------------------------- SDO_GEOMETRY(2001, NULL, SDO_POINT_TYPE(69, 9.5, NULL), NULL, NULL)

Checking we get:

gis@XE> SELECT mdsys.sdo_geom.relate(poly,'mask=DETERMINE', 2 mdsys.sdo_geom.sdo_PointOnSurface(poly,0.05),0.05) 3 FROM (select 4 mdsys.sdo_geometry(2003,null,null, 5 sdo_elem_info_array(1,1003,1), 6 sdo_ordinate_array( 69,9.5,206,86.5,397,185.5,553,189.5,698,143.5,920,-7.5,853,105.5,704,259.5,537,307.5,403,271.5,183,134.5,69,9.5) 7 ) as poly from dual) 8 / MDSYS.SDO_GEOM.RELATE(POLY,'MASK=DETERMINE',MDSYS.SDO_GEOM.SDO_POINTONSURFACE(POLY,0.05),0.05) ---------------------------------------------------------------------------------------------- TOUCH

That is, the generated centroid falls on the polygon’s boundary but not inside.

**4. MdSys.ST_Polygon.ST_PointOnSurface() **

Similarly, the SQL/MM ST_Polygon has a point-on-surface function that, funnily, is not license restricted!

gis@XE> SELECT mdsys.ST_Polygon(poly).ST_PointOnSurface() 2 FROM (select 3 mdsys.sdo_geometry(2003,null,null, 4 sdo_elem_info_array(1,1003,1), 5 sdo_ordinate_array( 69,9.5,206,86.5,397,185.5,553,189.5,698,143.5,920,-7.5,853,105.5,704,259.5,537,307.5,403,271.5,183,134.5,69,9.5) 6* ) as poly from dual) gis@XE> / MDSYS.ST_POLYGON(POLY).ST_POINTONSURFACE()(GEOM(SDO_GTYPE, SDO_SRID, SDO_POINT(X, Y, Z), SDO_ELEM_INFO, SDO_ORDINATES)) ------------------------------------------------------------------------------------------------------------------------ ST_POINT(SDO_GEOMETRY(2001, NULL, SDO_POINT_TYPE(183.006, 134.492, NULL), NULL, NULL))

This is an interesting result as the generated centroid is not the same as the one generated by SDO_GEOM.SDO_POINTONSURFACE(). How does this centroid fair in relation to the actual polygon?

gis@XE> SELECT mdsys.st_polygon(poly).ST_Contains(mdsys.ST_Polygon(poly).ST_PointOnSurface()) 2 FROM (select 3 mdsys.sdo_geometry(2003,null,null, 4 sdo_elem_info_array(1,1003,1), 5 sdo_ordinate_array( 69,9.5,206,86.5,397,185.5,553,189.5,698,143.5,920,-7.5,853,105.5,704,259.5,537,307.5,403,271.5,183,134.5,69,9.5) 6* ) as poly from dual) gis@XE> / MDSYS.ST_POLYGON(POLY).ST_CONTAINS(MDSYS.ST_POLYGON(POLY).ST_POINTONSURFACE()) ------------------------------------------------------------------------------ 1

Finally, we have a centroid inside the polygon. (See image at the end of this article for just where this centroid lies in relation to the polygon.)

** 5. Codesys.Geom.Sdo_Centroid() **

Finally, there is my own (see note below on ownership) humble offering.

gis@XE> SELECT codesys.geom.sdo_centroid(poly,0.05) 2 FROM (select 3 mdsys.sdo_geometry(2003,null,null, 4 sdo_elem_info_array(1,1003,1), 5 sdo_ordinate_array( 69,9.5,206,86.5,397,185.5,553,189.5,698,143.5,920,-7.5,853,105.5,704,259.5,537,307.5,403,271.5,183,134.5,69,9.5) 6* ) as poly from dual) gis@XE> / CODESYS.GEOM.SDO_CENTROID(POLY,0.05)(SDO_GTYPE, SDO_SRID, SDO_POINT(X, Y, Z), SDO_ELEM_INFO, SDO_ORDINATES) ----------------------------------------------------------------------------------------------------------- SDO_GEOMETRY(2001, NULL, SDO_POINT_TYPE(494.5, 242.1, NULL), NULL, NULL)

Checking its location reveals it falls within the polygon and is well placed (see image at end of article).

gis@XE> SELECT mdsys.sdo_geom.relate(poly,'mask=DETERMINE', 1 codesys.geom.sdo_centroid(poly,0.05),0.05) 2 FROM (select 3 mdsys.sdo_geometry(2003,null,null, 4 sdo_elem_info_array(1,1003,1), 5 sdo_ordinate_array( 69,9.5,206,86.5,397,185.5,553,189.5,698,143.5,920,-7.5,853,105.5,704,259.5,537,307.5,403,271.5,183,134.5,69,9.5) 6* ) as poly from dual) gis@XE> / MDSYS.SDO_GEOM.RELATE(POLY,'MASK=DETERMINE',CODESYS.GEOM.SDO_CENTROID(POLY,0.05),0.05) --------------------------------------------------------------------------------------- CONTAINS

Excellent. But is that all the story? See the image at the end of this article to see where it is actually located.

**6. Rough as Guts SQL Average **

One can average the X and Y ordinates of a geometry by extracting them in a table function. Yes, one can use sdo_util.GetVertices() but I will use a function in my own packages that I wrote a few years ago.

gis@XE> SELECT avg(p.x) as x,avg(p.y) as y 2 FROM table(codesys.geom.getpointset( 3 mdsys.sdo_geometry(2003,null,null, 4 sdo_elem_info_array(1,1003,1), 5 sdo_ordinate_array( 69,9.5,206,86.5,3 6* ))) p gis@XE> / X Y ----------- ----------- 466.000 141.250

Where is it located?

gis@XE> SELECT mdsys.sdo_geom.relate( 2 mdsys.sdo_geometry(2003,null,null, 3 sdo_elem_info_array(1,1003,1), 4 sdo_ordinate_array( 69,9.5,206,86.5,397,185.5,553,189.5,698,143.5,920,-7.5,853,105.5,704,259.5,537,307.5,403,271.5,183,134.5,69,9.5)), 5 'mask=DETERMINE', 6 mdsys.sdo_geometry(2001,null,sdo_point_type(avg(p.x),avg(p.y),NULL),NULL,NULL),0.05) 7 FROM table(codesys.geom.getpointset( 8 mdsys.sdo_geometry(2003,null,null, 9 sdo_elem_info_array(1,1003,1), 10 sdo_ordinate_array( 69,9.5,206,86.5,397,185.5,553,189.5,698,143.5,920,-7.5,853,105.5,704,259.5,537,307.5,403,271.5,183,134.5,69,9.5)) 11* )) p gis@XE> / MDSYS.SDO_GEOM.RELATE(MDSYS.SDO_GEOMETRY(2003,NULL,NULL,SDO_ELEM_INFO_ARRAY(1,1003,1),SDO_ORDINATE_ARRAY(69,9.5,206,86.5,397,185.5, ----------------------------------------------------------------------------------------------------------------------------------- DISJOINT

Outside the polygon.

**Summary**

In summary, the best algorithm is the one encapsulated within my geom.sdo_centroid function. It guarantees that the generated centroid falls within the polygon but is “well conditioned” with respect to that location. Also, the algorithm used will not place the centroid inside a hole (inner shell) inside a polygon; also, it will choose the largest of any parts (multiple outer shells) into which it will place the centroid. The original algorithm was not created by myself (though I have modified it for cases the original author missed; I added the code to select the largest part in a multi-part polygon) but I have permission to make it public and have done so for the past 6 years.. The origial coding was in Java: I only converted it to PL/SQL. If anyone wants a Java version contact me via email and I will supply it.

**Image **

The following image shows the relative locations of each of the centroids generated by the processing above.

!/images/13.gif (Centroid Shoot Out)!

## Documentation

- MySQL Spatial General Function Documentation
- Oracle Spatial Exporter Package Documentation
- Oracle Spatial Object Function Documentation
- Oracle Spatial Object Function Documentation (Multi Page Version)
- PostGIS pl/pgSQL Function Documentation
- SC4O Oracle Java Topology Suite (Stored Procedures) Package Documentation
- SQL Server Spatial General TSQL Function Documentation
- SQL Server Spatial LRS TSQL Function Documentation