ForHosting KIT · أدوات المطورين

حاسبة مدى البيانات

تقيس حاسبة مدى البيانات كامل المسافة بين أصغر قيمة وأكبر قيمة في مجموعة بيانات رقمية.

● Betaمجاني · داخل متصفحك

استخدمها من الويبAPIالبريدTelegramالتطبيق قريبًا

أدخلوا مصفوفة أرقام غير فارغة لتحصلوا على العدد والقيمة الصغرى والقيمة العظمى والمدى، حيث يُحسب المدى بطرح الصغرى من العظمى. العملية حتمية، وتحافظ على الأعداد السالبة والعشرية، وترفض المصفوفات الفارغة والقيم التي ليست أعدادًا محدودة. استخدموها لإعداد إحصاء وصفي سريع، أو قاعدة تحقق، أو مكوّن صغير ضمن سير عمل قابل للتكرار لمعالجة البيانات.

ما الذي يكشفه المدى عن مجموعة البيانات

المدى من أبسط مقاييس التشتت الإحصائي. فهو يجيب عن سؤال مباشر: كم تبلغ المسافة بين أصغر مشاهدة وأكبر مشاهدة؟ تفحص الحاسبة كل رقم مُدخل، وتحدد القيمة الصغرى والقيمة العظمى، ثم تطرح الأولى من الثانية. للقيم 4 و7 و12 و15 و19، تكون الصغرى 4 والعظمى 19 والمدى 15. أما مجموعة البيانات التي تحتوي على قيمة واحدة فمداها صفر، لأن الصغرى والعظمى متطابقتان. ولا تحتاج الأعداد السالبة إلى معالجة خاصة؛ فإذا كانت الصغرى -8 والعظمى 3، كان المدى 11. تظل النتيجة غير سالبة دائمًا عند تقديم مدخلات محدودة وصحيحة. يفيد هذا الإحصاء في تكوين فكرة سريعة عن المقياس، لكنه يصف الطرفين فقط. فلا يوضح كيفية توزيع القيم بينهما، ولا ما إذا كانت معظم المشاهدات متقاربة، ولا ما إذا كانت مشاهدة متطرفة قد وسعت النتيجة. اجمعوا بينه وبين الوسيط أو الأرباع أو الانحراف المعياري عندما يكون التوزيع الداخلي مهمًا.

إعداد المصفوفة الرقمية والتحقق منها

أرسلوا المشاهدات في الحقل numbers على هيئة مصفوفة JSON تحتوي على عدد محدود واحد على الأقل. تُقبل الأعداد الصحيحة والعشرية والصفر والقيم السالبة، ولا يؤثر ترتيبها الأصلي في الإجابة. تتعامل الإمكانية عمدًا مع السلاسل التي تبدو رقمية على أنها غير صالحة؛ فقيمة JSON ‏"12" نص، بينما 12 عدد. حوّلوا خلايا جداول البيانات المستوردة أو حقول النماذج قبل الإرسال، حتى لا تؤثر التسميات العارضة أو السلاسل الفارغة أو القيم الخالية أو القياسات المشوهة في الحساب من دون تنبيه. تُرفض أيضًا القيم اللانهائية وNaN لأنها لا تنتج نتيجة JSON محدودة وقابلة للنقل. عند نجاح التحقق، تتضمن الاستجابة العدد والقيمة الصغرى والقيمة العظمى والمدى، مما يجعل مراجعة الحساب سهلة. يوضح الطرفان مصدر الفرق، ويؤكد العدد عدد المشاهدات المفحوصة. إذا كانت المصفوفة فارغة أو احتوت على عنصر غير رقمي، يعيد الطلب خطأ إدخال غير صالح بدلًا من إحصاء جزئي قد يكون مضللًا.

استخدام النتيجة في التحليل والأتمتة

يصلح مدى البيانات مقياسًا موجزًا للفحص الأولي. يمكن لعملية ضبط الجودة مقارنة مدى القياسات المتكررة بحد تفاوت مسموح به، ووضع علامة على دفعة ذات تشتت أوسع من المقبول. ويمكن لتطبيق يراقب أزمنة الاستجابة تتبع الفرق اليومي بين أسرع مشاهدة وأبطئها. كما يستطيع المعلمون والطلاب التحقق من تمارين الإحصاء التمهيدية مع رؤية الطرفين اللذين تقوم عليهما الإجابة. في سير عمل API، احفظوا القيم الصغرى والعظمى والمدى والعدد بجانب الدفعة المصدر حتى يتمكن المراجعون لاحقًا من إعادة إنتاج النتيجة. تذكروا أن المدى شديد الحساسية للقيم الشاذة؛ فقد تهيمن قراءة مستشعر خاطئة واحدة على الإحصاء رغم استقرار جميع القيم الأخرى. إذا لم تكن هذه الحساسية مناسبة، فافحصوا البيانات وأضيفوا مقياسًا يعتمد على الأرباع. تمر الحاسبة على المصفوفة مرة واحدة بصورة حتمية، ولا تستخدم الشبكة أو العشوائية أو الساعة. تبلغ كلفة كل طلب API ‏$0.002 وتطبق عليه قواعد نسخة المتصفح نفسها.

حالات الاستخدام

فحص تشتت القياسات

قارنوا المسافة بين أصغر قراءة وأكبر قراءة بحد تفاوت مسموح به في ضبط الجودة.

تلخيص مجموعة درجات

اعرضوا المدى الملحوظ لدرجات التقييم أو الاستبيان أو المسابقة مع قيمتي طرفيه.

التحقق من البيانات المستوردة

ارفضوا المصفوفات الرقمية الفارغة أو الملوثة قبل أن يستخدم مسار لاحق مداها.

الأسئلة الشائعة

كيف يُحسب مدى البيانات؟

تُطرح أصغر قيمة من أكبر قيمة: المدى = القيمة العظمى - القيمة الصغرى.

هل يمكن أن تحتوي المصفوفة على أعداد سالبة أو عشرية؟

نعم. يُقبل كل عدد JSON محدود، بما في ذلك القيم السالبة والصفر والأعداد الصحيحة والعشرية.

ماذا يحدث عندما تكون المصفوفة فارغة؟

تعيد الإمكانية خطأ إدخال غير صالح، إذ لا يمكن تعريف قيمة صغرى أو عظمى لمجموعة فارغة.

هل تُقبل السلاسل النصية الرقمية؟

لا. القيم مثل "12" نصوص وتُرفض؛ أرسلوا 12 بوصفه عدد JSON بدلًا منها.

ما كلفة طلب API؟

تبلغ كلفة كل طلب API ‏$0.002. ويمكن تنفيذ الحساب الحتمي نفسه في المتصفح أيضًا.

للمطوّرين — الوصول عبر API

كل ما في هذه الصفحة متاح برمجيًا. هذا القسم موجّه للفرق التقنية التي تريد ربط الأداة بأنظمتها الخاصة؛ بقية المستخدمين يمكنهم استخدام الأداة أعلاه مباشرة دون الحاجة لقراءة ما يلي.

الـEndpoint

POSThttps://api.kit.forhosting.com/stat/data-range

صادِق على طلبك بترويسة Bearer، وأرسل طلب POST واحدًا لتدخل مهمتك قائمة التنفيذ فورًا؛ ثم تستلم النتيجة عبر webhook أو رابط موقّع.

استدعِ الخدمة من بيئتك

curl -X POST https://api.kit.forhosting.com/stat/data-range \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"numbers":[12,7,19,4,15]}'

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

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/stat/data-range",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "numbers": [
        12,
        7,
        19,
        4,
        15
    ]
},
)
task_id = res.json()["task_id"]

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

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

مثال على الطلب

{
  "numbers": [
    12,
    7,
    19,
    4,
    15
  ]
}

مثال على الاستجابة

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

الواجهة غير متزامنة: تستلم task_id فور الإرسال، ويمكنك الاستعلام عن الحالة بمعدل طلب واحد في الثانية.

الأسعار

لكل طلب$0.002

السعر معلن كما تراه: لا tokens ولا نظام نقاط؛ وإن فشلت المهمة فلن تُحاسَب عليها.

الأخطاء

HTTP	الرمز	المعنى
`401`	`unauthorized`	مفتاح الوصول مفقود أو غير صالح؛ تحقق من ترويسة Bearer في طلبك.
`402`	`insufficient_balance`	رصيدك لا يكفي لتنفيذ هذه المهمة؛ أعد شحن الرصيد ثم أعد المحاولة.
`404`	`unknown_type`	نوع المهمة المطلوب غير موجود في الكتالوج — راجع الاسم المرسل في الطلب.
`429`	`rate_limited`	تجاوزت الحد المسموح من الطلبات؛ انتظر قليلًا ثم أعد المحاولة.

اطّلع على توثيق KIT الكامل ←