sdo.html

Geotools是一个开源的Java GIS工具包,可利用它来开发符合标准的地理信息系统。Geotools提供了OGC(Open Geospatial Consortium)规范的一个实现来作为他们的

<PRE>
public static int <B>elemInfoStartingOffset</B>(<A HREF="http://www.jump-project.org/docs/jts/1.7/api/com/vividsolutions/jts/geom/Geometry.html" title="class or interface in com.vividsolutions.jts.geom">Geometry</A>&nbsp;geom)</PRE>
<DL>
<DD>Starting offset used by SDO_ORDINATES as stored in the SDO_ELEM_INFO
 array.
 
 <p>
 Starting offsets start from one.
 </p>
 
 <p>
 Describes ordinates as part of <code>SDO_ELEM_INFO</code> data type.
 </p>
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>geom</CODE> - 
<DT><B>Returns:</B><DD><code>1</code> for non nested <code>geom</code></DL>
</DD>
</DL>
<HR>

<A NAME="elemInfoEType(com.vividsolutions.jts.geom.Geometry)"><!-- --></A><H3>
elemInfoEType</H3>
<PRE>
protected static int <B>elemInfoEType</B>(<A HREF="http://www.jump-project.org/docs/jts/1.7/api/com/vividsolutions/jts/geom/Geometry.html" title="class or interface in com.vividsolutions.jts.geom">Geometry</A>&nbsp;geom)</PRE>
<DL>
<DD>Produce <code>SDO_ETYPE</code> for geometry description as stored in the
 <code>SDO_ELEM_INFO</code>.
 
 <p>
 Describes how Ordinates are ordered:
 </p>
 <pre><code><b>
 Value Elements Meaning</b>
    0           Custom Geometry (like spline) 
    1  simple   Point (or Points)
    2  simple   Line (or Lines)
    3           polygon ring of unknown order (discouraged update to 1003 or 2003)
 1003  simple   polygon ring (1 exterior counterclockwise order)
 2003  simple   polygon ring (2 interior clockwise order)
    4  compound series defines a linestring
    5  compound series defines a polygon ring of unknown order (discouraged)
 1005  compound series defines exterior polygon ring (counterclockwise order)
 2005  compound series defines interior polygon ring (clockwise order)
 </code></pre>
 
 <p>
 Keep in mind:
 </p>
 
 <ul>
 <li>
 <code>simple</code> elements are defined by a single triplet entry in
 the <code>SDO_ELEM_INFO</code> array
 </li>
 <li>
 <code>compound</code> elements are defined by a header triplet, and a
 series of triplets for the parts. Elements in a compound element share
 first and last points.
 </li>
 <li>
 We are not allowed to mix 1 digit and 4 digit values for ETYPE and GTYPE
 in a single geometry
 </li>
 </ul>
 
 <p>
 This whole mess describes ordinates as part of
 <code>SDO_ELEM_INFO</code> array. data type.
 </p>
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>geom</CODE> - Geometry being represented
<DT><B>Returns:</B><DD>Descriptionof Ordinates representation
<DT><B>Throws:</B>
<DD><CODE><A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/IllegalArgumentException.html" title="class or interface in java.lang">IllegalArgumentException</A></CODE></DL>
</DD>
</DL>
<HR>

<A NAME="elemInfoInterpretation(com.vividsolutions.jts.geom.Geometry)"><!-- --></A><H3>
elemInfoInterpretation</H3>
<PRE>
public static int <B>elemInfoInterpretation</B>(<A HREF="http://www.jump-project.org/docs/jts/1.7/api/com/vividsolutions/jts/geom/Geometry.html" title="class or interface in com.vividsolutions.jts.geom">Geometry</A>&nbsp;geom)</PRE>
<DL>
<DD>Produce <code>SDO_INTERPRETATION</code> for geometry description as
 stored in the <code>SDO_ELEM_INFO</code>.
 
 <p>
 Describes ordinates as part of <code>SDO_ELEM_INFO</code> array.
 </p>
 
 <ul>
 <li>
 <b><code>compound</code> element:</b>(SDO_ETYPE 4, 1005, or 2005)<br>
 Number of subsequent triplets are part of compound element
 </li>
 <li>
 <b><code>simple</code> element:</b>(SDE_ELEM 1, 2, 1003, or 2003)<br>
 Code defines how ordinates are interpreted (lines or curves)
 </li>
 </ul>
 
 <p>
 SDO_INTERPRETAION Values: (from Table 2-2 in reference docs)
 </p>
 <pre><code><b>
 SDO_ETYPE Value    Meaning</b>
 0         anything Custom Geometry
 1         1        Point
 1         N > 1    N points
 2         1        LineString of straight lines
 2         2        LineString connected by circ arcs (start,any,end pt)
 1003/2003 1        Polygon Edged with straight lines
 1003/2003 2        Polygon Edged with circ arcs (start, any, end pt)
 1003/2003 3        Non SRID rectangle defined by (bottomleft,topright pt)
 1003/2003 4        Circle defined by three points on circumference
 4         N > 1    Compound Line String made of N (ETYPE=2) lines and arcs
 1005/2005 N > 1    Polygon defined by (ETYPE=2) lines and arcs
 
                 
 </code></pre>
 
 <p>
 When playing with circular arcs (SDO_INTERPRETATION==2) arcs are defined
 by three points. A start point, any point on the arc and the end point.
 The last point of an arc is the start point of the next. When used to
 describe a polygon (SDO_ETYPE==1003 or 2003) the first and last point
 must be the same.
 </p>
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>geom</CODE> - </DL>
</DD>
</DL>
<HR>

<A NAME="elemInfoInterpretation(com.vividsolutions.jts.geom.Geometry, int)"><!-- --></A><H3>
elemInfoInterpretation</H3>
<PRE>
public static int <B>elemInfoInterpretation</B>(<A HREF="http://www.jump-project.org/docs/jts/1.7/api/com/vividsolutions/jts/geom/Geometry.html" title="class or interface in com.vividsolutions.jts.geom">Geometry</A>&nbsp;geom,
                                         int&nbsp;etype)</PRE>
<DL>
<DD>Allows specification of <code>INTERPRETATION</code> used to interpret
 <code>geom</code>.
 <p>
 Provides the INTERPRETATION value for the ELEM_INFO triplet
 of (STARTING_OFFSET, ETYPE, INTERPRETATION).
 </p>
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>geom</CODE> - Geometry to encode<DD><CODE>etype</CODE> - ETYPE value requiring an INTERPREATION
<DT><B>Returns:</B><DD>INTERPRETATION ELEM_INFO entry for geom given etype
<DT><B>Throws:</B>
<DD><CODE><A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/IllegalArgumentException.html" title="class or interface in java.lang">IllegalArgumentException</A></CODE> - If asked to encode a curve</DL>
</DD>
</DL>
<HR>

<A NAME="ordinates(com.vividsolutions.jts.geom.Geometry)"><!-- --></A><H3>
ordinates</H3>
<PRE>
public static double[] <B>ordinates</B>(<A HREF="http://www.jump-project.org/docs/jts/1.7/api/com/vividsolutions/jts/geom/Geometry.html" title="class or interface in com.vividsolutions.jts.geom">Geometry</A>&nbsp;geom)</PRE>
<DL>
<DD>Produce <code>SDO_ORDINATES</code> for geometry.
 
 <p>
 Please see SDO_ETYPE, SDO_INTERPRETATION and SDO_GTYPE for description
 of how these ordinates are to be interpreted.
 </p>
 
 <p>
 Ordinates are ordered by Dimension are non null:
 </p>
 
 <ul>
 <li>
 <p>
 Two Dimensional:
 </p>
 {x1,y1,x2,y2,...}
 </li>
 <li>
 <p>
 Three Dimensional:
 </p>
 {x1,y1,z1,x2,y2,z2,...}
 </li>
 </ul>
 
 <p>
 Spatial will siliently detect and ignore the following:
 </p>
 
 <ul>
 <li>
 d001 point/d005 multipoint elements that are not SDO_ETYPE==1 points
 </li>
 <li>
 d002 lines or curve/d006 multilines or multicurve elements that are not
 SDO_ETYPE==2 lines or SDO_ETYPE==4 arcs
 </li>
 <li>
 d003 polygon/d007 multipolygon elements that are not SDO_ETYPE==3
 unordered polygon lines or SDO_ETYPE==5 unorderd compound polygon ring
 are ignored
 </li>
 </ul>
 
 <p>
 While Oracle is silient on these errors - all other errors will not be
 detected!
 </p>
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>geom</CODE> - </DL>
</DD>
</DL>
<HR>

<A NAME="getCS(com.vividsolutions.jts.geom.Geometry)"><!-- --></A><H3>
getCS</H3>
<PRE>
public static <A HREF="http://www.jump-project.org/docs/jts/1.7/api/com/vividsolutions/jts/geom/CoordinateSequence.html" title="class or interface in com.vividsolutions.jts.geom">CoordinateSequence</A> <B>getCS</B>(<A HREF="http://www.jump-project.org/docs/jts/1.7/api/com/vividsolutions/jts/geom/Geometry.html" title="class or interface in com.vividsolutions.jts.geom">Geometry</A>&nbsp;geom)</PRE>
<DL>
<DD><DL>
</DL>
</DD>
</DL>
<HR>

<A NAME="coordinates(java.util.List, com.vividsolutions.jts.geom.Geometry)"><!-- --></A><H3>
coordinates</H3>
<PRE>
public static void <B>coordinates</B>(<A HREF="http://java.sun.com/j2se/1.4/docs/api/java/util/List.html" title="class or interface in java.util">List</A>&nbsp;list,
                               <A HREF="http://www.jump-project.org/docs/jts/1.7/api/com/vividsolutions/jts/geom/Geometry.html" title="class or interface in com.vividsolutions.jts.geom">Geometry</A>&nbsp;geom)</PRE>
<DL>
<DD>Encode Geometry as described by GTYPE and ELEM_INFO
 <p>
 CoordinateSequence & CoordinateAccess wil be used to determine the
 dimension, and the number of ordinates added.
 </p>
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>list</CODE> - Flat list of Double<DD><CODE>geom</CODE> - Geometry
<DT><B>Throws:</B>
<DD><CODE><A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/IllegalArgumentException.html" title="class or interface in java.lang">IllegalArgumentException</A></CODE> - If geometry cannot be encoded</DL>
</DD>
</DL>
<HR>

<A NAME="ordinateArray(com.vividsolutions.jts.geom.CoordinateSequence, int)"><!-- --></A><H3>
ordinateArray</H3>
<PRE>
public static double[] <B>ordinateArray</B>(<A HREF="http://www.jump-project.org/docs/jts/1.7/api/com/vividsolutions/jts/geom/CoordinateSequence.html" title="class or interface in com.vividsolutions.jts.geom">CoordinateSequence</A>&nbsp;coords,
                                     int&nbsp;ordinate)</PRE>
<DL>
<DD>Package up array of requested ordinate, regardless of geometry
 
 <p>
 Example numbering: for (x y g m) dimension==2, measure==2
 </p>
 
 <ul>
 <li>
 0: x ordinate array
 </li>
 <li>
 1: y ordinate array
 </li>
 <li>
 2: g ordinate array
 </li>
 <li>
 3: m ordinate array
 </li>
 </ul>
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>coords</CODE> - <DD><CODE>ordinate</CODE> - </DL>
</DD>
</DL>
<HR>

<A NAME="ordinateArray(com.vividsolutions.jts.geom.Coordinate[], int)"><!-- --></A><H3>
ordinateArray</H3>
<PRE>
public static double[] <B>ordinateArray</B>(<A HREF="http://www.jump-project.org/docs/jts/1.7/api/com/vividsolutions/jts/geom/Coordinate.html" title="class or interface in com.vividsolutions.jts.geom">Coordinate</A>[]&nbsp;array,
                                     int&nbsp;ordinate)</PRE>