earth osm

Earth-OSM

Un comando para extraer datos de infraestructura de OpenStreetMap

Descripción general

Descargas de OSM, filtros, limpiadores y exportaciones de OSM de OpenStreetMap (OSM). Proporciona una API de Python y una interfaz CLI para extraer datos para varios tipos de infraestructura, como líneas eléctricas, subestaciones y más.

? Características clave

• ? Extrae datos de infraestructura de OSM
• ? Limpia y estandariza los datos (próximamente)
• No hay límites de tasa de API (datos atendidos de Geofabrik)
• ? Proporciona una API de Python
• Admite el multiprocesamiento para una extracción más rápida
• Emite datos en formatos .csv y .geoJson
• ? Admite la extracción de datos globales
• ? ️ Interfaz CLI fácil de usar

Empezando

Instalación

Instale Earth-OSM usando PIP (recomendado):

pip install earth-osm

O con conda:

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

Uso básico

Extraiga datos de OSM utilizando la CLI:

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

Este comando extrae datos de infraestructura de potencia para Benin y Mónaco, centrándose en subestaciones y líneas eléctricas. Por defecto, los archivos .csv y .geoJson resultantes se almacenan en ./earth_data/out .

Cargue los datos 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' )

Referencia de CLI

Extraer comando

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

Argumentos:

• <primary> : característica primaria para extraer (por ejemplo)

Opciones requeridas:

• --regions : especifique una o más regiones usando códigos ISO 3166-1 Alpha-2, ISO 3166-2 o nombres completos

Consejo: una lista de regiones está disponible en regiones.md

Argumentos opcionales:

Argumento	Descripción	Por defecto
--features	Especificar subfreaturas de la característica principal	Todas las características
--update	Actualizar los datos existentes	FALSO
--no_mp	Deshabilitar el multiprocesamiento	Falso (MP habilitado)
--data_dir	Directorio de ruta al directorio de datos	'./earth_data'
--out_dir	Directorio de ruta a salida	Igual que data_dir
--out_format	Formato (s) de exportación: CSV y/o Geojson	['CSV', 'Geojson']
--agg_feature	Salidas agregadas por función	FALSO
--agg_region	Salidas agregadas por región	FALSO

? API de Python

Para un uso más avanzado, puede usar la API de 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 ,
)

Desarrollo

Para contribuir a la Tierra-OSM, siga estos pasos:

1. (Opcional) Instale una versión específica de Earth_osm:

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

2. (Opcional) Cree un entorno virtual para Python> = 3.10:

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

3. Instale las dependencias de desarrollo:

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

4. Lea el archivo contribuyente.md para obtener información más detallada sobre cómo contribuir al proyecto.

? Licencia

Este proyecto tiene licencia bajo la licencia MIT. Consulte el archivo de licencia para obtener más detalles.

? Comunidad

Únase a nuestra comunidad de Discord para conectarse con otros usuarios y contribuyentes, hacer preguntas y obtener soporte.

Documentación

Para obtener información más detallada, consulte nuestra documentación completa.

---

Hecho con ❤️ por el equipo de Pypsa Meets Earth