d3fc 组

用于操控 CSV / TSV 数据的功能,用于渲染分组序列.

主要 D3FC 软件包

安装

npm install @d3fc/d3fc-group

API 参考

API 概况

这个 d3 - dsv (英语) 软件包提供一些用于解析分隔器分隔值的功能,例如逗号分隔(CSV)或分页分隔(TSV). 由于 DSV 输入,这些解析器会产生一系列对象,其属性与列相对应.

例如,使用来自 此 D3 实例,一个简单的 CSV 解析如下:

const data = d3.csvParse(
    `State,Under 5 Years,5 to 13 Years
    AL,310,552
    AK,52,85
    AZ,515,828`);

形成以下结构:

[
   {'State': 'AL', 'Under 5 Years': '310', '5 to 13 Years': '552' },
   {'State': 'AK', 'Under 5 Years': '52', '5 to 13 Years': '85' },
   {'State': 'AZ', 'Under 5 Years': '515', '5 to 13 Years': '828' }
];

组分部分采用这个结构,并把它操纵成一个更适合使每行在组图中成为单个序列的形式.

以下是如何将组组件应用于上述产出:

const group = fc.group()
  .key('State');
const grouped = group(data);

默认的组取向是"垂直",它为每个列创建了"序列",而不是代表键的一列. 以此为例,纵向组如下:

[
  [["AL", 310], ["AK", 52], ["AZ", 515]],
  [["AL", 552], ["AK", 85], ["AZ", 828]]
]

这种结构与输出非常类似 d3. 装订 并适合渲染成组系列,在此情况下按状态分组.

每个系列的密钥为: 系列.key和每个点的输入数据元素作为 点数据.

const group = fc.group()
  .key('State');
const grouped = group(data);
// [
//   [["AL", 310], ["AK", 52], ["AZ", 515]],
//   [["AL", 552], ["AK", 85], ["AZ", 828]]
// ]

// each series has a key property
grouped[0].key // 'Under 5 Years'
grouped[1].key // '5 to 13 Years'

// and each data element has a data property:
grouped[0][0].data //  {'State': 'AL', 'Under 5 Years': '310', '5 to 13 Years': '552' }

如以下例子所示,您也可以进行横向分组:

const group = fc.group()
  .orient('horizontal')
  .key('State');
const grouped = group(data);

它为每行创建一个序列,在这种情况下允许按年龄段分组:

[
  [["Under 5 Years", 310], ["5 to 13 Years", 552]],
  [["Under 5 Years", 52 ], ["5 to 13 Years", 85 ]],
  [["Under 5 Years", 515], ["5 to 13 Years", 828]]
]

API 密码

{\fn方正粗倩简体\fs12\an8\1cHFFFF00\b0} 页:1.组(a) 与《公约》有关的其他事项

构造带有默认设置的新组生成器.

{\fn方正粗倩简体\fs12\an8\1cHFFFF00\b0} 组。 。 。 .键(单位:千美元)键值(中文(简体) )

若为 键值 ,设置代表密钥的DSV数据中的列名称。 若为 键值 未指定,返回当前密钥.

{\fn方正粗倩简体\fs12\an8\1cHFFFF00\b0} 组。 。 。 .价值(单位:千美元)数值Func(中文(简体) )

若为 数值Func ,设置用于获取特定行/列值的存取器函数。 若为 数值Func 未指定,返回当前访问器.

每次组组件获得单元格值时,都会引用访问器。 这个 valueFunc(row, column) 函数与当前行(由DSV parser提供)和列名一起被引用。 此存取器函数的默认执行将所有单元格值强制变为数字实例 .

{\fn方正粗倩简体\fs12\an8\1cHFFFF00\b0} 组。 。 。 .东方(单位:千美元)方向(中文(简体) )

若为 方向 指定组合操作的方向。 若为 方向 未指定,返回当前方向.