earth osm

Earth-ofm

Um comando para extrair dados de infraestrutura do OpenStreetMap

Visão geral

Downloads da Earth-OSM, filtros, limpam e exporta dados de infraestrutura do OpenStreetMap (OSM). Ele fornece uma API Python e uma interface CLI para extrair dados para vários tipos de infraestrutura, como linhas de energia, subestações e muito mais.

? Principais recursos

• ? Extrair dados de infraestrutura do OSM
• ? Limpa e padroniza os dados (em breve)
• Sem limites de taxa de API (dados atendidos pela Geofabrik)
• ? Fornece uma API Python
• Suporta multiprocessamento para extração mais rápida
• Produz dados nos formatos .csv e .geojson
• ? Suporta extração de dados global
• ? Aste interface da CLI fácil de usar

Começando

Instalação

Instale o Earth-OSM usando PIP (recomendado):

pip install earth-osm

Ou com conda:

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

Uso básico

Extraia os dados do OSM usando a CLI:

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

Este comando extrai dados de infraestrutura de energia para Benin e Mônaco, com foco em subestações e linhas de energia. Por padrão, os arquivos .CSV e .Geojson resultantes são armazenados em ./earth_data/out .

Carregue os dados extraídos usando 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' )

Referência da CLI

Extrair comando

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

Argumentos:

• <primary> : Recurso primário para extrair (por exemplo, poder)

Opções necessárias:

• --regions : especifique uma ou mais regiões usando os códigos ISO 3166-1 alfa-2, ISO 3166-2 ou nomes completos

Dica: uma lista de regiões está disponível em regiões.md

Argumentos opcionais:

Argumento	Descrição	Padrão
--features	Especifique sub-fumantes do recurso primário	Todos os recursos
--update	Atualizar dados existentes	Falso
--no_mp	Desativar o multiprocessamento	Falso (MP ativado)
--data_dir	Caminho para diretório de dados	'./earth_data'
--out_dir	Diretório de caminho para saída	O mesmo que data_dir
--out_format	Formato (s) de exportação: CSV e/ou Geojson	['CSV', 'Geojson']
--agg_feature	Saídas agregadas por recurso	Falso
--agg_region	Saídas agregadas por região	Falso

? API Python

Para um uso mais avançado, você pode usar a API do Python:

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

Desenvolvimento

Para contribuir com o Earth-OSM, siga estas etapas:

1. (Opcional) Instale uma versão específica de Earth_OSM:

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

2. (Opcional) Crie um ambiente virtual para Python> = 3.10:

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

3. Instale as dependências de desenvolvimento:

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

4. Leia o arquivo contribuinte.md para obter informações mais detalhadas sobre como contribuir para o projeto.

? Licença

Este projeto está licenciado sob a licença do MIT. Consulte o arquivo de licença para obter detalhes.

? Comunidade

Junte -se à nossa comunidade Discord para se conectar com outros usuários e colaboradores, fazer perguntas e obter suporte.

Documentação

Para obter informações mais detalhadas, consulte nossa documentação completa.

---

Feito com ❤️ pelo Pypaes Meets Earth Team