labapi: a Python object model for the LabArchives electronic lab notebook

Nel moderno laboratorio, la storia di un esperimento non è più solo un registro scritto a mano in un libro rilegato in pelle. È un record digitale, un archivio vivente dove ogni osservazione, ogni calcolo e ogni risultato deve essere archiviato con precisione. Per gli scienziati dei National Institutes of Health e di molte altre istituzioni di ricerca, questa dimora digitale è un sistema chiamato LabArchives. Esso funziona come un quaderno elettronico, uno spazio sicuro dove i ricercatori documentano il proprio lavoro passo dopo passo, assicurando che la storia di una scoperta sia preservata insieme alla scoperta stessa. Tuttavia, è emerso un divario tra il modo in cui gli scienziati lavorano e il modo in cui questi quaderni digitali sono costruiti. Mentre i ricercatori si affidano sempre più a programmi informatici automatizzati per elaborare i dati — eseguendo calcoli complessi che generano risultati in pochi secondi — devono ancora copiare e incollare manualmente tali risultati nel quaderno attraverso un browser web. È un compito tedioso e ripetitivo che interrompe il flusso della scienza, costringendo un essere umano ad agire come ponte tra un computer veloce e una pagina web statica.

Per risolvere questa frizione, un team di ricercatori ha sviluppato un nuovo strumento chiamato labapi, una libreria software progettata per permettere ai programmi informatici di parlare la stessa lingua del quaderno elettronico. Il traguardo centrale di questo lavoro è la creazione di un ponte che traduce i comandi tecnici e piatti del sistema sottostante del quaderno in una struttura che risulti naturale per un utto umano. Invece di costringere un programma informatico a cercare oscuri codici interni per trovare una pagina specifica, il nuovo strumento permette al programma di navigare nel quaderno utilizzando gli stessi percorsi familiari che userebbe una persona: muovendosi da un quaderno, all'interno di una cartella, e giù fino a una pagina specifica. Questo strumento non si limita a spostare dati; comprende la gerarchia del quaderno, riconoscendo che una cartella può contenere altre cartelle o pagine, e che le pagine contengono le effettive voci di dati. Costruendo questa struttura, gli autori hanno permesso ai ricercatori di creare flussi di lavoro automatizzati in grado di scrivere i propri risultati direttamente nel quaderno e di rileggerli in seguito senza alcun intervento umano.

Gli sviluppatori hanno progettato questo strumento con un obiettivo specifico: rendere il quaderno digitale intuitivo quanto l'interfaccia web che gli scienziati già conoscono. In passato, connettere un programma informatico al quaderno richiedeva la scrittura di codice personalizzato per tradurre un semplice percorso, come "Progetto A/Risultati/Soggetto 1", in una complessa serie di richieste interne. La nuova libreria gestisce questa tradificazione automaticamente. Include funzioni di supporto che possono verificare se una cartella esiste e crearla se manca, o trovare una pagina specifica senza dover conoscere il suo ID interno nascosto. Questo approccio segue il principio di "analizzare, non validare", il che significa che il software accetta il percorso così come l'utente lo digita e ne deduce i dettagli, invece di costringere l'utente a conformarsi a una struttura rigida e predefinita. Questa flessibilità permette al software di creare nuove voci, come salvare un file di dati complesso come allegato JSON, che appare poi nel quaderno con un'anteprima formattata facilmente leggibile dagli umani.

Il valore pratico di questo strumento è già percepito nella ricerca reale. Gli autori lo hanno utilizzato per costruire due applicazioni specifiche che sono ora in uso da altri laboratori. Un'applicazione, chiamata muronto, registra automaticamente gli output di esperimenti neuro-comportamentali, catturando dati che altrimenti richiederebbero l'inserimento manuale. Un'altra, chiamata save-my-jupyter, scatta istantanee di Jupyter notebook — un formato comune per la programmazione scientifica — e le deposita direttamente nel record elettronico. In una dimostrazione delle capacità dello strumento, gli autori hanno mostrato come un flusso di lavoro potesse prendere dati da cinque soggetti diversi, calcolare un valore di controllo qualità per ciascuno e scrivere tali risultati nel quaderno. Il sistema ha poi riletto quei valori salvati, li ha riassunti in un rapporto di coorte e ha allegato una figura visiva alla stessa pagina. Tutto questo è avvenuto automaticamente, con il computer che navigava la struttura del quaderno come se un essere umano stesse cliccando attraverso i menu.

Questo lavoro affronta un bisogno specifico all'interno della comunità scientifica, in particolare per le istituzioni che sono tenute a utilizzare quaderni elettronici approvati per la loro ricerca. Mentre altri sistemi per quaderni elettronici dispongono di librerie software ufficiali per facilitare l'automazione, LabArchives non ne fornisce una pubblica. I precedenti tentativi di costruire una connessione con il sistema erano incompleti, non mantenuti o richiedevano ai ricercatori di costruire l'intero sistema di navigazione da zero. La nuova libreria colma questo vuoto, offrendo uno strumento general-purpose che combina navigazione dei percorsi, gestione delle voci e trasferimento di file in un unico pacchetto. È progettata per essere utilizzata da ricercatori computazionali e sviluppatori di software che lavorano fianco a fianco con i laboratori sperimentali, fornendo loro un modo affidabile per mantenere aggiornati i propri record digitali.

Lo strumento è ora disponibile per chiunque, con il codice sorgente e la documentazione pubblicati apertamente. Richiede una versione moderna del linguaggio di programmazione Python per funzionare ed è rilasciato sotto una licenza che consente un ampio uso e modifica. Gli sviluppatori hanno incluso esempi e test per aiutare altri a iniziare, assicurando che il percorso da un file di dati grezzi a un record di laboratorio permanente non sia più un compito manuale, ma una parte fluida del processo scientifico. Rimuovendo la barriera tra l'analisi automatizzata e il quaderno elettronico, questo strumento permette agli scienziati di concentrarsi maggiormente sulle domande che stanno ponendo e meno sulla meccanica del deposito delle loro risposte.