Converti ECSV in CSV

Il software scientifico produce spesso ECSV, mentre le applicazioni per fogli di calcolo, database e report richiedono comunemente il normale CSV. La conversione rende la tabella più facile da condividere e modificare, ma rimuove i metadati che CSV non può memorizzare.

Che cos'è ECSV

ECSV significa Enhanced Character-Separated Values. È un formato di tabella testuale sviluppato per l'ecosistema Astropy e utilizzato principalmente nell'astronomia e in altri flussi di lavoro relativi ai dati scientifici.

Un file ECSV combina un'intestazione di metadati in stile YAML con dati tabellari delimitati. L'intestazione può definire nomi delle colonne, tipi di dati, unità, descrizioni, gestione dei valori nulli e altri metadati delle tabelle Astropy. Un file tipico inizia con # %ECSV 1.0. ECSV può utilizzare virgole, tabulazioni o un altro delimitatore, quindi la sola estensione del file non determina il separatore.

Astropy scrive questo formato a partire da oggetti astropy.table.Table con format='ascii.ecsv'. Microsoft Excel e la maggior parte delle applicazioni generiche per fogli di calcolo non interpretano nativamente l'intestazione ECSV come una tabella.

Che cos'è CSV

CSV memorizza un record per riga, con i campi separati da virgole. Un campo contenente una virgola, una virgoletta o un'interruzione di riga viene normalmente racchiuso tra virgolette doppie, mentre una virgoletta incorporata viene rappresentata da due virgolette doppie.

CSV è supportato da LibreOffice Calc, Microsoft Excel, importatori di database, librerie di programmazione e molti servizi web. È più semplice e spesso più compatto di ECSV, ma normalmente non conserva unità, descrizioni, tipi di dati specifici di Astropy, maschere, provenienza o metadati personalizzati delle tabelle. CSV dispone di convenzioni comuni, ma non di un'unica implementazione completamente uniforme; pertanto le applicazioni possono differire per codifica, terminatori di riga, delimitatori e valori mancanti.

Convertire con Astropy

Astropy è l'opzione più sicura perché legge lo schema ECSV invece di trattare l'intestazione dei metadati come dati ordinari.

Installare Astropy:

python -m pip install astropy

Eseguire questo comando dalla directory contenente il file di origine:

python -c "from astropy.table import Table; Table.read('input.ecsv', format='ascii.ecsv').write('output.csv', format='ascii.csv', overwrite=True)"

Questo legge input.ecsv e scrive un output.csv delimitato da virgole. L'opzione overwrite=True sostituisce un file di output esistente; ometterla se si desidera impedire la sostituzione accidentale.

Per conversioni ripetute, salvare quanto segue come convert_ecsv.py:

from astropy.table import Table

table = Table.read('input.ecsv', format='ascii.ecsv')
table.write('output.csv', format='ascii.csv', overwrite=True)

Eseguirlo con:

python convert_ecsv.py

Se l'origine utilizza una funzionalità ECSV insolita o contiene valori mascherati, esaminare la tabella risultante e modificare la tabella Astropy prima della scrittura. Non rimuovere manualmente le righe di commento a meno che il file non abbia una struttura semplice e nota; ciò può causare la perdita delle definizioni delle colonne o disallineare i dati.

Utilizzare strumenti desktop e online

Utilizzare LibreOffice Calc o Microsoft Excel per esaminare il CSV generato, non per analizzare l'ECSV originale. Aprire il risultato tramite File → Open, selezionare la virgola come delimitatore quando richiesto e controllare i tipi rilevati. Quando si salva nuovamente, scegliere CSV e confermare la virgola come delimitatore e UTF-8 come codifica, se l'applicazione offre queste impostazioni. In caso contrario, le impostazioni locali del foglio di calcolo potrebbero produrre un output separato da punti e virgola o modificare i valori decimali e delle date.

Non esiste un convertitore web specifico per ECSV ampiamente supportato che conservi in modo affidabile gli schemi Astropy. Per una conversione basata sul browser, Google Colab è un'opzione online pratica: creare un notebook, eseguire !pip install astropy, caricare il file ECSV ed eseguire lo stesso codice Table.read(...).write(...). Non caricare dati riservati o soggetti a normative in Colab o in un convertitore di terze parti. I siti web generici per CSV, come Zamzar o Convertio, devono essere utilizzati solo se l'elenco dei formati attualmente supportati accetta esplicitamente ECSV; in caso contrario, potrebbero copiare l'intestazione YAML nell'output o interpretarla come dati.

Controllare il file convertito

Confrontare il numero di colonne e di righe dell'input e dell'output, quindi esaminare l'intestazione, il delimitatore, la codifica dei caratteri, la rappresentazione dei valori mancanti e il separatore decimale. Aprire il CSV con un programma compatibile con CSV, perché la suddivisione manuale delle righe danneggia i campi che contengono virgole tra virgolette o interruzioni di riga.

La conversione non può trasferire i metadati ECSV in un normale file CSV. Conservare l'ECSV originale e registrare separatamente unità, descrizioni, provenienza e tipi di dati se sono necessari per l'interpretazione scientifica.

Le colonne scalari numeriche, di testo e simili alle date vengono generalmente convertite direttamente. Le colonne multidimensionali, le quantità, le colonne mascherate, i valori complessi e gli oggetti Astropy personalizzati potrebbero non avere una rappresentazione CSV portabile univoca. Appiattire o serializzare esplicitamente tali colonne e verificare i valori risultanti prima di importare il CSV in un'altra applicazione.