الصفحة الرئيسية>المتعلقة بالبرمجة>باور بيلدر
تنزيل

الأرض

مفيد واحد لاستخراج بيانات البنية التحتية من OpenStreetMap

ملخص

تنزيلات Earth-OSM ومرشحات وتنظيف وتصدير بيانات البنية التحتية من OpenStreetMap (OSM). يوفر واجهة برمجة تطبيقات Python وواجهة CLI لاستخراج البيانات لأنواع البنية التحتية المختلفة ، مثل خطوط الطاقة ، المحطات الفرعية ، وأكثر من ذلك.

؟ الميزات الرئيسية

  • ؟ يستخلص بيانات البنية التحتية من OSM
  • ؟ ينظف وتوحيد البيانات (قريبًا)
  • لا حدود معدل API (البيانات المقدمة من Geofabrik)
  • ؟ يوفر Python API
  • يدعم المعالجة المتعددة لاستخراج أسرع
  • يخرج البيانات بتنسيقات .csv و .geojson
  • ؟ يدعم استخراج البيانات العالمية
  • ️ واجهة CLI سهلة الاستخدام

ابدء

تثبيت

تثبيت Earth-OSM باستخدام PIP (موصى به): 

pip install earth-osm

أو مع كوندا: 

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

الاستخدام الأساسي

استخراج بيانات OSM باستخدام CLI: 

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

يستخرج هذا الأمر بيانات البنية التحتية للطاقة لـ Benin و Monaco ، مع التركيز على المحطات الفرعية وخطوط الطاقة. بشكل افتراضي ، يتم تخزين ملفات .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 أو أسماء كاملة

نصيحة: قائمة بالمناطق متوفرة في المناطق.

الحجج الاختيارية:

دعوى وصف تقصير
--features حدد الميزات الفرعية للميزة الأساسية جميع الميزات
--update تحديث البيانات الحالية خطأ شنيع
--no_mp تعطيل المعالجة المتعددة خطأ (تمكين MP)
--data_dir مسار إلى دليل البيانات './arth_data "
--out_dir مسار إلى دليل الإخراج مثل data_dir
--out_format تنسيقات التصدير: CSV و/أو Geojson ['CSV' ، 'Geojson']
--agg_feature إجمالي المخرجات حسب الميزة خطأ شنيع
--agg_region إجمالي المخرجات حسب المنطقة خطأ شنيع

؟ بيثون 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. (اختياري) إنشاء بيئة افتراضية لبيثون> = 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. اقرأ ملف المساهمة. md للحصول على معلومات أكثر تفصيلاً حول كيفية المساهمة في المشروع.

؟ رخصة

هذا المشروع مرخص بموجب ترخيص معهد ماساتشوستس للتكنولوجيا. انظر ملف الترخيص للحصول على التفاصيل.

؟ مجتمع

انضم إلى مجتمع Discord للتواصل مع المستخدمين والمساهمين الآخرين ، وطرح الأسئلة ، والحصول على الدعم.

الوثائق

لمزيد من المعلومات التفصيلية ، تحقق من وثائقنا الكاملة.

مصنوع من ❤ من قبل Pypsa Meets Earth Team

شعار الأرض

يوسع
معلومات إضافية
تطبيقات ذات صلة
نوصي لك
أخبار ذات صلة الكل