D3.js - API Nilai yang Dipisahkan Pembatas

Pembatas adalah urutan satu atau beberapa karakter yang digunakan untuk menentukan batas antara kawasan terpisah dan independen dalam teks biasa atau data lainnya. Pembatas bidang adalah urutan nilai yang dipisahkan koma. Nah, nilai yang dipisahkan pembatas adalahcomma separated values (CSV) atau tab-separated values(TSV). Bab ini menjelaskan nilai yang dipisahkan pembatas secara mendetail.

Konfigurasi API

Kita dapat dengan mudah memuat API menggunakan sintaks berikut.

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

Metode API

Berikut adalah berbagai metode API dari nilai-nilai yang dipisahkan pembatas.

d3.csvParse (string [, baris])
d3.csvParseRows (string [, baris])
d3.csvFormat (baris [, kolom])
d3.csvFormatRows(rows)
d3.tsvParse (string [, baris])
d3.tsvParseRows (string [, baris])
d3.tsvFormat (baris [, kolom])
d3.tsvFormatRows(rows)

Mari kita bahas masing-masing metode API ini secara mendetail.

d3.csvParse (string [, baris])

Metode ini digunakan untuk mengurai format csv. Pertimbangkan file tersebutdata.csv yang ditunjukkan di bawah ini.

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

Sekarang, kita dapat menerapkan fungsi yang diberikan di atas.

Example - Mari kita perhatikan contoh berikut.

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

Di sini, ini mengurai string yang ditentukan dalam nilai yang dipisahkan pembatas. Ini mengembalikan array objek yang mewakili baris yang diurai.

d3.csvParseRows (string [, baris])

Metode ini digunakan untuk mengurai format csv yang setara dengan baris.

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

Ini mem-parsing setiap baris di file csv.

d3.csvFormat (baris [, kolom])

Metode ini digunakan untuk memformat baris dan kolom csv.

Example - Mari kita perhatikan contoh berikut.

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

Di sini, jika kolom tidak ditentukan, daftar nama kolom yang membentuk baris header ditentukan oleh gabungan semua properti di semua objek dalam baris. Jika kolom ditentukan, itu adalah larik string yang mewakili nama kolom.

d3.csvFormatRows (baris)

Metode ini digunakan untuk memformat baris csv.

Example - Mari kita perhatikan contoh berikut.

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

Di sini, ini memformat larik baris string yang ditentukan sebagai nilai yang dipisahkan pembatas, mengembalikan string.