geofileops.clip_by_geometry#
- geofileops.clip_by_geometry(input_path: Union[str, os.PathLike[Any]], output_path: Union[str, os.PathLike[Any]], clip_geometry: Union[Tuple[float, float, float, float], str], input_layer: Optional[str] = None, output_layer: Optional[str] = None, columns: Optional[List[str]] = None, explodecollections: bool = False, force: bool = False)#
Clip all geometries in the imput file by the geometry provided.
If
explodecollections
is False and the input and output file type is GeoPackage, the fid will be preserved. In other cases this will typically not be the case.- Parameters:
input_path (PathLike) – the input file
output_path (PathLike) – the file to write the result to
clip_geometry (Union[Tuple[float, float, float, float], str]) – the bounds or WKT geometry to clip with.
input_layer (str, optional) – input layer name. Optional if the file only contains one layer.
output_layer (str, optional) – input layer name. Optional if the file only contains one layer.
columns (List[str], optional) – list of columns to retain. If None, all standard columns are retained. In addition to standard columns, it is also possible to specify “fid”, a unique index available in all input files. Note that the “fid” will be aliased eg. to “fid_1”. Defaults to None.
explodecollections (bool, optional) – True to output only simple geometries. Defaults to False.
force (bool, optional) – overwrite existing output file(s). Defaults to False.