d3.js v4 Force官方API

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传null

simulation.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而不是修改节点事件侦听器内的节点位置或速度。