SkyProfile

SkyProfile は、単機または複数の航空機について ADSBexchange のグローバル履歴を照会し、複数レグのフライトを検出し、KML/CSV/JSON/Excel をリッチな分析情報（空港、ルート、時間帯、コールサイン、FAA メタデータ）とともにエクスポートする PyQt5 デスクトップアプリです。

主な機能

• ICAO 16進コードによる日付範囲クエリ。ADSBx の基本航空機データベースによる任意の tail/reg（テール番号/機体記号）の検索。
• 堅牢なレグ（区間）検出（地上 → 空中 → 地上）。空中/地上フラグ、高度/対地速度のヒューリスティック、90 秒の地上滞在、20 分のギャップ処理、ライブのコールサイン履歴を備えています。
• エクスポート（種類ごとにオン/オフ切り替え）: KML ポイント、KML ルート 2D、KML ルート 3D、エアポートヒートマップ KML（アクティビティに応じてサイズが変わる白いドット）、CSV、JSON、Excel サマリー。
• オプションの Consolidate reports を備えたバッチモード。すべての航空機を単一のオフラインエクスポート一式（CSV/JSON/KML/Excel）に統合します。統合時には個別ファイルは生成されません。
• 空港マッチング（250 km 以内で最寄り、該当なしの場合は合成 ID）を KML と Excel で共用。
• N ナンバー機の FAA 登録簿検索（ローカル DB は resources/faa_registry）。
• フェーズごとのステータスを表示する GUI プログレス。実行/停止コントロール。ウィンドウ/タスクバーに適用されるアプリアイコン。
• 設定メニューに「アップデートを確認」（GitHub タグのチェック）と「バージョン情報」（バージョン/情報 + データの帰属表示）。

バッチモード

• 入力: 列 icao_hex（または hex/icao）および/または tail/registration を持つ CSV。各行が 1 つの航空機ターゲットです。
• 動作:
  • 選択した日付範囲で、リストされたすべての航空機を実行します。
  • 航空機ごとの出力を output/<HEX>_<TAIL>/ に書き込みます（テール番号がない場合は hex のみ）。
  • オプションの Consolidate reports: 有効にすると、個別ファイルを生成せず、単一の統合セットを生成します:
    • 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 ポイント: 各レグの到着ごとに 1 つのプレースマーク。時刻、所要時間、コールサイン、メタデータを含みます。
• KML ルート 2D/3D: レグ全体のトラック（直線ではありません）。3D ルートには高度が含まれます。
• エアポートヒートマップ KML: 訪問した空港ごとに 1 つのマーカー。総訪問数（到着+出発）に応じてサイズが決まり、クリーンなオーバーレイのために白色で表示されます。属性には到着/出発日、hex、tail が含まれます。
• CSV: ヒットごとに 1 行。列には hex と tail に加えて、フラット化された ac_data が含まれます（生の ac_data_json 列はありません）。
• JSON: 航空機ごとにラップされたペイロード: { hex, tail, meta, data: [raw trace_full blobs] }。統合 JSON はこれらのペイロードのリストです。
• Excel サマリー（複数シートの完全なワークブック）:
  • Summary: メタデータ（hex、機体記号、型式、所有者、モデル、フラグ、日付範囲）。利用可能な場合は FAA の詳細。
  • Flights: 検出されたレグごとに 1 行。列には hex、tail、セグメント ID、出発/到着の UTC タイムスタンプ、所要時間、出発/到着空港 ID と名前、緯度/経度、曜日/日/時間帯のバケット、コールサインと履歴。
  • Airports: 訪問数（到着 + 出発）による上位空港。ID、ICAO/IATA、名前、都市/国、件数、緯度/経度を含みます。棒グラフ「Airports by Number of Visits」を含みます。
  • Routes: 読みやすい空港ラベルと件数による上位ルート。棒グラフ「Count of Routes Traveled」を含みます。
  • DayOfWeek: 曜日ごとの件数と棒グラフ。
  • DayOfMonth: 日ごとの件数と棒グラフ。

リソースとキャッシュ

• 共有データは resources/ にあります（acdb_cache、airport_db、faa_registry）。PyInstaller ビルドでは --add-data でこれらを含め、EXE の隣にコピーします。
• ADSBx のトレースキャッシュは output/cache/<hex>/YYYY-MM-DD.json の下に置かれます。
• 航空機ごとのエクスポートは output/<HEX>_<TAIL>/ にまとめられます（テール番号がない場合は hex のみ）。統合バッチエクスポートは、メインの output/ フォルダ内で consolidated_<N>ACFT_<date range>* を使用します。

注意事項と制限事項

• カバレッジのギャップにより、正確な地上時間を取得できない場合があります。最寄り空港マッチングが、合成 LL_lat_lon ID にフォールバックすることがあります。
• 破損した図形を避けるため、Excel では写真が無効になっています。
• Onefile EXE は Python + Qt + 依存関係をバンドルするため大きくなります。より小さい EXE が必要な場合は one-dir を使用してください。

ライセンス

• Apache License 2.0（LICENSE を参照）。外部データ/API はそれぞれの利用条件に従います。