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一起製成的❤️