簇布局
最后更新于：2022-04-01 11:11:47
> [Wiki](Home) ▸ [[API--中文手册]] ▸ [[布局]] ▸ **簇布局**
* 如发现翻译不当或有其他问题可以通过以下方式联系译者:
* 邮箱：zhang_tianxu@sina.com
* QQ群：[D3数据可视化](http://jq.qq.com/?_wv=1027&k=ZGcqYF)205076374，[大数据可视化](http://jq.qq.com/?_wv=1027&k=S8wGMe)436442115
簇布局可以产生树状图：将树的叶节点放在同一深度的节点连接图。例如，簇布局可以用来在软件包层次结构中组织类：
同D3中的其他类一样，布局遵循方法链模式，在该模式下setter方法返回布局本身，允许使用简单语句调用多个setter。
# d3.layout.cluster()
使用默认设置创建新的簇布局：默认排序为空；默认子访问器假定每个输入数据为带子数组的对象；默认分离函数在同层级使用一个节点宽度，在不同层级使用两个节点宽度；默认尺寸为1×1。
# cluster(root)
# cluster.nodes(root)
运行簇布局，返回节点数组及指定的根节点。簇数组为D3分层布局家族的一部分。这些布局具有相同的基本结构：布局的输入参数为分层的根节点，输出返回值为一个数组，表示计算过的所有节点的位置。每个节点都有各自属性：
• 上层-父节点，在根节点时为空。
• 下层-子节点数组，在叶节点时为空。
• 深度-节点深度，从根节点计算，值从0开始。
• x-节点位置的x坐标值。
• y-节点位置的y坐标。
虽然布局在x和y轴有值存在，但这表示一个任意坐标系；例如，可以将x坐标视为直径，将y坐标当做角，从而形成一个射线，而非笛卡尔坐标系布局。
# cluster.links(nodes)
指定节点数组，如以节点形式返回的数组，返回对象节点表示每个节点中父节点同子节点之间的关系。叶节点没有任何关系。每个节点都是一个具有两个属性的对象：
source -父节点（如上述所示）。
target -子节点。
该方法在获取一组关系描述时很有效果，通常与对角图形生成器共同使用。例如：
svg.selectAll("path")
.data(cluster.links(nodes))
.enter().append("path")
.attr("d", d3.svg.diagonal());
# cluster.children([children])
如果子节点已经指定，则设定子节点访问器函数。如未指定，则返回当前子节点访问器函数，该函数将输入数据默认为带子数组的对象：
functionchildren(d){
returnd.children;
}
通常，使用d3.json可以方便地加载节点分层，并将输入分层表示为一个嵌套JSON对象。例如：
{
"name":"flare",
"children":[
{
"name":"analytics",
"children":[
{
"name":"cluster",
"children":[
{"name":"AgglomerativeCluster","size":3938},
{"name":"CommunityStructure","size":3812},
{"name":"MergeEdge","size":743}
]
},
{
"name":"graph",
"children":[
{"name":"BetweennessCentrality","size":3534},
{"name":"LinkDistance","size":5731}
]
}
]
}
]
}
在分层中，子访问器在根节点首先被调用。如果访问器返回值为空，则该节点在布局遍历结束时被假定为叶节点。否则，访问器需要返回数据元素数组，来表示子节点。
# cluster.sort([comparator])
如已指定comparator，则使用指定的comparator函数设置布局中同级节点排序顺序。如comparator未指定，则返回当前分组的排序顺序，默认值为空。为每对节点，调用comparator函数。 comparator的默认值为空，此时采用三种遍历顺序，排序被禁用。例如，按照输入数据的字符串名对同层节点以降序顺序排序，即：
functioncomparator(a,b){
returnd3.ascending(a.name,b.name);
}
See d3.ascending or d3.descending for details.
详见：d3.ascending或d3.descending
# cluster.separation([separation])
如果已经指定separation，使用指定的函数计算相邻节点的间距。如果未指定separation，则返回当前间距函数。默认情况下，该函数为：
存在一个更加适合于射线布局的变动，可以根据直径大小相应减少间距：
functionseparation(a,b){
return(a.parent==b.parent?1:2)/a.depth;
}
两个相邻节点a和b传递到separation函数，且必须返回节点间期望的间距。节点通常是同级的，虽然，这些节点也可能属于相近关系（或更远的关系），如果布局将这些节点临近放置的话。
# cluster.size([size])
如果已经指定size，则将可用布局尺寸设定为指定的二元数组，以x和y来表示。如果尺寸没有指定，则返回当前尺寸，默认值为1×1，如果nodeSize正在使用中，则默认值为空。虽然布局在x和y轴都有数值，但该坐标系可以是任意坐标系。例如，创建一个射线布局，其中树的广度（x）用角度来测量, 树的深度（y）表示半径r, 单位为像素，即 [360, r]。
# cluster.nodeSize([nodeSize])
如果nodeSize已经指定，以二元数组x和y的形式返回每个节点的固定尺寸。如果nodeSize没有指定，则返回当前节点尺寸，默认值为空，表示布局尺寸总体固定，可以使用size来获得。
# cluster.value([value])
如果已经指定value，则用指定的函数设定值访问器。如果尚未指定value，则返回当前值访问器，默认值为空，表示值属性没有计算。指定之后，每次输入数据元，都会调用值访问器，并且必须返回一个用以表示节点数值的数字。该值对集群布局没有影响，但它是分层布局所提供的通用功能。
* 张烁译 20140430
* 咕噜校对 2014-11-30 10:42:08