惑星位置ウィジェット
A Planet Position Widget (leancrew.com)
要約
著者は、macOSのウィジェットを作成するためにPythonスクリプトを開発しました。このスクリプトは、Astropyライブラリを使用して太陽、月、および古代の定義における惑星の位置(方位角と高度)を計算し、TerminalWidgetアプリケーションに表示します。これにより、空に見える天体の位置をリアルタイムで把握できるようになります。
全文翻訳
惑星位置ウィジェット
2026年8月12日 午後12時16分 Dr. Drang 著
TerminalWidgetでMacウィジェットを作成する方法とAstropyで天体の位置を特定する方法を学んだ後、自然な流れとして、これらを組み合わせて惑星を追跡するウィジェットを作成することにしました。
[画像: プラネット位置ウィジェット]
私が使用しているのは惑星の古代の定義であり、太陽と月を含みますが、土星より先の天体は含みません。数字はそれぞれ方位角と高度で、度単位で示されます。このアイデアは、何が見える可能性があり、それがどこにあるかを私に伝えることです。この特定のスクリーンショットは、昨夜10時過ぎに撮影されたものです。すべてが地平線の下にあったため、外に出る理由は何もありませんでした。
太陽を含めるかどうか迷いました。空で太陽を見つけるのに助けが必要な人はほとんどいませんし、太陽が出ているときは月以外のものは何も見えません。しかし、一部の天体の可視性が太陽からの分離に依存するため、完全性のために、またその理由から、含めることにしました。
まず、ウィジェットのテキストを生成するコードから始めましょう。これはplanetsというPythonスクリプトです。
1: import astropy.units as u
2: from astropy.time import Time
3: from astropy.coordinates import get_body, AltAz, EarthLocation
4: from subprocess import run
5:
6: def direction(az):
7: 'Return a string indication of the azimuth (given in degrees).'
8:
9: dirs = 'N NNE NE ENE E ESE SE SSE S SSW SW WSW W WNW NW NNW'.split()
10: i = int(((az + 11.25) % 360) / 22.5)
11: return dirs[i]
12:
13: # Current time in UTC.
14: ut = Time.now()
15:
16: # Observation location.
17: home = EarthLocation(lat=41.81433*u.deg, lon=-88.07093*u.deg, height=208*u.m)
18:
19: # Bodies of interest.
20: planets = 'Moon Sun Mercury Venus Mars Jupiter Saturn'.split()
21:
22: # Current positions of all the bodies.
23: pos = {}
24: const = {}
25: for p in planets:
26: pos[p] = get_body(p, ut).transform_to(AltAz(obstime=ut, location=home))
27: const[p] = pos[p].get_constellation()
28:
29: # Assemble the results.
30: output = []
31: for p in planets:
32: output.append(f'{p:>8s}: {pos[p].az.value:3.0f} \
33: {direction(pos[p].az.value):3s} {pos[p].alt.value:3.0f} {const[p]}')
34:
35: # Pipe the results through TerminalWidget.
36: tw = '/Applications/TerminalWidget.app/Contents/MacOS/TerminalWidget\
37: --target planets --font Menlo --bg eeeeee --fg 000000 --text -'.split()
38: run(tw, input='
'.join(output).encode())
39:
40: # print('
'.join(output))
launchdによって後述するように呼び出されるため、シェバン行はありません。
planetsが必要なモジュールをインポートした後、6〜11行目は方位角を受け取り、対応するコンパスの方位を示す文字列を返すdirection関数を定義しています。これは、Astropyが方位角を223°と報告しても、私にはすぐに「南西」とはわからないためです。この関数は、この図のような16点コンパスを想定しています。
[画像: ウィキペディアからのコンパスローズ]
Wikipediaより画像。
各点は22.5°で区切られているため、10行目では22.5で割っています。10行目の他の部分は、北が348.75°(-11.25°)から始まり、方位角は360°でリセットされ、リストのインデックスは整数でなければならないという事実を調整しています。Astropyにはすでにdirectionと同じ機能を持つ関数があるかもしれませんが、ドキュメントを検索するよりも、自分で関数を書く方が簡単(そして楽しい)だろうと思いました。
14行目と17行目は、観測の時間と場所を定義しています。planetsは30分ごとに実行されてウィジェットを更新するため、表示される情報は30分以上前のものにはなりません。上記のhomeの場所は実際にはモートン樹木園ですが、私のスクリプトのバージョンでは自宅の緯度と経度を使用しています。
20行目はplanetsリストを定義し、23〜27行目は各惑星のAltAzの位置と星座を含むposとconstという2つの辞書を作成します。get_body関数(26行目)が位置を取得し、get_constellation関数(27行目)はその位置を使用して、天体がどの星座にあるかを判断します。
30〜33行目はoutput行のリストを作成し、36〜38行目はsubprocessモジュールのrun関数を使用して、出力行をTerminalWidgetに送信します。twリストには、TerminalWidget実行可能ファイルへのフルパスと、それに渡されるすべてのオプションが含まれています。runのinputパラメータは、以前に定義されたoutputであり、改行で区切られた単一の文字列に変換され、バイトとしてエンコードされています。
40行目は、将来の開発のために残しておいたデバッグ行です。planetsを記述している間、36〜38行目をコメントアウトし、40行目のコメントを外して、結果をターミナルですぐに確認できるようにしていました。
planetsは、この起動エージェントcom.leancrew.planets.plistを介して、30分ごと(毎時0分と30分)にlaunchdによって実行されます。
1: <?xml version="1.0" encoding="UTF-8"?>
2: <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
3: <plist version="1.0">
4: <dict>
5: <key>Label</key>
6: <string>com.leancrew.planets</string>
7: <key>ProgramArguments</key>
8: <array>
9: <string>/path/to/python</string>
10: <string>/path/to/planets</string>
11: </array>
12: <key>StartCalendarInterval</key>
13: <array>
14: <dict>
15: <key>Minute</key>
16: <integer>0</integer>
17: </dict>
18: <dict>
19: <key>Minute</key>
20: <integer>30</integer>
21: </dict>
22: </array>
23: </dict>
24: </plist>
ProgramArguments配列の最初の項目はPython実行可能ファイルへのフルパス(これがplanetsにシェバン行が不要な理由です)、2番目の項目はplanetsスクリプト自体のフルパスです。planetsの実行スケジュールはStartCalendarInterval配列にあります。分が0または30のときはいつでも、スクリプトが実行されます。
この記事を書いている間、日食がほぼ始まっています。ここシカゴ地域では、非常に部分的な日食になるでしょう。太陽の1%しか隠されません。しかし、雲によって太陽の100%が隠されているため、日食を見ることはできません。しかし、私の惑星ウィジェットは、大まかに言って、それが雲の上で起こっていることを示しています。
[画像: 日食の時間近くの惑星ウィジェット]
太陽と月の位置を最も近い度数に丸めるだけでは、日食を特定するには十分な精度ではありませんが、良い手がかりにはなります。
更新 2026年8月20日 午後4時41分
私が書いたスクリプトをBrettが取り上げ、新しいTerminalWidgetの機能で強化したと聞いても驚かないでしょう。彼は過去1週間、ウィジェットとアプリの両方を更新していましたが、まだ完了していないことが明らかだったので、彼の作業のどれにもリンクしませんでした。今では、彼は基本的に完了し、他のことに移っていると思います。
[画像: Terpstra惑星ウィジェット]
彼の惑星ウィジェットのバージョンをより良く見せる新しいTWの機能は、情報のテーブルを表示するあらゆるウィジェットの外観をきれいにします。Brettは最近、App Storeのレビューチームにかなりのプレッシャーをかけていましたが(アプリのバージョン履歴を見てください)、今は少し休憩していると思います。