وضع الورقة البحثية

حوّل مشروع تعليق توضيحي إلى تقرير مجموعة بيانات بصيغة LaTeX قابل للترجمة بأمر واحد: توزيعات التصنيفات، وإحصاءات الاتفاق مع الاستشهادات الصحيحة، وجداول المعلّقين، والتوقيت، والقيود.

جديد في الإصدار v2.7.0

تنتهي كل ورقة مجموعة بيانات بالطريقة نفسها: إعادة تجميع أعداد المعلّقين وإحصاءات الاتفاق وتوزيعات التصنيفات والتوقيت من ملفات مخرجات متفرقة، ثم تنسيقها يدوياً في LaTeX. أما وضع الورقة البحثية (Paper Mode) فيفعل ذلك بأمر واحد.

bash

python -m potato.paper config.yaml -o paper_export

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

المخرجات تعمل دون اتصال بالكامل. بلا LLM، وبلا خادم، وبلا شبكة.

text

paper_export/
├── paper.tex        # compilable standalone; every section cut-paste-able
├── paper.bib        # citations for every metric used (+ Potato)
├── tables/*.csv     # each table as CSV, for your own styling
└── summary.json     # every computed number, machine-readable

يُترجم paper.tex كما هو، وتقع كل فقرة وكل جدول بين علامتين فاصلتين كي ترفع الأقسام مباشرة إلى مخطوطتك:

latex

%% === BLOCK: paragraph-annotation-methods ===
Annotators spent a median of 42 seconds per item (12.3 person-hours in total).
Inter-annotator agreement for \emph{politeness}, measured by Krippendorff's
$\alpha$ (nominal) \citep{krippendorff2004content} over the 214
multiply-annotated units, was $\alpha = 0.712$ (tentative agreement). ...
%% === END BLOCK: paragraph-annotation-methods ===

ما الذي يولّده

الكتلة	المحتوى
`paragraph-dataset-description`	أعداد العناصر، والمخططات، والتصنيفات، وإجماليات المعلّقين والتصنيفات، جاهزة لقسم البيانات
`paragraph-annotation-methods`	التوقيت، وKrippendorff's α لكل مخطط، ومتوسط Cohen's κ الثنائي، مع الاستشهادات كاملة
`table-distribution-<scheme>`	جدول توزيع تصنيفات بنمط booktabs لكل مخطط، مع الإجماليات
`table-annotators`	العناصر والتصنيفات ووسيط الثواني لكل عنصر لدى كل معلّق
`table-agreement`	α، ومتوسط κ، والتفسير لكل مخطط مقابل عتبتَي Krippendorff عند 0.667 و0.8
`paragraph-limitations`	تحفّظات بأرقام حقيقية: الوحدات ذات التعليق الواحد، والمخططات منخفضة α، وعيّنات المعلّقين الصغيرة

خيارات سطر الأوامر

الراية	الافتراضي	الوصف
`-o, --output-dir`	`paper_export`	مكان كتابة التقرير
`--no-anonymize`	معطّلة	الإبقاء على أسماء المستخدمين الحقيقية؛ افتراضياً يصير المعلّقون A1..An

ملاحظات منهجية

يقرأ وضع الورقة البحثية ملف {output_annotation_dir}/<user>/user_state.json مباشرة، ويحلّه نسبةً إلى ملف التهيئة، فيعمل على المشاريع المؤرشفة دون تشغيل خادم.
تُحسب Krippendorff's α (الاسمية) باستخدام simpledorff، وهو التنفيذ نفسه المستخدم في لوحة تحكم المشرف، على الوحدات ذات تعليقين أو أكثر. وتُحسب Cohen's κ الثنائية لكل زوج معلّقين بينهما عنصران مشتركان أو أكثر.
تحصل المخططات الفئوية (radio، likert، multiselect، select، bws) على توزيعات واتفاق. ويعامل اتفاق multiselect كل خانة (item, label) كوحدة مرمّزة ثنائياً. أما مخططات النطاقات ومربعات النص فتُدرج على أنها غير مشمولة.
يأتي التوقيت من تتبع السلوك، باستخدام total_time_ms مع الرجوع إلى امتدادات الطوابع الزمنية للتفاعل، وتجاهل الفجوات التي تتجاوز ساعة.

قراءات إضافية

توثيق مجموعات بيانات التعليق التوضيحي
اتفاق المُعلّقين
لوحة تحكم المشرف — النظائر الحية لهذه الأرقام
الوثائق المصدرية