earth osm

地球-OSM

从OpenStreetMap中提取基础架构数据的一个命令

概述

从OpenStreetMap（OSM）下载地球OSM下载，过滤器，清洁和导出基础架构数据。它提供了Python API和CLI接口，以提取各种基础结构类型（例如电源线，变电站等）的数据。

？关键功能

• ？从OSM提取基础架构数据
• ？清理和标准化数据（即将推出）
• 没有API率限制（Geofabrik提供的数据）
• ？提供Python API
• 支持多处理，以更快地提取
• 以.csv和.geojson格式输出数据
• ？支持全球数据提取
• ？易于使用的CLI界面

入门

安装

使用PIP安装接地OSM（建议）：

pip install earth-osm

或与Conda：

conda install --channel=conda-forge earth-osm

基本用法

使用CLI提取OSM数据：

earth_osm extract power --regions benin monaco --features substation line

该命令提取贝宁和摩纳哥的电力基础架构数据，重点关注变电站和电源线。默认情况下，结果.csv和.geojson文件存储在./earth_data/out中。

使用熊猫加载提取的数据：

 import pandas as pd
import geopandas as gpd

# For Pandas
df_substations = pd . read_csv ( './earth_data/out/BJ_raw_substations.csv' )

# For GeoPandas
gdf_substations = gpd . read_file ( './earth_data/out/BJ_raw_substations.geojson' )

CLI参考

提取命令

earth_osm extract < primary > --regions < region 1> < region 2> ... [options]

参数：

• <primary> ：提取的主要功能（例如电源）

必需的选项：

• --regions ：使用ISO 3166-1 Alpha-2，ISO 3166-2代码或全名指定一个或多个区域

提示：区域列表可在digrom.md上找到

可选参数：

争论	描述	默认
--features	指定主要功能的子功能	所有功能
--update	更新现有数据	错误的
--no_mp	禁用多处理	false（启用MP）
--data_dir	数据目录的路径	'./earth_data'
--out_dir	输出目录的路径	与data_dir相同
--out_format	出口格式：CSV和/或Geojson	['csv'，'geojson']
--agg_feature	按功能汇总输出	错误的
--agg_region	按区域汇总输出	错误的

？ Python API

对于更高级的用法，您可以使用Python API：

 import earth_osm as eo

eo . save_osm_data (
    primary_name = 'power' ,
    region_list = [ 'benin' , 'monaco' ],
    feature_list = [ 'substation' , 'line' ],
    update = False ,
    mp = True ,
    data_dir = './earth_data' ,
    out_format = [ 'csv' , 'geojson' ],
    out_aggregate = False ,
)

发展

为了对地球贡献，请执行以下步骤：

1. （可选）安装Earth_OSM的特定版本：

   pip install git+https://github.com/pypsa-meets-earth/earth-osm.git@ < required-commit-hash >

2. （可选）为Python创建虚拟环境> = 3.10：

   python3 -m venv .venv
   source .venv/bin/activate

3. 安装开发依赖性：

   pip install git+https://github.com/pypsa-meets-earth/earth-osm.git
   pip install -e .[dev]

4. 阅读有关如何为项目贡献的更多详细信息。

？执照

该项目已根据MIT许可获得许可。有关详细信息，请参见许可证文件。

？社区

加入我们的Discord社区，与其他用户和贡献者建立联系，提出问题并获得支持。

文档

有关更多详细信息，请查看我们的完整文档。

---

由PYPSA与Earth Team一起制成的❤️