SuperAPI AI 工具集

owid-catalog

编程与开发

查看项目

更新于 10-16 03:14

技能介绍

用途:owid-catalog 是 Our World in Data(OWID)的 Python 库,用于发现并加载其已发布数据集,适合在 Python 环境中按需检索图表、数据表和时间序列指标。

主要能力:支持三种搜索类型。图表(charts)是已发布可视化,经过较好整理和文档化,一个图表可使用单个或多个指标;数据表(tables)是某数据集的完整 DataFrame,便于一次性取用同数据集的多列;指标(indicators)通过向量嵌入做语义搜索,覆盖完整时间序列,结果通常按图表使用频率排序。指标和数据表遵循 ETL 路径,如 "garden/un/2024-07-12/un_wpp/population#population",路径含 channel、namespace、version、dataset、table、column 等层级;channel 体现数据加工阶段(meadow、garden、grapher),garden 可能含性别、年龄等额外维度。国家名称与代码已统一,便于按时间和实体合并。

使用方式:若环境有 uv,可在脚本头部用内联依赖运行,如 # /// script 加 dependencies = ["owid-catalog"],再执行 uv run --no-project script.py;否则用 pip install owid-catalog。基本用法为 from owid.catalog import fetch, search,例如 fetch("life-expectancy") 取图表数据,search("population", kind="table") 搜索数据表,search("...", kind="indicator") 做语义搜索,结果可用 to_frame().head(30).to_csv() 输出。可传入完整 URL 或目录路径。结果容器 ResponseSet 支持索引、过滤、排序、取最新版本及转换。

限制与注意:默认 rich 展示不适合纯文本输出,应转为 CSV 或字符串。使用前应查看 metadata(codebook)以理解单位、来源,确保正确解读。数据使用需正确署名:元数据有完整引用则采用,否则以各来源的 attribution(缺失时用 producer)构造致谢。该库依赖 Python 3.10 及以上。若只需快速查询、不使用 Python,可考虑基于 HTTP 的方式。官方资料未提供具体收费、价格或性能数据。