Versione verificata
| Framework | GX-TXT 0.9.8.10-dev-031 |
|---|---|
| Modulo | acq.rigol_csv 2.0.0 |
| Output | timeseries.table |
| Runtime import | GNU Octave configurato |
1. Workflow
- Seleziona Rigol oscilloscope CSV import in Acquisition.
- Aggiungi il file alla source batch table.
- Controlla parser/layout nella configurazione.
- Apri Preview e Variables.
- Assegna canonical names e unità ai segnali da importare.
- Avvia l'import.
2. Parser disponibili
rigol_ds1000z | Layout RIGOL DS1000Z-style; default. |
|---|---|
generic_sequence | Sequenza con sequence column configurabile. |
generic_time | Layout basato su colonna tempo esplicita. |
3. Configurazione principale
| Campo | Default dev-031 | Scopo |
|---|---|---|
| Delimiter | comma | comma / semicolon / tab. |
| Header rows | 2 | Righe iniziali da interpretare come header. |
| Sequence column | 1 | Indice della sequenza per parser sequence. |
| Time column | 1 | Indice della colonna tempo per parser generic_time. |
| Manual tStart / dt | blank | Override manuale del timing quando necessario. |
| Chunk rows | 250000 | Blocchi di parsing del worker. |
| Raw fields | 0 = auto | Numero campi record quando il layout lo richiede. |
| Trailing fields | 0 | Campi finali da ignorare. |
| Strict sequence | ON | Controllo incremento +1. |
4. Preview RIGOL
La Preview è intenzionalmente leggera: legge l'header configurato e un piccolo campione — il manuale corrente indica otto righe dati — senza scansione completa del file.
Nel layout DS1000Z nativo:
- la prima header row fornisce i nomi dei canali;
- la seconda fornisce unità e timing;
StarteIncrementvengono mantenuti come metadata, non come colonne di segnale.
5. Variables
La tabella Variables contiene soltanto i segnali individuati dal parser. Qui scegli quali colonne abilitare e assegni canonical name e unità.
CSV column 2 → source channel CH1 → canonical variable Va_V
CSV column 3 → source channel CH2 → canonical variable Vg_V6. Output Dataset
Ogni segnale abilitato diventa un Dataset canonico timeseries.table con:
time_s
<selected signal variable>Il RAW originale viene preservato e CORE registra Dataset, hashes e provenance.
7. Timing
Nel formato RIGOL nativo, timing e unità vengono estratti dall'header. Se il file reale ha una struttura diversa, parser, header count, sequence/time columns oppure tStart/dt devono essere adeguati prima dell'import.
La stessa configurazione viene usata da Preview e import; non esistono due parser con impostazioni divergenti.
8. Large CSV
Il worker streaming evita di caricare l'intera acquisizione in memoria. chunk_rows definisce il blocco di lavoro del parser e può essere regolato se necessario.
La Preview rimane comunque bounded e separata dalla scansione completa richiesta dall'import.
9. Instrument provenance
L'importatore non crea automaticamente un oscilloscopio nella sezione Instrumentation. Se vuoi registrare modello, seriale, firmware o canale fisico, crea esplicitamente l'Instrument instance e collega le variabili ai suoi ID/canali.
10. Diagnostica
Un file non riconosciuto o con layout incoerente deve restare un failure esplicito. Non va “riparato” cambiando arbitrariamente il formato sorgente. Controlla:
- numero di header rows;
- delimiter;
- parser selezionato;
- sequence/time column;
- numero di campi e trailing fields;
- sequence increment quando Strict sequence è attivo.
11. Guide collegate
- Generic CSV — per tabelle non vendor-specific.
- Dataset e Variable ID.
- Scientific Dataset Plot.