GeoPandas 공간분석 가이드

무엇을 해주나

Python GeoPandas로 벡터(점·선·면) 데이터를 다룰 때 흔히 발생하는 오류를 사전에 차단하는 규칙과 도구를 제공합니다.

• 재현 가능한 환경: GeoPandas 1.1.4 기준으로 numpy/pandas/shapely/pyproj/pyogrio 버전을 고정한 uv 설치 스니펫 제공
• 8가지 정확성 게이트: 출처·해시 확인, 결측/빈/무효 지오메트리 구분, CRS 메타데이터 검증(set_crs vs to_crs), 평면 단위 확인, 변환 정확도, 정밀도 그리드, 조인 카디널리티, 출력 계약
• API 판단 기준: sjoin 술어(within/contains/covers/dwithin) 방향성, sjoin_nearest의 동일 거리 다중 매칭, overlay/clip/dissolve의 타입 변경 및 슬리버 처리
• I/O 규칙: pyogrio 기본, GeoPackage/GeoParquet 권장, GeoParquet schema 1.0.0과 crs 키 해석, PostGIS는 파라미터 바인딩과 트랜잭션 사용
• 프라이버시 계약: 정확한 좌표·주소·이동 경로를 민감정보로 취급하고 공개 전 일반화
• 로컬 CLI 6종: 벡터 인벤토리, CRS 재투영 계획, 지오메트리 유효성 리포트, 공간조인 감사, 내보내기 계약, 민감좌표 체크리스트

이런 분께 추천

• 행정구역·부동산·물류·환경 데이터를 GeoPandas로 분석하는 데이터 분석가·연구자
• GeoPandas 0.14 이하 코드를 1.x로 마이그레이션해야 하는 개발자(PyGEOS 제거, op=→predicate=, unary_union→union_all() 등 체크리스트 포함)
• 좌표계(CRS) 실수로 면적·거리 결과가 틀리는 문제를 겪어본 사람
• 개인 위치정보가 포함된 공간데이터를 외부에 공개해야 하는 팀

활용 예시

1. "이 GeoPackage 안의 폴리곤이 왜 면적이 이상하게 나오나요?" → CRS가 지리좌표계(EPSG:4326)인지 확인하고 적절한 등면적/UTM 투영으로 변환하는 절차와 geometry_validity_report.py 실행 결과를 함께 제시
2. "포인트와 행정구역을 조인했는데 행 수가 늘었어요" → spatial_join_audit.py로 술어 의미와 중복 ID, 1:N 매칭을 점검하고 예상 카디널리티를 명시한 재작업 코드 제안
3. "고객 좌표 지도를 보고서에 넣어야 해요" → sensitive_coordinates_checklist.py로 공개 게이트를 통과시키고 explore(tiles=None, tooltip=False) 기반 일반화된 초안 지도 코드 작성

클로드스킬마트에서 찾은 스킬을 설치해줘.
GitHub 저장소 K-Dense-AI/scientific-agent-skills 의 skills/geopandas 폴더를 내 ~/.claude/skills/geopandas/ 에 그대로 복사해줘.
설치가 끝나면 이 스킬로 무엇을 할 수 있는지 한 줄로 알려줘.