D3.js - API значений, разделенных разделителями

Разделитель - это последовательность из одного или нескольких символов, используемых для определения границы между отдельными независимыми областями в тексте или других данных. Разделитель полей - это последовательность значений, разделенных запятыми. Ну, значения, разделенные разделителями,comma separated values (CSV) или tab-separated values(ТСВ). В этой главе подробно объясняются значения, разделенные разделителями.

Настройка API

Мы можем легко загрузить API, используя следующий синтаксис.

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

Методы API

Ниже приведены различные методы API значений, разделенных разделителями.

d3.csvParse (строка [, строка])
d3.csvParseRows (строка [, строка])
d3.csvFormat (строки [, столбцы])
d3.csvFormatRows(rows)
d3.tsvParse (строка [, строка])
d3.tsvParseRows (строка [, строка])
d3.tsvFormat (строки [, столбцы])
d3.tsvFormatRows(rows)

Давайте подробно рассмотрим каждый из этих методов API.

d3.csvParse (строка [, строка])

Этот метод используется для анализа формата csv. Рассмотрим файлdata.csv это показано ниже.

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

Теперь мы можем применить данную функцию.

Example - Рассмотрим следующий пример.

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

Здесь он анализирует указанную строку в значениях, разделенных разделителями. Он возвращает массив объектов, представляющих проанализированные строки.

d3.csvParseRows (строка [, строка])

Этот метод используется для синтаксического анализа формата csv, эквивалентного строкам.

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

Он анализирует каждую строку в файле csv.

d3.csvFormat (строки [, столбцы])

Этот метод используется для форматирования строк и столбцов CSV.

Example - Рассмотрим следующий пример.

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

Здесь, если столбцы не указаны, список имен столбцов, образующих строку заголовка, определяется объединением всех свойств всех объектов в строках. Если указаны столбцы, это массив строк, представляющих имена столбцов.

d3.csvFormatRows (строки)

Этот метод используется для форматирования строк csv.

Example - Рассмотрим следующий пример.

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

Здесь он форматирует указанный массив строковых строк как значения, разделенные разделителями, возвращая строку.