D3.js - API de valeurs séparées par des délimiteurs

Un délimiteur est une séquence d'un ou de plusieurs caractères utilisée pour spécifier la limite entre des régions séparées et indépendantes dans du texte brut ou d'autres données. Un délimiteur de champ est une séquence de valeurs séparées par des virgules. Eh bien, les valeurs séparées par des délimiteurs sontcomma separated values (CSV) ou tab-separated values(TSV). Ce chapitre explique en détail les valeurs séparées par des séparateurs.

Configurer l'API

Nous pouvons facilement charger l'API en utilisant la syntaxe suivante.

<script src = "https://d3js.org/d3-dsv.v1.min.js"></script>
<script>
   var data = d3.csvParse(string);
</script>

Méthodes API

Voici les différentes méthodes API des valeurs séparées par des délimiteurs.

d3.csvParse (chaîne [, ligne])
d3.csvParseRows (chaîne [, ligne])
d3.csvFormat (lignes [, colonnes])
d3.csvFormatRows(rows)
d3.tsvParse (chaîne [, ligne])
d3.tsvParseRows (chaîne [, ligne])
d3.tsvFormat (lignes [, colonnes])
d3.tsvFormatRows(rows)

Passons en revue chacune de ces méthodes API en détail.

d3.csvParse (chaîne [, ligne])

Cette méthode est utilisée pour analyser le format csv. Considérez le fichierdata.csv qui est montré ci-dessous.

year,population
2006,40
2008,45
2010,48
2012,51
2014,53
2016,57
2017,62

Maintenant, nous pouvons appliquer la fonction ci-dessus.

Example - Prenons l'exemple suivant.

var data = d3.csvParse(string, function(d) {
   return {
      year: new Date(+d.Year, 0, 1), // lowercase and convert "Year" to Date
      population: d.population
   };
});

Ici, il analyse la chaîne spécifiée dans les valeurs séparées par un séparateur. Il renvoie un tableau d'objets représentant les lignes analysées.

d3.csvParseRows (chaîne [, ligne])

Cette méthode est utilisée pour analyser le format csv équivalent aux lignes.

var data = d3.csvParseRows(string, function(d, i) {
   return {
      year: new Date(+d[0], 0, 1), // convert first colum column to Date
      population: d[1],
   };
});

Il analyse chaque ligne du fichier csv.

d3.csvFormat (lignes [, colonnes])

Cette méthode est utilisée pour formater les lignes et colonnes csv.

Example - Prenons l'exemple suivant.

var string = d3.csvFormat(data, ["year", "population"]);

Ici, si les colonnes ne sont pas spécifiées, la liste des noms de colonne qui forme la ligne d'en-tête est déterminée par l'union de toutes les propriétés de tous les objets des lignes. Si des colonnes sont spécifiées, il s'agit d'un tableau de chaînes représentant les noms de colonnes.

d3.csvFormatRows (lignes)

Cette méthode est utilisée pour formater les lignes csv.

Example - Prenons l'exemple suivant.

var string = d3.csvFormatRows(data.map(function(d, i) {
   return [
      d.year.getFullYear(), // Assuming d.year is a Date object.
      d.population
   ];
}));

Ici, il met en forme le tableau spécifié de lignes de chaînes en tant que valeurs séparées par des délimiteurs, renvoyant une chaîne.