프로젝트 소개

AssaySentinel.jl은 환자 진단이 아니라 측정 품질을 다루는 과학자, 분석법 개발자, 임상 실험실 연구자, 생물통계학자 및 의사를 대상으로 하는 Julia 패키지입니다. 이 패키지가 제시하는 질문은 측정 과정이 변화했는지, 언제, 어느 방향으로, 어떤 불확실성과 함께 변화했는지, 그리고 그 결론을 나중에 재구성할 수 있는지입니다. 범위 및 진입점 - 드리프트 및 변화점: detect_drift, detect_changes, 그리고 어떤 방법이 선택되었는지 이유를 보고하는 :auto 모드가 있습니다. 언급된 탐지기에는 CUSUM, PELT, 베이지안 곱-분할 변화점, Westgard 스타일 QC, 교정 이벤트, 로트/기기 비교가 포함됩니다. - QC: 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 및 PanelReport를 반환하는 analyze(panel); 단위는 분석물 간에 통합되지 않습니다. - 스트리밍: Sentinel, update!, onalert. - 시뮬레이션 및 평가: simulate_assay, evaluate_detector, showcase_dataset. - 출처 추적 및 출력: explain, save, report. 사용법 README는 짧은 워크플로를 보여줍니다: 패키지를 로드하고, showcase_dataset()을 호출하고, 데이터 스트림에 analyze를 실행하고, 결과를 출력하고, explain을 호출하고, HTML 보고서를 작성합니다. Tables.jl 소스는 Assay 정의와 value, time, lot, instrument에 대한 열 매핑을 전달하여 분석할 수 있습니다. 다기관 이력은 analyze(study, Dict(...))를 사용하며 사이트별 차트가 있는 포레스트 플롯을 생성합니다. 패널은 스트림을 AssayPanel에 푸시하고 분석하여 구성합니다. CLI는 bin/assaysentinel 아래에 analyze, study, panel, version 하위 명령과 --json 출력 옵션과 함께 제공됩니다. 재현성 및 출처 추적 README는 각 analyze 호출을 재현 가능(rng 시드와 입력 지문이 결론과 함께 이동), 불확실성 인식(결합 SD, RMS(u), 가중 평균, 크기 표준 오차), 플롯됨(관리도, 재구성 타임라인, 로트/기기 스트립, 출처), 출처 완전(ingest, outliers, change-point, drift, reconstruct, 각각 observed, statistical, algorithmic 또는 annotation으로 태그됨)으로 설명합니다. 나열된 설계 원칙에는 다음이 포함됩니다: 측정은 단순한 숫자가 아니라 시스템이다; 블랙박스 점수보다 설명 가능한 통계를 선호한다; 탐지와 보정은 별개이다; 이상치는 조용히 삭제되지 않고 주석이 달린다; 결측 및 NaN은 절대 0으로 강제 변환되지 않는다; 호환되지 않는 단위는 명시적 변환 없이 절대 비교되지 않는다; 시간적 연관은 인과관계가 아니다; 그리고 모든 결론은 재현 가능해야 한다. 설치 및 의존성 Julia 1.10 이상이 필요합니다. General 레지스트리 등록이 완료될 때까지 설치는 Pkg.add(url=...)을 통해 이루어집니다. 핵심 패키지는 stdlib만 사용하는 것으로 설명되며, Makie, Unitful, Measurements, OnlineStats 및 Turing은 분석, 설명 또는 보고에 절대 필요하지 않은 선택적 확장입니다. 안전 경계 및 라이선스 README는 이 소프트웨어가 연구, 분석 품질 평가, 방법 개발 및 과학적 의사 결정 지원을 위한 것이며, 진단 의료 기기가 아니고, 환자 진단이나 치료를 독립적으로 결정해서는 안 된다고 명시합니다. 심각도 레이블과 Sentinel Score는 임상 위험이 아니라 분석 과정을 설명합니다. 라이선스는 소스 공개 독점으로 설명되며, LICENSE에 따른 평가와 상업적 또는 생산적 사용에는 상업적 라이선스 또는 인수가 필요합니다; 관련 문서에는 COMMERCIAL.md, ACQUISITION.md, LICENSE_TRANSITION_NOTICE.md 및 NOTICE가 포함됩니다. 문서, 통계적 방법, 검증 노트 및 변경 로그는 저장소에서 링크됩니다.