ForHosting KIT · البيانات والملفات: تحويل وتنظيف

حساب إحصاءات عمود CSV من المتوسط إلى الانحراف المعياري

حوّلوا عموداً رقمياً في CSV إلى ملخص إحصائي موجز من دون فتح جدول بيانات أو كتابة برنامج مؤقت.

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

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

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

قدّموا نص CSV وحددوا عموداً واحداً

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

افهموا الإحصاءات الخمسة المعادة

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

احموا العمل اللاحق بتحقق صارم

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

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

فحص تصدير للقياسات

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

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

تأكدوا قبل استيراد CSV من وجود عمود رقمي مطلوب ومن احتوائه على قيم قابلة للاستخدام فقط.

وصف نتائج استطلاع

احسبوا النزعة المركزية وتشتت المجتمع لإجابة رقمية من دون صيغ جداول البيانات.

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

أي نوع من الانحراف المعياري يُعاد؟

يُعاد الانحراف المعياري للمجتمع، إذ تُقسم التباينات على العدد الكامل للمشاهدات قبل أخذ الجذر التربيعي.

هل تُهمل الخلايا الفارغة؟

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

هل يمكن أن يستخدم CSV فاصلاً غير الفاصلة العادية؟

نعم. قدّموا أي محدد صالح من محرف واحد، مثل الفاصلة المنقوطة أو علامة الجدولة أو الخط العمودي.

هل تُدعم حقول CSV الواقعة بين علامتي اقتباس؟

نعم. تُحلل المحددات المقتبسة وفواصل الأسطر الداخلية وعلامات الاقتباس المزدوجة المهروبة وفق أعراف CSV.

ما تكلفة طلب API؟

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

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

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

الـEndpoint

POSThttps://api.kit.forhosting.com/data/csv-column-stats

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

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

curl -X POST https://api.kit.forhosting.com/data/csv-column-stats \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"csv":"name,score\nAda,10\nGrace,20\nLinus,30","column":"score"}'

const res = await fetch("https://api.kit.forhosting.com/data/csv-column-stats", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "csv": "name,score\nAda,10\nGrace,20\nLinus,30",
    "column": "score"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/data/csv-column-stats",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "csv": "name,score\nAda,10\nGrace,20\nLinus,30",
    "column": "score"
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/data/csv-column-stats", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"csv":"name,score\\nAda,10\\nGrace,20\\nLinus,30","column":"score"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"csv":"name,score\nAda,10\nGrace,20\nLinus,30","column":"score"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/data/csv-column-stats", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

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

{
  "csv": "name,score\nAda,10\nGrace,20\nLinus,30",
  "column": "score"
}

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

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

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

الأسعار

لكل طلب$0.002

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

الحدود

max_mb 25

الأخطاء

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

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