geopandas.GeoSeries.to_file#

GeoSeries.to_file(filename, driver=None, index=None, **kwargs)[来源]#

GeoSeries写入文件。

默认情况下,会写入ESRI shapefile,但可以写入任何由Pyogrio或Fiona支持的OGR数据源。

Parameters:
filenamestring

要写入的文件路径或文件句柄。路径可以指定一个 GDAL VSI 方案。

driverstring, default None

用于写入矢量文件的OGR格式驱动程序。 如果未指定,它会尝试从文件扩展名中推断。如果未指定扩展名,它将把ESRI Shapefile保存到一个文件夹。

indexbool, default None

如果为True,则将索引写入一个或多个列(适用于MultiIndex)。 默认None仅在索引命名、为MultiIndex或具有非整数数据类型时,将索引写入一个或多个列。如果为False,则不写入索引。

在版本 0.7 中新增:之前索引没有被写入。

modestring, default ‘w’

写入模式,‘w’表示覆盖现有文件,‘a’表示追加。并非所有驱动程序都支持追加。支持追加的驱动程序列在fiona.supported_drivers或Toblerity/Fiona中。

crspyproj.CRS, default None

如果指定,CRS 将传递给 Fiona,以更好地控制文件的写入方式。如果为 None,GeoPandas 将根据 crs df 属性确定 crs。该值可以是任何被 pyproj.CRS.from_user_input() 接受的内容,例如权威字符串(例如“EPSG:4326”)或 WKT 字符串。该关键字不支持“pyogrio”引擎。

enginestr, “pyogrio” or “fiona”

用于写入文件的底层库。目前,支持的选项是“pyogrio”和“fiona”。如果已安装,默认使用“pyogrio”,否则尝试“fiona”。

**kwargs

要传递给引擎的关键字参数,可以用于写入多层数据、将数据存储在档案(zip 文件)中等。在“pyogrio”引擎的情况下,关键字参数被传递给pyogrio.write_dataframe。在“fiona”引擎的情况下,关键字参数被传递给 fiona.open`。有关可能的关键字的更多信息,请输入:import pyogrio; help(pyogrio.write_dataframe)

另请参阅

GeoDataFrame.to_file

将 GeoDataFrame 写入文件

read_file

将文件读取到GeoDataFrame

示例

>>> s.to_file('series.shp')  
>>> s.to_file('series.gpkg', driver='GPKG', layer='name1')  
>>> s.to_file('series.geojson', driver='GeoJSON')