ForHosting KIT · 数学

調和平均計算機

率や速度を正しく平均します。1、2、4の調和平均は12/7で、算術平均より小さくなります。逆数を平均してから、その結果をもう一度逆数に戻すためです。同じ距離を進む区間の速度の平均に向いています。ブラウザで無料で使えます。

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

無料で実行 API仕様を見る

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

計算例

入力した場合

数値: 1, 2, 4

結果

数量: 3
調和平均: 1.7142857143
算術平均: 2.3333333333
逆数和: 1.75

調和平均は、各値の逆数の算術平均の逆数です。厳密に正の数のリストでは、nを各値の逆数の和で割ったものになります。同じ総量の単位あたりで定義される速度・レート・抵抗などをまとめるときに適した平均です。異なる速度の二区間の旅、並列抵抗のオーム、同じ分母が重要になる価格収益型の比率などが典型例です。算術平均と違い、ゼロに近い値が調和平均を大きく押し下げるため、無意味な結果を返す代わりにゼロと負の値は拒否します。この機能は正の有限数の非空リストを受け取り、調和平均に加え件数、比較用の算術平均、逆数和、最小と最大を、サンプリングや乱数やネットワーク副作用のない決定的な純粋parse呼び出しで一度に返します。

調和平均とは何か、いつ使うか

Hを、各観測値の逆数の和でnを割ったものとして書いてください。これは各逆数の算術平均を取り、その平均の逆数を取るのと全く同じです。正の数では調和平均は常に幾何平均以下であり、幾何平均は常に算術平均以下で、すべての値が同一のときだけ等号が成り立ちます。

教室の典型例：一、二、四のリストでは逆数和は一たす二分の一たす四分の一で一点七五となり、Hは三を一点七五で割った十二分の七、およそ一点七一四です。もう一つのきれいな例は二、三、六：逆数は二分の一、三分の一、六分の一で和は一なのでHは三です。

等距離の時速、並列回路の抵抗、同じ作業単位上のバッチ処理量など、共通の総量を共有するレートを平均するときに調和平均を使ってください。生の値の合計がレートより重要なときは算術平均を、乗法的成長には幾何平均を選んでください。実数値の調和平均計算機にゼロや負の値を入れないでください。

ゼロの逆数は未定義で、負の値は通常依拠する順序性を壊します。空リストも拒否されます。何もないものの調和平均は存在しません。

活用例

等距離での平均速度

同じ距離を異なる速度で走る二区間の旅：全体の平均速度は算術平均ではなく調和平均です。

レートと比率のパイプライン

フル統計ライブラリをどこにも載せることなく、サービス内で正のレート・並列抵抗・逆数型指標を要約します。

よくある質問

なぜゼロと負の値が拒否されるのですか？

実数値の調和平均はゼロで未定義（逆数でのゼロ除算）であり、標準的な正のレート用途では負の値に対して定義されません。

調和平均はどのように計算されますか？

H = n / sum(1/xi)：逆数の算術平均の逆数です。

算術平均とどう違いますか？

算術平均はsum/nで、元の尺度ですべての値を等しく扱います。調和平均は小さい正の値により重く重みを置き、共有総量上の多くのレートの正しい平均です。正の値では H ≤ 算術平均です。

通常の平均ではなく調和平均を使うのはどんなときですか？

同じ合計を共有する率を平均するときです。同じ距離の区間ごとの速度、並列につないだ抵抗、同じ作業量あたりの処理量などが当てはまります。値そのものの合計が重要なら算術平均を使います。

調和平均と幾何平均の大小関係は？

正の数では、調和平均は幾何平均以下で、幾何平均は算術平均以下になります。3つが等しくなるのは、すべての値が同じときだけです。

開発者向け — APIアクセス

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

エンドポイント

POSThttps://api.kit.forhosting.com/stat/harmonic-mean

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

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

curl -X POST https://api.kit.forhosting.com/stat/harmonic-mean \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"numbers":[1,2,4]}'

const res = await fetch("https://api.kit.forhosting.com/stat/harmonic-mean", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "numbers": [
      1,
      2,
      4
    ]
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/stat/harmonic-mean",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "numbers": [
        1,
        2,
        4
    ]
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/stat/harmonic-mean", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"numbers":[1,2,4]}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"numbers":[1,2,4]}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/stat/harmonic-mean", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

リクエスト例

{
  "numbers": [
    1,
    2,
    4
  ]
}

レスポンス例

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "stat.harmonic_mean",
  "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`	リクエストが多すぎます。しばらく待ってから再度お試しください。

技術的な注記

APIの呼び方と返却内容

厳密に正の有限数の非空配列です。配列内の数値文字列は強制変換され、カンマや空白区切りの文字列も簡易テキスト形式として受け付けます。宿題チェッカー、金融や運用のレートダッシュボード、逆数量を平均するセンサーパイプライン、統計パッケージを各マシンに入れずに調和平均が必要な任意のワークフローから利用できます。必須フィールドnumbersを含むJSON本体を送ってください。別名values、data、listも同じ動作で受け付けます。成功時の応答にはnとしてのcount、解釈順の入力値としてのnumbers、逆数和でnを割ったharmonic_mean、横並び比較用の通常平均arithmetic_mean、各xiの逆数の中間和としてのreciprocal_sum、標本のminとmaxが含まれます。numbers欠落、空リスト、非有限値、ゼロや負、十万を超えるリストなどの検証失敗はinvalid_inputを返し、課金されません。料金は成功したリクエストごとに定額の$0.002で、単位item・限界単位価格ゼロです。

実務のヒント、制限、関連検索

対話的なWorkerとブラウザ経路が速いままでいられるよう、公開されたサイズ上限内にリストを収めてください。正の数十万件は教室セットと大半の運用標本に十分です。授業では一・二・四と二・三・六を対にして分数と整数の調和平均の両方を見せ、ほぼゼロの正の値を入れるとHがゼロに向かって潰れる様子を示してください。算術平均・中央値・最頻値だけが必要なら姉妹の平均中央値最頻値計算機を使い、このページは正のレート等の調和平均を探す人向けです。極めて小さな正の値でもIEEE浮動小数点ではアンダーフローまで有限の逆数を持ちます。極めて大きな大きさは逆数和の精度を失わせることがあり、結果が有限でない場合ハンドラはinfinityではなくinvalid_inputを返します。invalid_inputを返す失敗タスクは前払い残高を消費しないため、学生が誤ってゼロを打っても探索スクリプトのコストを抑えられます。生の正のリストを一度送り、各クライアントで逆数ループを手書きする代わりに一回の応答からharmonic_meanを読む方がよいです。一つの契約、一つの課金単位、ブラウザとAPIで同一の結果です。

連携の活用例

宿題と試験の解答キー

ゼロと負を明確に拒否する決定的なブラウザまたはAPI結果で、調和平均問題の学生答案を照合します。

技術的な質問

この調和平均計算機は何を返しますか？

正の数の非空リストに対し、count、numbers、harmonic_mean、arithmetic_mean、reciprocal_sum、min、maxを返します。

調和平均計算機は無料ですか？

ブラウザツールは無料でローカル実行です。API呼び出しは成功リクエストごとに$0.002の前払いKIT残高を使用し、失敗タスクは課金されません。

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