geopandas.GeoSeries.clip#
- GeoSeries.clip(mask, keep_geom_type=False)#
将点、线或多边形几何体剪裁到遮罩范围。
这两个层必须位于相同的坐标系(CRS)中。GeoSeries将被裁剪到 mask 对象。
如果遮罩中有多个多边形，则来自GeoSeries的数据将被剪裁到遮罩中所有多边形的总边界。
- 参数
- maskGeoDataFrame、GeoSeries、(多)面、类似列表
用于剪裁的多边形矢量层 gdf 。遮罩的几何体被分解为一个几何特征，并与GeoSeries相交。如果掩码是具有四个元素的类似列表
(minx, miny, maxx, maxy)，clip将使用更快的矩形裁剪 (clip_by_rect())，可能会导致结果略有不同。- keep_geom_type布尔值，默认为FALSE
如果为True，则在产生多个几何图形类型或GeometryCollection的情况下仅返回原始类型的几何图形。如果为False，则返回所有生成的几何图形(可能是混合类型)。
- 退货
- GeoSeries
来自的矢量数据(点、线、面) gdf 从遮罩剪裁到多边形边界。
参见
clip剪辑的顶级函数
示例
剪贴点(全球城市)与多边形(南美大陆)：
>>> world = geopandas.read_file( ... geopandas.datasets.get_path('naturalearth_lowres')) >>> south_america = world[world['continent'] == "South America"] >>> capitals = geopandas.read_file( ... geopandas.datasets.get_path('naturalearth_cities')) >>> capitals.shape (202, 2)
>>> sa_capitals = capitals.geometry.clip(south_america) >>> sa_capitals.shape (12,)