ForHosting KIT · 開発者向けツール

平均点との差を割合と標準偏差で計算

得点は、クラス全体の成績と比べるまで、非常に良くも悪くも見えることがあります。この計算機は、その比較を補完的な2つの方法で明確にします。得点からクラス平均を引いて符号付きのパーセントポイント差を求め、さらにその差をクラスの標準偏差で割って z-score を算出します。結果は、得点が平均より上か下か、または平均と同じかを示します。元の採点尺度を変えずに、学習者、教員、指導者、分析担当者が簡潔に解釈できます。

● Beta無料・ブラウザ内で実行

無料で実行 API仕様を見る

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

同じ採点尺度の割合をご入力ください

個人の得点、クラス平均、クラスの標準偏差を、いずれも 0 から 100 の割合尺度でご入力ください。得点と平均は、同じ試験と同じ集団のものでなければなりません。難易度を意図的に等化した試験でない限り、ある試験の得点を別の試験の平均と比較しないでください。標準偏差は、平均に対する割合や分散ではなく、パーセントポイントで指定します。通常、得点が平均から8ポイントほど離れる場合は 8 と入力します。standard_deviation、std、sd のいずれか1つを使用できます。すべて有限値である必要があり、標準偏差はゼロより大きくなければなりません。たとえば、得点 86、平均 74、標準偏差 8 は、すべて同じ 0–100 尺度上の値です。

ポイント差と z-score を合わせてお読みください

符号付きの差は、得点から平均を引いた値です。12 なら平均より12パーセントポイント上、−6 なら6ポイント下を意味します。これは採点尺度上の絶対差であり、相対的な増加率ではありません。z-score は、この差を標準偏差で割ります。差が 12、標準偏差が 8 なら結果は 1.5 で、平均より1.5標準偏差上です。負の値は平均より下、ゼロは完全な一致を示します。出力には絶対距離と方向も含まれます。元の得点差を説明する際はパーセントポイントを、散らばりが異なる試験間で相対的位置を比べる際は z-score をご利用ください。どちらの値も、それだけで合否や到達基準を決めるものではありません。

比較結果を慎重に解釈してください

標準偏差による距離は分布内の位置を表しますが、自動的にパーセンタイルを示すものではありません。z-score をパーセンタイルへ変換するには、通常は正規分布などの分布モデルを仮定する必要がありますが、この計算機はその仮定を行いません。実際の得点は偏っていたり、上限付近に集中したり、少人数のクラスに基づいたりします。ご提供いただいた統計量による記述的な比較としてお扱いください。散らばりが5のクラスと15のクラスでは、同じ10ポイント差の珍しさが異なることも説明できます。また、「平均より何ポイント上」と「何パーセント良い」の混同も防げます。自動レポート用 JSON には、入力、差、方向、z-score、絶対距離、要約が含まれます。ブラウザーは無料で、API の成功した各項目は $0.002 です。

活用例

試験結果をご説明する

平均との差と、その差がクラスの散らばりに対してどの程度珍しいかを学習者へ示します。

クラス間の位置をご比較する

平均やばらつきが異なる評価を、標準偏差の距離とパーセントポイントで比較します。

一貫した成績報告を作成する

自動進捗レポートに方向、符号付き差、z-score、分かりやすい要約を追加します。

よくある質問

パーセントポイント差とは何ですか？

得点からクラス平均を引いた値です。得点 82、平均 75 なら7ポイントであり、相対的に7パーセント増えたという意味ではありません。

標準偏差による距離はどのように計算しますか？

符号付きのポイント差を指定された標準偏差で割ります：z = (score − mean) / standard deviation。

z-score はパーセンタイルと同じですか？

いいえ。パーセンタイルへの変換には分布の仮定が必要です。ここでは観測された距離のみを示します。

標準偏差をゼロにできないのはなぜですか？

ゼロは散らばりがない状態です。ゼロ除算は定義できないため、入力は無効となります。

API リクエストの料金はいくらですか？

成功した API 項目ごとに $0.002 です。同じ決定論的計算をブラウザーでは無料でご利用いただけます。

開発者向け — APIアクセス

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

エンドポイント

POSThttps://api.kit.forhosting.com/edu/percent-above-mean

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

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

curl -X POST https://api.kit.forhosting.com/edu/percent-above-mean \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"score":86,"mean":74,"standard_deviation":8}'

const res = await fetch("https://api.kit.forhosting.com/edu/percent-above-mean", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "score": 86,
    "mean": 74,
    "standard_deviation": 8
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/edu/percent-above-mean",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "score": 86,
    "mean": 74,
    "standard_deviation": 8
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/edu/percent-above-mean", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"score":86,"mean":74,"standard_deviation":8}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"score":86,"mean":74,"standard_deviation":8}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/edu/percent-above-mean", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

リクエスト例

{
  "score": 86,
  "mean": 74,
  "standard_deviation": 8
}

レスポンス例

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

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