earth osm

Earth-OSM

OpenStreetMap에서 인프라 데이터를 추출하는 하나의 명령

개요

Earth-OSM은 OpenStreetMap (OSM)에서 인프라 데이터를 다운로드, 필터, 청소 및 수출합니다. 파이썬 API 및 CLI 인터페이스를 제공하여 전력선, 변전소 등과 같은 다양한 인프라 유형에 대한 데이터를 추출합니다.

? 주요 기능

• ? OSM에서 인프라 데이터를 추출합니다
• ? 데이터를 정리하고 표준화합니다 (곧 출시)
• API 요율 제한 없음 (Geofabrik에서 제공되는 데이터)
• ? 파이썬 API를 제공합니다
• 더 빠른 추출을 위해 멀티 프로세싱을 지원합니다
• .csv 및 .geojson 형식의 데이터를 출력합니다
• ? 글로벌 데이터 추출을 지원합니다
• ? ️ 사용하기 쉬운 CLI 인터페이스

시작하기

설치

PIP를 사용하여 Earth-OSM 설치 (권장) :

pip install earth-osm

또는 콘다와 함께 :

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

기본 사용

CLI를 사용하여 OSM 데이터 추출 :

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-2, ISO 3166-2 코드 또는 성명을 사용하여 하나 이상의 영역을 지정합니다.

팁 : 지역 목록은 지역에서 구할 수 있습니다 .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	영역 별 집계 출력	거짓

? 파이썬 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. 프로젝트에 기여하는 방법에 대한 자세한 정보는 Contributing.md 파일을 읽으십시오.

? 특허

이 프로젝트는 MIT 라이센스에 따라 라이센스가 부여됩니다. 자세한 내용은 라이센스 파일을 참조하십시오.

? 지역 사회

불화 커뮤니티에 가입하여 다른 사용자 및 기고자와 연결하고 질문을하고 지원을 받으십시오.

선적 서류 비치

자세한 정보는 전체 문서를 확인하십시오.

---

PYPSA가 지구 팀을 만나는 ❤️로 제작되었습니다