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

مؤشر ثايل

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

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

شغّل الأداة مجانًا اطّلع على الـAPI

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

يعتمد عليه الاقتصاديون ومحللو السياسات وصحفيو البيانات لأنه قابل للتفكيك الجمعي إلى مكوّنات داخل المجموعات وبينها—وهو ما لا يقدمه معامل جيني بصورة نظيفة. تقبل هذه القدرة توزيعًا من دخول موجبة تمامًا، وتحسب صيغة ثايل T الكلاسيكية باللوغاريتم الطبيعي، وتُبلغ عن متوسط الدخل ومجموعه، وسقفًا نظريًا ln(n)، ونسبة اختيارية مُطبَّعة T/ln(n). وعندما تقدّمون أيضًا تسميات مجموعات فرعية بنفس الطول، تُرجع قيم ثايل لكل مجموعة مع مساهمات داخل المجموعة وبين المجموعات التي تعيد جمع المؤشر الكلي. يشغّل نفس الوحدة التحليلية الخالصة أداة المتصفح المجانية ومسار API المدفوع مسبقًا، فلا تختلف فحوص الواجبات ودفاتر البحث وأنابيب الإنتاج على حالة حدّية للفاصلة العائمة.

طريقة الاستخدام

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

راجع بياناتك

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

أعد الحساب أو نفّذه آليًا

استخدم أداة الويب للفحوص الفردية، واستخدم الواجهة البرمجية عند دمج الإمكانية نفسها في سير عمل آلي.

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

احصل على النتيجة الآن

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

قارن السيناريوهات

غيّر قيمة واحدة في كل مرة وأعد الحساب لمعرفة ما الذي يؤثر في النتيجة.

أتمت العمل المتكرر

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

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

كيف يُحسب مؤشر ثايل T من الدخول؟

ل n دخول موجبة بمتوسط μ، T = (1/n) · Σ (y_i/μ) · ln(y_i/μ). تعيد API تلك القيمة ك theil_t مع المتوسط والمجموع و max_theil = ln(n) و normalized_theil الاختياري = T/ln(n).

لماذا يجب أن يكون كل دخل موجبًا تمامًا؟

يستخدم ثايل T اللوغاريتم الطبيعي لنسب الدخل. الدخول الصفرية أو السالبة تجعل تلك اللوغاريتمات غير معرّفة، لذلك تفشل المهمة ب invalid_input بدل إرجاع NaN.

كيف يعمل تفكيك المجموعات الفرعية؟

قدّموا مصفوفة groups محاذاة مع incomes. تتضمن الاستجابة within_theil و between_theil وتفاصيل لكل مجموعة. بالبناء يساوي within_theil + between_theil قيمة theil_t الكلية (مع هامش التقريب).

بم يختلف ثايل T عن معامل جيني؟

يلخص جيني منحنى لورنز ولا يُفكك جمعيًا بسهولة عبر المجموعات. ثايل T قائم على الإنتروبيا وأكثر حساسية للأعلى وينقسم بوضوح إلى عدم مساواة داخل المجموعة وبين المجموعات.

كم تكلفة حاسبة مؤشر ثايل؟

أداة المتصفح مجانية. تستخدم طلبات API رصيد KIT المدفوع مسبقًا بسعر $0.002 لكل استدعاء ناجح؛ ولا تُفوتر المدخلات غير الصالحة.

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

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

الـEndpoint

POSThttps://api.kit.forhosting.com/econ/theil-index-distribution

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

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

curl -X POST https://api.kit.forhosting.com/econ/theil-index-distribution \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"incomes":[10,20,30,40]}'

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

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/econ/theil-index-distribution",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "incomes": [
        10,
        20,
        30,
        40
    ]
},
)
task_id = res.json()["task_id"]

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

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

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

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

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

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "econ.theil_index_distribution",
  "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 الكامل ←