D3.js - API de valores separados por delimitador

Um delimitador é uma sequência de um ou mais caracteres usados para especificar o limite entre regiões separadas e independentes em texto simples ou outros dados. Um delimitador de campo é uma sequência de valores separados por vírgula. Bem, valores separados por delimitadores sãocomma separated values (CSV) ou tab-separated values(TSV). Este capítulo explica os valores separados por delimitador em detalhes.

Configurando API

Podemos carregar facilmente a API usando a seguinte sintaxe.

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

Métodos API

A seguir estão os vários métodos de API dos valores separados por delimitador.

d3.csvParse (string [, linha])
d3.csvParseRows (string [, linha])
d3.csvFormat (linhas [, colunas])
d3.csvFormatRows(rows)
d3.tsvParse (string [, linha])
d3.tsvParseRows (string [, linha])
d3.tsvFormat (linhas [, colunas])
d3.tsvFormatRows(rows)

Vamos examinar cada um desses métodos de API em detalhes.

d3.csvParse (string [, linha])

Este método é usado para analisar o formato csv. Considere o arquivodata.csv isso é mostrado abaixo.

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

Agora, podemos aplicar a função fornecida acima.

Example - Vamos considerar o seguinte exemplo.

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

Aqui, ele analisa a string especificada nos valores separados por delimitador. Ele retorna uma matriz de objetos que representam as linhas analisadas.

d3.csvParseRows (string [, linha])

Este método é usado para analisar o formato csv equivalente a linhas.

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

Ele analisa cada linha no arquivo csv.

d3.csvFormat (linhas [, colunas])

Este método é usado para formatar as linhas e colunas csv.

Example - Vamos considerar o seguinte exemplo.

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

Aqui, se as colunas não forem especificadas, a lista dos nomes das colunas que formam a linha do cabeçalho é determinada pela união de todas as propriedades em todos os objetos nas linhas. Se as colunas forem especificadas, é uma matriz de strings que representa os nomes das colunas.

d3.csvFormatRows (linhas)

Este método é usado para formatar as linhas csv.

Example - Vamos considerar o seguinte exemplo.

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

Aqui, ele formata a matriz especificada de linhas de string como valores separados por delimitador, retornando uma string.