説明

M値に基づいた頂点ポイントのフィルタリングを行います。返されるジオメトリは最小値以上最大値以下のM値を持つポイントだけでできています。最大値の引数が指定されていない場合には、最小値のみ考慮されます。第4引数が指定されていない場合には、M値は結果ジオメトリに存在しません。結果ジオメトリの頂点ポイントの数が、ジオメトリを構成するに必要な数に達しない場合には、空ジオメトリが返されます。ジオメトリコレクション内の、十分なポイントを持たないジオメトリ要素は消えます。

この関数は主にST_SetEffectiveAreaとの併用を意図しています。ST_SetEffectiveAreaは、頂点のM値に関する有効範囲を設定します。ST_FilterByMでフィルタリングをすることで、他の計算を行わずに、単純化されたジオメトリを得ることができます。

	ポイント数が基準を満たすのに十分でない時のST_SimplifyVWの返り値とST_FilterByMの返り値とで違いがあります。ST_FilterByMは空ジオメトリを返し、ST_SimplifyVWは十分なポイントを持つジオメトリを返します。

	返されるジオメトリは不正になることがあることに注意して下さい。

	この関数は、Z値とM値を含む、すべての次元を返します。

Availability: 2.5.0

例

ラインストリングにフィルタリングを行います

SELECT ST_AsText(ST_FilterByM(geom,30)) simplified
FROM (SELECT  ST_SetEffectiveArea('LINESTRING(5 2, 3 8, 6 20, 7 25, 10 10)'::geometry) geom) As foo;
-- 結果 --
         simplified
----------------------------
 LINESTRING(5 2,7 25,10 10)

                                

関連情報

ST_SetEffectiveArea, ST_SimplifyVW