moon_phase_map
Generate a moon phase calendar for any month and location, showing daily lunar illumination and crescent orientation. Use it to find full moons, new moons, or view a lunation sequence.
Instructions
月齢マップ(月の満ち欠けを1か月ぶん並べた図)を返す(認証不要・ローカル計算)。
例:「今月の月齢マップを見せて」「2026年9月の月相カレンダー」「9月の満月はいつ?」
日食の時系列パネル(solar_eclipse_series)と同じ幾何計算を使い、観測地から見た
太陽と月の実位置から「輝面の向き(位置角 PA)」と照度を求め、月円盤を正しい向きに
欠けさせて描きます(月齢から向きを決め打ちしない)。月齢は直前の朔(新月)からの
経過日数、照度は円盤の輝面の割合です。描いた画素から輝面の面積比を測り直し、
申告した照度と突き合わせて自己検証します(figure.verify)。
layout="calendar"(既定)は指定した月の日別セル(日月火水木金土の格子)、
layout="lunation" は1朔望月(朔→朔)を等間隔の時系列パネルで返します。
月齢・照度は地球規模の見え方なので観測地には依存しませんが、日付・時刻・曜日は
現地時間(緯度経度から取得した UTC オフセット)で表示します。
Args:
date: 年月("2026-09" / "2026年9月")または年月日("2026-09-16")。省略時は現在の月。
place: 観測地(例 "東京","大阪","new york")。lat/lon 指定時は無視。省略時は東京。
lat: 観測地の緯度。lon と併用時は place より優先。
lon: 観測地の経度。
layout: "calendar"(既定・1か月の格子)または "lunation"(朔望月の時系列パネル)。
days: layout="lunation" のパネル枚数(3〜12・既定8)。calendar では無視。
インライン画像を表示できないハーネス(CLI系・Android系の codex / opencode など)向けに、
content の先頭へ「🖼️ [生成した画像を開く(…)](file:///…) | 保存先: `…`」という
アイコン付きリンクを必ず出します(画像は出力ディレクトリに保存し、同じパスを
structuredContent.image_path にも入れます)。
回答時はこのリンクをそのまま提示してください(画像が描画されない環境では唯一の導線)。
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| lat | No | ||
| lon | No | ||
| date | No | ||
| days | No | ||
| place | No | ||
| layout | No | calendar |