D3js-delimiterseparated-values-api
D3.js-区切り文字区切り値API
区切り文字は、プレーンテキストまたはその他のデータの個別の独立した領域間の境界を指定するために使用される1つ以上の文字のシーケンスです。 フィールド区切り文字は、コンマで区切られた値のシーケンスです。 区切り文字で区切られた値は、カンマ区切り値(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(string [、row])
- d3.csvParseRows(string [、row])
- d3.csvFormat(rows [、columns])
- d3.csvFormatRows(rows)
- d3.tsvParse(string [、row])
- d3.tsvParseRows(string [、row])
- d3.tsvFormat(rows [、columns])
- d3.tsvFormatRows(rows)
これらの各APIメソッドを詳しく見ていきましょう。
d3.csvParse(string [、row])
このメソッドは、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(string [、row])
このメソッドは、行に相当する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(rows [、columns])
このメソッドは、csvの行と列をフォーマットするために使用されます。
例-次の例を考えてみましょう。
var string = d3.csvFormat(data, ["year", "population"]);
ここで、列が指定されていない場合、ヘッダー行を形成する列名のリストは、行内のすべてのオブジェクトのすべてのプロパティの和集合によって決定されます。 列が指定されている場合、列名を表す文字列の配列です。
d3.csvFormatRows(rows)
このメソッドは、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(string [、row])
このメソッドは、tsv形式を解析するために使用されます。 csvParseに似ています。
d3.tsvParseRows(string [、row])
このメソッドは、行に相当するtsv形式を解析するために使用されます。 csvParseRows関数に似ています。
d3.tsvFormat(rows [、columns])
このメソッドは、tsvの行と列をフォーマットするために使用されます。
d3.tsvFormatRows(rows)
このメソッドは、tsv行をフォーマットするために使用されます。