إضافة أداة أو مثال أدب
في هذه الصفحة
يمكن أن تكون المساهمة المفيدة صغيرة: تحديد نموذج منشور أو تحديد رمزه أو تحسين خطوة الإعداد أو الإبلاغ عن فشل في التشغيل. متصفح يكفي لاقتراح مصدر. اتبع ال المعايير المشتركة.
كتالوج السجلات#
المصادر القابلة للتحرير هي tools.csv, papers.csv، و examples.csv..... معرفات هي أسماء الأحرف الصغيرة مستقرة مفصولة الواصلات. تستخدم قوائم الهويات الفاصلة المنقوطة. حافظ على مثال الأداة المعرفات متسقة مع معرفات أداة المثال.
بالنسبة للأداة ، قم بتسجيل الغرض منها ، والمصدر الرسمي والوثائق ، وترخيص شفرة المصدر ، وشروط وقت التشغيل / البيانات / الأصول المنفصلة ، وتوافر المصدر ، والتاريخ الذي تم التحقق منه بالفعل. لا تساوي التنزيل المجاني مع المصدر المفتوح أو تصف توفر المستودع كدليل صيانة أو تنفيذ. تضمين أدوات المشهد وأطر التحسين عندما تكون مفيدة ، مع تحديد دورها بدقة.
كمرجع ، تحقق من العنوان والمؤلفين والسنة ونوع المنشور و DOI مقابل سجل أساسي. تسجيل الوصول إلى النص الكامل والممرات تفقد فعلا بشكل منفصل عن التحقق من البيانات الوصفية. يمكن أن تدعم ورقة البرامج وصف الأداة ؛ يحتاج تجول التطبيق إلى نموذج أو طريقة أو معادلة أو قائمة أو معيار أو تجربة يمكن تحديدها.
على سبيل المثال ، أضف دليلًا يعطي سؤال البحث ، واتصال الورق الدقيق ، وإصدار التعليمات البرمجية / الأرشيف ، والبيئة ، وشروط الإدخال ، والأوامر أو مسار التنفيذ الملموس ، وملفات الإخراج المتوقعة ، ومقاييس المقارنة. اشرح الاختلافات عن الورقة. استخدم حالة واحدة:
| الحالة في CSV | الأدلة المطلوبة |
|---|---|
executed_adaptation |
وشملت رمز التدريس ركض ؛ الاحتفاظ بالمعلمات والبيئة والمخرجات والشيكات الفعلية. هذا لا يؤكد إعادة إنتاج الورق. |
upstream_instructions_checked |
ملفات المصدر وتعليمات تشغيل المنبع فحصها ؛ ولا يزال الإعدام معلقا. |
access_pending |
موقع الاقتباس أو المادة ، ولكن لا يمكن بعد فحص قطعة أثرية مطلوبة. الدولة بالضبط ما هو مفقود. |
استخدم ال run-record قالب من أجل جولة جديدة. الادعاء بأن النتيجة المنشورة قد تم استنساخها يحتاج أيضًا إلى هدف محدد ، وأساليب ومدخلات مطابقة ، ومقارنة وتسامح صريحين ، ومراجعة علمية بشرية. الحفاظ على دراسات جديدة موضوعية في مستودعات البحوث الخاصة بهم.
طرق البحث للكتالوج الكامل#
الـ جرد طريق من الورق إلى الكود خطط بناء السجلات بشكل منفصل عن كتالوج التدريس-المثال المقبول. حرّر research/routes.json الحفاظ على سجل البيانات الوصفية الأولية ، وموقع الورق ، وعلاقة الرمز إلى الورق ، والإصدار غير القابل للتغيير حيثما كان ذلك متاحًا ، والوصول إلى الإدخال ، وأوامر البناء ، وهدف المقارنة ، وأدلة التنفيذ ، والثغرات التي لم تحل.
يحدد مرشح نتيجة الورقة ما يجب إعادة إنتاجه ؛ مثال ورقة البرمجيات أو البرنامج التعليمي ذات الصلة لديه علاقة أضيق للبحث. لا تقم بترقية حالة تنفيذ بدون سجل تشغيل. وتتطابق احتياجات المقارنة بين الأهداف المنشورة مع المدخلات والأساليب، وهي واضحة ويمكن ملاحظتها والتسامح، وتحتفظ بالأدلة العددية. تبقى المراجعة العلمية البشرية منفصلة.
تشغيل python3 simulation-lab/research.py --write قبل تجديد الكتالوج الرئيسي. هذا يتحقق من صحة مسار واحد لكل أداة كتالوج ويولد أدلة المجال الستة وجرد الطريق القابل للتنزيل. وتنتمي البحوث الموضوعية الجديدة إلى مستودع الدراسات؛ هذا المخزون هو التعلم المشترك وتخطيط الاستنساخ.
محاولات المؤلف والرمز والمقارنات العددية#
الـ حملة المرشحين يحتوي على سجل واحد لكل من الأدوات الـ 21 المختارة. حافظ على الإخفاقات الأصلية وإصدارات النشر / المستند وإعدادات الإدخال المتطابقة والمخرجات الأصلية والتجزئة وأي تغييرات في التعليمات البرمجية أو البيئة. تشغيل رمز المؤلف، والحفاظ على تكرار طرف ثالث، والتكيف، وتحليل الأرشيف، ومقارنة ورقة مختارة تمرير لها متطلبات أدلة مختلفة.
أعلن قاعدة الملاحظة والمقارنة قبل إنتاج النتيجة العددية. ولا يزال الاستخراج المنقح أو المقارنة بعد انتهاء المهمة استكشافيا حتى لو تبعته إعادة حتمية. تحتاج الأهداف الورقية إلى مواقع المصدر والدقة المبررة أو عدم اليقين ؛ يجب أن تحتفظ المباراة الحالية أو مباراة الإخراج المؤرشفة بهذا النطاق الأضيق. تحقق من تقارب الحلال وجدواه بشكل منفصل عن حالة خروج العملية. سجل المراجعة العلمية البشرية معلقة حتى يتم تنفيذها فعليًا.
حرّر reproductions/campaign.json وقوالب دليلها الأصلي، ثم تجديد مع python3 simulation-lab/reproduce.py --write..... مشاركة المخرجات القابلة لإعادة الاستخدام بشكل صريح فقط والحفاظ على الأصول لكل ملف ونموذج وشروط وقت التشغيل. استخدام أمثلة ناجحة جديدة executed_author_code أو لهدف عابر مختار مع أدلته، published_target_compared..... استخدام تحليلات المخرجات المحفوظة analysed_saved_output..... لا تؤكد هذه الحالات أبدًا على إعادة إنتاج الورق الكامل أو القبول البشري.
تجديد والتحقق من#
من جذر المحور ، باستخدام Python 3.10 أو أحدث:
python3 simulation-lab/reproduce.py --write
python3 simulation-lab/research.py --write
python3 simulation-lab/catalog.py --write
python3 simulation-lab/catalog.py
يتحقق هذا من المعرفات والمراجع والتواريخ وتنسيقات رابط المصدر وملفات الدليل المحلية ونضارة الملف الذي تم إنشاؤه. لا يتصل بمواقع خارجية أو يتحقق من الادعاءات العلمية. اتبع ال تعليمات بناء الموقع للتحقق من الروابط المقدمة والتخطيط عند تغيير الصفحات.
قم بتقديم طلب سحب مع المصادر التي قمت بفحصها ، والأوامر التي قمت بتشغيلها ، والنتائج ، والقيود المتبقية ، ومساعدة الوكيل المادي ، والإنسان المسؤول. لا تقم بتحميل ملفات PDF للمكتبة ما لم تسمح شروط إعادة التوزيع الخاصة بها بذلك. DOI وموقع مرور دقيق يكفيان للاستشهاد بمقال مقيد ؛ استخدام ال مسار طلب الموارد عندما تكون هناك حاجة إلى الوصول.