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

مؤشر شانون للتنوع

مؤشر تنوع شانون، ويُسمى أيضاً مؤشر شانون–وينر أو شانون–ويفر، يقيس مدى اختلاط جماعة حيوية انطلاقاً من أعداد أفراد كل نوع.

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

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

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

ليس قائمة أنواع ولا مجرد عدّ للغنى: قد تؤوي قطعتان العدد نفسه من الأصناف ومع ذلك تختلفان لأن إحداهما تهيمن عليها نوع واحد وفير بينما توزّع الأخرى الأفراد بمزيد من التساوي. تأخذ هذه الحاسبة قائمة أعداد أفراد غير سالبة، وتحوّل كل عدد إلى وفرة نسبية p_i تساوي n_i على N، ثم تُرجع H شرطة مساوياً لسالب مجموع p_i مضروباً في اللوغاريتم الطبيعي لـ p_i. الأعداد الصفرية لا تساهم بشيء، لأن نهاية p مضروباً في ln p عندما يقترب p من الصفر هي صفر. العدد السالب ليس جماعة، والمجموع الصفري يترك كل نسبة غير معرّفة، لذا تفشل تلك الحالات بـ invalid_input بدلاً من إرجاع NaN. الدالة النقية نفسها تغذّي ودجت المتصفح المجاني وواجهة API بسعر $0.002 لكل طلب ناجح.

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

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

راجع بياناتك

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

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

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

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

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

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

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

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

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

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

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

ما مؤشر تنوع شانون؟

H′ = −Σ p_i ln(p_i)، حيث p_i هي الوفرة النسبية n_i / N لكل نوع. يُبلَّغ هنا بوحدة nats (اللوغاريتم الطبيعي). ارتفاع H′ يعني جماعة أكثر اختلاطاً.

لماذا تُرفض الأعداد السالبة والمجموع الصفري؟

الجماعة السالبة ليست عينة. عندما تكون كل الأعداد صفراً يكون N صفراً وكل p_i غير معرّفة، فلا يمكن حساب المؤشر. الحالتان تفشلان بـ invalid_input.

هل تغيّر الأعداد الصفرية المؤشر؟

لا. وفرة صفرية لا تساهم لأن نهاية p ln p عندما يقترب p من الصفر هي صفر. الأصفار لا تزيد الغنى أيضاً، إذ يُعدّ الغنى المدخلات الموجبة قطعاً فقط.

ما العدالة في الاستجابة؟

عدالة بيلو J′ = H′ / ln(S)، المؤشر مقسوماً على أقصى H′ ممكن لذلك الغنى. نوع مشغول واحد يُعامل على أنه متساوٍ تماماً، فالعدالة 1.

كم تبلغ التكلفة؟

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

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

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

الـEndpoint

POSThttps://api.kit.forhosting.com/eco/shannon-index

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

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

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

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

import os, requests

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

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

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

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

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

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

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

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

الأسعار

لكل طلب$0.002

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

الحدود

max_items 10000

الأخطاء

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

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