pgLatLon
diff README.html @ 20:8a8d6dc44337
Changed/fixed behavior of "contains" operator regarding perimeters; Added "contains" operator for ebox type; Minor changes in README
| author | jbe |
|---|---|
| date | Mon Sep 12 18:00:52 2016 +0200 (2016-09-12) |
| parents | e319679cefbd |
| children | a7ba8335e541 |
line diff
1.1 --- a/README.html Fri Sep 09 23:44:28 2016 +0200 1.2 +++ b/README.html Mon Sep 12 18:00:52 2016 +0200 1.3 @@ -1,5 +1,5 @@ 1.4 -<html><head><title>pgLatLon v0.4 documentation</title></head><body> 1.5 -<h1>pgLatLon v0.4 documentation</h1> 1.6 +<html><head><title>pgLatLon v0.5 documentation</title></head><body> 1.7 +<h1>pgLatLon v0.5 documentation</h1> 1.8 1.9 <p>pgLatLon is a spatial database extension for the PostgreSQL object-relational 1.10 database management system providing geographic data types and spatial indexing 1.11 @@ -40,8 +40,8 @@ 1.12 <p>It is also possible to compile and install the extension without GNU Make as 1.13 follows:</p> 1.14 1.15 -<pre><code>cc -Wall -O2 -fPIC -shared -I `pg_config --includedir-server` -o latlon-v0003.so latlon-v0003.c 1.16 -cp latlon-v0003.so `pg_config --pkglibdir` 1.17 +<pre><code>cc -Wall -O2 -fPIC -shared -I `pg_config --includedir-server` -o latlon-v0005.so latlon-v0005.c 1.18 +cp latlon-v0005.so `pg_config --pkglibdir` 1.19 cp latlon.control `pg_config --sharedir`/extension/ 1.20 cp latlon--*.sql `pg_config --sharedir`/extension/ 1.21 </code></pre> 1.22 @@ -285,8 +285,8 @@ 1.23 <li><code>ecluster && ecluster</code></li> 1.24 </ul> 1.25 1.26 -<p>The <code>&&</code> operator is commutative, i.e. <code>a && b</code> is the same as <code>b && a</code>. Each 1.27 -commutation is supported as well.</p> 1.28 +<p>The <code>&&</code> operator is commutative, i.e. "<code>a && b</code>" is the same as "<code>b && a</code>". 1.29 +Each commutation is supported as well.</p> 1.30 1.31 <h4>Lossy overlap operator <code>&&+</code></h4> 1.32 1.33 @@ -302,7 +302,7 @@ 1.34 <li><code>ecluster &&+ ecluster</code></li> 1.35 </ul> 1.36 1.37 -<p>The <code>&&+</code> operator is commutative, i.e. <code>a &&+ b</code> is the same as <code>b &&+ a</code>. 1.38 +<p>The <code>&&+</code> operator is commutative, i.e. "<code>a &&+ b</code>" is the same as "<code>b &&+ a</code>". 1.39 Each commutation is supported as well.</p> 1.40 1.41 <p>Where two data types support both the <code>&&</code> and the <code>&&+</code> operator, the <code>&&+</code> 1.42 @@ -315,14 +315,21 @@ 1.43 1.44 <ul> 1.45 <li><code>ebox @> epoint</code> (alias for <code>&&</code>)</li> 1.46 +<li><code>ebox @> ebox</code></li> 1.47 <li><code>ebox @> ecluster</code></li> 1.48 <li><code>ecluster @> epoint</code> (alias for <code>&&</code>)</li> 1.49 <li><code>ecluster @> ebox</code></li> 1.50 <li><code>ecluster @> ecluster</code></li> 1.51 </ul> 1.52 1.53 -<p>The commutator of <code>@></code> ("contains") is <code><@</code> ("is contained in"), i.e. <code>a @> b</code> 1.54 -is the same as <code>b <@ a</code>.</p> 1.55 +<p>The commutator of <code>@></code> ("contains") is <code><@</code> ("is contained in"), i.e. 1.56 +"<code>a @> b</code>" is the same as "<code>b <@ a</code>".</p> 1.57 + 1.58 +<p>Whether the perimeter of an object is taken into account is undefined and may 1.59 +differ between the left and the right hand side of the operator. The current 1.60 +implementation returns true only if an object is contained completely within 1.61 +the other object, not touching its perimeter, paths, outlines, or any singular 1.62 +points.</p> 1.63 1.64 <h4>Distance operator <code><-></code></h4> 1.65 1.66 @@ -342,7 +349,7 @@ 1.67 <li><code>ecluster <-> ecluster</code></li> 1.68 </ul> 1.69 1.70 -<p>The <code><-></code> operator is commutative, i.e. <code>a <-> b</code> is the same as <code>b <-> a</code>. 1.71 +<p>The <code><-></code> operator is commutative, i.e. "<code>a <-> b</code>" is the same as "<code>b <-> a</code>". 1.72 Each commutation is supported as well.</p> 1.73 1.74 <p>For short distances, the result is very accurate (i.e. respects the dimensions