トラブルシューティング#
GWexpy の利用時に遭遇しやすい問題とその解決策をまとめます。
まずここを見る#
症状から逆引きする場合は、次を起点にしてください。
インストール関連#
1. Cannot install nds2 / framel#
[gw] エクストラで使用されるバイナリライブラリは pip ではインストールできません。
解決策: Conda (Miniforge 等) で専用環境を作成し、その中で PyPI から GWexpy をインストールしてください。
conda create -n gwexpy python=3.11
conda activate gwexpy
conda install -c conda-forge python-nds2-client python-framel ldas-tools-framecpp
pip install "gwexpy[gw,analysis,fitting]"
関連: インストールガイド
2. Errors on Apple Silicon (M1/M2/M3) Mac#
一部の GW 解析用パッケージが Intel (x86_64) 版としてビルドされており、そのままでは動作しない場合があります。
解決策: conda-forge チャンネルからインストールしたものに関しては、ネイティブ (arm64) 対応が進んでいます。常に最新版に更新してください。
conda update -c conda-forge --all
3. Compilation error for minepy (MIC calculation)#
pip install minepy が C 拡張のコンパイルで失敗することがあります。
解決策： 自動ビルドスクリプトは、GWexpy リポジトリのソースチェックアウトでのみ利用できます。まずリポジトリを clone してから、次を実行してください。
python scripts/dev_tools/install_minepy.py
最小インストールを拡張している途中で発生した場合は、インストールガイド の extras 案内を確認してください。
描画・可視化関連#
4. Plots not displaying / Tcl_AsyncDelete error#
Jupyter Notebook や GUI アプリで Matplotlib のバックエンドに関する不整合が起こっている可能性があります。
解決策: バックエンドを明示的に指定して試してください。
import matplotlib
matplotlib.use('Qt5Agg') # or 'Agg', 'TkAgg'
5. Map (GeoMap) not displaying#
pygmt のインストール状況と、GMT (Generic Mapping Tools) 本体がパスに含まれているか確認してください。
解決策: Conda で pygmt を再インストールすることを推奨します。
conda install -c conda-forge pygmt
クイックスタート の最小例から始めた場合、pygmt はオプションであり、最小インストールには含まれない点に注意してください。
解決しない場合#
軽量な不具合報告や機能追加の要望には、フィードバックフォーム を使用してください。公開追跡が必要な再現可能な技術的問題は、エラーログを添えて GitHub の Issues で報告してください。個人情報、認証情報、脆弱性の詳細をフォームや公開 Issue に含めないでください。リポジトリの Security Policy に従ってください。次の情報があると調査が容易になります。
OS バージョン
Python バージョン
実行したコマンドと詳細なトレースバック (Traceback)