Visionneuse TSV : ouvrir des fichiers à tabulations sur une carte ou en tableau

Ce que fait cette visionneuse

Le TSV (valeurs séparées par des tabulations) est l'un des formats de données les plus simples : une ligne par enregistrement et un caractère de tabulation entre les colonnes. Beaucoup d'outils l'écrivent. Les bases de données l'exportent, les portails scientifiques le proposent en téléchargement, et quand vous copiez des cellules dans Excel ou Google Sheets, le presse-papiers contient du TSV. Le problème : ouvert dans un éditeur de texte, un fichier TSV est difficile à lire, car les colonnes ne sont pas alignées.

Cette visionneuse lit le fichier et le montre sous la forme la plus utile. Elle regarde d'abord les noms des colonnes. Si elle trouve une colonne de latitude et une de longitude, par exemple Latitude/Longitude, lat/lon, Breitengrad/Längengrad ou 緯度/経度, chaque ligne avec des valeurs valides apparaît comme un point sur la carte. Elle lit aussi les coordonnées en degrés, minutes et secondes, les nombres avec une virgule décimale et les colonnes uniques comme "52.52, 13.40" ou POINT (13.40 52.52). Si elle ne trouve rien, elle affiche les données en tableau, et vous pouvez quand même choisir les colonnes de coordonnées.

Je l'ai créée pour jeter un coup d'œil rapide à un fichier qu'on vous envoie. Vous voyez où se trouvent les lignes, vous colorez les points selon n'importe quelle colonne, vous cliquez sur un point pour lire sa ligne, vous passez au tableau pour trier et filtrer, et vous sautez d'une ligne du tableau à son point. À la fin, vous téléchargez les lignes de la carte en GeoJSON, ou tout le tableau en CSV. Le fichier reste dans votre navigateur et n'est jamais envoyé.

À quoi ressemble un fichier TSV

Voici l'en-tête et trois lignes du fichier d'exemple de cette page. Chaque → représente un caractère de tabulation, invisible dans la plupart des éditeurs. La dernière ligne a des cellules de latitude et de longitude vides, donc la visionneuse la compte comme une ligne sans coordonnées.

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→→

Séparateur

Un caractère de tabulation (\t, Unicode U+0009) entre deux cellules. Deux tabulations à la suite signifient une cellule vide.

Lignes

Un enregistrement par ligne. Les fins de ligne Windows (\r\n) et Unix (\n) fonctionnent toutes les deux. Les lignes vides sont ignorées.

Première ligne

En général les noms des colonnes. La visionneuse le décide seule : si la première ligne contient des nombres dans les mêmes colonnes que la deuxième, ce sont des données. Vous pouvez changer ce choix dans le panneau File.

Guillemets

Le format TSV d'origine n'a pas de guillemets, donc une cellule ne peut jamais contenir une tabulation ou un saut de ligne. Excel et Google Sheets ajoutent des guillemets de style Excel quand une cellule en a besoin. La visionneuse lit les deux styles.

Noms et type de fichier

En général .tsv, parfois .tab ou .txt. Le type de média enregistré est text/tab-separated-values.

Un fichier TSV n'a pas de types de données. Chaque cellule est du texte, et la visionneuse décide ce qui est un nombre ou une coordonnée. Dans l'export GeoJSON, les nombres simples deviennent des nombres, tandis que les codes avec un zéro au début, comme le code postal 01067, restent du texte.

TSV ou CSV : lequel choisir

TSV et CSV stockent le même type de tableau. La seule vraie différence est le séparateur, mais cette différence a quelques effets pratiques.

Mon avis : si vos données contiennent des adresses, du texte libre ou des virgules décimales, le TSV est le choix le plus sûr, car une tabulation n'apparaît presque jamais dans une valeur. Si vous avez besoin de la plus large prise en charge, exportez en CSV. Cette visionneuse convertit n'importe quel TSV en CSV en un clic.

Quels noms de colonnes sont reconnus

Les noms de colonnes sont comparés après un nettoyage : majuscules et minuscules ne comptent pas, le texte entre parenthèses ou crochets comme (WGS84) ou [deg] est retiré, et les espaces et points deviennent des tirets bas. Ainsi Latitude (WGS84), LAT. et gps latitude sont tous trouvés. Si rien ne correspond, vous choisissez les colonnes dans le panneau Coordinates.

Latitude

lat, latitude, lati, y, ycoord, point_y, decimalLatitude, gps_lat, lat_dd, lat_wgs84, ainsi que Breite/Breitengrad, latitud, latitudine et 緯度.

Longitude

lng, lon, long, longitude, x, xcoord, point_x, decimalLongitude, gps_lon, lon_dd, ainsi que Länge/Längengrad, longitud, longitudine et 経度.

Une colonne avec les deux

Des noms comme coordinates, coords, latlng, lnglat, position, location, gps, wkt ou geometry, quand les cellules contiennent deux nombres ("52.52, 13.40") ou un point WKT (POINT (13.40 52.52)).

Choix entre candidats

Chaque paire possible de latitude et de longitude est testée sur les 300 premières lignes. La paire avec le plus de valeurs dans ±90 et ±180 gagne. x/y perdent les égalités face aux vrais noms lat/lon, donc des colonnes x/y projetées en mètres ne sont jamais prises pour des degrés.

Ordre dans une colonne

Le WKT met toujours la longitude en premier. lnglat et lonlat veulent dire longitude d'abord. Les autres paires de texte sont lues avec la latitude d'abord, l'ordre de Google Maps, sauf si seul l'autre ordre donne des valeurs valides.

Détails techniques

Voici exactement ce que la visionneuse accepte et produit.

Entrée

Fichiers .tsv, .tab et .txt jusqu'à 50 Mo, ou texte séparé par des tabulations collé dans la zone Paste TSV. Un fichier .csv reçoit un message qui renvoie vers l'outil CSV to Map.

Encodage

UTF-8. La marque d'ordre des octets au début est retirée.

Formats de coordonnées

Degrés décimaux (48.8584, 48,8584), avec symbole de degré ou lettre d'hémisphère (48.8584° N, W 1.5115), et degrés-minutes-secondes (48°51'30"N, 48 51 30 N, 48:51.5).

Coordonnées valides

Latitude entre −90 et 90, longitude entre −180 et 180 (WGS84). Les lignes hors de ces plages sont comptées et restent hors de la carte. Les lignes qui iraient avec les deux valeurs inversées sont aussi comptées, avec un bouton Swap.

Lignes irrégulières

Les lignes avec moins de cellules que l'en-tête sont complétées par des cellules vides. Les cellules en trop reçoivent leurs propres colonnes, nommées Column N. Le panneau File indique combien de lignes étaient irrégulières.

Vue tableau

100 lignes par page, tri par n'importe quelle colonne (les nombres sont triés comme des nombres), une zone de filtre qui cherche dans toutes les cellules, et un bouton ⌖ sur chaque ligne avec coordonnées qui saute à son point.

Couleur par colonne

Toute colonne avec au plus 10 valeurs différentes peut colorer les points, avec une légende et un compte par valeur.

Export

GeoJSON avec les lignes présentes sur la carte, chaque colonne en propriété. CSV avec tout le tableau, y compris les lignes sans coordonnées.

Confidentialité

Le fichier est lu dans votre navigateur. Seules les tuiles du fond de carte viennent d'internet.

Comment ouvrir un fichier TSV, étape par étape

Voici tout le déroulement avec l'exemple intégré : 29 lieux célèbres d'Europe avec les colonnes Latitude et Longitude, dont une ligne n'a pas de coordonnées. L'étape 6 montre ce qui se passe avec un fichier dont les colonnes de coordonnées ont des noms inhabituels.

1

Étape 1: Ouvrir la visionneuse

La carte s'ouvre avec un fond routier. Utilisez Upload, Paste TSV ou glissez un fichier sur la carte. Ici, j'ai cliqué sur Sample Data.

2

Étape 2: Vérifier le fichier

Le panneau File montre la taille, le nombre de lignes et de colonnes, et si la première ligne a été lue comme noms de colonnes. 28 des 29 lignes sont sur la carte ; la ligne des lacs de Plitvice a des cellules de coordonnées vides.

3

Étape 3: Confirmer les colonnes de coordonnées

Le panneau Coordinates montre les colonnes trouvées, ici Latitude et Longitude. Vous pouvez choisir d'autres colonnes à tout moment, ou passer à « One column » pour des cellules comme "48.85, 2.29" ou POINT (2.29 48.85).

4

Étape 4: Colorer les points selon une colonne

Choisissez une colonne sous « Color by column ». Ici, Category donne à chaque type de lieu sa propre couleur, avec une légende et un compte. Cliquez sur un point pour lire sa ligne.

5

Étape 5: Passer au tableau

Cliquez sur Table pour voir toutes les lignes. Les colonnes de coordonnées sont mises en évidence. Cliquez sur un nom de colonne pour trier, tapez dans la zone de filtre pour chercher, et cliquez sur ⌖ pour aller à cette ligne sur la carte.

6

Étape 6: Un fichier sans coordonnées reconnues

Cette liste collée utilise les colonnes N et E, que la visionneuse ne traite pas comme des noms de coordonnées. Elle s'ouvre donc en tableau avec un message. Choisissez N comme latitude et E comme longitude dans le panneau Coordinates, et la carte s'ouvre.

Autres façons d'ouvrir un fichier TSV

Cette visionneuse est le moyen le plus rapide de regarder un fichier TSV. Quand le même fichier fait partie d'un travail plus large, j'utilise ces outils.

Le même travail en code

Tous les exemples utilisent le fichier d'exemple de cette page, avec les coordonnées dans les colonnes `Latitude` et `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

Mon avis : utilisez cette visionneuse pour regarder un nouveau fichier et vérifier ses coordonnées. Une fois les colonnes connues, ogr2ogr ou quelques lignes de pandas font la conversion à chaque changement des données.

Comment fonctionne la visionneuse

Voici ce qui se passe entre le dépôt d'un fichier et l'affichage de la carte ou du tableau. Chaque étape a lieu dans votre navigateur.

1. Vérifier le séparateur. Les premières lignes sont examinées pour trouver des tabulations. S'il n'y en a pas mais qu'il y a des virgules ou des points-virgules, un message indique que le fichier est probablement un CSV.
2. Découper lignes et cellules. Papa Parse découpe le texte sur les tabulations et les sauts de ligne et comprend les guillemets de style Excel. Si les guillemets cassent les lignes, le fichier est relu en traitant chaque guillemet comme du texte normal, comme dans le format TSV d'origine.
3. Trouver l'en-tête. Si la première ligne contient des nombres dans les mêmes colonnes que la deuxième, ce sont des données, et les colonnes s'appellent Column 1, Column 2, etc. Sinon, elle contient les noms des colonnes. Les noms vides sont complétés et les noms répétés reçoivent (2), (3).
4. Détecter les coordonnées. Les noms de colonnes sont nettoyés et comparés aux listes ci-dessus. Chaque paire candidate est testée sur 300 lignes au plus, et la paire avec le plus de valeurs valides gagne. Si aucune paire ne convient, les colonnes contenant les deux valeurs sont essayées.
5. Carte ou tableau. Avec des coordonnées, chaque ligne est lue en degrés décimaux ou en degrés-minutes-secondes, les lignes non valides sont comptées et les points sont dessinés sur une couche canvas. Sans coordonnées, c'est le tableau qui s'ouvre.
6. Tout modifier. Le choix de l'en-tête, les colonnes de coordonnées, l'ordre et les couleurs se changent dans la barre latérale. La carte et le tableau se mettent à jour tout de suite.

La détection n'est qu'une première proposition. Chaque choix peut être changé dans la barre latérale, donc une mauvaise proposition coûte un clic.

Lire les coordonnées : DMS, plages et précision

Les coordonnées des fichiers TSV se présentent sous plusieurs formes. Ces trois blocs expliquent comment la visionneuse les transforme en points et comment savoir si les nombres ont du sens.

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

Quand cette visionneuse est utile

Voici les situations où j'ouvre une visionneuse TSV.

1. Vérifier un téléchargement d'un portail de données. Beaucoup de portails scientifiques et publics, comme les bases de données sur la biodiversité et les noms de lieux, proposent des téléchargements en TSV. Vous voyez tout de suite où sont les enregistrements et lesquels n'ont pas de coordonnées.
2. Regarder un export de base de données. Les outils de base de données exportent souvent du texte délimité par des tabulations. Ouvrez-le en tableau, triez-le, filtrez-le et vérifiez les colonnes de position sur la carte.
3. Mettre sur la carte des cellules d'un tableur. Sélectionnez des cellules dans Excel ou Google Sheets, copiez-les et collez-les dans Paste TSV. Les lignes apparaissent sur la carte sans enregistrer de fichier.
4. Lire un fichier sans coordonnées. Tous les fichiers TSV ne sont pas géographiques. La vue tableau avec tri et filtre est un moyen rapide de lire n'importe quel fichier à tabulations sans ouvrir de tableur.
5. Convertir du TSV en CSV ou GeoJSON. Obtenez un CSV pour les outils qui ne lisent pas le TSV, ou un GeoJSON pour QGIS, ArcGIS ou une carte web.
6. Trouver des coordonnées fausses. Les comptes de valeurs manquantes, hors plage et inversées, ainsi que la carte elle-même, montrent des erreurs difficiles à voir dans une longue liste de nombres.
7. Lire des coordonnées DMS. Les listes de relevés et les données anciennes en degrés, minutes et secondes sont lues directement, sans conversion préalable.
8. Grouper les points par colonne. Colorez par type, statut ou région pour voir des tendances, par exemple quels lieux appartiennent à quelle catégorie.

Questions fréquentes

Bibliothèques et crédits

La détection des coordonnées, le lecteur DMS et le tableau ont été écrits pour ce site. La carte et la lecture du TSV utilisent des logiciels libres.

• Leaflet 1.9 · BSD-2-Clause · Volodymyr Agafonkin and contributors
  Dessine la carte interactive, la couche de points en canvas et les popups.
• Papa Parse 5 · MIT · Matt Holt and contributors
  Découpe le texte TSV en lignes et en cellules, y compris les cellules entre guillemets de style Excel.
• OpenStreetMap, Protomaps (hosted by KONAKTIVE), CARTO, Esri World Imagery · ODbL et conditions du fournisseur · OpenStreetMap contributors, Protomaps, KONAKTIVE, CARTO, Esri
  Tuiles et images du fond de carte.

Outils associés