Pomiar potrzebuje ścieżki do swojego źródła
Liczba w LIMS jest użyteczna tylko wtedy, gdy laboratorium potrafi wskazać zapis aparatury, który ją wytworzył. Źródłem może być plik tekstowy, arkusz, XML, eksport bazy, obraz, widmo, format binarny lub zestaw artefaktów. Po odłączeniu wartości od źródła późniejszy przegląd opiera się na założeniach.
Integracja aparatury jest więc procesem obsługi dowodów: przyjmuje artefakt, rozpoznaje format, wybiera metodę interpretacji, wyodrębnia rekordy, waliduje je, normalizuje zatwierdzone pola i łączy z kontekstem naukowym. Każdy krok może zawieść w inny sposób i powinien pozostawić widoczny stan. Wskazówki FDA, MHRA, OECD i WHO dotyczące integralności danych w regulowanych środowiskach różnią się zakresem, ale łączy je praktyczna lekcja: ścieżka danych i traktowanie pierwotnych dowodów nie mogą być dodatkiem na końcu.
Zachowaj artefakt przed jego interpretacją
Usługa importu powinna zarchiwizować otrzymany artefakt przed parsowaniem. Zapisz oryginalną nazwę, ścieżkę źródłową lub kanał transferu, rozmiar, czas odbioru, dostępną tożsamość aparatury lub stanowiska oraz użytkownika albo usługę inicjującą transfer. Ogranicz modyfikację i usuwanie zgodnie z retencją oraz zasadami dostępu laboratorium.
Wylicz hash kryptograficzny przechowywanych bajtów. Funkcje hash NIST opisują rodzinę SHA do tworzenia skrótów o stałej długości. Hash pokazuje, czy później przedstawiona sekwencja bajtów jest tą samą, ale nie dowodzi poprawnego przypisania próbki, stanu aparatury ani poprawności interpretacji parsera. Dla eksportów wieloplikowych zachowaj cały zestaw i strukturę oraz manifest z hashami. Niezmienność oznacza zachowanie dowodu pierwotnego, podczas gdy korekty tworzą nowe rekordy, mapowania, uruchomienia parsera lub poprawki.
Wykrywanie formatu i wybór parsera wymagają zapisanych decyzji
Rozszerzenie pliku jest wskazówką, a nie dowodem. Detektor może badać nagłówki, magic bytes, identyfikatory schematu, metadane aparatury, oczekiwane pliki, separatory, kodowania, nazwy arkuszy i wersje wewnętrzne. Powinien zwracać dowody wyboru oraz stan pewności lub niejednoznaczności, na który aplikacja może zareagować.
Gdy pasuje kilka formatów, umieść artefakt w kwarantannie. Parser, który przypadkiem kończy pracę sukcesem, może zwrócić wiarygodnie wyglądające wartości z błędną mapą kolumn, jednostką, ustawieniem regionalnym lub wersją oprogramowania. Zapisuj dokładną wersję parsera i konfigurację, build, sygnaturę formatu, reguły mapowania, konwersje jednostek oraz profil aparatury. Diagnostyka musi też wyjaśniać sukces częściowy, brakujące pola, pominięte rekordy, błędne wiersze, kodowania, duplikaty, nieobsługiwane jednostki i utratę precyzji.
Każda wyodrębniona wartość powinna zachować lokalizację źródłową
Zapisuj położenie wartości wewnątrz artefaktu: wiersz i kolumnę, arkusz i komórkę, ścieżkę XML lub JSON, tabelę i identyfikator wiersza, obszar obrazu, indeks widma albo referencję bloku binarnego. Reprezentacja zależy od formatu, lecz recenzent powinien odnaleźć oryginalny dowód bez odtwarzania wewnętrznego rozumowania parsera.
W miarę możliwości zachowuj wartość oryginalną, jednostkę i reprezentację tekstową obok wersji znormalizowanej. Nadaj tożsamość każdemu uruchomieniu parsera i połącz je z artefaktem, hashem, wynikiem detekcji, wersją, konfiguracją, czasem, diagnostyką, walidacją i tożsamością operatora lub usługi. Każdy pomiar powinien odwoływać się do uruchomienia parsera, lokalizacji źródłowej, wartości pierwotnej, wartości znormalizowanej, jednostki, stanu walidacji i ewentualnej poprawki.
Udane parsowanie nie ustanawia korelacji naukowej
Parsowanie wyodrębnia i interpretuje wartości ze źródła. Korelacja łączy je z właściwą próbką, pojemnikiem, aparaturą, eksperymentem, metodą, etapem procesu, operatorem lub oknem czasowym. To osobne decyzje. Kod próbki może być odczytany poprawnie, a mimo to wskazywać archiwalny identyfikator, używaną ponownie etykietę albo nieistniejący obiekt; znacznik czasu może być poprawnym tekstem przy źle ustawionym zegarze.
Reguły korelacji powinny korzystać z kontrolowanych dowodów, np. kodu próbki, skanu kodu kreskowego, tożsamości aparatury, czasu akwizycji, zaplanowanego przebiegu, wydania eksperymentu, wersji metody, wyboru operatora, przypisania folderu lub manifestu transferu. Nie zgaduj przy niejednoznaczności: skieruj import do kolejki przeglądu i zapisz wybrany obiekt, kandydatów, recenzenta, czas i uzasadnienie.
Walidacja rozstrzyga, czy rekordy mogą wejść do pracy naukowej
Waliduj pojedyncze pola i cały rekord: typ, zakres, jednostkę, precyzję, wartości wymagane, identyfikatory, dozwolone kody, liczbę kanałów, sekwencję, powtórzenia, wymagania metody i zależności między wartościami. Nieudany lub niepewny import powinien wejść do kwarantanny z nienaruszonym artefaktem, powodem, wynikiem detekcji, diagnostyką parsera, błędami walidacji, stanem korelacji i dostępnymi działaniami.
Kwarantanna jest kolejką operacyjną: potrzebuje właściciela, zasad dostępu, widocznego wieku spraw i rozróżnienia pracy zablokowanej od rutynowego przeglądu. Korekty, zatwierdzenia profilu, odrzucenie źródła, zmiana mapowania lub naprawa parsera tworzą nowy stan bez niszczenia poprzedniej próby. Replay musi wskazywać artefakt, parser, konfigurację, powód, inicjatora i relację do wcześniejszych uruchomień.
Korekty powinny dodawać historię zamiast ją zastępować
Gdy wartość przypisano do złej próbki, błędnie zmapowano jednostkę lub defekt parsera dotknął grupy importów, korekta powinna tworzyć poprawkę albo nową wersję z opisem zmiany, powodu, akceptacji, czasu obowiązywania i zastępowanego rekordu. Raporty oraz analizy muszą jawnie wiązać się z wersjami, a wpływ na wydany wynik powinien wskazywać artefakty wymagające przeglądu, zamiast po cichu nadpisywać historię.
Rekonstrukcja audytu pyta, czy uprawniony recenzent potrafi wyjaśnić powstanie widocznej wartości, przechodząc od pomiaru przez rekord znormalizowany, lokalizację źródłową, uruchomienie i wersję parsera, konfigurację, walidację, korelację, surowy artefakt, hash i kontekst akwizycji. Zalecenie W3C PROV-O dostarcza ogólnego słownika relacji pochodzenia, który można zachować w modelu dziedzinowym LIMS.
Odtwarzalność zaczyna się od możliwego do zrekonstruowania importu
National Academies opisuje odtwarzalność obliczeniową jako uzyskiwanie spójnych wyników z tych samych danych wejściowych, kroków, metod, kodu i warunków analizy. Dla integracji aparatury oznacza to zachowanie oryginalnych bajtów, wersji parsera, konfiguracji, danych referencyjnych, reguł transformacji i środowiska wykonawczego.
Odtworzenie importu jest węższe niż odtworzenie eksperymentu naukowego, który może wymagać historii próbki, stanu aparatury, wersji metody, kalibracji, środowiska i działań operatora. Okresowe testy replay wykrywają brakujące zależności: wybieraj kontrolowane artefakty, odtwarzaj środowisko parsera, porównuj wynik i badaj różnice w kodzie, konfiguracji, bibliotekach, tabelach referencyjnych, ustawieniach regionalnych lub runtime.
Kontrolowany import aparatury zachowuje odwracalność interpretacji
W przypadku systemów laboratoryjnych Gaiaa pliki z aparatury nie mogły bezpiecznie stać się pomiarami bez zachowania źródła, zachowania parsera, walidacji i kontekstu. Każde źródło archiwizowano niezmiennie i opatrywano hashem przed identyfikacją formatu oraz wyborem wersjonowanego parsera.
Rekordy normalizowano i walidowano, a korelację z próbkami i sprzętem pozostawiono jako osobną, kontrolowaną decyzję. Niejednoznaczne i nieudane importy trafiały do kwarantanny na przegląd i replay. Recenzent może wrócić do źródła, zobaczyć interpretację i uruchomić nową kontrolowaną interpretację bez usuwania pierwszej. Wybierz jedną ścieżkę aparatury i prześledź zgłoszony pomiar do pierwotnego artefaktu, aby odkryć luki w archiwum, parserze, walidacji, korelacji lub poprawkach.