libs/geometry/doc/doxy/doxygen_output/html_by_doxygen/_o_g_c.html

   1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
   2 <html>
   3 <head>
   4 <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
   5 <title>Boost.Geometry (aka GGL, Generic Geometry Library)</title>
   6 <link href="doxygen.css" rel="stylesheet" type="text/css">
   7 <link href="tabs.css" rel="stylesheet" type="text/css">
   8 </head>
   9 <table cellpadding="2" width="100%">
  10 <tbody>
  11 <tr>
  12 <td valign="top">
  13 <img alt="Boost.Geometry" src="images/ggl-logo-big.png" height="80" width="200">
  14 &nbsp;&nbsp;
  15 </td>
  16 <td valign="top" align="right">
  17 <a href="http://www.boost.org">
  18 <img alt="Boost C++ Libraries" src="images/accepted_by_boost.png" height="80" width="230" border="0">
  19 </a>
  20 </td>
  21 </tr>
  22 </tbody>
  23 </table>
  24 <!-- Generated by Doxygen 1.8.6 -->
  25   <div id="navrow1" class="tabs">
  26     <ul class="tablist">
  27       <li><a href="index.html"><span>Main&#160;Page</span></a></li>
  28       <li class="current"><a href="pages.html"><span>Related&#160;Pages</span></a></li>
  29       <li><a href="modules.html"><span>Modules</span></a></li>
  30       <li><a href="namespaces.html"><span>Namespaces</span></a></li>
  31       <li><a href="annotated.html"><span>Classes</span></a></li>
  32       <li><a href="files.html"><span>Files</span></a></li>
  33       <li><a href="examples.html"><span>Examples</span></a></li>
  34     </ul>
  35   </div>
  36 </div><!-- top -->
  37 <div class="header">
  38   <div class="headertitle">
  39 <div class="title">OGC (Open Geospatial Consortium) </div>  </div>
  40 </div><!--header-->
  41 <div class="contents">
  42 <div class="textblock"><p>OGC is the Open Geospatial Consortium, the standardization committee on Geospatial Interoperability and GIS (Geographical Information Systems). OGC geometries are used in many environments and databases.</p>
  43 <p>The Generic Geometry Library uses OGC conventions for algorithms and for geometry type names. Note that though OGC is concentrating on GIS, the conventions followed here are 'geometry only', the so-called 'simple features' (simple in the sense that polygons are not allowed to have self-intersections).</p>
  44 <p>OGC specifies a library based on inheritance, as opposed to this library, which is a generic template based library where data classes are separated from the algorithms. Therefore this library is not an OGC implementation in the strict sense.</p>
  45 <h1><a class="anchor" id="Classes"></a>
  46 Classes</h1>
  47 <p>OGC defines the following geometry classes, which are implemented as concepts (and as geometries) in the Generic Geometry Library:</p>
  48 <ul>
  49 <li><a class="el" href="classboost_1_1geometry_1_1model_1_1point.html">point</a>: a point. The point defined here is dimensionally agnostic. Library users does not have to use this point, they might also use their own points as long as it meets the concepts.</li>
  50 <li><a class="el" href="classboost_1_1geometry_1_1model_1_1linestring.html">linestring</a>: Sequence of point values with linear interpolation between points. Note that library users does not have to use this type. Algorithms works on iterators, so all algorithms also accept iterators on a vector (or other container) of points.</li>
  51 <li><a class="el" href="classboost_1_1geometry_1_1model_1_1ring.html">linear_ring</a>: Sequence of point values with linear interpolation between points, which is closed and not self-intersecting</li>
  52 <li><a class="el" href="classboost_1_1geometry_1_1model_1_1polygon.html">polygon</a>: Plane figure, consisting of an outer ring and zero or more inner rings. So basically a polygon which might have holes. <em>Note that this definition is different from several other polygon definitions and libraries, where polygons are not allowed to have holes. These polygons are comparable to the linear_ring above</em></li>
  53 </ul>
  54 <p>And multi-geometries:</p>
  55 <ul>
  56 <li><a class="el" href="classboost_1_1geometry_1_1model_1_1multi__point.html">multi_point</a>: collection of points</li>
  57 <li><a class="el" href="classboost_1_1geometry_1_1model_1_1multi__linestring.html">multi_linestring</a>: collection of linestrings</li>
  58 <li><a class="el" href="classboost_1_1geometry_1_1model_1_1multi__polygon.html">multi_polygon</a>: collection of polygons</li>
  59 </ul>
  60 <p>The naming of these classes is used in:</p>
  61 <ul>
  62 <li>WKT (Well-Known Text)</li>
  63 <li>KML (Google Maps)</li>
  64 <li>GML</li>
  65 <li>many GIS/geometry libraries</li>
  66 </ul>
  67 <p>and in many databases:</p>
  68 <ul>
  69 <li>Oracle Spatial</li>
  70 <li>SQL Server 2008</li>
  71 <li>PostGreSQL</li>
  72 <li>MySQL</li>
  73 <li>MonetDB</li>
  74 </ul>
  75 <p>Besides this the Generic Geometry Library provides the following additional classes:</p>
  76 <ul>
  77 <li><a class="el" href="classboost_1_1geometry_1_1model_1_1box.html">box</a>: Box, used for selections and for envelopes (bounding boxes)</li>
  78 <li><a class="el" href="classboost_1_1geometry_1_1model_1_1segment.html">segment</a>: Segment, helper class, used for e.g. intersections</li>
  79 </ul>
  80 <p>Finally geometry types can be added as extensions. This is e.g. done with an "n-sphere" meaning "circle" and "sphere". Circle is convenient for selections.</p>
  81 <h1><a class="anchor" id="Differences"></a>
  82 Differences</h1>
  83 <p>The Generic Geometry Library does not implement the OGC Simple Feature interface exactly and completely. There are many differences. Below the most important differences are listed.</p>
  84 <ul>
  85 <li>In OGC all operations are class methods. The Generic Geometry Library is a template library and defines the algorithms as generic functions.</li>
  86 <li>In OGC a point is defined by an x-coordinate value, a y-coordinate value and possibly a z-coordinate value and a measured value. In the Generic Geometry Library the basic point defines coordinates in a neutral way, so there is no x, no y.</li>
  87 <li>In OGC all geometries have additional members, such as SRID (spatial reference system id) or isMeasured. These properties are not defined in the Generic Geometry Library. Library users can implement them, if necessary, in derived classes.</li>
  88 <li>In OGC the envelope returns a geometry, in the Generic Geometry Library it returns a box</li>
  89 <li>The OGC algorithm asText is named "wkt"</li>
  90 <li>Union and intersection are currently named "X_inserter" to indicate that they insert there produced geometries (if any) as an OutputIterator</li>
  91 </ul>
  92 <p>More information on OGC can be found on their website, <a href="http://www.opengeospatial.org">http://www.opengeospatial.org</a> and on Wikipedia <a href="http://en.wikipedia.org/wiki/Open_Geospatial_Consortium">http://en.wikipedia.org/wiki/Open_Geospatial_Consortium</a> </p>
  93 </div></div><!-- contents -->
  94 <hr size="1">
  95 <table width="100%">
  96 <tbody>
  97 <tr>
  98 <td align="left"><small>
  99 <p>April 2, 2011</p>
 100 </small></td>
 101 <td align="right">
 102 <small>
 103 Copyright &copy; 2007-2011 Barend Gehrels, Amsterdam, the Netherlands<br>
 104 Copyright &copy; 2008-2011 Bruno Lalande, Paris, France<br>
 105 Copyright &copy; 2009-2010 Mateusz Loskot, London, UK<br>
 106 </small>
 107 </td>
 108 </tr>
 109 </tbody>
 110 </table>
 111 <address style="text-align: right;"><small>
 112 Documentation is generated by&nbsp;<a href="http://www.doxygen.org/index.html">Doxygen</a>
 113 </small></address>
 114 </body>
 115 </html>