earth osm Download - earth osm Source Code Download

earth osm

PowerBuilder

2.3.post1

Herunterladen

Erde-Osm

One-Command, um Infrastrukturdaten aus OpenStreetMap zu extrahieren

Überblick

Earth-OSM-Downloads, Filter, Reinigungen und Exporte Infrastrukturdaten von OpenStreetMap (OSM). Es bietet eine Python -API und eine CLI -Schnittstelle, um Daten für verschiedene Infrastrukturtypen wie Stromleitungen, Umspannwerke und mehr zu extrahieren.

? Schlüsselmerkmale

? Extrahiert Infrastrukturdaten aus OSM
? Reinigt und standardisiert die Daten (bald kommen)
Keine API -Ratenbegrenzungen (Daten, die von Geofabrik bedient wurden)
? Bietet eine Python -API
Unterstützt die Multiprozesation für eine schnellere Extraktion
Gibt Daten in .csv- und .geojson -Formaten aus
? Unterstützt die globale Datenextraktion
? ️ leicht zu bedienende CLI-Schnittstelle

Erste Schritte

Installation

Installieren Sie Earth-Osm mit PIP (empfohlen):

pip install earth-osm

Oder mit Conda:

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

Grundnutzung

OSM -Daten mit der CLI extrahieren:

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

Dieser Befehl extrahiert Power -Infrastrukturdaten für Benin und Monaco und konzentriert sich auf Umspannwerke und Stromleitungen. Standardmäßig werden die resultierenden .csv- und .geojson -Dateien in ./earth_data/out gespeichert.

Laden Sie die extrahierten Daten mit 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' )

CLI -Referenz

Befehl extrahieren

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

Argumente:

<primary> : Primäres Merkmal zum Extrahieren (z. B. Leistung)

Erforderliche Optionen:

--regions : Geben Sie eine oder mehrere Regionen mit ISO 3166-1 Alpha-2, ISO 3166-2 oder vollständigen Namen an

Tipp: Eine Liste von Regionen ist in Regionen verfügbar.md

Optionale Argumente:

Argument	Beschreibung	Standard
`--features`	Geben Sie Unterfehler des primären Merkmals an	Alle Funktionen
`--update`	Aktualisieren Sie vorhandene Daten	FALSCH
`--no_mp`	Multiprozessierung deaktivieren	False (MP aktiviert)
`--data_dir`	Pfad zum Datenverzeichnis	'./earth_data' '
`--out_dir`	Pfad zum Ausgabeverzeichnis	Gleich wie data_dir
`--out_format`	Exportformat (en): CSV und/oder Geojson	['CSV', 'Geojson']]
`--agg_feature`	Aggregierte Ausgaben nach Funktionen	FALSCH
`--agg_region`	Aggregierte Ausgaben nach Region	FALSCH

? Python API

Für fortgeschrittene Nutzung können Sie die Python -API verwenden:

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

Entwicklung

Um zum Erde zu beitragen, befolgen Sie die folgenden Schritte:

(Optional) Installieren Sie eine bestimmte Version von Earth_osm:

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

(Optional) Erstellen Sie eine virtuelle Umgebung für Python> = 3.10:
```
python3 -m venv .venv
source .venv/bin/activate
```

Installieren Sie die Entwicklungsabhängigkeiten:

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

Lesen Sie die Datei mit beitragen.md für detailliertere Informationen zum Beitrag zum Projekt.

? Lizenz

Dieses Projekt ist unter der MIT -Lizenz lizenziert. Weitere Informationen finden Sie in der Lizenzdatei.

? Gemeinschaft

Schließen Sie sich unserer Discord -Community bei, um sich mit anderen Benutzern und Mitwirkenden zu verbinden, Fragen zu stellen und Unterstützung zu erhalten.