大気消光等級計算ツール
消光係数がエアマスあたり0.2等で、エアマス1.5を通して見る星は、地球の大気で0.3等暗くなります。消光係数とエアマスを入力するだけで、大気による消光量が分かります。ブラウザで無料で使えます。
- 無料
- ブラウザで動作
- 登録不要
- データは端末の外に出ません
無料で実行
計算例
- 減光係数
- 0.2
- 大気質量
- 1.5
- 消光等級
- 0.3 mag
- 精度
- 10
この大気消光等級計算ツールは、光が地球大気を通過するときに失われる天文等級を求めます。1 エアマス当たりの等級で表した消光係数と、1 以上の光学的エアマスをご入力ください。標準的な線形近似 A = k × X を適用します。k は消光係数、X はエアマスです。結果として大気消光量 A を等級単位で返すため、観測の見積もり、較正の確認、教材、再現可能なソフトウェアテストにご利用いただけます。
大気消光等級が表すもの
大気消光とは、恒星、惑星、その他の天体から届く光が地球大気を通過する間に弱くなる現象です。等級表現では、正の消光量が大きいほど失われた光が多く、天体は大気圏外で見る場合より暗く見えます。本ツールは一次の関係 A = k × X を使用します。
消光係数 k は 1 エアマス当たりに失われる等級を示し、X は視線方向における大気中の相対的な光路長を示します。単純な平行平面モデルでは、エアマス 1 は通常、天頂付近の天体に対応し、このとき失われる等級は係数と同じです。エアマス 2 なら、モデル上の損失は 2 倍になります。
たとえば、係数が 0.20 等級毎エアマス、エアマスが 1.5 なら、失われる量は 0.30 等級です。この規約で大気圏外の等級を推定する場合は、通常、観測等級から消光量を差し引きますが、本ツールはその別工程の補正までは行いません。
消光係数とエアマスの入力方法
係数は、波長帯、観測地、気象、エアロゾル、その夜の状態によって異なります。そのため、本ツールは既定値を推測せず、場所から自動的に導出することもありません。対象フィルターと観測条件に対して測定された係数、または課題や観測計画で指定された値をご使用ください。
airmass には、1 以上の有限な無次元数をご入力ください。数値文字列のほか、係数の k、エアマスの x という一般的な別名も使用できます。任意の precision は 0 から 15 までで返却値の小数桁数を指定し、既定値は 10 です。
検証後に乗算し、返却時のみ丸めます。
線形消光モデルが役立つ場面
A = k × X は、適切な消光係数がすでにあり、大気による減光を分かりやすく見積もりたい場合に有用です。観測者は、高度の異なる露出を比較したり、較正表が想定どおり補正しているか確認したり、観測記録に大気の寄与を添えたりできます。教員の方は、地平線に近い天体ほど暗くなる理由を示す演習を作り、大規模な測光ソフトウェアに式を隠さず計算を確認できます。
対象範囲は意図的に限定しています。高度や天頂角からエアマスを導出せず、標準星から係数を当てはめず、分子散乱とエアロゾルを分離せず、色項や光束透過率も計算しません。また、地平線付近の曲率や屈折もモデル化しません。
単一の係数を異なるフィルターや変化する天候へ無条件に適用すべきでもありません。この範囲内では、単位エアマス当たりの損失とエアマス数の積という監査可能な結果を返します。
活用例
観測比較を計画する
同じ夜とフィルターに適した係数を使い、異なるエアマスで観測する天体の等級損失を見積もれます。
測光ワークシートを確認する
表計算や実習で、指定の消光係数と記録されたエアマスが正しく乗算されたか確認できます。
決定論的テストデータを作る
単体テスト、観測ログ取込、教育アプリ、天文処理用に安定した大気消光値を生成できます。
よくある質問
どの式を使用しますか？
A = k × X を使います。A は等級単位の大気消光、k は 1 エアマス当たりの損失、X は無次元のエアマスです。
結果は天体の補正済み等級ですか？
いいえ。 等級単位の大気減光量だけを返します。測光補正工程の符号規約に従って適用してください。
観測所の消光係数を求められますか？
いいえ。 観測地、フィルター、条件に合う測定済みまたは採用済みの係数をご用意ください。係数の推定や気象取得は行いません。
エアマスが1以上でなければならないのはなぜですか？
この地上観測の近似では、1が大気を通る最短の経路を表すためです。1未満の値は物理的に誤解を招く結果になるので、計算せずに受け付けません。
エアマスが大きくなるとどれだけ暗くなりますか？
消光量はエアマスに比例して増えます。エアマス1では係数と同じ値、2ではその2倍になり、係数0.2でエアマス1.5なら0.3等の減光です。
関連ツール
開発者向け — APIアクセス
このページの機能はすべてAPIからも利用できます。自社システムに組み込みたいチーム向けのセクションです。それ以外の方は上のツールをそのままお使いください。
エンドポイント
Bearerトークンで認証し、POST1回でタスクをキューに登録します。結果はWebhookまたは署名付きリンクで受け取れます。
お使いのスタックから呼び出す
curl -X POST https://api.kit.forhosting.com/astro/extinction-magnitude \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"extinction_coefficient":0.2,"airmass":1.5}'const res = await fetch("https://api.kit.forhosting.com/astro/extinction-magnitude", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"extinction_coefficient": 0.2,
"airmass": 1.5
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/astro/extinction-magnitude",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"extinction_coefficient": 0.2,
"airmass": 1.5
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/astro/extinction-magnitude", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"extinction_coefficient":0.2,"airmass":1.5}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"extinction_coefficient":0.2,"airmass":1.5}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/astro/extinction-magnitude", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)リクエスト例
{
"extinction_coefficient": 0.2,
"airmass": 1.5
}レスポンス例
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "astro.extinction_magnitude",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}非同期APIです。task_idは即時に返ります。ポーリングは1秒あたり1リクエストまでです。
料金
単価はすべて公開しています。トークン換算や独自クレジットはありません。失敗したタスクは課金されません。
制限
max_extinction_coefficient | 1000 |
max_airmass | 1000 |
エラー
| HTTP | コード | 意味 |
|---|---|---|
401 | unauthorized | APIキーが無効か、指定されていません。Authorizationヘッダーを確認してください。 |
402 | insufficient_balance | 残高が不足しています。チャージ後に再度お試しください。 |
404 | unknown_type | 指定されたタスクタイプは存在しません。タイプ名を確認してください。 |
429 | rate_limited | リクエストが多すぎます。しばらく待ってから再度お試しください。 |
技術的な注記
ブラウザーでの計算は無料で、正常な API リクエスト 1 回の料金は $0.002 です。
大気消光等級が表すもの
返される extinction_magnitude は等級単位の減光量であり、観測された見かけの等級、透過率、天体固有の性質ではありません。
消光係数とエアマスの入力方法
extinction_coefficient には、1 エアマス当たりの等級で表した有限の 0 以上の数値をご入力ください。この下限は重要です。 本ツールが採用する通常の地上観測近似では 1 が対応可能な最短の大気光路を表すため、1 未満は物理的に誤解を招く計算をせず invalid_input として拒否します。ネットワーク、乱数、保存観測、日付依存表を使わないため、同じ有効入力からは常に同じ JSON が得られます。
線形消光モデルが役立つ場面
開発者の方は API を呼び出し、決定論的なテストデータの作成、観測ログ取り込みの検証、型付き処理での表計算再現に利用できます。ブラウザーでは無料、API は正常なリクエスト 1 回 $0.002 でご利用いただけます。
技術的な質問
エアマスが 1 以上でなければならない理由は何ですか？
通常の地上観測モデルでは 1 が対応する最短の大気光路です。1 未満の値は invalid_input として拒否します。
API 計算の料金はいくらですか？
ブラウザーでは無料です。正常な API リクエスト 1 回は $0.002 で、無効な入力は計算せず拒否します。