ForHosting KIT · 開発者向けツール

パーセンタイルからスタナインを計算

この計算ツールは、教育検査や心理検査の報告で広く使われる9段階の標準尺度に、パーセンタイル順位を変換します。1～99の有限な値を入力すると、小数を含む場合でも、スタナイン、対応するパーセンタイル区間、分かりやすい評価が得られます。固定された標準境界を使用するため、計算は決定的で検証も容易です。報告書にはパーセンタイルが記載されている一方、比較表、要約、学校記録ではスタナインが必要な場合に役立ちます。

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

無料で実行 API仕様を見る

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

スタナインから分かるパーセンタイル順位

スタナインは、パーセンタイル順位を9つの大まかな区分のいずれかにまとめる尺度です。名称は「標準」と「9」を組み合わせたもので、分布を見やすく比較しやすくする目的があります。スタナイン1はパーセンタイル1～3、スタナイン9は96～99に対応します。中央のスタナイン5は40～59です。中央区分は両端の区分より広いため、小さなパーセンタイル差を過大評価せずに、釣鐘型分布のおおよその姿を保てます。この計算ツールは、スタナイン番号、実際に適用した標準パーセンタイル区間、「平均」や「平均より高い」などの短い評価を返します。スタナインは報告用のカテゴリーであり、新しい検査得点でも正答率でもありません。元の検査で用いられた規準集団内の相対的位置を表します。したがって、変換結果を解釈する際にも、その規準集団の品質と対象者への適合性が重要です。

9つの標準区分を適用する方法

変換では標準的な境界をそのまま使用します。パーセンタイル1–3はスタナイン1、4–10は2、11–22は3、23–39は4、40–59は5、60–76は6、77–88は7、89–95は8、96–99は9です。それぞれの上限値を区分に含めます。たとえば、39はスタナイン4、40はスタナイン5になります。小数のパーセンタイル順位も同じ境界と直接比較します。そのため、39.5は39より大きく59以下なのでスタナイン5です。分類前に入力値を丸めることはありません。1未満、99を超える値、未入力、数値以外の値は、意図を推測せず無効として扱います。固定区分を直接参照するため、同じ有効な入力からは必ず同じ結果が得られます。標本データ、受検者情報、ネットワーク通信、無作為処理、日付、端末の地域設定によって変換結果が変わることはありません。

検査報告で結果を適切に利用する方法

完全なパーセンタイル順位より、簡潔なカテゴリー要約が適している場面でスタナインをご利用ください。ダッシュボード、累積指導要録、選考資料の要約、互換性のある規準化方法を用いる下位検査間の比較に向いています。スタナインへの変換では意図的に細かな情報が失われるため、可能であれば元のパーセンタイルも保存してください。パーセンタイル41と58は正確な相対的位置が異なりますが、どちらもスタナイン5です。一方、境界の両側にある近い値が別のスタナインになることもあります。無関係な検査、異なる年齢層、互換性のない規準集団の結果を結合する目的には使用しないでください。このツールは、信頼性、信頼区間、標準誤差、妥当性、検査会社独自の境界を評価しません。所属機関が独自方式を指定している場合は検査マニュアルをご確認ください。自動処理ではpercentileフィールドを送信し、stanineとpercentile_rangeの両方を保存します。API処理は1回につき$0.002で、固定区分による結果は別途検証できます。

活用例

学校用の得点要約を作成する

報告されたパーセンタイルを簡潔なスタナインに変換し、返された元の区間も生徒記録に保存できます。

評価ダッシュボードを統一する

互換性のある規準に基づく複数の検査を、共通の1～9カテゴリーで表示できます。

境界付近の分類を確認する

標準的な境界値またはその近くのパーセンタイルが、下側と上側のどちらの区分になるか確認できます。

よくある質問

各スタナインに対応するパーセンタイルは何ですか？

スタナイン1～9の標準区分は、それぞれ1–3、4–10、11–22、23–39、40–59、60–76、77–88、89–95、96–99です。

区分の境界値は範囲に含まれますか？

はい。各上限値はその区分に含まれます。たとえば、パーセンタイル39はスタナイン4、40はスタナイン5です。

小数のパーセンタイル順位を入力できますか？

はい。1～99の有限な小数を入力でき、事前に丸めず、その値のまま区分を判定します。

スタナインは正答率と同じですか？

いいえ。規準に基づくパーセンタイルから得られる大まかな相対的位置であり、正解した問題の割合ではありません。

すべての検査が同じ境界を使いますか？

ここでは標準的な9区分を使用します。検査マニュアルに独自の報告方法が定められている場合は、発行元の規定をご確認ください。

開発者向け — APIアクセス

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

エンドポイント

POSThttps://api.kit.forhosting.com/edu/stanine-from-percentile

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

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

curl -X POST https://api.kit.forhosting.com/edu/stanine-from-percentile \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"percentile":72}'

const res = await fetch("https://api.kit.forhosting.com/edu/stanine-from-percentile", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "percentile": 72
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/edu/stanine-from-percentile",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "percentile": 72
},
)
task_id = res.json()["task_id"]

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

body := bytes.NewBufferString(`{"percentile":72}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/edu/stanine-from-percentile", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

リクエスト例

{
  "percentile": 72
}

レスポンス例

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "edu.stanine_from_percentile",
  "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の完全なドキュメントを見る →