SkyProfile

SkyProfile는 ADSBexchange 글로벌 기록을 조회하여 단일 또는 다중 항공기의 멀티레그 비행을 감지하고, KML/CSV/JSON/Excel로 내보내기(공항, 경로, 시간대, 콜사인, FAA 메타데이터 등 풍부한 분석 포함)가 가능한 PyQt5 데스크톱 앱입니다.

주요 기능

• ICAO 16진수로 날짜 범위 조회; ADSBx 기본 항공기 DB를 통한 꼬리/등록번호 선택적 조회.
• 강력한 레그 감지(지상→공중→지상) - 공중/지상 플래그, 고도/대지속도 휴리스틱, 90초 지상 체류, 20분 갭 처리, 실시간 콜사인 기록.
• 내보내기(유형별 전환 가능): KML 포인트, KML 2D 경로, KML 3D 경로, 공항 히트맵 KML(활동량에 따라 크기가 조정된 흰색 점), CSV, JSON, Excel 요약.
• 배치 모드와 선택적 보고서 통합: 모든 항공기의 데이터를 단일 오프라인 내보내기 파일(CSV/JSON/KML/Excel)로 병합. 통합 시 개별 파일은 생성되지 않음.
• 공항 매칭(250km 이내 가장 가까운 공항, 없을 경우 합성 ID 사용) - KML 및 Excel에서 재사용.
• FAA 등록부 조회(N-번호 항공기, resources/faa_registry의 로컬 DB).
• 단계별 상태를 표시하는 GUI 진행률; 실행/중지 버튼; 창/작업 표시줄에 적용된 앱 아이콘.
• "업데이트 확인"(GitHub 태그 확인) 및 "정보"(버전/정보 + 데이터 출처 표시) 설정 메뉴.

배치 모드

• 입력: icao_hex(또는 hex/icao) 및/또는 tail/registration 열이 포함된 CSV. 각 행은 하나의 항공기 대상.
• 동작:
  • 선택한 날짜 범위 내에서 나열된 모든 항공기를 실행.
  • 항공기별 출력을 output/<HEX>_<TAIL>/ 디렉토리에 작성(꼬리 번호가 없으면 16진수만).
  • 선택적으로 보고서 통합: 활성화하면 개별 파일을 생성하지 않고 단일 병합 세트를 생성:
    • consolidated_<N>ACFT_<start>_<end>.csv/.json (모든 히트/JSON 페이로드)
    • 통합 KML(포인트, 경로, 3D 경로, 공항 히트맵) - 오프라인 보기를 위해 인라인 병합
    • 통합 Excel 요약 - 일반 실행과 동일한 탭/차트로 모든 비행을 결합
• 캐싱: ADSBx 다운로드는 output/cache/<hex>/YYYY-MM-DD.json 아래에 항공기/일별로 계속 캐시됨.

설치 / 실행

소스 코드에서

pip install PyQt5 requests simplekml openpyxl lxml numpy
python skyprofile.py

패키지 EXE (Windows)

• dist/SkyProfile.exe와 함께 dist/resources/ 디렉토리 사용(FAA/공항/acdb 데이터 포함).

내보내기 및 정규화

• 레그 감지: 지상/공중 플래그, 고도/GS 확인, 90초 지상 체류, 20분 갭 착륙, 지상-클러스터 평균화, 레그별 콜사인 기록.
• KML 포인트: 착륙한 각 레그당 하나의 장소 표시 - 시간, 지속 시간, 콜사인, 메타 포함.
• KML 2D/3D 경로: 전체 레그 트랙(직선 아님); 3D 경로에는 고도 포함.
• 공항 히트맵 KML: 방문한 공항당 하나의 마커, 총 방문 횟수(도착+출발)에 따라 크기 조정, 깔끔한 오버레이를 위해 흰색; 속성에는 도착/출발 날짜, 16진수, 꼬리 번호 포함.
• CSV: 히트당 한 행; 16진수 및 꼬리 번호 열과 평탄화된 ac_data 포함(원시 ac_data_json 열 없음).
• JSON: 항공기당 래핑된 페이로드: { hex, tail, meta, data: [raw trace_full blobs] }; 통합 JSON은 이러한 페이로드의 목록.
• Excel 요약(전체 다중 시트 워크북):
  • Summary: 메타데이터(16진수, 등록 번호, 유형, 소유자, 모델, 플래그, 날짜 범위); FAA 세부 정보(있는 경우).
  • Flights: 감지된 각 레그당 한 행; 16진수, 꼬리 번호, 세그먼트 ID, 출발/도착 UTC 타임스탬프, 지속 시간, 출발/도착 공항 ID 및 이름, 위도/경도, 요일/일/시간 버킷, 콜사인 및 기록 열.
  • Airports: 방문 횟수(도착 + 출발) 기준 상위 공항 - ID, ICAO/IATA, 이름, 도시/국가, 횟수, 위도/경도 포함; "방문 횟수별 공항" 막대 차트 포함.
  • Routes: 읽기 쉬운 공항 레이블과 횟수가 포함된 상위 경로; "이동 경로 횟수" 막대 차트 포함.
  • DayOfWeek: 요일별 횟수 - 막대 차트 포함.
  • DayOfMonth: 일별 횟수 - 막대 차트 포함.
  • Hours: UTC 시간별 이륙 vs 착륙 - 이중 계열 막대 차트(이륙 파란색, 착륙 주황색).

리소스 및 캐싱

• 공유 데이터는 resources/ 디렉토리에 있음(acdb_cache, airport_db, faa_registry). PyInstaller 빌드는 --add-data를 통해 이를 포함하고 EXE와 함께 복사.
• ADSBx 추적 캐시는 output/cache/<hex>/YYYY-MM-DD.json 아래에 유지.
• 항공기별 내보내기는 output/<HEX>_<TAIL>/ 아래에 그룹화(꼬리 번호가 없으면 16진수만). 통합 배치 내보내기는 주 output/ 폴더에 consolidated_<N>ACFT_<날짜 범위>* 파일 사용.

참고 사항 및 제한 사항

• 적용 범위 공백으로 인해 정확한 지상 시간을 놓칠 수 있음; 가장 가까운 공항 매칭이 LL_lat_lon 합성 ID로 대체될 수 있음.
• Excel에서 사진은 손상된 그림을 방지하기 위해 비활성화됨.
• Onefile EXE는 Python + Qt + 종속성을 번들로 포함하기 때문에 크기가 큼. 더 작은 EXE가 필요하면 one-dir 사용.

라이선스

• Apache License 2.0 (LICENSE 파일 참조). 외부 데이터/API는 각각의 약관에 따름.