Selezionare Dataset di ingresso, namespace e alias

Quando uno script Octave utilizza dati provenienti da GX-TXT, la finestra Script Runner consente di collegare uno o più Dataset canonici a una singola invocazione. Ogni collegamento specifica un namespace, un’identità del Dataset e un nome semantico (alias) con il quale lo script potrà distinguere gli ingressi. La selezione acquisisce inoltre la revisione del Dataset: se i dati o la loro collocazione cambiano, è necessaria una nuova revisione della scelta.

La guida utilizza i controlli reali di GX-TXT Octave Script Workspace e due piccole serie numeriche di esempio. Tutte le operazioni qui descritte riguardano la preparazione degli ingressi: Validate review non avvia Octave e non crea un Job.

1. Preparare uno script salvato e due Dataset canonici

Aprire la Session scientifica contenente i Dataset da utilizzare. Prima di accedere al Runner, il codice Octave deve essere salvato con File → Save e identificato correttamente nella Session.

Per riconoscere l’ambiente di lavoro, consideriamo uno script semplice:

% Synthetic temperature samples for reviewing input bindings.
% No calculation is started during input selection.
time_s = [0, 10, 20, 30, 40];
temperature_C = [19.0, 20.2, 21.0, 21.6, 22.1];
Octave Script Workspace con uno script GNU Octave registrato contenente campioni sintetici di temperatura.
Figura 1 — Un sorgente Octave registrato e leggibile nella modalità concentrata sul codice.

Nell’esempio sono già disponibili due Dataset numerici canonici di cinque righe, uno per le misure e uno per il riferimento. La loro pubblicazione preliminare non è svolta dal Runner: la creazione dei Dataset e la successiva elaborazione scientifica sono operazioni distinte.

2. Aprire Runner e individuare gli ingressi

Dal Source selezionato, scegliere Run → Open Script Runner…. La finestra mostra l’identità dello script e la revisione del sorgente. Scorrere fino alla sezione Inputs and output, eventualmente espandendola con il pulsante omonimo.

Script Runner di GX-TXT con la sezione Inputs and output e il pulsante Add input Dataset, prima di aggiungere ingressi.
Figura 2 — La sezione Inputs and output di Script Runner, prima di aggiungere gli ingressi.

Il pulsante Add input Dataset aggiunge una richiesta d’ingresso all’invocazione corrente. Non importa un file dal disco, non pubblica un nuovo Dataset e non esegue il codice. La sezione Output request, visibile più in basso, riguarda invece gli eventuali risultati ed è separata dagli ingressi.

3. Aggiungere una riga e comprendere il namespace iniziale

Premere Add input Dataset. Appare una riga Input 1 con i campi Semantic alias, Display label (optional), Namespace e Dataset ID, oltre a Remove input.

Riga Input 1 di Script Runner con Semantic alias, Display label, Namespace base e il messaggio No Datasets in this namespace.
Figura 3 — La prima riga di ingresso si apre nel namespace corrente, che può non contenere Dataset selezionabili.

Il namespace iniziale è quello corrente della Session. Nell’esempio è base, che non contiene le due serie desiderate. Il messaggio No Datasets in this namespace non significa che la Session sia priva di Dataset: significa soltanto che il filtro di quella riga non ne trova nel namespace selezionato.

4. Usare Namespace per filtrare i Dataset

Aprire Namespace e selezionare l’area in cui risiede la prima serie. Nell’esempio scegliamo bench/measurements.

Riga di ingresso di Script Runner con il namespace bench/measurements che filtra l’elenco Dataset ID.
Figura 4 — La scelta di bench/measurements filtra il campo Dataset ID della sola prima riga.

Namespace è un criterio organizzativo; Dataset ID è l’identità canonica. Il percorso di un namespace non coincide con un percorso di file. La modifica del namespace di una riga non sposta il Dataset e non cambia il Current namespace della Session.

5. Scegliere il Dataset ID e acquisire la revisione

Nel menu Dataset ID selezionare il Dataset corretto, ad esempio o15_measured_temperature. La riga visualizza l’identità scelta, il contratto table.generic e l’indicazione revision captured.

Riga di ingresso con il Dataset o15_measured_temperature, alias measured, etichetta e indicazione revision captured.
Figura 5 — Il Dataset delle misure è selezionato, con alias, etichetta e revisione acquisita.

La revisione acquisita è un riferimento allo stato canonico del Dataset al momento della scelta. Non è la revisione dello script .m, né un nuovo Dataset. GX-TXT può controllare nuovamente questo riferimento prima di accettare un’invocazione.

6. Distinguere Semantic alias, Display label e Dataset ID

Assegnare all’ingresso un Semantic alias breve, significativo e univoco, ad esempio measured. Display label (optional), ad esempio Measured thermistor temperature, è un’etichetta per la lettura umana; non sostituisce l’identità canonica.

Aggiungere una seconda riga con Add input Dataset. Scegliere il namespace bench/reference, il Dataset o15_reference_temperature e l’alias reference. Scorrere dentro la finestra Runner per vedere entrambe le righe senza modificare l’assetto dell’editor.

Script Runner con due righe di ingresso, measured e reference, ciascuna con namespace, Dataset ID e revisione propri.
Figura 6 — Due ingressi realmente distinti: measured e reference, ciascuno con il proprio namespace, Dataset ID e revisione.
CampoPrimo ingressoSecondo ingresso
Semantic aliasmeasuredreference
Namespacebench/measurementsbench/reference
Dataset IDo15_measured_temperatureo15_reference_temperature
Display labelMeasured thermistor temperatureReference thermometer

L’alias è il nome scientifico che distingue i due ingressi della stessa invocazione. Un riferimento potrebbe essere letto in una fase successiva attraverso le API pubbliche GX-TXT per Octave; la configurazione degli ingressi da sola non introduce istruzioni di lettura nello script.

7. Cambiare namespace richiede una nuova scelta del Dataset

Se si cambia Namespace nella seconda riga, Runner cancella il Dataset ID e la revisione precedentemente selezionati solo per quella riga. La prima riga conserva il suo Dataset, il suo alias e il proprio riferimento di revisione.

Per ripristinare il secondo ingresso, riselezionare bench/reference e poi il Dataset corretto dal relativo elenco. Il ritorno al vecchio namespace non ripristina automaticamente una selezione precedente: occorre scegliere di nuovo il Dataset.

Questa regola evita che la schermata continui a mostrare come valida un’associazione nata in un altro namespace.

8. Convalidare alias distinti

Il pulsante Validate review permette di controllare l’invocazione senza richiedere l’esecuzione. I due ingressi devono avere alias differenti. Se entrambi sono chiamati measured, la convalida mostra Duplicate input alias ‘measured’.

Validate review di Script Runner che segnala Duplicate input alias measured.
Figura 7 — Validate review rifiuta l’alias duplicato, senza eseguire lo script o creare un Job.

Correggere il secondo alias in reference, lasciando invariati i Dataset selezionati. Una selezione coerente può ottenere Review valid. No Job submitted. Il messaggio segnala che il controllo preparatorio è passato, non che i dati siano stati elaborati.

9. Riconoscere un ingresso non più aggiornato

Un Dataset può cambiare namespace o revisione dopo che è stato selezionato nel Runner. In quel caso l’associazione non è più sicura: la verifica confronta lo stato corrente con quello acquisito.

Validate review che rifiuta un Dataset spostato dopo la selezione, non più presente nel namespace dichiarato.
Figura 8 — Un Dataset spostato dopo la selezione viene rifiutato perché non si trova più nel namespace dichiarato.

Non basta modificare soltanto il testo dell’alias o conservare il vecchio riferimento. Controllare il namespace attuale e riselezionare esplicitamente il Dataset ID per acquisire la revisione corrente.

Script Runner con il namespace ripristinato, il Dataset riselezionato e Validate review di nuovo positivo.
Figura 9 — Dopo il ripristino del namespace e una nuova selezione, Validate review può tornare a esito positivo.

Questa protezione è importante nei flussi scientifici riproducibili: l’identità del Dataset da sola non dimostra che si stiano usando esattamente i dati revisionati.

10. Rimuovere una richiesta senza eliminare il Dataset

Remove input elimina la singola riga di collegamento dal Runner. Non cancella il Dataset canonico, non tocca gli altri ingressi e non modifica il codice Octave.

Script Runner dopo Remove input, con un solo ingresso rimasto e i Dataset canonici ancora presenti nella Session.
Figura 10 — Dopo Remove input rimane l’ingresso conservato; i Dataset canonici continuano a esistere nella Session.

Si può aggiungere nuovamente una riga, scegliere il namespace e selezionare il Dataset aggiornato. Quando gli ingressi sono corretti, Validate review controlla la preparazione senza inviare Job. Se si desidera tornare al Source, utilizzare Close.

In sintesi: scegliere prima il namespace corretto, poi il Dataset ID e infine un alias univoco; controllare l’indicazione di revisione e validare la configurazione. Solo una successiva richiesta esplicita Run Job, con parametri e uscite opportunamente riesaminati, può avviare il calcolo.