earth osm

โลก

คำสั่งเดียวในการแยกข้อมูลโครงสร้างพื้นฐานจาก OpenStreetMap

ภาพรวม

การดาวน์โหลด Earth-OSM ตัวกรองทำความสะอาดและข้อมูลโครงสร้างพื้นฐานจาก 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 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 หรือชื่อเต็ม

เคล็ดลับ: รายการภูมิภาคมีอยู่ที่ region.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. อ่านไฟล์ที่มีส่วนร่วม MD สำหรับข้อมูลรายละเอียดเพิ่มเติมเกี่ยวกับวิธีการมีส่วนร่วมในโครงการ

- ใบอนุญาต

โครงการนี้ได้รับใบอนุญาตภายใต้ใบอนุญาต MIT ดูไฟล์ใบอนุญาตสำหรับรายละเอียด

- ชุมชน

เข้าร่วมชุมชน Discord ของเราเพื่อเชื่อมต่อกับผู้ใช้และผู้สนับสนุนคนอื่น ๆ ถามคำถามและรับการสนับสนุน

เอกสาร

สำหรับข้อมูลรายละเอียดเพิ่มเติมตรวจสอบเอกสารฉบับเต็มของเรา

---

ทำด้วย❤โดย pypsa พบกับทีมโลก