Visualizzatore TSV: apri file separati da tabulazioni su una mappa o come tabella

Cosa fa questo visualizzatore

TSV (valori separati da tabulazioni) è uno dei formati di dati più semplici: una riga per record e un carattere di tabulazione tra le colonne. Molti programmi lo scrivono. I database lo esportano, i portali scientifici lo offrono da scaricare, e quando copi celle da Excel o Google Sheets, negli appunti c'è un testo TSV. Il problema è che un file TSV aperto in un editor di testo è difficile da leggere, perché le colonne non sono allineate.

Questo visualizzatore legge il file e lo mostra nella forma più utile. Prima guarda i nomi delle colonne. Se trova una colonna di latitudine e una di longitudine, per esempio Latitude/Longitude, lat/lon, Breitengrad/Längengrad o 緯度/経度, ogni riga con valori validi appare come un punto sulla mappa. Legge anche coordinate in gradi, minuti e secondi, numeri con la virgola decimale e colonne singole come "52.52, 13.40" o POINT (13.40 52.52). Se non trova niente, mostra i dati come tabella, e puoi comunque scegliere tu le colonne delle coordinate.

L'ho creato per dare un'occhiata veloce a un file che qualcuno ti ha mandato. Vedi dove si trovano le righe, colori i punti secondo qualsiasi colonna, clicchi su un punto per leggerne la riga, passi alla tabella per ordinare e filtrare, e salti da una riga della tabella al suo punto. Alla fine puoi scaricare le righe sulla mappa in GeoJSON, oppure l'intera tabella in CSV. Il file resta nel tuo browser e non viene mai caricato.

Com'è fatto un file TSV

Ecco l'intestazione e tre righe del file di esempio di questa pagina. Ogni → indica un carattere di tabulazione, invisibile nella maggior parte degli editor. L'ultima riga ha le celle di latitudine e longitudine vuote, quindi lo strumento la conta come riga senza coordinate.

ID→Name→Category→City→Country→Latitude→Longitude
1→Eiffel Tower→Tower→Paris→France→48.8584→2.2945
5→Colosseum→Monument→Rome→Italy→41.8902→12.4922
29→Plitvice Lakes→Nature park→Plitvička Jezera→Croatia→→

Separatore

Un carattere di tabulazione (\t, Unicode U+0009) tra due celle. Due tabulazioni di fila indicano una cella vuota.

Righe

Un record per riga. Funzionano sia i fine riga di Windows (\r\n) sia quelli Unix (\n). Le righe vuote vengono saltate.

Prima riga

Di solito i nomi delle colonne. Lo strumento lo decide da solo: se la prima riga ha numeri nelle stesse colonne della seconda, sono dati. Puoi cambiare la scelta nel pannello File.

Virgolette

Il formato TSV originale non usa virgolette, quindi una cella non può mai contenere una tabulazione o un a capo. Excel e Google Sheets aggiungono virgolette in stile Excel quando una cella ne ha bisogno. Lo strumento legge entrambi gli stili.

Nomi e tipo di file

Di solito .tsv, a volte .tab o .txt. Il tipo di media registrato è text/tab-separated-values.

Un file TSV non ha tipi di dati. Ogni cella è testo, e lo strumento decide cosa è un numero o una coordinata. Nell'esportazione GeoJSON i numeri semplici diventano numeri, mentre i codici con uno zero iniziale, come il codice postale 01067, restano testo.

TSV o CSV: quale usare

TSV e CSV salvano lo stesso tipo di tabella. L'unica vera differenza è il separatore, ma questa differenza ha alcune conseguenze pratiche.

Il mio parere: se i tuoi dati hanno indirizzi, testo libero o virgole decimali, TSV è la scelta più sicura, perché una tabulazione non compare quasi mai dentro un valore. Se ti serve il supporto più ampio, esporta in CSV. Questo strumento converte qualsiasi TSV in CSV con un clic.

Quali nomi di colonna vengono riconosciuti

I nomi delle colonne vengono confrontati dopo una pulizia: maiuscole e minuscole non contano, il testo tra parentesi tonde o quadre come (WGS84) o [deg] viene tolto, e spazi e punti diventano trattini bassi. Così Latitude (WGS84), LAT. e gps latitude vengono tutti trovati. Se niente corrisponde, scegli le colonne nel pannello Coordinates.

Latitudine

lat, latitude, lati, y, ycoord, point_y, decimalLatitude, gps_lat, lat_dd, lat_wgs84, più Breite/Breitengrad, latitud, latitudine e 緯度.

Longitudine

lng, lon, long, longitude, x, xcoord, point_x, decimalLongitude, gps_lon, lon_dd, più Länge/Längengrad, longitud, longitudine e 経度.

Una colonna con entrambi

Nomi come coordinates, coords, latlng, lnglat, position, location, gps, wkt o geometry, quando le celle contengono due numeri ("52.52, 13.40") o un punto WKT (POINT (13.40 52.52)).

Scelta tra i candidati

Ogni possibile coppia di latitudine e longitudine viene provata sulle prime 300 righe. Vince la coppia con più valori entro ±90 e ±180. x/y perdono i pareggi contro i veri nomi lat/lon, quindi colonne x/y proiettate in metri non vengono mai prese per gradi.

Ordine in una colonna

WKT ha sempre la longitudine per prima. lnglat e lonlat vogliono dire longitudine prima. Le altre coppie di testo si leggono con la latitudine prima, l'ordine di Google Maps, a meno che solo l'altro ordine dia valori validi.

Dettagli tecnici

Ecco esattamente cosa accetta e cosa produce lo strumento.

Input

File .tsv, .tab e .txt fino a 50 MB, oppure testo separato da tabulazioni incollato nel riquadro Paste TSV. Un file .csv riceve un messaggio che rimanda allo strumento CSV to Map.

Codifica

UTF-8. Il byte order mark all'inizio viene rimosso.

Formati delle coordinate

Gradi decimali (48.8584, 48,8584), con simbolo dei gradi o lettera dell'emisfero (48.8584° N, W 1.5115), e gradi-minuti-secondi (48°51'30"N, 48 51 30 N, 48:51.5).

Coordinate valide

Latitudine tra −90 e 90, longitudine tra −180 e 180 (WGS84). Le righe fuori da questi intervalli vengono contate e restano fuori dalla mappa. Anche le righe che andrebbero bene con i due valori scambiati vengono contate, con un pulsante Swap.

Righe irregolari

Le righe con meno celle dell'intestazione vengono completate con celle vuote. Le celle in più ricevono colonne proprie, chiamate Column N. Il pannello File mostra quante righe erano irregolari.

Vista tabella

100 righe per pagina, ordinamento per qualsiasi colonna (i numeri sono ordinati come numeri), un campo filtro che cerca in ogni cella e un pulsante ⌖ su ogni riga con coordinate che porta al suo punto.

Colore per colonna

Qualsiasi colonna con al massimo 10 valori diversi può colorare i punti, con legenda e conteggio per valore.

Esportazione

GeoJSON con le righe presenti sulla mappa, ogni colonna come proprietà. CSV con l'intera tabella, comprese le righe senza coordinate.

Privacy

Il file viene letto nel tuo browser. Solo le tile della mappa di base arrivano da internet.

Come aprire un file TSV, passo dopo passo

Ecco tutto il procedimento con l'esempio integrato: 29 luoghi famosi d'Europa con le colonne Latitude e Longitude, dove una riga non ha coordinate. Il passo 6 mostra cosa succede con un file le cui colonne delle coordinate hanno nomi insoliti.

1

Passo 1: Apri lo strumento

La mappa si apre con una mappa stradale di base. Usa Upload, Paste TSV o trascina un file sulla mappa. Qui ho cliccato su Sample Data.

2

Passo 2: Controlla il file

Il pannello File mostra la dimensione, il numero di righe e colonne e se la prima riga è stata letta come nomi di colonna. 28 delle 29 righe sono sulla mappa; la riga dei Laghi di Plitvice ha le celle delle coordinate vuote.

3

Passo 3: Conferma le colonne delle coordinate

Il pannello Coordinates mostra le colonne trovate, qui Latitude e Longitude. Puoi scegliere altre colonne quando vuoi, o passare a "One column" per celle come "48.85, 2.29" o POINT (2.29 48.85).

4

Passo 4: Colora i punti secondo una colonna

Scegli una colonna in "Color by column". Qui Category dà a ogni tipo di luogo il suo colore, con legenda e conteggio. Clicca su un punto per leggerne la riga.

5

Passo 5: Passa alla tabella

Clicca su Table per vedere tutte le righe. Le colonne delle coordinate sono evidenziate. Clicca sul nome di una colonna per ordinare, scrivi nel campo filtro per cercare e clicca su ⌖ per andare a quella riga sulla mappa.

6

Passo 6: Un file senza coordinate riconosciute

Questo elenco incollato usa le colonne N ed E, che lo strumento non tratta come nomi di coordinate. Quindi si apre come tabella con un avviso. Scegli N come latitudine ed E come longitudine nel pannello Coordinates e la mappa si apre.

Altri modi per aprire un file TSV

Questo strumento è il modo più veloce per guardare un file TSV. Quando lo stesso file fa parte di un lavoro più grande, uso questi strumenti.

Lo stesso lavoro in codice

Tutti gli esempi usano il file di esempio di questa pagina, con le coordinate nelle colonne `Latitude` e `Longitude`.

# Python: pandas reads TSV with sep="\t", GeoPandas builds the points
import pandas as pd
import geopandas as gpd

df = pd.read_csv("landmarks.tsv", sep="\t", dtype=str)
df = df.dropna(subset=["Latitude", "Longitude"])
gdf = gpd.GeoDataFrame(
    df,
    geometry=gpd.points_from_xy(df["Longitude"].astype(float), df["Latitude"].astype(float)),
    crs="EPSG:4326",
)
gdf.to_file("landmarks.geojson", driver="GeoJSON")

# GDAL / OGR: TSV to GeoJSON in one command
ogr2ogr -f GeoJSON landmarks.geojson landmarks.tsv \
  -oo X_POSSIBLE_NAMES=Longitude -oo Y_POSSIBLE_NAMES=Latitude \
  -a_srs EPSG:4326

# Command line: print name and coordinates, skip rows without a latitude
awk -F'\t' 'NR > 1 && $6 != "" { print $2 ": " $6 ", " $7 }' landmarks.tsv

# Only the columns you need (cut splits on tabs by default)
cut -f2,6,7 landmarks.tsv

Il mio parere: usa questo strumento per guardare un file nuovo e controllarne le coordinate. Quando conosci le colonne, ogr2ogr o poche righe di pandas fanno la conversione ogni volta che i dati cambiano.

Come funziona lo strumento

Ecco cosa succede tra il momento in cui trascini un file e quello in cui vedi la mappa o la tabella. Ogni passo avviene nel tuo browser.

1. Controllare il separatore. Nelle prime righe si cercano le tabulazioni. Se non ce ne sono ma ci sono virgole o punti e virgola, ricevi un avviso che il file è probabilmente un CSV.
2. Dividere righe e celle. Papa Parse divide il testo su tabulazioni e a capo e capisce le virgolette in stile Excel. Se le virgolette rompono le righe, il file viene letto di nuovo trattando ogni virgoletta come testo normale, come nel formato TSV originale.
3. Trovare l'intestazione. Se la prima riga ha numeri nelle stesse colonne della seconda, sono dati, e le colonne si chiamano Column 1, Column 2 e così via. Altrimenti contiene i nomi delle colonne. I nomi vuoti vengono completati e quelli ripetuti ricevono (2), (3).
4. Riconoscere le coordinate. I nomi delle colonne vengono puliti e confrontati con gli elenchi sopra. Ogni coppia candidata viene provata su un massimo di 300 righe, e vince la coppia con più valori validi. Se nessuna coppia va bene, si provano le colonne con entrambi i valori.
5. Mappa o tabella. Con le coordinate, ogni riga viene letta in gradi decimali o gradi-minuti-secondi, le righe non valide vengono contate e i punti sono disegnati su un livello canvas. Senza coordinate si apre invece la tabella.
6. Cambiare tutto. La scelta dell'intestazione, le colonne delle coordinate, l'ordine e i colori si cambiano nella barra laterale. Mappa e tabella si aggiornano subito.

Il riconoscimento è solo una prima ipotesi. Ogni scelta si può cambiare nella barra laterale, quindi un'ipotesi sbagliata costa un clic.

Leggere le coordinate: DMS, intervalli e precisione

Le coordinate nei file TSV si presentano in varie forme. Questi tre blocchi spiegano come lo strumento le trasforma in punti e come capire se i numeri hanno senso.

decimal = degrees + minutes / 60 + seconds / 3600

52°31'12"N  →  52 + 31/60 + 12/3600     =  52.52
13°24'18"E  →  13 + 24/60 + 18/3600     =  13.405
33°52'08"S  →  −(33 + 52/60 + 8/3600)   = −33.8689

valid  ⇔  −90 ≤ latitude ≤ 90   and   −180 ≤ longitude ≤ 180

stored:   lat = 151.21,  lon = −33.87   →  invalid
swapped:  lat = −33.87,  lon = 151.21   →  valid (Sydney)

1° latitude  ≈ 111 320 m
1° longitude ≈ 111 320 m · cos(latitude)

decimals   latitude step   longitude step in Paris (48.86°)
1          11.1 km          7.3 km
2          1.1 km           730 m
3          111 m            73 m
4          11.1 m           7.3 m
5          1.1 m            0.73 m
6          0.11 m           0.07 m

Quando serve questo visualizzatore

Queste sono le situazioni in cui apro un visualizzatore TSV.

1. Controllare un download da un portale di dati. Molti portali scientifici e pubblici, come le banche dati sulla biodiversità e sui toponimi, offrono download in TSV. Vedi subito dove sono i record e quali non hanno coordinate.
2. Guardare un'esportazione da database. Gli strumenti per database esportano spesso testo delimitato da tabulazioni. Aprilo come tabella, ordinalo e filtralo, e controlla le colonne di posizione sulla mappa.
3. Portare sulla mappa celle da un foglio di calcolo. Seleziona celle in Excel o Google Sheets, copiale e incollale in Paste TSV. Le righe compaiono sulla mappa senza salvare alcun file.
4. Leggere un file senza coordinate. Non tutti i file TSV sono geografici. La vista tabella con ordinamento e filtro è un modo veloce per leggere qualsiasi file separato da tabulazioni senza aprire un foglio di calcolo.
5. Convertire TSV in CSV o GeoJSON. Ottieni un CSV per gli strumenti che non leggono TSV, oppure un GeoJSON per QGIS, ArcGIS o una mappa web.
6. Trovare coordinate sbagliate. I conteggi dei valori mancanti, fuori intervallo e scambiati, insieme alla mappa, mostrano errori difficili da vedere in un lungo elenco di numeri.
7. Leggere coordinate DMS. Elenchi di rilievo e dati vecchi in gradi, minuti e secondi vengono letti direttamente, senza convertirli prima.
8. Raggruppare i punti per colonna. Colora per tipo, stato o regione per vedere degli schemi, per esempio quali luoghi appartengono a quale categoria.

Domande frequenti

Librerie e crediti

Il riconoscimento delle coordinate, il lettore DMS e la tabella sono stati scritti per questo sito. La mappa e la lettura del TSV usano software open source.

• Leaflet 1.9 · BSD-2-Clause · Volodymyr Agafonkin and contributors
  Disegna la mappa interattiva, il livello di punti su canvas e i popup.
• Papa Parse 5 · MIT · Matt Holt and contributors
  Divide il testo TSV in righe e celle, comprese le celle tra virgolette in stile Excel.
• OpenStreetMap, Protomaps (hosted by KONAKTIVE), CARTO, Esri World Imagery · ODbL e condizioni del fornitore · OpenStreetMap contributors, Protomaps, KONAKTIVE, CARTO, Esri
  Tile e immagini della mappa di base.

Strumenti correlati