博客
关于我
d3.js v4 Force官方API
阅读量:123 次
发布时间:2019-02-26

本文共 3109 字,大约阅读时间需要 10 分钟。

d3的力导图运用了速度表示的韦尔莱算法。

  • d3.forceSimulation(nodes):使用指定的nodes数组创建一个新的simulation,但不含引力(with no forces)。如果未指定nodes,默认为空数组。模拟器会自动执行;使用simulation.on在模拟运行时监听tick事件。如果希望手动运行模拟,需要调用simulation.stop,然后根据需要调用simulation.tick。

  • simulation.restart():重新启动内部计时器并返回simulation对象。结合simulation.alphaTarget或simulation.alpha,此方法可用于在交互期间“重新加热”模拟,例如拖动节点时,或在暂时将模拟与simulation.stop后恢复模拟。

  • simulation.stop():停止模拟的内部计时器(如果它正在运行)并返回模拟。 如果计时器已经停止,则此方法不执行任何操作。 此方法对于手动运行模拟非常有用; 见simulation.tick。

  • simulation.tick(iterations):通过指定的迭代次数手动执行模拟,并返回模拟。如果未指定迭代,则默认为1(单步)。对于每一次迭代,通过 (alphaTarget - alpha) × alphaDecay增加当前的alpha,并调用force。 然后通过velocity×velocityDecay递减每个节点的速度; 最后通过速度递增每个节点的位置。此方法可与simulation.stop结合使用以计算静态力布局。 对于大型图形,应在Web worker中计算静态布局,以避免冻结用户界面。

  • simulation.nodes(nodes):如果指定了节点,则将模拟的节点设置为指定的对象数组,必要时初始化它们的位置和速度,然后重新初始化forces,返回simulation对象。 如果未指定nodes,则返回指定给构造函数的模拟节点数组。每一个node必须是一个对象,simulation会给节点分配一下属性:index  - 节点从零开始的节点索引;x  - 节点的当前x位置;y  - 节点的当前y位置;vx  - 节点的当前x速度;vy  - 节点的当前y速度。随后可以通过力和模拟来修改位置〈x,y〉和速度〈vx,vy〉。 如果vx或vy是NaN,则速度初始化为〈0.0〉。 如果x或y是NaN,则位置以叶序排列初始化,这样做是为了确保节点在原点周围的均匀分布。要在给定位置固定节点,可以指定另外两个属性:fx  - 节点的固定x位置;fy  - 节点的固定y位置。

           在每一次tick结束,运用了force之后,节点的fx会固定,并且同时会将node.x设置为这个值,node.vx设为0;y坐标同理。所以要解除固定的节点使它再次移动,需要把fx和fy             设置为null,或者干脆删除这两个属性。

           如果nodes数组有改变,需要再次调用simulation.nodes方法来通知simulation和绑定新的forces。

  • simulation.alpha(alpha):如果指定了alpha,则将当前alpha设置为[0,1]范围内的指定数字并返回此模拟。 如果未指定alpha,则返回当前alpha值,默认值为1。

  • simulation.alphaMin(min):如果指定了min,则将最小alpha设置为[0,1]范围内的指定数字并返回此模拟。 如果未指定min,则返回当前最小alpha值,默认值为0.001。 当前alpha小于最小alpha时,模拟的内部计时器停止。 默认的α衰减率~0.0228对应于300次迭代。

  • simulation.alphaDecay(decay):如果指定了衰减,则将alpha衰减率设置为[0,1]范围内的指定数字并返回此模拟。 如果未指定衰减,则返回当前的alpha衰减率,默认为0.0228 ... = 1  -  pow(0.001,1 / 300),其中0.001是默认的最小alpha。默认的目标alpha为0,则这个参数控制的是冷却速度。较高的衰减率会使模拟更快地稳定,但有可能陷入局部最小值; 较低的值会导致模拟运行时间更长,但通常会收敛到更好的布局。 要使模拟永远在当前alpha运行,请将衰减率设置为零; 或者,将目标alpha设置为大于最小alpha。

  • simulation.alphaTarget(target):如果指定了target,则将当前目标alpha设置为[0,1]范围内的指定数字并返回此模拟。 如果未指定target,则返回当前目标alpha值,默认值为0。

  • simulation.velocityDecay(decay):如果指定了衰减,则将速度衰减因子设置为[0,1]范围内的指定数字并返回此模拟。 如果未指定衰减,则返回当前速度衰减因子,默认值为0.4。 衰变因子类似于大气摩擦; 在每一次tick之后,每个节点的速度乘以(1  - 衰减率)。 与降低alpha衰变速率一样,较小的速度衰减率可能会收敛于更好的解决方案,但存在数值不稳定性和振荡的风险。

  • simulation.force(name[, force]):如果指定了force,则为指定的名称分配force并返回此模拟。 如果未指定force,则返回具有指定名称的force,如果没有此类force,则返回undefined。 (默认情况下,新的simulation没有force)例如,要创建新的模拟来布局图形:

var simulation = d3.forceSimulation(nodes)    .force("charge", d3.forceManyBody())    .force("link", d3.forceLink(links))    .force("center", d3.forceCenter());要删除对应的force,就往对应的name传nullsimulation.force("charge", null);
  • simulation.find(x, y[, radius]):返回与给定搜索半径最接近位置〈x,y〉的节点。 如果未指定radius,则默认为无穷大。 如果搜索区域内没有节点,则返回undefined。

  • simulation.on(typenames, [listener]):如果指定了listener,则为指定的类型名设置事件侦听器并返回此模拟。 如果事件侦听器已经注册了相同的类型和名称,则在添加新侦听器之前将删除现有侦听器。 如果listener为null,则删除指定类型名称的当前事件侦听器(如果有)。 如果未指定侦听器,则返回与指定的类型名匹配的第一个当前分配的侦听器(如果有)。 调度指定的事件时,将使用此上下文作为模拟调用每个侦听器。

       类型名是一个包含一个或多个由空格分隔的类型名的字符串。 每个typename都是一个类型,可选地后跟一个句点(.)和一个名字,例如tick.foo和tick.bar; 该名称允许多个               侦听器注册相同的类型。 类型必须是以下之一:tick  - 在模拟内部计时器的每个tick之后。end - 模拟的计时器在alpha <alphaMin时停止。手动调用simulation.tick事件不               会触发tick事件,事件仅由内部计时器调度,用于模拟的交互式渲染。 要影响模拟,要注册force而不是修改节点事件侦听器内的节点位置或速度。

转载地址:http://lpoy.baihongyu.com/

你可能感兴趣的文章
Mysql 分页
查看>>
Mysql 分页语句 Limit原理
查看>>
MySql 创建函数 Error Code : 1418
查看>>
MySQL 创建新用户及授予权限的完整流程
查看>>
mysql 创建表,不能包含关键字values 以及 表id自增问题
查看>>
mysql 删除日志文件详解
查看>>
mysql 判断表字段是否存在,然后修改
查看>>
MySQL 到底能不能放到 Docker 里跑?
查看>>
mysql 前缀索引 命令_11 | Mysql怎么给字符串字段加索引?
查看>>
mysql 协议的退出命令包及解析
查看>>
mysql 取表中分组之后最新一条数据 分组最新数据 分组取最新数据 分组数据 获取每个分类的最新数据
查看>>
mysql 四种存储引擎
查看>>
MySQL 基础模块的面试题总结
查看>>
MySQL 备份 Xtrabackup
查看>>
mysql 多个表关联查询查询时间长的问题
查看>>
mySQL 多个表求多个count
查看>>
mysql 多字段删除重复数据,保留最小id数据
查看>>
MySQL 多表联合查询:UNION 和 JOIN 分析
查看>>
MySQL 大数据量快速插入方法和语句优化
查看>>
mysql 如何给SQL添加索引
查看>>