Go to content Go to navigation and search

Home

Current Oracle Spatial Blog Articles

    GeoRaptor 4.x Update 2 (Project has Stalled)
    Tip: Drop that Spatial Index!
    Convert Single Geometry to Multi-part Geometry in Oracle Spatial
    Optimized Rectangle to 5 Point Polygon
    Centroid Package now supports Y ordinate seeding
    Convert GeoJSON document to Sdo_Geometry objects
    Implementation Of Travelling Salesman Problem
    Create Polygon From Bearings And Distances
    Function That Returns a Compass Point From a Whole Circle Bearing
    Playing around with Centroids by using different seed values
    Simple Oracle C Sprintf or Java String.format
    Some Oriented Point Functions
    Extracting Inner Rings Changed Ordinate Ordering: A Trap For Players Who Don't Read Documentation!
    PLS-00306: wrong number or types of arguments in call to 'SDO_GEOMETRY'
    Converting Google Earth Formatted Longitude/Latitude points to decimal degrees
    Oracle Business Intelligence Warehousing and Analytics - Spatial Summit
    How far inside, is inside? Measuring actual distance.
    Noding and building a polygon from single, overlapping linestrings
    Analyzing Spatial Query Performance Improvements in Oracle Spatial and Graph 12c Through Cross-Vendor Comparison
    ST_VertexN / ST_PointN - Extracting a specific point from any geometry
    Convert Single Point stored in SDO_ORDINATES to SDO_POINT_TYPE
    Aggregate APPEND Islands and XOR polygons
    Circular Arcs in Geodetic Polygons
    Some SDO_GEOMETRY/DIMINFO handling functions
    Applying And Extending Oracle Spatial - Book Released
    Changing all DIMINFO sdo_tolerance values for all metadata records in one go.
    Building Polygons from Incomplete Linestrings using ST_PolygonBuilder
    Computing Cardinal Directions to nearby geometries
    Intersecting two aggregated polygon layers with SC4O
    Spatial and Oracle 12c
    Update Triggers and SDO_GEOMETRY Equality
    Duplicate Geometry data and Data Models
    CENTROID package update
    How to calculate cumulative length of a linestring
    Useful Package of Wrapper Functions for Sdo_Util.AffineTransforms
    Compute Location from known Lat/Long point using delta easting and northing in miles
    SDO_AGGR_SET_UNION
    Sorting SDO_GEOMETRY data using the ORDER BY clause of a SELECT statement
    Creating linestrings from points
    Rounding Coordinates or Ordinates in SDO_GEOMETRY
    Effects of Sdo_Geometry Ordinate Precision on Performance
    Effects of Sdo_Geometry Ordinate Precision on Storage
    The Spatial filtering of geometries: The effect of tolerances on relationships
    Application of Delaunay Triangulation and Inverse Distance Weighting (IDW) in Oracle for Soils Interpolation
    Selecting all SDO_GTYPE values for all tables/sdo_geometry columns in a schema
    CENTROID package - Tips for Use
    Announcing the Spatial Companion For Oracle (SC4O)
    Filtering Rings (Oracle Spatial)
    Splitting a polygon using one or more linestrings
    isValid, isSimple, Dimension and CoordDim methods for SDO_Geometry
    Line Merging or Collecting lines together: ST_LineMerger
    ST_DeleteVertex for Oracle SDO_Geometry based on Jaspa/JTS
    3D/4D and SRID aware Conversion functions for SDO_Geometry: WKT and EWKT
    Topological vs Non-Topological Simplification/Generalization of Aggregated Area Geometies in Oracle
    Filtering very short linestrings via bitmap function index
    CENTROID For Oracle
    Gridding a sdo_geometry line/polygon object (Oracle)
    Finding centre and radius of a circular geometry
    Constraining geometry type for sdo_geometry column in a table.
    CASE Statements and SDO_GEOMETRY
    The Power of Constraints and Indexes for Spatial Constraints: stopping duplicate points
    Replacement for SDO_GEOM.RELATE - ST_Relate based on JTS
    Changing Oracle Spatial Index Parameters on existing index
    Writing Excel Spreadsheets files from within the Oracle database using Java and PL/SQL
    Writing xSV (eg csv) files from within the Oracle database using Java and PL/SQL
    A simple spike finder for Spatial/Locator
    JTS Java class compilation for 11g and above
    Random Spatial Search Procedure
    Geometry Snapping using JTS in Oracle
    Exposing JTS's MinimumBoundingCircle functionality
    Exposing JTS's Densifier functionality
    Using JTS's Comparison Functions - HausdorffSimilarityMeasure & AreaSimilarityMeasure with SDO_GEOMETRY
    Free JTS-based Area/Length Functions
    Handy way of systematically fixing polygon geometries with 13349 and other errors
    Standalone CENTROID package now available for download
    Free Union, Intersection, Xor and Difference Functions for Oracle Locator - Part 4 Processing Geodetic data
    Configurable Buffer: JTS and Oracle
    Free Union, Intersection, Xor and Difference Functions for Oracle Locator - Part 3
    Free Union, Intersection, Xor and Difference Functions for Oracle Locator - Part 2
    Free Union, Intersection, Xor and Difference Functions for Oracle Locator - Part 1
    Building Lines into Polygons in Oracle Locator / Spatial
    Finding Intersection Points between Line and Polygon
    SDO2GeoJSON
    Free version of sdo_length
    Alternative to my SQL based GetNumRings function
    External Tables and SDO_Geometry data.
    layer_gtype keyword issue when indexing linear data on 11g
    String Tokenizer for Oracle
    Free Aggregate Method for Concatenating 2D Lines in Oracle Locator 10g
    Reducing 5 Vertex Polygon to Optimized Rectangle
    Square Buffer
    Converting decimal seconds to string
    SDO_GEOM.VALIDATE_GEOMETRY_WITH_CONTEXT - 13356 Issues
    Valid conversion unit values for Oracle sdo_geom.sdo_length()
    Removing Steps in Gridded Vector Data - SmoothGrid for Oracle
    Oracle Spatial DISJOINT search/filtering
    Creating SDO_Geometry from geometric data recorded in the columns of a table
    Concave Hull Geometries in Oracle 11gR2
    Projecting SDO_GEOM_METADATA DIMINFO XY ordinates
    Instantiating MDSYS.VERTEX_TYPE
    New PL/SQL Packages - Rotate oriented point
    GeoRaptor Development Team
    Fast Refreshing Materialized View Containing SDO_GEOMETRY and SDO_GEOM.SDO_AREA function
    Performance of PL/SQL Functions using SQL vs Pure Code
    Implementing the BEST VicGrid Projection in Oracle 10gR2
    Making Sdo Geometry Metadata Update Generic Code
    ORA-13011 errors when using SDO_GEOM.VALIDATE_LAYER_WITH_CONTEXT()
    Extract Polygons from Compound Polygon
    Detecting sdo_geometries with compound (3-point Arcs) segments
    GEOMETRY_COLUMNS for Oracle Spatial
    Convert GML to SDO_Geometry in Oracle 10gR2
    Spatial Sorting of Data via Morton Key
    Swapping Ordinates in an SDO_GEOMETRY object
    New To_3D Function
    Extend (Reduce/Contract/Skrink) Function for Oracle
    Loading and Processing GPX 1.1 files using Oracle XMLDB
    Loading Spatial Data from an external CSV file in Oracle
    Calling the Oracle Spatial shapefile loader from within the Oracle database itself
    Implementing SDO_VertexUpdate/ST_VertexUpdate for Oracle
    Implementing SDO_RemovePoint/ST_RemovePoint for Oracle
    Implementing SDO_AddPoint/ST_AddPoint for Oracle
    ESRI ArcSDE Exverted and Inverted Polygons and Oracle Spatial
    Funky Fix Ordinates By Formula
    Implementing a SetPoint/ST_SetPoint function in Oracle
    Implementing an ST_SnapToGrid (PostGIS) function for Oracle Spatial
    Generating random point data
    Implementing an Affine/ST_Affine function for Oracle Spatial
    Implementing a Scale/ST_Scale function for Oracle Spatial
    Implementing a Parallel/ST_Parallel function for linestring data for Oracle Spatial
    Implementing a Rotate/ST_Rotate function for Oracle Spatial
    Limiting table list returned when connecting to Oracle Database using ODBC
    ST_Azimuth for Oracle: AKA Cogo.Bearing
    Implementing a Translate/ST_Translate/Move function for Oracle Spatial
    Elem_Info_Array Processing: An alternative to SDO_UTIL.GetNumRings and querying SDO_ELEM_INFO itself
    Minumum Bounding Rectangle (MBR) Object Type for Oracle
    How to extract elements from the result of an sdo_intersection of two polygons.
    How to restart a database after failed parameter change
    Fixing failed spatial indexes after import using data pump
    generate_series: an Oracle implementation in light of SQL Design Patterns
    Multi-Centroid Shootout
    Oracle Spatial Centroid Shootout
    On the use of ROLLUP in Oracle SELECT statements
    Surrounding Parcels
    Spatial Pipelining
    Using Oracle's SDO_NN Operator - Some examples
    Converting distances and units of measure in Oracle Locator
    Split Sdo_Geometry Linestring at a known point
    Forcing an Sdo_Geometry object to contain only points, lines or areas
    Unpacking USER_SDO_GEOM_METADATA's DIMINFO structure using SQL
    Generating multi-points from single point records in Oracle Spatial
    Object Tables of Sdo_Geometry
    Oracle Locator vs Oracle Spatial: A Reflection on Oracle Licensing of the SDO_GEOM Package
    FAST REFRESHing of Oracle Materialized Views containing Sdo_Geometry columns
    Australian MGA/AMG Zone Calculation from geographic (longitude/latitude) data
    Loading Shapefiles (SHP) into Oracle Spatial
    Oracle Spatial Mapping and Map Rendering Performance Tips
    The significance of sdo_lb/sdo_ub in USER_SDO_GEOM_METDATA: Do I need it?
    Oracle Spatial Forum - Melbourne April 2007
    Layer_GTypes for spatial indexes
    Oracle's SQL/MM Compliant Types
    Tips and Tricks

Search

    Browse

RSS / Atom

Email me

textpattern

Creative Commons License
All Blog Articles, Data Models and Free Source Code by Simon Greener, The SpatialDB Advisor is licensed under a Creative Commons Attribution-ShareAlike 3.0 Unported License.

Implementing a Translate/ST_Translate/Move function for Oracle Spatial

Monday December 22 2008 at 10:56

Many years ago I wrote a PL/SQL function to move any sdo_geometry when supplied a “delta” in terms of deltaX, deltaY and optionally deltaZ. This function also allowed a user to supply an envelope, box or minimum bounding rectangle (MBR) to the function so that only those vertices that lie within an sdo_geometry object would be moved.

I often play with PostGIS and have found the writings on Regina Obe very enlightening. PostGIS contains a function called ST_Translate (not part of the SQL/MM standard) which is identical to my original Move function.

So, recently, I decided to re-visit my Move function to improve its implementation, and provide ST_Translate wrappers for it.

This article summarises this recent work.

PostGIS’s ST_Translate function is described, neatly, by its documentation so I will duplicate the examples it for my Oracle implementation.

/* Move a point 1 degree longitude */
/* PostGIS */
SELECT ST_AsText(ST_Translate(ST_GeomFromText('POINT(-71.01 42.37)',4326),1,0)) As wgs_transgeomtxt;

	wgs_transgeomtxt
	---------------------
	POINT(-70.01 42.37)

/* Oracle */
SELECT Geom.ST_Translate(mdsys.ST_Geometry.From_WKT('POINT(-71.01 42.37)',4326),1,0).Get_WKT() As wgs_transgeomtxt from dual;

WGS_TRANSGEOMTXT
---------------------------
(CLOB) POINT (-70.01 42.37)

1 rows selected

/* Move a linestring 1 degree longitude and 1/2 degree latitude*/
/* PostGIS */
SELECT ST_AsText(ST_Translate(ST_GeomFromText('LINESTRING(-71.01 42.37,-71.11 42.38)',4326),1,0.5)) As wgs_transgeomtxt;

		   wgs_transgeomtxt
	---------------------------------------
	LINESTRING(-70.01 42.87,-70.11 42.88)

/* Oracle */
SELECT Geom.ST_Translate(mdsys.ST_Geometry.From_WKT('LINESTRING(-71.01 42.37,-71.11 42.38)',4326),1,0.5).Get_WKT() As wgs_transgeomtxt from dual;

WGS_TRANSGEOMTXT
----------------------------------------------
(CLOB) LINESTRING (-70.01 42.87, -70.11 42.88)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   

1 rows selected

/* Move a 3d point */
/* PostGIS */
SELECT ST_AsEWKT(ST_Translate(CAST('POINT(0 0 0)' As geometry), 5, 12,3));

	st_asewkt
	---------
	POINT(5 12 3)	

/* Oracle */
SELECT Geom.AsEWKT(Geom.ST_Translate(mdsys.SDO_Geometry(3001,Null,sdo_point_type(0,0,0),null,null),5,12,3)) as st_asewkt FROM DUAL;

ST_ASEWKT
---------------------------
(CLOB) POINT XYZ (5 12 3) )

1 rows selected

/* Move a curve and a point */
/* PostGIS */
SELECT ST_AsText(ST_Translate(ST_Collect('CURVEPOLYGON(CIRCULARSTRING(4 3,3.12 0.878,1 0,-1.121 5.1213,6 7, 8 9,4 3))','POINT(1 3)'),1,2));

		                                                 st_astext                                                  
------------------------------------------------------------------------------------------------------------
 GEOMETRYCOLLECTION(CURVEPOLYGON(CIRCULARSTRING(5 5,4.12 2.878,2 2,-0.121 7.1213,7 9,9 11,5 5)),POINT(2 5))

/* Oracle */
SELECT GEOM.AsEWKT(Geom.ST_Translate(MDSYS.SDO_GEOMETRY(2003,null,null,MDSYS.SDO_ELEM_INFO_ARRAY(1,1005,1,1,2,2),MDSYS.SDO_ORDINATE_ARRAY(4,3,7,4,6,7,-1.121,5.1213,1,0,3.12,0.878,4,3)),1,2)) as st_asText from dual;

ST_ASTEXT
-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
(CLOB) POLYGON XY ( MULTICURVEPOLYGON( CURVESTRING(5.0 5.0, 8.0 6.0, 7.0 9.0, -0.121 7.1213 2.0 2.0, 4.12 2.878, 5.0 5.0)) )

1 rows selected

OK, so my functions pass the “PostGIS” test.

That is all well and good with the standard parameters, but is that all?

What I have found is that, sometimes, you want to move only part of a geometry object. For example, at Forestry Tasmania, when I was GIS Manager, we had a situation, before my time, where King Island (see image below) had been artificially moved from its geographic position to an artificial position for the purposes of map production (it was also related to single precision vs double precision ArcInfo coverages but that is another story). When implementing a change from the Australian Map Grid (AMG, based on the Australian Geodetic Datum 1966) to the Map Grid of Australia (based on the Australian Geodetic Datum 1994), we had to first move King Island back to its normal AMG position before projecting it to MGA.

King Island Original

In this situation, I found that the Move function needed to be enhanced to allow for the provision of a minimum bounding rectangle (MBR) which the function tested against each vertex in an sdo_geometry object such that it moved only those which the INSIDE topological relationship.

In summary, the ST_Translate PostGIS function needs enhancing to allow for this possibility. I will now present the Move and ST_Translate functions which are implemented in the GEOM package which is a part of my free PL/SQL functions. I will only present the relevant package specifications:

  /* ----------------------------------------------------------------------------------------
  * function   : MOVE
  * precis     : Function which updates all coordinates in a shape by applying x/y shift.
  * version    : 2.0
  * description: In order to be able to apply the King Island move to the shapes stored
  *               in an Oracle Spatial shape, a function is needed that iterates though
  *               all the coordinates of a shape and applys a deltaX and deltaY to them.
  *               If p_envelope is provided, only those coordinate that fall within it are moved:
  *               otherwise all are moved.
  * usage      : Function move ( p_geometry IN MDSYS.SDO_GEOMETRY,
  *                               p_deltaX IN number,
  *                               p_deltaY IN number,
  *                               p_envelope IN MDSYS.SDO_GEOMETRY ) RETURN MDSYS.SDO_GEOMETRY DETERMINISTIC;
  *               eg fixedShape := CODESYS.geom.tolerance(shape,diminfo);
  * param      : p_geometry    : The shape to move.
  * paramtype  : p_geomery     : MDSYS.SDO_GEOMETRY
  * param      : p_deltaX      : Shift to be applied to the X coordinate.
  * paramtype  : p_deltaX      : number
  * param      : p_deltaY      : Shift to be applied to the Y coordinate.
  * paramtype  : p_deltaY      : number
  * param      : p_deltaZ      : Shift to be applied to the Z coordinate.
  * paramtype  : p_deltaZ      : number
  * param      : p_mbr         : minimum bounding rectangle/envelope in which p_geometry's coordinates have to be within to be able to be moved.
  * paramtype  : p_mbr         : MBR object
  * param      : p_filter_geom : A shape defining a sub-area in which p_geometry's coordinates have to be within for move.
  * paramtype  : p_filter_geom : MDSYS.SDO_GEOMETRY
  * param      : p_filter_mask : A mask for use with SDO_GEOM.RELATE()
  * paramtype  : p_filer_mask  : varchar
  * param      : p_tolerance   : Tolerance used when processing vertices with SDO_GEOM.RELATE
  * param      : p_tolerance   : Number  * requires   : CODESYS.GF package.
  * return     : newShape      : Shape whose coordinates are 'moved'.
  * rtnType    : newShape      : MDSYS.SDO_GEOMETRY
  * history    : Simon Greener - Mar 2003 - Original coding.
  * history    : Simon Greener - Jul 2006 - Migrated to GF package and made 3D aware.
  * history    : Simon Greener - Sep 2007 - Removed need for SDO_GEOM.RELATE via use of MBR type.
  * history    : Simon Greener - Jun 2008 - Removed modification of ordinates to precision of diminfo/tolerance as duplicates Tolerance() function.
  * @copyright  : Free for public use
  **/
  FUNCTION Move( p_geometry    IN MDSYS.SDO_GEOMETRY,
                 p_deltaX      IN NUMBER,
                 p_deltaY      IN NUMBER,
                 p_deltaZ      IN NUMBER             := NULL, 
                 p_mbr         IN CODESYS.MBR        := NULL,
                 p_filter_geom IN MDSYS.SDO_GEOMETRY := NULL,
                 p_filter_mask IN VARCHAR2           := 'INSIDE',
                 p_tolerance   IN NUMBER             := NULL
                ) 
    Return MDSYS.SDO_GEOMETRY Deterministic;

  /* Wrapper functions using OGC Syntax */
  FUNCTION ST_Translate( p_geometry IN MDSYS.ST_GEOMETRY,
                         p_deltaX   IN NUMBER,
                         p_deltaY   IN NUMBER,
                         p_deltaZ   IN NUMBER := NULL )
    Return MDSYS.ST_GEOMETRY DETERMINISTIC;

  FUNCTION ST_Translate( p_geometry IN MDSYS.SDO_GEOMETRY,
                         p_deltaX   IN NUMBER,
                         p_deltaY   IN NUMBER,
                         p_deltaZ   IN NUMBER := NULL, 
                         p_mbr      IN CODESYS.MBR := NULL
                       )
    Return MDSYS.SDO_GEOMETRY Deterministic;

  FUNCTION ST_Translate( p_geometry    IN MDSYS.SDO_GEOMETRY,
                         p_deltaX      IN NUMBER,
                         p_deltaY      IN NUMBER,
                         p_deltaZ      IN NUMBER, 
                         p_filter_geom IN MDSYS.SDO_GEOMETRY,
                         p_filter_mask IN VARCHAR2 := 'INSIDE',
                         p_tolerance   IN NUMBER   := 0.05
                         ) 
    Return MDSYS.SDO_GEOMETRY Deterministic;

So, first, let’s move “King Island”: to a new location.

update King_Island a
   set a.geometry = Geom.St_Translate(a.geometry,40000,-9000,NULL,Codesys.MBR(225000,5548000,257000,5616000))
 where a.name = 'King Island';
commit;

Notice how King Island has been moved to a new location in the following image.

King Island New Location

Now, let’s move it back:

update King_Island a
   set a.geometry = Geom.St_Translate(a.geometry,-40000,9000,NULL,Codesys.MBR(265000,5539000,297000,5607000))
 where a.name = 'King Island';
commit;

Here it is moved back to its original position:

King Island Original

Now, above we used an MBR parameter to constrain the move. But what if we wanted to move vertices that won’t neatly fit into an MBR object? The Move/ST_Translate functions need parameters to enable a move from any input SDO_GEOMETRY and topological mask. If the following we use a polygon to move King Island and Hunter Island (in blue in the following image).

All back to where they started

update King_Island a
   set a.geometry = Geom.St_Translate(a.geometry,40000,10000,NULL,NULL,mdsys.sdo_geometry('POLYGON((225647 5617686, 227451 5503583, 316749 5500877, 308180 5624902, 225647 5617686))',28355),'INSIDE',0.05);
commit;

This image shows the two islands only being moved.

King and Hunter Islandsl

Finally, Now, move King Island and Hunter Island back to their original position.

update King_Island a
   set a.geometry = Geom.St_Translate(a.geometry,-40000,-10000,NULL,NULL)
 where a.name in ('King Island','Hunter Island');
commit;

All back to where they started

The implementation of the Move and ST_Translate functions are in the GEOM package of my free PL/SQL utilities.

I hope this is useful to someone.

Creative Commons License

post this at del.icio.uspost this at Diggpost this at Technoratipost this at Redditpost this at Farkpost this at Yahoo! my webpost this at Windows Livepost this at Google Bookmarkspost this to Twitter

Comment [1]

Dose this package(actually the move function) support oracle 9i,I can’t compile it in 9i, could you please tell me how to fix it or can you provide me an oracle 9i version of the package, many thanks!

— Benny · 13 May 2009, 02:33 · #