Учебники

D3.js — API с разделителями-значениями

Декабрь 25, 2018

Разделитель — это последовательность из одного или нескольких символов, используемая для указания границы между отдельными независимыми областями в виде простого текста или других данных. Разделитель полей — это последовательность значений, разделенных запятыми. Ну, значения, разделенные разделителем, являются значениями, разделенными запятыми (CSV), или значениями, разделенными табуляцией (TSV). В этой главе подробно рассматриваются значения, разделенные разделителем.

Конфигурирование 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 (row [, columns])
  • d3.csvFormatRows (строки)
  • d3.tsvParse (строка [, строка])
  • d3.tsvParseRows (строка [, строка])
  • d3.tsvFormat (row [, columns])
  • d3.tsvFormatRows (строки)

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

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

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

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

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

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

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 (row [, columns])

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

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

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

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

d3.csvFormatRows (строки)

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

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

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

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

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

Этот метод используется для разбора формата TSV. Это похоже на csvParse.

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

Этот метод используется для анализа формата tsv, эквивалентного строкам. Это похоже на функцию csvParseRows.

d3.tsvFormat (row [, columns])

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

d3.tsvFormatRows (строки)

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

43
Share: