ForHosting KIT · 科学

月の照度割合計算

Q: この計算機は日付や月齢を使いますか？

いいえ。 与えられた位相角から k だけを評価します。民事日付からの月相には別の日付起点ツールを使い、割合の式だけが必要ならここへ i を渡してください。

太陽・月・観測者の角度から、月の面がどれだけ照らされているかが分かります。位相角90度ならちょうど半分が輝く半月で、0度は満月、180度は新月です。ブラウザで無料で使えます。

無料
ブラウザで動作
登録不要
データは端末の外に出ません

無料で実行 API仕様を見る

ご利用方法ウェブAPIメールTelegramアプリ近日

計算例

入力した場合

位相角: 90

結果

位相角 (°): 90 deg
位相角(rad): 1.5707963268
位相角の余弦: 0
照らされた割合: 0.5

月ディスクの照度割合とは、地球から見た見かけの月面のうち太陽に照らされている部分の比率です。観測者・写真家・教育者は、暦の日付ではなく既知の位相角からその割合を必要とすることが多いです。本ツールは太陽–月–観測者の幾何学における位相角 i を受け取り、教科書の月面測光・暦表で用いられる関係式、すなわち k は i の余弦に1を足して2で割った値を返します。0度ではディスク全体が照らされ（満月）、90度では半分が明るく（弦）、180度では夜側が地球を向きます（新月）。

位相角の意味と照度割合の定義

月の幾何学において位相角 i は、月における太陽方向と観測者方向のなす角です。太陽・月・地球がほぼ一直線で地球が中央にあるとき、i はほぼ0で近傍面が全面日照となり満月です。空で月が太陽から約90度の位置にあるとき、i は約90度でディスクの半分が明るく、上弦または下弦です。

月が地球と太陽の間にあるとき、i は180度に近づき夜半球がこちらを向く新月になります。見かけのディスクの古典的な照度割合は k = (1 + cos i) / 2 です。この恒等式は球状体の投影面積から導かれ、ターミネータが球を分け、日照部分が位相角の余弦に1を足した値の半分になります。

結果は常に0以上1以下です。本能力はこの式のみを評価し、暦日を i に変換せず、秤動や大気の補正もアースシャインもモデル化しません。暦表・軌道伝播・教科書問題からすでに i がある場合は、すぐに k を得られます。

民事日付だけから位相名や照度が必要な場合は日付起点の月相ツールを使い、本ページはそれらのパイプラインがなお純粋関数として必要とする角から割合への段階を対象とします。

照らされた割合が役立つ場面

撮影計画や露出ノートは既知の位相角をヒストグラム目標や HDR ブラケットの充填率に変換します。教室実習では表にした i から k を計算させ、範囲外を拒否するオラクルは黙ったクランプではなく物理領域を教えます。

軌道・ミッション解析スクリプトはすでに太陽・月ベクトルを積分しており、報告のディスク照度フラグには k = (1 + cos i) / 2 だけが必要です。月の照度割合計算機で検索されるコンテンツサイトは、同一の純モジュール上で有料自動化と一致する無料ブラウザ経路の恩恵を受けます。検証失敗は残高を消費しません。

活用例

暦表の後処理

任意の月暦表から得た位相角を、ダッシュボードと報告用のディスク照度割合 k = (1 + cos i) / 2 に変換します。

授業と宿題の確認

学習者が度またはラジアンで i を提出し、教科書の月幾何に対して k・百分率・範囲外エラーを検証できるようにします。

撮影と露出計画

既知の位相角を、ヒストグラム目標・HDR ブラケット・月撮影チェックリスト用の充填割合に変換します。

よくある質問

この計算機は日付や月齢を使いますか？

いいえ。与えられた位相角から k だけを評価します。民事日付からの月相には別の日付起点ツールを使い、割合の式だけが必要ならここへ i を渡してください。

月の位相角とは何ですか？

月の位置で測った、太陽の方向と観測者の方向のなす角です。角度が小さいほどこちらに向いた面が照らされ、大きいほど暗い部分が多くなります。

位相角90度では月のどのくらいが照らされますか？

ちょうど半分で、照らされた割合は0.5、つまり50 %です。月が空で太陽から約90度離れている上弦か下弦の月にあたります。

満月と新月はそれぞれ位相角何度ですか？

位相角0度では面全体が照らされた満月になります。180度では夜側が地球を向き、照らされた部分が見えない新月になります。

角度をラジアンで入れることはできますか？

できます。初めは度で扱いますが、ラジアンに切り替えられます。角度は0度から180度、ラジアンなら0から円周率までの範囲で入れてください。

開発者向け — APIアクセス

このページの機能はすべてAPIからも利用できます。自社システムに組み込みたいチーム向けのセクションです。それ以外の方は上のツールをそのままお使いください。

エンドポイント

POSThttps://api.kit.forhosting.com/astro/moon-illumination-fraction

Bearerトークンで認証し、POST1回でタスクをキューに登録します。結果はWebhookまたは署名付きリンクで受け取れます。

お使いのスタックから呼び出す

curl -X POST https://api.kit.forhosting.com/astro/moon-illumination-fraction \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"phase_angle":90}'

const res = await fetch("https://api.kit.forhosting.com/astro/moon-illumination-fraction", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "phase_angle": 90
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/astro/moon-illumination-fraction",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "phase_angle": 90
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/astro/moon-illumination-fraction", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"phase_angle":90}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"phase_angle":90}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/astro/moon-illumination-fraction", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

リクエスト例

{
  "phase_angle": 90
}

レスポンス例

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "astro.moon_illumination_fraction",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

非同期APIです。task_idは即時に返ります。ポーリングは1秒あたり1リクエストまでです。

料金

1リクエストあたり$0.002

単価はすべて公開しています。トークン換算や独自クレジットはありません。失敗したタスクは課金されません。

エラー

HTTP	コード	意味
`401`	`unauthorized`	APIキーが無効か、指定されていません。Authorizationヘッダーを確認してください。
`402`	`insufficient_balance`	残高が不足しています。チャージ後に再度お試しください。
`404`	`unknown_type`	指定されたタスクタイプは存在しません。タイプ名を確認してください。
`429`	`rate_limited`	リクエストが多すぎます。しばらく待ってから再度お試しください。

技術的な注記

物理的範囲外の角は invalid_input で拒否され、自動化が不可能な幾何を黙ったゼロとして扱わないようにします。

入力契約・単位・範囲検査・応答の形

欠落・空白・非有限の角も失敗します。見かけの明るさが必要なら独自の等級・露出モデルと組み合わせてください。POST で phase_angle（有限数）を含む JSON 本体を送り、任意で unit を deg（既定）または rad に設定します。角フィールドには別名 i、phase、angle、phase_angle_deg が使えます。unit が deg のとき phase_angle は0から180の閉区間、rad のときは0からπの閉区間になければなりません。下限未満または上限超は invalid_input と範囲外条件を示すメッセージで失敗し、課金されません。成功時は phase_angle と phase_angle_deg（度）、phase_angle_rad（ラジアン）、使用 unit、cos_phase_angle、0〜1 の illuminated_fraction k、k の100倍の illuminated_percent、粗い phase_hint（full・gibbous・quarter・crescent・new）、式文字列、代入済み方程式、短いメッセージを返します。例: phase_angle 90 と unit deg は illuminated_fraction 0.5 と illuminated_percent 50 を返し、幾何的な弦に一致します。本エンドポイントは幾何的ディスク割合で止まります。

位相角から照度割合を返す API が役立つ場面

小さな parse API を呼べば、フロント言語ごとに余弦式を再実装する必要がありません。実装は純粋 parse の tier A のため、成功した呼び出しはモデルトークンも外向きネットワークもなく公開の基本料金 $0.002 です。リクエストを小さく保ち、丸めた割合をテストに固定すれば、余弦を評価するだけのために完全な月暦表を立てなくても、教育・メディア・エッジワーカー向けに再現可能なディスク照度が得られます。

技術的な質問

位相角から月の照度割合をどう計算しますか？

phase_angle i を送ります（既定は 0–180°、unit rad なら 0–π）。API は k = (1 + cos i) / 2 を illuminated_fraction と illuminated_percent として返します。

phase_angle の許容範囲は？

unit deg（既定）: 0 から 180 を含む。unit rad: 0 から π を含む。範囲外は invalid_input で失敗し、課金されません。

phase_angle 0°・90°・180° は何を意味しますか？

0° → 満月 (k = 1)；90° → 幾何的な弦 (k = 0.5)；180° → 新月 (k = 0)。中間値は盈凸または三日月の割合になります。

月の照度割合計算機の料金は？

ブラウザツールは無料です。API リクエストは成功1回あたり $0.002 の前払い KIT 残高を使い、無効入力は課金されません。

KITの完全なドキュメントを見る →