earth osm

Земля-Осм

Одно команда для извлечения данных инфраструктуры из OpenStreetMap

Обзор

Загрузки на землю, фильтры, очищают и экспортируют данные инфраструктуры от OpenStreetMap (OSM). Он обеспечивает интерфейс Python API и интерфейс CLI для извлечения данных для различных типов инфраструктуры, таких как линии электропередачи, подстанции и многое другое.

? Ключевые функции

• ? Извлекает данные инфраструктуры из OSM
• ? Очищает и стандартизирует данные (скоро)
• Нет ограничений по ставке API (данные, обслуживаемые Geofabrik)
• ? Обеспечивает Python API
• Поддерживает многопроцесс
• Выводы данных в форматах .csv и .geojson
• ? Поддерживает глобальное извлечение данных
• ? ️ простой в использовании интерфейс CLI

Начиная

Установка

Установите Earth-OSM с помощью PIP (рекомендуется):

pip install earth-osm

Или с Conda:

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

Основное использование

Извлеките данные OSM, используя CLI:

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

Эта команда извлекает данные о силовой инфраструктуре для Бенина и Монако, сосредоточившись на подстанциях и линиях электропередачи. По умолчанию, полученные файлы .csv и .geojson хранятся в ./earth_data/out .

Загрузите извлеченные данные с помощью Pandas:

 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' )

КЛИ Ссылка

Извлечь команду

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

Аргументы:

• <primary> : основная особенность для извлечения (например, сила)

Требуемые варианты:

• --regions : укажите одну или несколько областей, используя ISO 3166-1 Alpha-2, ISO 3166-2 коды или полные имена

Совет: список регионов доступен на регионах.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 ,
)

Разработка

Чтобы внести свой вклад в Earth-OSM, следуйте этим шагам:

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. Прочитайте файл appling.md для более подробной информации о том, как внести свой вклад в проект.

? Лицензия

Этот проект лицензирован по лицензии MIT. Смотрите файл лицензии для получения подробной информации.

? Сообщество

Присоединяйтесь к нашему сообществу Discord, чтобы связаться с другими пользователями и участниками, задавать вопросы и получить поддержку.

Документация

Для получения более подробной информации, ознакомьтесь с нашей полной документацией.

---

Сделано с ❤ от Pypsa встречает Earth Team