Polars-ST 空间数据处理库入门指南
什么是 Polars-ST
Polars-ST 是一个基于 Polars 的空间数据处理扩展库,它为 Polars 的数据结构(包括表达式、Series、DataFrame 和 LazyFrame)添加了丰富的空间数据处理能力。该库通过 st
命名空间提供了一系列几何操作函数,使得在 Polars 生态中进行空间数据分析变得简单高效。
安装方法
安装 Polars-ST 非常简单,只需使用 pip 命令:
pip install polars-st
基础使用
创建空间数据
Polars-ST 支持从多种格式创建空间数据。以下是一个从 WKT(Well-Known Text)格式创建 GeoDataFrame 的示例:
import polars_st as st
# 从WKT字符串创建GeoDataFrame
gdf = st.GeoDataFrame({
"geometry": [
"POLYGON ((0 0, 0 1, 1 1, 1 0, 0 0))",
"POLYGON ((0 0, 0 1, 1 1, 0 0))",
]
})
在底层,GeoDataFrame 构造函数会自动将这些 WKT 格式的几何对象解析为 EWKB(Extended Well-Known Binary)内部表示形式。除了 WKT,Polars-ST 还支持多种其他格式的空间数据输入。
从已有 Series 创建
如果你已经有一个包含空间数据的 Polars Series,可以直接使用解析函数:
import polars as pl
s = pl.Series(["POLYGON ((0 0, 0 1, 1 1, 1 0, 0 0))",
"POLYGON ((0 0, 0 1, 1 1, 0 0))"])
gdf = pl.select(geometry=st.from_wkt(s))
执行空间操作
Polars-ST 提供了丰富的空间操作函数,例如计算多边形面积:
# 计算几何列的面积
area = gdf.select(st.geom("geometry").st.area())
核心概念解析
GeoDataFrame 的本质
需要特别注意的是,Polars-ST 中的 GeoDataFrame
构造函数实际上返回的是一个标准的 Polars DataFrame
,只是添加了空间数据处理的能力。这意味着你可以无缝地将 Polars-ST 的功能与 Polars 的其他功能结合使用。
st.geom 的妙用
st.geom()
是 Polars-ST 提供的一个实用函数,类似于 Polars 的 pl.col()
,但专门用于处理几何列。它有以下特点:
- 类型支持:返回的是带有
st
命名空间类型注解的GeoExpr
,便于类型检查和代码补全 - 智能默认:当几何列名为默认的 "geometry" 时,可以省略列名参数
- 简化语法:对于单几何操作,可以直接调用函数而无需先获取几何列
# 简化写法1:省略列名
area = gdf.select(st.geom().st.area())
# 简化写法2:直接调用面积函数
area = gdf.select(st.area())
为什么选择 Polars-ST
- 性能优势:基于 Polars 的高性能数据处理引擎
- 易用性:提供简洁的 API 和智能默认值
- 类型安全:完善的类型注解支持
- 无缝集成:与 Polars 生态完美融合
总结
Polars-ST 为 Polars 用户提供了强大而便捷的空间数据处理能力。通过本文的介绍,你应该已经掌握了如何安装 Polars-ST、创建空间数据以及执行基本的空间操作。这个库特别适合需要在数据分析和空间计算之间无缝切换的场景,是地理空间数据分析的有力工具。
- DDeepSeek-V3.1-BaseDeepSeek-V3.1 是一款支持思考模式与非思考模式的混合模型Python00
- QQwen-Image-Edit基于200亿参数Qwen-Image构建,Qwen-Image-Edit实现精准文本渲染与图像编辑,融合语义与外观控制能力Jinja00
GitCode-文心大模型-智源研究院AI应用开发大赛
GitCode&文心大模型&智源研究院强强联合,发起的AI应用开发大赛;总奖池8W,单人最高可得价值3W奖励。快来参加吧~044CommonUtilLibrary
快速开发工具类收集,史上最全的开发工具类,欢迎Follow、Fork、StarJava04GitCode百大开源项目
GitCode百大计划旨在表彰GitCode平台上积极推动项目社区化,拥有广泛影响力的G-Star项目,入选项目不仅代表了GitCode开源生态的蓬勃发展,也反映了当下开源行业的发展趋势。06GOT-OCR-2.0-hf
阶跃星辰StepFun推出的GOT-OCR-2.0-hf是一款强大的多语言OCR开源模型,支持从普通文档到复杂场景的文字识别。它能精准处理表格、图表、数学公式、几何图形甚至乐谱等特殊内容,输出结果可通过第三方工具渲染成多种格式。模型支持1024×1024高分辨率输入,具备多页批量处理、动态分块识别和交互式区域选择等创新功能,用户可通过坐标或颜色指定识别区域。基于Apache 2.0协议开源,提供Hugging Face演示和完整代码,适用于学术研究到工业应用的广泛场景,为OCR领域带来突破性解决方案。00openHiTLS
旨在打造算法先进、性能卓越、高效敏捷、安全可靠的密码套件,通过轻量级、可剪裁的软件技术架构满足各行业不同场景的多样化要求,让密码技术应用更简单,同时探索后量子等先进算法创新实践,构建密码前沿技术底座!C0300- WWan2.2-S2V-14B【Wan2.2 全新发布|更强画质,更快生成】新一代视频生成模型 Wan2.2,创新采用MoE架构,实现电影级美学与复杂运动控制,支持720P高清文本/图像生成视频,消费级显卡即可流畅运行,性能达业界领先水平Python00
- GGLM-4.5-AirGLM-4.5 系列模型是专为智能体设计的基础模型。GLM-4.5拥有 3550 亿总参数量,其中 320 亿活跃参数;GLM-4.5-Air采用更紧凑的设计,拥有 1060 亿总参数量,其中 120 亿活跃参数。GLM-4.5模型统一了推理、编码和智能体能力,以满足智能体应用的复杂需求Jinja00
Yi-Coder
Yi Coder 编程模型,小而强大的编程助手HTML013
热门内容推荐
最新内容推荐
项目优选









