SkyProfile

SkyProfile 是一款 PyQt5 桌面应用，用于查询 ADSBexchange 全球历史数据（单架或多架飞机）、检测多航段航班，并导出带有丰富分析功能（机场、航线、时间段、呼号、FAA 元数据）的 KML/CSV/JSON/Excel 文件。

主要特性

• 按 ICAO hex 进行日期范围查询；可选通过 ADSBx 基础飞机数据库进行尾号/注册号查询。
• 稳健的航段检测（地面 → 空中 → 地面），包含空中/地面标志、高度/地速启发式判断、90 秒地面停留、20 分钟间隔处理以及实时呼号历史。
• 导出（按类型切换）：KML 航点、KML 2D 航线、KML 3D 航线、机场热力图 KML（白色圆点按活动量缩放）、CSV、JSON、Excel 摘要。
• 批处理模式，可选合并报告：将所有飞机合并为一组离线导出文件（CSV/JSON/KML/Excel）。合并时不生成单个飞机文件。
• 机场匹配（250 公里内最近；无匹配时使用合成 ID）在 KML 和 Excel 中复用。
• FAA 注册表查询 N-number 飞机（本地数据库位于 resources/faa_registry）。
• GUI 进度显示每个阶段状态；运行/停止控制；应用图标应用于窗口/任务栏。
• 设置菜单包含“检查更新”（GitHub 标签检查）和“关于”（版本/信息 + 数据归属）。

批处理模式

• 输入：CSV，包含 icao_hex（或 hex/icao）和/或 tail/registration 列。每行代表一个飞机目标。
• 行为：
  • 在所选日期范围内运行所有列出的飞机。
  • 将每架飞机的输出写入 output/<HEX>_<TAIL>/（如果缺少尾号则仅使用 hex）。
  • 可选合并报告：启用后，不再生成单个文件，而是生成一组合并输出：
    • 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：每个到访机场一个标记，大小按总访问次数（到达+起飞）缩放，并着色为白色以便叠加；属性包括到达/起飞日期、hex、尾号。
• CSV：每条记录一行；列包含 hex 和尾号，以及展平的 ac_data（不包含原始 ac_data_json 列）。
• JSON：每架飞机的包装负载：{ hex, tail, meta, data: [raw trace_full blobs] }；合并的 JSON 是这些负载的列表。
• Excel 摘要（完整的多工作表工作簿）：
  • Summary：元数据（hex、注册号、类型、所有者、型号、标志、日期范围）；如有则包含 FAA 详细信息。
  • Flights：每个检测到的航段一行；列包括 hex、尾号、航段 ID、起飞/到达 UTC 时间戳、持续时间、起飞/到达机场 ID 和名称、纬度/经度、星期/几号/小时分桶、呼号和历史。
  • Airports：按访问次数（到达 + 起飞）排名的机场，包含 ID、ICAO/IATA、名称、城市/国家、计数、纬度/经度；包含条形图“按访问次数统计的机场”。
  • Routes：热门航线，带有可读的机场标签和计数；包含条形图“航线飞行次数”。
  • DayOfWeek：按星期统计次数，并带有条形图。
  • DayOfMonth：按月内日期统计次数，并带有条形图。
  • Hours：按 UTC 小时统计起飞与降落，使用双系列条形图（起飞为蓝色，降落为橙色）。

资源与缓存

• 共享数据位于 resources/（acdb_cache、airport_db、faa_registry）中。PyInstaller 构建通过 --add-data 包含它，并将其复制到 EXE 旁边。
• ADSBx 轨迹缓存位于 output/cache/<hex>/YYYY-MM-DD.json。
• 每架飞机的导出按飞机分组存放在 output/<HEX>_<TAIL>/（如果没有尾号则仅使用 hex）。合并的批处理导出使用 consolidated_<N>ACFT_<date range>* 存放在主 output/ 目录中。

注意事项与限制

• 覆盖缺口仍可能丢失精确的地面时间；最近机场匹配可能会回退到合成的 LL_lat_lon ID。
• Excel 中禁用了照片，以避免图形损坏。
• 单文件 EXE 体积较大，因为它打包了 Python + Qt 及依赖项；如果需要更小的 EXE，请使用 one-dir 模式。

许可证

• Apache License 2.0（见 LICENSE）。外部数据/API 仍遵循其各自条款。