D3.js: API de valores separados por delimitadores

Un delimitador es una secuencia de uno o más caracteres que se usa para especificar el límite entre regiones separadas e independientes en texto sin formato u otros datos. Un delimitador de campo es una secuencia de valores separados por comas. Bueno, los valores separados por delimitadores soncomma separated values (CSV) o tab-separated values(TSV). Este capítulo explica en detalle los valores separados por delimitadores.

Configuración de API

Podemos cargar fácilmente la API usando la siguiente sintaxis.

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

Métodos API

A continuación se muestran los diversos métodos de API de los valores separados por delimitadores.

• d3.csvParse (cadena [, fila])
• d3.csvParseRows (cadena [, fila])
• d3.csvFormat (filas [, columnas])
• d3.csvFormatRows(rows)
• d3.tsvParse (cadena [, fila])
• d3.tsvParseRows (cadena [, fila])
• d3.tsvFormat (filas [, columnas])
• d3.tsvFormatRows(rows)

Repasemos cada uno de estos métodos API en detalle.

d3.csvParse (cadena [, fila])

Este método se utiliza para analizar el formato csv. Considere el archivodata.csv que se muestra a continuación.

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

Ahora, podemos aplicar la función dada anteriormente.

Example - Consideremos el siguiente ejemplo.

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

Aquí, analiza la cadena especificada en los valores separados por delimitadores. Devuelve una matriz de objetos que representan las filas analizadas.

d3.csvParseRows (cadena [, fila])

Este método se utiliza para analizar el formato csv equivalente a filas.

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

Analiza cada fila en el archivo csv.

d3.csvFormat (filas [, columnas])

Este método se utiliza para formatear las filas y columnas de csv.

Example - Consideremos el siguiente ejemplo.

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

Aquí, si no se especifican las columnas, la lista de nombres de columna que forma la fila de encabezado está determinada por la unión de todas las propiedades en todos los objetos de las filas. Si se especifican columnas, es una matriz de cadenas que representan los nombres de las columnas.

d3.csvFormatRows (filas)

Este método se utiliza para formatear las filas csv.

Example - Consideremos el siguiente ejemplo.

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

Aquí, formatea la matriz especificada de filas de cadenas como valores separados por delimitadores y devuelve una cadena.

d3.tsvParse (cadena [, fila])

Este método se utiliza para analizar el formato tsv. Es similar a csvParse.

d3.tsvParseRows (cadena [, fila])

Este método se utiliza para analizar el formato tsv equivalente a filas. Es similar a la función csvParseRows.

d3.tsvFormat (filas [, columnas])

Este método se utiliza para formatear las filas y columnas de tsv.

d3.tsvFormatRows (filas)

Este método se utiliza para formatear las filas tsv.