ForHosting KIT · 教育

クラス内パーセンタイル順位

Q: 同点はパーセンタイル順位を上げますか？

いいえ。 照会に一致する級友は equal に入り below には入りません。排他順位は下回った割合だけです。

Q: 本人の得点を scores に入れるべきですか？

どちらでも妥当です。 名簿にその生徒がいれば n は人数で自己一致は equal に出ます。それ以外なら n は級友数です。計算機は照会点を挿入も削除もしません。

Q: 第kパーセンタイルやミッドランクと同じですか？

違います。 第kパーセンタイルは整列リスト上の切れ目を求めます。ミッドランクは同点に半分を与えます。本用具は厳密に下回った教室の排他割合を報告します。

10人のクラスで85点を取り、5人が下、2人が同点、3人が上なら、パーセンタイル順位は50です。クラスの得点一覧と1人の得点を入れると、下回った割合と同点以下の割合が分かります。ブラウザで無料で使えます。

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

無料で実行 API仕様を見る

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

計算例

入力した場合

得点: 85

結果

N: 10
下: 5
同順位: 2
上: 3

クラス内パーセンタイル順位は、成績簿が必ず突き当たる問いに答えます。この生徒の得点に対し、クラスのどれだけが厳密に低い点だったか。教員・進路・LMS作者・保護者が欲しいのは第kパーセンタイルの切れ目でも言葉の帯でもなく、目の前の名簿から出した順位です。表計算のレシピは排他・包括・ミッドランクで揺れ、比較リストが固定されていないと同じ点でも組ごとに順位が違います。本計算機は照会点と有限のクラス得点列を受け、名簿のうち照会を厳密に下回る件数を数え、クラス人数に対する百分率として返します。通信もモデルも乱数もなく、名簿と得点を渡せば、有効な入力ごとに順位は再現できます。

名簿からクラス内パーセンタイル順位を定義する

クラス内パーセンタイル順位は、データ集合の第kパーセンタイルと同じ統計ではありません。第kパーセンタイルは整列リスト上の選んだ位置にどの点が座るかを答え、クラス順位は逆の教室の問い、つまり名簿に既にある点のうちこの生徒の得点を厳密に下回る割合はいくつか、に答えます。

ここで用いる排他式は PR が B を N で割って百倍したもので、N は送る scores の長さ、B は照会点より厳密に小さい名簿値の件数です。同点は排他順位を膨らませません。照会に一致する級友は equal に入り below には入らないため、十人クラスの唯一の最高点は B が九で順位九十、四人の級友も取った点でも下回った割合だけを報告します。

通知表が包括の相棒を要することがあるからです。同点に半分を与えるミッドランクでも、平均と標準偏差から始める z得点やベルカーブのレターでもありません。名簿に照会生徒を含めるかは利用者が決めます。

その生徒を含む全クラスなら N は人数で自己一致は equal に出ます。それ以外なら N は級友数で、順位は下回った仲間の割合です。どちらも妥当で、計算機は照会点を自ら挿入も削除もしません。

境界は率直です。唯一の最低点は順位ゼロ、名簿のすべてを上回る点は百、一人クラスで点が一致すれば排他順位ゼロかつ以下または同点が百パーセントです。平均の推定も順序統計の補間も、低・平均・高の帯への写像もしません。数え、割り、二つの百分率と below・equal・above の件数を返すので、教員は黒板で算術を示せます。

クラス内パーセンタイル順位が効く場面

教室の成績簿と LMS プラグインは、素点と名簿から 0–100 の順位への文書化された写像を必要とし、印刷通知・保護者ポータル・オフィスアワーの説明が同じ生徒で食い違わないようにします。組を比べる学科長は、各自が個人表で別の同点規則を発明するのではなく、下回った割合という排他の数字を求めます。

学習支援と学修支援の窓口は、八十二点が難しい試験では中央近く、易しい試験では下近くになる理由を家庭に説明します。項目点を既に持つ教育製品は、第二の統計エンジンを積まず名簿を第三者へ上げず、縁でクラス内パーセンタイルを付けられます。

クラス内パーセンタイル順位や得点のパーセンタイルを狙うコンテンツサイトは、同じ解析ライブラリの上で有料自動化とバイト一致する無料ブラウザ経路の恩恵を受けます。検証失敗は残高を消費しません。後で言葉のラベルが要るなら帯分類器と、切れ目が要るなら別の第kパーセンタイル用具と組み合わせてください。

活用例

掲示名簿での成績簿順位

生徒の一点と組の得点列を、通知表と LMS 向けの排他パーセンタイル順位にします。

オフィスアワーと保護者への説明

below・equal・above の件数を示し、ある点を下回った級友が何人かを家庭に見えるようにします。

よくある質問

同点はパーセンタイル順位を上げますか？

いいえ。照会に一致する級友は equal に入り below には入りません。排他順位は下回った割合だけです。

本人の得点を scores に入れるべきですか？

どちらでも妥当です。名簿にその生徒がいれば n は人数で自己一致は equal に出ます。それ以外なら n は級友数です。計算機は照会点を挿入も削除もしません。

第kパーセンタイルやミッドランクと同じですか？

違います。第kパーセンタイルは整列リスト上の切れ目を求めます。ミッドランクは同点に半分を与えます。本用具は厳密に下回った教室の排他割合を報告します。

パーセンタイル順位と同点以下の割合はどう違いますか？

パーセンタイル順位は本人より低い得点だけを数え、もう一方は同点も加えます。例では10人中5人が下なので50、同点の2人を加えると70になります。

クラスの平均や標準偏差は必要ですか？

いいえ。貼り付けた得点一覧から直接順位を求めるので、平均やばらつき、正規分布を仮定しません。zスコアからの推定ではなく、実際のクラスについての答えになります。

開発者向け — APIアクセス

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

エンドポイント

POSThttps://api.kit.forhosting.com/edu/percentile-rank-class

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

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

curl -X POST https://api.kit.forhosting.com/edu/percentile-rank-class \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"score":85,"scores":[62,71,74,78,81,85,85,88,92,97]}'

const res = await fetch("https://api.kit.forhosting.com/edu/percentile-rank-class", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "score": 85,
    "scores": [
      62,
      71,
      74,
      78,
      81,
      85,
      85,
      88,
      92,
      97
    ]
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/edu/percentile-rank-class",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "score": 85,
    "scores": [
        62,
        71,
        74,
        78,
        81,
        85,
        85,
        88,
        92,
        97
    ]
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/edu/percentile-rank-class", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"score":85,"scores":[62,71,74,78,81,85,85,88,92,97]}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"score":85,"scores":[62,71,74,78,81,85,85,88,92,97]}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/edu/percentile-rank-class", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

リクエスト例

{
  "score": 85,
  "scores": [
    62,
    71,
    74,
    78,
    81,
    85,
    85,
    88,
    92,
    97
  ]
}

レスポンス例

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

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

料金

1リクエストあたり$0.002

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

制限

`max_n`	10000
`max_abs`	1000000000000000

エラー

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

技術的な注記

同じ決定的な解析モジュールが無料ブラウザとAPI経路を支えるため、成績簿プラグインとオフィスアワーの確認は食い違いません。

名簿からクラス内パーセンタイル順位を定義する

応答は percent_at_or_below も返し、B 足す E を N で割って百倍したものです。

入力契約・応答欄・検証

各要素は有限小数として読まれ、任意の符号と指数表記は許されます。例：リストにない七十五を五十・六十・七十・八十・九十に当てると below 三、equal 零、above 二、順位六十です。POST で必須欄ふたつの JSON 本体を送ってください。score は名簿と同じ尺度の有限数、scores は空でない有限のクラス点の列です。score は別名 value・mark・raw・x を受けます。scores は class_scores・roster・data・values を受け、フォームが JSON 配列ではなく平文を送るときはカンマまたは空白区切りの数字列も受けます。空トークン・真偽値・オブジェクト・Infinity・NaN は invalid_input で失敗し、悪いセルが黙ってゼロになることはありません。エンジンは名簿点の上限一万件と値ごとの大きさの天井を課し、無料ブラウザ経路と Worker のメモリと遅延を予測可能な予算に収めます。score 欠落、scores 欠落、空リスト、公開長を超えるリストは invalid_input で失敗し、課金されません。成功時は score をエコーし、名簿長の n、三分した below・equal・above、below を n で割って百倍した percentile_rank、below 足す equal を n で割って百倍した percent_at_or_below、観測端の class_min と class_max、method の exclusive_below、短い formula、公開天井 max_n、UI 向け一行の message を返します。例：score 85 を六十二・七十一・七十四・七十八・八十一・八十五・八十五・八十八・九十二・九十七の十点名簿に当てると below 五、equal 二、above 三、percentile_rank 五十、percent_at_or_below 七十です。

クラス内パーセンタイル順位が効く場面

決定的な API ならその会話は同じ件数から始められます。実装は解析ティア A のため、成功した呼び出しは公開の基本料金 $0.002 で、モデルトークンも外向き通信もありません。ペイロードを小さく保ち、試験で percentile_rank を below と n と一緒に固定すれば、成績簿プラグイン・教務スクリプト・保護者報告向けに再現可能な教室順位が得られ、自ら大きな心理測定スタックを立てる必要はありません。

連携の活用例

LMS と教務の自動化

保存名簿へ機械的に安定した percentile_rank を付け、無料ブラウザと同じ排他式を使います。

技術的な質問

クラス内パーセンタイル順位はどう計算しますか。

score とクラスの scores を送ってください。API は得点を厳密に下回る名簿点を数え、n で割って 100 を掛けます。その排他の割合が percentile_rank です。

クラス内パーセンタイル順位の計算機の料金は。

ブラウザ用具は無料です。API 要求は成功した呼び出しごとに前払い KIT 残高から $0.002 です。無効な入力は課金されません。

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

クラス内パーセンタイル順位

無料で実行

計算例

名簿からクラス内パーセンタイル順位を定義する

クラス内パーセンタイル順位が効く場面

活用例

掲示名簿での成績簿順位

オフィスアワーと保護者への説明

よくある質問

関連ツール

開発者向け — APIアクセス

エンドポイント

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

リクエスト例

レスポンス例

料金

制限

エラー

技術的な注記

名簿からクラス内パーセンタイル順位を定義する

入力契約・応答欄・検証

クラス内パーセンタイル順位が効く場面

連携の活用例

LMS と教務の自動化

技術的な質問

ありがとう