Generic CSV dataset import

Importa un CSV o TSV come Dataset, associa variabili e unità e gestisci intestazioni duplicate o righe incomplete.

acq.generic_csv · Versione 3

Usa questo importatore per trasformare un CSV o TSV a righe e colonne in un Dataset consultabile e riusabile. Per l’esercizio segnale.csv seleziona table.generic, auto e una riga di intestazione. Accoda il file, imposta l’ID tabella_base e apri Preview. Verifica quattro righe e due nomi sorgente, Tempo e Tensione.

  1. Apri Variables per associare nomi come tempo_s e tensione_V, unità s/V ed eventuali ruoli. Mantieni le due spunte se vuoi conservare entrambe le colonne.
  2. Torna ad Acquisition e importa. In Dataset attiva tabella_base e apri Canonical table. L’ultima riga contiene 0.03 e 0.75. Nomi, unità e ruoli congelati nello schema si possono rileggere in Variables o nelle proprietà del Dataset.
  3. Ripeti con il TSV e usa tab se il rilevamento è ambiguo. Con file che usano il punto e virgola, scegli semicolon. Per il separatore virgola scegli comma. I separatori interni a un valore vanno gestiti secondo il quoting del file.

Il campo superiore Canonical dataset ID appartiene alla configurazione generale, mentre il Dataset ID della coda è assegnato per ogni fonte e può derivare dal nome del file normalizzato. Delimitatore, intestazioni e contratto si possono controllare e cambiare nella singola riga. Le intestazioni o i valori in RAW conservano il contenuto originario. Le impostazioni in Variables riguardano la pubblicazione canonica.

Correggere intestazioni e righe incomplete

Se due intestazioni coincidono, come in csv_header_duplicato.csv, imposta due Canonical variable distinti in Variables prima di importare. L’esercizio pubblica prima_colonna e seconda_colonna. Se a una riga manca un campo, come in csv_riga_incompleta.csv, correggi il record con la sorgente documentata e ricontrolla il numero di colonne. Il log della Sessione mostra numero di riga e larghezza attesa.

Con Header rows a 0, in P011-bis il convertitore di Generic CSV segnala header-rows must be >= 1, anche dopo avere scelto alias validi. Conserva il sorgente e aggiungi una riga di nomi a una copia. Usa tsv-con-intestazione.tsv per vedere il recupero della fixture a due righe. Imposta Delimiter su tab e Header rows a 1. I due campioni pubblicati sono (0, 1,125) e (1, 2,25).

Dati di esercizio

Fonti, licenze e SHA-256

Schermate del percorso

Apri una schermata per leggerla a grandezza originale.

segnale.csv aggiunto in Acquisition con Dataset ID tabella_base. La riga mostra le impostazioni per l’import.
segnale.csv aggiunto in Acquisition con Dataset ID tabella_base. La riga mostra le impostazioni per l’import.
Preview Pending di segnale.csv con intestazione, mappa e quattro righe del campione.
Preview Pending di segnale.csv con intestazione, mappa e quattro righe del campione.
Dopo Import, il browser mostra Active Dataset: tabella_base. La scheda Technical Details / Provenance descrive il risultato registrato.
Dopo Import, il browser mostra Active Dataset: tabella_base. La scheda Technical Details / Provenance descrive il risultato registrato.
Canonical table di tabella_base. La quarta riga riporta 0,03 s e 0,75 V.
Canonical table di tabella_base. La quarta riga riporta 0,03 s e 0,75 V.
Il tentativo resta Failed con Header rows a 0 anche dopo aver impostato Variables.
Il tentativo resta Failed con Header rows a 0 anche dopo aver impostato Variables.
Canonical table della copia TSV con intestazione. Le due colonne sono prima_colonna e seconda_colonna.
Canonical table della copia TSV con intestazione. Le due colonne sono prima_colonna e seconda_colonna.

Comandi e impostazioni

Canonical dataset ID

Imposta un’identità proposta per le sorgenti che aggiungi con questo importatore. Controlla l’ID effettivo nella singola riga prima di Import. Il browser Dataset usa l’identità pubblicata per trovare il risultato.

Valore proposto nella configurazione di base curve_family.primary.

Dataset contract / kind

Scegli il contratto della tabella. table.generic è adatto a una tabella senza struttura scientifica più specifica. Con Other… immetti l’ID nel campo adiacente. Prima di scegliere un altro contratto consulta Contracts… e controlla che la struttura richiesta corrisponda alla tabella.

Valore proposto nella configurazione di base curve_family.table.

  • (catalogo dinamico) · Le voci provengono dai contratti visibili nell’installazione. Controlla nome, condizioni e origine in Contracts… e l’eventuale opzione Other… nella vista di lavoro.

Other

Scegli il contratto della tabella. table.generic è adatto a una tabella senza struttura scientifica più specifica. Con Other… immetti l’ID nel campo adiacente. Prima di scegliere un altro contratto consulta Contracts… e controlla che la struttura richiesta corrisponda alla tabella.

Il campo parte vuoto.

CSV delimiter

Scegli il separatore effettivo del sorgente. auto lo stima dal campione. comma usa virgola, semicolon punto e virgola, tab tabulazione e whitespace spazi bianchi dove disponibile. Verifica che Preview restituisca il numero di colonne atteso.

Valore proposto nella configurazione di base auto.

  • auto · Scegli il separatore effettivo del sorgente. auto lo stima dal campione. comma usa virgola, semicolon punto e virgola, tab tabulazione e whitespace spazi bianchi dove disponibile. Verifica che Preview restituisca il numero di colonne atteso.
  • comma · Scegli il separatore effettivo del sorgente. auto lo stima dal campione. comma usa virgola, semicolon punto e virgola, tab tabulazione e whitespace spazi bianchi dove disponibile. Verifica che Preview restituisca il numero di colonne atteso.
  • semicolon · Scegli il separatore effettivo del sorgente. auto lo stima dal campione. comma usa virgola, semicolon punto e virgola, tab tabulazione e whitespace spazi bianchi dove disponibile. Verifica che Preview restituisca il numero di colonne atteso.
  • tab · Scegli il separatore effettivo del sorgente. auto lo stima dal campione. comma usa virgola, semicolon punto e virgola, tab tabulazione e whitespace spazi bianchi dove disponibile. Verifica che Preview restituisca il numero di colonne atteso.

Scorrimento

Sposta la vista con la barra orizzontale o verticale disponibile per raggiungere campi, voci o testo fuori bordo.

Header rows

Numero di righe di intestazione da considerare nella lettura. Usa 1 con i nomi nella prima riga. In P011-bis il convertitore rifiuta 0. Per sole righe di dati usa la procedura nel capitolo. Controlla nella coda il valore del singolo file.

Valore proposto nella configurazione di base 1.

Scorrimento

Sposta la vista con la barra orizzontale o verticale disponibile per raggiungere campi, voci o testo fuori bordo.