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、创建空间数据以及执行基本的空间操作。这个库特别适合需要在数据分析和空间计算之间无缝切换的场景,是地理空间数据分析的有力工具。
- QQwen3-Next-80B-A3B-InstructQwen3-Next-80B-A3B-Instruct 是一款支持超长上下文(最高 256K tokens)、具备高效推理与卓越性能的指令微调大模型00
- QQwen3-Next-80B-A3B-ThinkingQwen3-Next-80B-A3B-Thinking 在复杂推理和强化学习任务中超越 30B–32B 同类模型,并在多项基准测试中优于 Gemini-2.5-Flash-Thinking00
GitCode-文心大模型-智源研究院AI应用开发大赛
GitCode&文心大模型&智源研究院强强联合,发起的AI应用开发大赛;总奖池8W,单人最高可得价值3W奖励。快来参加吧~0267cinatra
c++20实现的跨平台、header only、跨平台的高性能http库。C++00AI内容魔方
AI内容专区,汇集全球AI开源项目,集结模块、可组合的内容,致力于分享、交流。02- HHunyuan-MT-7B腾讯混元翻译模型主要支持33种语言间的互译,包括中国五种少数民族语言。00
GOT-OCR-2.0-hf
阶跃星辰StepFun推出的GOT-OCR-2.0-hf是一款强大的多语言OCR开源模型,支持从普通文档到复杂场景的文字识别。它能精准处理表格、图表、数学公式、几何图形甚至乐谱等特殊内容,输出结果可通过第三方工具渲染成多种格式。模型支持1024×1024高分辨率输入,具备多页批量处理、动态分块识别和交互式区域选择等创新功能,用户可通过坐标或颜色指定识别区域。基于Apache 2.0协议开源,提供Hugging Face演示和完整代码,适用于学术研究到工业应用的广泛场景,为OCR领域带来突破性解决方案。00- HHowToCook程序员在家做饭方法指南。Programmer's guide about how to cook at home (Chinese only).Dockerfile06
- PpathwayPathway is an open framework for high-throughput and low-latency real-time data processing.Python00
热门内容推荐
最新内容推荐
项目优选









