عن المشروع

AssaySentinel.jl هي حزمة جوليا موجهة إلى العلماء ومطوري المقايسات والباحثين في المختبرات السريرية والإحصائيين الحيويين والأطباء الذين يعملون على جودة القياس بدلاً من تشخيص المرضى. والسؤال المعلن الذي تطرحه هو ما إذا كانت عملية القياس قد تغيرت، ومتى، وفي أي اتجاه، وبأي قدر من عدم اليقين، وما إذا كان يمكن إعادة بناء هذا الاستنتاج لاحقاً. النطاق ونقاط الدخول - الانحراف ونقاط التغير: detect_drift وdetect_changes، مع وضع :auto يوضح سبب اختيار الطريقة. تشمل الكواشف المذكورة CUSUM وPELT ونقاط التغير البايزية بتجزئة المنتج، وضبط الجودة بنمط Westgard، وأحداث المعايرة، ومقارنات الدفعات/الأجهزة. - ضبط الجودة: monitor وwestgard_rules وماكرو @qcrule وبيانات مخطط التحكم Levey-Jennings. - المعايرة: calibrate وcompare_calibrations. - الدفعات: detect_batch_effects وتصحيح اختياري عبر correct_batch_effects. - المقارنات: compare_methods وcompare_instruments وcompare_lots وcompare_sites. - الحدود المرجعية: reference_interval وassess_partitions وreference_curve. - الدراسات متعددة المواقع: hierarchical_sites وanalyze(study, streams) وStudySentinel، مع تسميات المشاركة (:global و:site_specific و:mixed و:stable) ومقياس I-squared الذي يصف التوافق الإحصائي بين المواقع. - لوحات متعددة المحاليل: AssayPanel وanalyze(panel) التي تعيد PanelReport؛ ولا يتم تجميع الوحدات عبر المحاليل المختلفة. - البث: Sentinel وupdate! وonalert. - المحاكاة والتقييم: simulate_assay وevaluate_detector وshowcase_dataset. - المصدر والتوثيق: explain وsave وreport. الاستخدام يعرض ملف README سير عمل قصيراً: تحميل الحزمة، واستدعاء showcase_dataset()، وتشغيل analyze على تدفق البيانات، وطباعة النتيجة، واستدعاء explain، وكتابة تقرير HTML. ويمكن تحليل مصدر Tables.jl عبر تمرير تعريف Assay مع تعيينات الأعمدة للقيمة والوقت والدفعة والجهاز. وتستخدم السجلات متعددة المواقع analyze(study, Dict(...)) وتنتج مخططاً غابوياً مع رسوم بيانية لكل موقع. وتُبنى اللوحات بدفع التدفقات إلى AssayPanel ثم تحليلها. تتوفر واجهة سطر أوامر تحت bin/assaysentinel مع أوامر فرعية analyze وstudy وpanel وversion، إضافة إلى خيار إخراج --json. قابلية التكرار والمصدر يصف ملف README كل استدعاء analyze بأنه قابل للتكرار (بذرة rng وبصمة المدخلات ترافق الاستنتاج)، ويراعي عدم اليقين (الانحراف المعياري المدمج، RMS(u)، المتوسط الموزون، الخطأ المعياري للمقدار)، ومرسوم (مخطط التحكم، الجدول الزمني لإعادة البناء، شرائط الدفعة/الجهاز، المصدر)، ومكتمل المصدر (الاستيعاب، القيم الشاذة، نقطة التغير، الانحراف، إعادة البناء، وكل منها موسوم بأنه ملاحظ أو إحصائي أو خوارزمي أو تعليقي). تشمل مبادئ التصميم المذكورة: القياسات أنظمة وليست أرقاماً مجردة؛ تفضيل الإحصاءات القابلة للتفسير على الدرجات الصندوقية السوداء؛ الفصل بين الكشف والتصحيح؛ وسم القيم الشاذة بدلاً من حذفها بصمت؛ عدم تحويل القيم المفقودة وNaN إلى صفر أبداً؛ عدم مقارنة الوحدات غير المتوافقة دون تحويل صريح؛ الارتباط الزمني ليس سببية؛ وينبغي أن يكون كل استنتاج قابلاً للتكرار. التثبيت والاعتماديات يتطلب Julia 1.10 أو أحدث. وإلى أن يكتمل التسجيل في السجل العام، يتم التثبيت عبر Pkg.add(url=...). وتوصف الحزمة الأساسية بأنها تعتمد على المكتبة القياسية فقط، مع Makie وUnitful وMeasurements وOnlineStats وTuring كملحقات اختيارية لا تُطلب أبداً للتحليل أو الشرح أو إعداد التقارير. حدود السلامة والترخيص يذكر ملف README أن البرنامج مخصص للبحث وتقييم الجودة التحليلية وتطوير الطرق ودعم القرار العلمي، وليس جهازاً طبياً تشخيصياً، ويجب ألا يحدد بشكل مستقل تشخيص المريض أو علاجه. وتصف تسميات الشدة وSentinel Score العملية التحليلية وليس المخاطر السريرية. ويوصف الترخيص بأنه ملكي متاح المصدر، مع التقييم بموجب LICENSE، ويتطلب الاستخدام التجاري أو الإنتاجي ترخيصاً تجارياً أو استحواذاً؛ وتشمل المستندات ذات الصلة COMMERCIAL.md وACQUISITION.md وLICENSE_TRANSITION_NOTICE.md وNOTICE. وتُربط من المستودع الوثائق والأساليب الإحصائية وملاحظات التحقق وسجل التغييرات.