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

حاسبة معامل جيني: قياس التفاوت من 0 إلى 1

تحوّل حاسبة معامل جيني قائمة من الدخول أو القيم غير السالبة إلى مقياس شائع للتفاوت.

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

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

تعني النتيجة صفر أن جميع القيم المدخلة متساوية، وكلما اقتربت النتيجة من واحد زاد تركّز المجموع لدى عدد أقل من المشاهدات. الحساب حتمي، ويقبل البيانات غير المرتبة، ويعرض عدد المشاهدات إلى جانب المعامل. لذلك يفيد في المقارنات السريعة والتقارير القابلة لإعادة الإنتاج ومسارات العمل الإحصائية المؤتمتة، من دون الحاجة إلى جدول بيانات أو برنامج مخصص.

فسّروا المعامل ضمن سياقه

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

افهموا طريقة الحساب

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

جهّزوا البيانات وقارنوا النتائج بمسؤولية

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

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

مقارنة توزيعات الدخل

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

مراقبة تركّز العملاء

لخّصوا ما إذا كانت الإيرادات أو قيمة الحسابات موزعة على نطاق واسع أم مركزة لدى عدد قليل من العملاء.

تقييم توازن أعباء العمل

قارنوا أعداد المهام غير السالبة بين الأشخاص أو الآلات أو قوائم الانتظار بمقياس قابل لإعادة الإنتاج.

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

ماذا يعني أن يكون معامل جيني صفرًا؟

يعني أن جميع المشاهدات المدخلة متساوية. وتعيد الحاسبة صفرًا أيضًا عندما تكون كل المشاهدات صفرًا.

هل يجب ترتيب المصفوفة مسبقًا؟

لا. يرتب الحساب نسخة من القيم داخليًا ولا يغيّر المصفوفة المرسلة.

هل يمكن إدراج قيم صفرية؟

نعم. الصفر مشاهدة غير سالبة صالحة وينبغي إدراجه عندما يمثل قيمة مقيسة حقيقية.

لماذا تُرفض القيم السالبة؟

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

هل يُطبق تصحيح خاص بالعينة؟

لا. تعاد قيمة معامل المجتمع القياسية للمصفوفة المدخلة من دون تصحيح للعينة المحدودة.

ما كلفة طلب API؟

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

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

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

الـEndpoint

POSThttps://api.kit.forhosting.com/stat/gini-coefficient

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

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

curl -X POST https://api.kit.forhosting.com/stat/gini-coefficient \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"values":[10,20,30,40]}'

const res = await fetch("https://api.kit.forhosting.com/stat/gini-coefficient", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "values": [
      10,
      20,
      30,
      40
    ]
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/stat/gini-coefficient",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "values": [
        10,
        20,
        30,
        40
    ]
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/stat/gini-coefficient", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"values":[10,20,30,40]}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"values":[10,20,30,40]}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/stat/gini-coefficient", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

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

{
  "values": [
    10,
    20,
    30,
    40
  ]
}

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

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

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

الأسعار

لكل طلب$0.002

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

الحدود

max_items 100000

الأخطاء

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

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