使用者の手引きおよび解説書

ST_Relate

ST_Relate は 2 つの図形を比較して、 DE-9IM パターン・マトリックス・ストリングで指定されている条件を図形が満たしていれば 1 (TRUE) を戻し、 そうでなければ 0 (FALSE) を戻します。 DE-9IM パターン・マトリックスに関する情報は、述部関数を参照してください。

構文

db2gse.ST_Relate(g1 db2gse.ST_Geometry, g2 db2gse.ST_Geometry, patternMatrix String)

戻りタイプ

整数

DE-9IM パターン・マトリックスは、図形を比較する装置です。 この種のマトリックスには複数のタイプがあります。 たとえば、等価 パターン・マトリックスは、 2 つの図形が等しいかどうかを知らせます。

この例で、表 56 の等価パターン・マトリックスは、 左から右、上から下にストリングを読みます ("T*F**FFF*")。

表 56. 等価パターン・マトリックス



b




内部

境界

外部


内部

T

*

F

a

境界

*

*

F


外部

F

F

*

次に、表 RELATE_TEST は、以下の CREATE TABLE ステートメントで作成されます。

CREATE TABLE RELATE_TEST (rid integer, g1 db2gse.ST_Geometry,
g2 db2gse.ST_Geometry, g3 db2gse.ST_Geometry);

以下の INSERT ステートメントによって、 サンプルのサブクラスが RELATE_TEST 表に挿入されます。

INSERT INTO RELATE_TEST VALUES(
       1,
        db2gse.ST_PointFromText('point (10.02 20.01)',db2gse.coordref()..srid(0),
        db2gse.ST_PointFromText('point (10.02 20.01)',db2gse.coordref()..srid(0),
        db2gse.ST_PointFromText('point (30.01 20.01)',db2gse.coordref()..srid(0)
)

以下の SELECT ステートメントおよび対応する結果セットによって、 geotype の次元とともに GEOTYPE 列に格納されているサブクラス名がリストされます。

SELECT rid, relate(g1,g2) equals, relate(g1,g3) not_equals
FROM relate_test
RID     equals    not_equals
-------- -----------   -----------------
1         1              0
  1 record(s) selected.


[ ページのトップ | 前ページ | 次ページ | 目次 | 索引 ]