ValidateTopology — トポロジの問題についての詳細を示すvalidatetopology_returntypeの集合を返します。
setof validatetopology_returntype ValidateTopology(varchar toponame, geometry bbox);
トポロジの問題の詳細説明に関するvalidatetopology_returntypeオブジェクトを返します。任意にbboxパラメータで指定された範囲に確認を制限します。
エラーの一覧を示します。可能性のある、意味することろ、返されるid表現は次の通りです:
| Error | id1 | id2 | 意味 |
|---|---|---|---|
| coincident nodes (訳注: 重複ノード) | 最初のノードの識別子。 | 2番目のノードの識別子。 | 二つのノードは同じジオメトリを持ちます。 |
| edge crosses node (訳注: エッジとノードのクロス) | エッジの識別子。 | ノードの識別子。 | エッジが内部にノードを持っています。ST_Relateを参照して下さい。 |
| invalid edge (訳注: 不正なエッジ) | エッジの識別子。 | エッジジオメトリが不正です。ST_IsValidをご覧下さい。 | |
| edge not simple (訳注: 単純でないエッジ) | エッジの識別子。 | エッジジオメトリが自己交差しています。ST_IsSimpleを参照して下さい。 | |
| edge crosses edge (訳注: エッジとエッジのクロス) | 最初のエッジの識別子。 | 2番目のエッジの識別子。 | 二つのエッジが内部でインタセクトしています。ST_Relateをご覧下さい。 |
| edge start node geometry mis-match (訳注: 開始ノードジオメトリの不整合) | エッジの識別子。 | 示された開始ノードの識別子。 | エッジの開始ノードとして示されたノードのジオメトリが、エッジジオメトリの最初のポイントと合致しません。ST_StartPointを参照して下さい。 |
| edge end node geometry mis-match (訳注: 終了ノードジオメトリの不整合) | エッジの識別子。 | 示された終了ノードの識別子。 | エッジの終了ノードとして示されたノードのジオメトリがエッジジオメトリの最後のポイントと合致しません。ST_EndPointを参照して下さい。 |
| face without edges (訳注: エッジのないフェイス) | 取り残されたフェイスの識別子。 | 既存のフェイスを左右いずれかの側に (left_face, right_faceとして)持つエッジが存在しません。 | |
| face has no rings (訳注: 環のないフェイス) | 部分的に定義されたフェイスの識別子。 | 環を形成しない側のフェイスを示すエッジ。 | |
| face has wrong mbr (訳注: 誤ったバウンディングボックスを持ったフェイス) | 不正なMBRキャッシュを持つフェイスの識別子。 | フェイスの最小バウンディング四角形が、サイド上のフェイスを示すエッジのコレクションの最小バウンディングボックスと合致しません。 | |
| hole not in advertised face (訳注: 穴がフェイス内に存在しない) | リングを識別する符号付きのエッジ識別子。GetRingEdgesを参照して下さい。 | エッジの環が、外環のフェイスが異なるフェイスに含まれているフェイスを示します。 | |
| not-isolated node has not- containing_face (訳注: 非孤立ノードが非孤立フェイスを持っています) | はっきりしないノードの識別子。 | 一つ以上のエッジの境界上にあると示された一つのノードが、そのノードを含んでいるフェイスを示しています。 | |
| isolated node has containing_face (訳注: 孤立ノードがcontaining_faceを持っています) | はっきりしないノードの識別子。 | どのエッジの境界上にもないと報告されるノードが、それを含むフェイスが無いことを示しています。 | |
| isolated node has wrong containing_face (訳注: この孤立ノードを含んでいるフェイスが不正) | 不正確なノードの識別子。 | どのエッジの境界上にもないと報告されるノードが、そのノードを実際に含むフェイスではないフェイスに含まれていることを示しています。GetFaceContainingPointを参照して下さい。 | |
| invalid next_right_edge (訳注: 不正なnext_right_edge) | 不正確なエッジの識別子。 | 符号付き識別子で次の右エッジを示します。 | エッジの右側を進んで遭遇する次のエッジが間違っていることを示しています。 |
| invalid next_left_edge (訳注: 不正なnext_left_edge) | 不正確なエッジの識別子。 | 符号付き識別子で次の左エッジを示します。 | エッジの左側を進んで遭遇する次のエッジが間違っていることを示しています。 |
| mixed face labeling in ring (訳注: リング内のフェイスのラベルの矛盾) | リングを識別する符号付きのエッジ識別子。GetRingEdgesを参照して下さい。 | リング内のエッジが、進む側にあるフェイスが矛盾していることを示しています。これは「サイドロケーションの矛盾」とも言われます。 | |
| non-closed ring (訳注: 閉じていないリング) | リングを識別する符号付きのエッジ識別子。GetRingEdgesを参照して下さい。 | 続くnext_left_edge/next_right_edge属性で形成されるエッジのリングの始点と終点が異なります。 | |
| face has multiple shells (訳注: 複数の外殻を持つフェイス) | 競合するフェイスの識別子。 | リングを識別する符号付きのエッジ識別子。GetRingEdgesを参照して下さい。 | 複数のエッジのリングがその内部で同じフェイスを示しています。 |
Availability: 1.0.0
Enhanced: 2.0.0では、より効果的なエッジ交差検出が可能になり、以前の版で残っていた偽陽性を解決しています。
Changed: 2.2.0 エラーの記述と矛盾しないように'edge crosses node'のid1とid2の値が入れ替わっています。
Changed: 3.2.0 任意パラメータbboxを追加し、フェイスラベルとエッジリンクのチェックを追加しました。
SELECT * FROM topology.ValidateTopology('ma_topo');
error | id1 | id2
-------------------+-----+-----
face without edges | 1 |