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')