インストール

SOPRANは現在PyPIで配布しておらず、リポジトリを取得してインストールします。 Python 3.11以上が必要です。

git clone https://github.com/Nkzono99/sopran.git
cd sopran
python -m pip install -e ".[full]"

[full]は、KAGUYA・ARTEMIS・月面マップ・可視化に必要な依存をまとめて入れます。 使うデータが決まっている場合は、下の表から必要なextraだけを選べます。

Rust拡張のビルドに必要なもの

ソースからのインストールでは、PACEのデコードやピッチ角集計を担うRust拡張 sopran._nativeを同時にビルドします。Rustのツールチェーンと、WindowsではMSVCのビルドツールが必要です。 事前の確認にはsopran-env-checkを使います（インストール後にも実行できます）。

.\.venv\Scripts\sopran-env-check.exe --native

Windowsでは、管理者権限のPowerShellでChocolateyを使うと次の手順でそろいます。

choco install -y python314
choco install -y rust visualstudio2022buildtools visualstudio2022-workload-vctools
refreshenv

python3.14 -m venv .venv
.\.venv\Scripts\python.exe -m pip install --upgrade pip
.\.venv\Scripts\python.exe -m pip install -e ".[full]"

extraの選び方

pip install -e .だけではnumpyとpandasしか入らず、import sopranと トップレベルの入口だけが動きます。各extraには、その経路でSOPRANが実際にimportするパッケージだけを入れています。

extra	使う場面	入るパッケージ
kaguya	PACE・LMAG・LRSの読み込み、SPICEによる幾何計算	cdflib, polars, pyarrow, scipy, spiceypy, xarray
artemis	ARTEMIS（THEMIS-B・C）のCDFの取得と読み込み	cdflib, xarray
moon	GeoTIFFの月面地図、SPICEによる太陽方向	rasterio, spiceypy
viz	図の作成、PlotStackの対話表示	matplotlib, panel
analysis, experimental	補間、試作モデル	scipy
full	上記すべて

OMNIの読み込みにはxarray、作図にはmatplotlibが必要です。[kaguya,viz]を入れていれば足ります。

python -m pip install -e ".[kaguya,viz]"

動作を確かめる

import sopran as spn

spn.kaguya.info()     # KAGUYAで使える機器の一覧

一覧が表示されれば準備完了です。データの保存先を決めて、最初の図を描くへ進んでください。 開発用の依存（[dev]）やテストの実行方法は開発環境と検証にまとめています。