D3.js - API dei valori separati da delimitatori

Un delimitatore è una sequenza di uno o più caratteri utilizzata per specificare il confine tra regioni separate e indipendenti in testo normale o altri dati. Un delimitatore di campo è una sequenza di valori separati da virgole. Bene, i valori separati da delimitatore sonocomma separated values (CSV) o tab-separated values(TSV). Questo capitolo spiega in dettaglio i valori separati da delimitatori.

Configurazione dell'API

Possiamo facilmente caricare l'API utilizzando la seguente sintassi.

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

Metodi API

Di seguito sono riportati i vari metodi API dei valori separati da delimitatori.

  • d3.csvParse (stringa [, riga])
  • d3.csvParseRows (stringa [, riga])
  • d3.csvFormat (righe [, colonne])
  • d3.csvFormatRows(rows)
  • d3.tsvParse (stringa [, riga])
  • d3.tsvParseRows (stringa [, riga])
  • d3.tsvFormat (righe [, colonne])
  • d3.tsvFormatRows(rows)

Esaminiamo in dettaglio ciascuno di questi metodi API.

d3.csvParse (stringa [, riga])

Questo metodo viene utilizzato per analizzare il formato csv. Considera il filedata.csv quello è mostrato sotto.

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

Ora possiamo applicare la funzione sopra indicata.

Example - Consideriamo il seguente esempio.

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

Qui, analizza la stringa specificata nei valori separati da delimitatori. Restituisce un array di oggetti che rappresentano le righe analizzate.

d3.csvParseRows (stringa [, riga])

Questo metodo viene utilizzato per analizzare il formato csv equivalente alle righe.

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],
   };
});

Analizza ogni riga nel file csv.

d3.csvFormat (righe [, colonne])

Questo metodo viene utilizzato per formattare le righe e le colonne csv.

Example - Consideriamo il seguente esempio.

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

Qui, se le colonne non sono specificate, l'elenco dei nomi delle colonne che forma la riga di intestazione è determinato dall'unione di tutte le proprietà su tutti gli oggetti nelle righe. Se vengono specificate colonne, si tratta di un array di stringhe che rappresentano i nomi delle colonne.

d3.csvFormatRows (righe)

Questo metodo viene utilizzato per formattare le righe csv.

Example - Consideriamo il seguente esempio.

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

Qui, formatta l'array specificato di righe di stringa come valori separati da delimitatori, restituendo una stringa.

d3.tsvParse (stringa [, riga])

Questo metodo viene utilizzato per analizzare il formato tsv. È simile a csvParse.

d3.tsvParseRows (stringa [, riga])

Questo metodo viene utilizzato per analizzare il formato tsv equivalente alle righe. È simile alla funzione csvParseRows.

d3.tsvFormat (righe [, colonne])

Questo metodo viene utilizzato per formattare le righe e le colonne tsv.

d3.tsvFormatRows (righe)

Questo metodo viene utilizzato per formattare le righe tsv.