条件数計算機
条件数APIは正方行列を受け取り、その2ノルム条件数、すなわち行列の最大特異値と最小特異値の比を返します。この一つの数値が、丸め誤差・測定ノイズ・打ち切られた係数といったデータの小さな誤差が、線形方程式系を解いたり行列を逆転したりする際にどれだけ増幅されうるかを示します。条件数が1に近ければ問題は安定しており、大きければ解がノイズに支配される可能性があるという警告です。計算は一つの決定論的なパスで実行されます。行列が検証され、Aの転置×Aが構成され、その固有値が古典的なヤコビ反復で求められ、その平方根が特異値となります。
無料で実行
条件数が実際に測るもの
Ax = b という方程式系を数値的に解くとき、厳密な A と b で作業することはほとんどありません。係数は測定値や以前の計算結果、あるいは途中で丸められた10進入力から得られます。条件数とは、その不確かさの最悪ケースの増幅率です。入力が相対量イプシロンだけ変化すれば、解は最大でカッパ倍のイプシロンまで変化しえます。カッパ = 10 なら、データの1%の誤差が答えに10%の誤差を生じさせえます。カッパ = 1,000,000 なら、倍精度が保持できる約16桁の10進数字のうち6桁を失いかねません。ここで計算する2ノルム条件数カッパ_2は、A の特異値によって定義されます。最大特異値シグマ_maxは行列がベクトルを最大どれだけ伸ばせるかを、最小特異値シグマ_minは最大どれだけ縮められるかを測り、その比がカッパ_2です。回転のような直交行列のカッパ_2はちょうど1で、これが最良の値です。線形従属な行を持つ行列はシグマ_min = 0 でカッパ_2は無限大となります。だからこそこの機能は、意味のない巨大な数を表示する代わりに、特異行列を拒否するのです。
ここでの数値の計算方法
アルゴリズムは決定論的かつ自己完結的で、外部の数値計算ライブラリは使いません。まず入力が正規化されます。係数は行の配列として、または改行やセミコロンで行を区切り、カンマやスペースで値を区切ったテキストとして送信できます。各係数は有限の数値でなければならず、すべての行は同じ長さで、行列は正方でなければなりません。2×3の行列にはこの意味での条件数がないため、そのリクエストは原因となったフィールド名を示す明確なエラーで拒否されます。次にコードは対称行列 G = A^T A を構成し、古典的な巡回ヤコビ反復でその固有値を取り出します。これは固定された順序の平面回転が非対角成分を一つずつゼロにし、行列が作業精度で対角になるまで続くものです。回転の順序、符号の規約、スイープの上限がすべて固定されているため、同じ行列は常にビット単位で同じ答えを返します。G の固有値は A の特異値の二乗なので、その平方根がシグマ_maxとシグマ_minを与え、安定した出力のために小数点以下12桁に丸められた比が、返される条件数です。最小特異値がスケーリングされた数値的床(およそカッパ_2が100億以上)を下回る行列は、倍精度では階数欠損行列と正直に区別できないため、数値的に特異として報告されます。
結果の読み方と上手な活用法
応答は四つのものを提供します。条件数そのもの、シグマ_max、シグマ_min、そして行列を分類する平易なメッセージです。およそ10未満のカッパは良条件と見なしてください。直接ソルバーは安定に動作します。100から100万の間では、目に見える精度低下を見込み、安定なアルゴリズム、例えばQR分解や部分ピボット付きLUを選んでください。明示的な逆行列の構成は、それを供給する計算の誤差を二乗してしまいます。100万を超える場合の正直な読み方は、答えがソルバーよりもデータのノイズに左右されるということであり、正しい対処は通常、問題の再スケーリング、正則化、あるいはモデルの行列が適切かどうかの再検討です。実践的な習慣が二つ役に立ちます。悪い答えについてソルバーを責める前に条件数を確認すること。悪条件の行列は正しいコードから誤った答えを生みます。そして定式化の間で条件数を比較すること。同じ物理問題でも、別の単位や基底関数で書けばカッパは桁違いに変わりえます。ここで動くのと同じコードがこのページ上のお客様のブラウザで無料で実行されますので、自動化のために1リクエスト $0.002 をお支払いいただく前に、行列を貼り付けて結果をご確認いただけます。
活用例
線形方程式系を解く前のチェック
測定された係数に対してLUやQRで求解する前に、解の何桁が信頼できるかを見積もります。
収束しない回帰の診断
ほぼ共線なデザイン行列は、ソルバーが失敗するはるか前に、Xの転置×Xの巨大な条件数として現れます。
同じ問題の離散化の比較
同じ物理モデルの二つの有限要素または基底関数による定式化は、条件性が桁違いに異なることがあります。安定な方を選んでください。
よくある質問
料金はいくらですか?
1リクエスト $0.002 です。このページのお客様のブラウザでも無料で実行できます。
なぜ私の行列は特異として拒否されたのですか?
最小特異値が数値的にゼロであり、条件数が無限大になるためです。倍精度で階数欠損となる(カッパがおよそ100億を超える)技術的には可逆な行列も含まれます。
なぜ行列は正方でなければならないのですか?
2ノルム条件数カッパ_2 = シグマ_max / シグマ_minは、正方の係数行列の特異値によって定義されるためです。長方形の最小二乗問題では、代わりに正方行列であるXの転置×Xの条件数を評価してください。
行列はどのように送信できますか?
同じ長さの数値行の配列として、または改行やセミコロンで行を区切り、カンマやスペースで係数を区切ったテキストとして送信できます。どちらの形式でも同じ結果になります。
どのくらいの大きさの行列に対応していますか?
最大32×32で、係数の絶対値は1e12までです。計算は決定論的なヤコビ反復による倍精度の厳密な算術です。
結果は再現可能ですか?
はい。ヤコビ反復は固定された回転順序、符号規約、スイープ上限を用いるため、同じ入力は常に同じ、小数点以下12桁に丸められた出力を生成します。
開発者向け — APIアクセス
このページの機能はすべてAPIからも利用できます。自社システムに組み込みたいチーム向けのセクションです。それ以外の方は上のツールをそのままお使いください。
エンドポイント
Bearerトークンで認証し、POST1回でタスクをキューに登録します。結果はWebhookまたは署名付きリンクで受け取れます。
お使いのスタックから呼び出す
curl -X POST https://api.kit.forhosting.com/math/condition-number \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"matrix":[[2,1],[1,2]]}'const res = await fetch("https://api.kit.forhosting.com/math/condition-number", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"matrix": [
[
2,
1
],
[
1,
2
]
]
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/math/condition-number",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"matrix": [
[
2,
1
],
[
1,
2
]
]
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/math/condition-number", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"matrix":[[2,1],[1,2]]}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"matrix":[[2,1],[1,2]]}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/math/condition-number", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)リクエスト例
{
"matrix": [
[
2,
1
],
[
1,
2
]
]
}レスポンス例
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "math.condition_number",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}非同期APIです。task_idは即時に返ります。ポーリングは1秒あたり1リクエストまでです。
料金
単価はすべて公開しています。トークン換算や独自クレジットはありません。失敗したタスクは課金されません。
制限
max_rows | 32 |
max_cols | 32 |
max_abs | 1000000000000 |
エラー
| HTTP | コード | 意味 |
|---|---|---|
401 | unauthorized | APIキーが無効か、指定されていません。Authorizationヘッダーを確認してください。 |
402 | insufficient_balance | 残高が不足しています。チャージ後に再度お試しください。 |
404 | unknown_type | 指定されたタスクタイプは存在しません。タイプ名を確認してください。 |
429 | rate_limited | リクエストが多すぎます。しばらく待ってから再度お試しください。 |