簇布局

最后更新于: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
';