d3-force-bounce

d3.forceBounce
==============

[![NPM package][npm-img]][npm-url]
[![Build Size][build-size-img]][build-size-url]
[![NPM Downloads][npm-downloads-img]][npm-downloads-url]

An elastic collision force type for the d3-force simulation engine.

This force is similar to d3.forceCollide, but allows for fully elastic collisions that conserve kinetic energy. This makes d3.forceCollide appropriate for preventing the overlap of nodes, and d3.forceBounce better suited when the intent is to achieve an elastic collision effect, with varying degrees of elasticity (coefficient of restitution).

Here's a visual comparison between the two forces.

It can be used, for example to simulate particle collisions or in a Newton's cradle.

See also d3.forceSurface.

Quick start

``js
import d3ForceBounce from 'd3-force-bounce';
`
or using a script tag
`html

`
then
`js
d3.forceSimulation()
.nodes()
.force('bounce', d3.forceBounce()
.radius(5)
);
`

API reference

| Method | Description | Default |
| ------------------ | -------------------------------------------------------------------------------------------------------------------------- | ------------- |
| elasticity([number]) | Getter/setter for every collision's coefficient of restitution, aka elasticity. A value of 1 represents a purely elastic collision with no energy loss, while a 0 will fully eliminate the bounce in the collision direction. Values >1 can be used to introduce acceleration at each collision. Values <0 are not recommended. | 1 |
| radius([num or fn]) | Getter/setter for the node object radius accessor function (fn(node)) or a constant (num) for all nodes. | 1 |
| mass([num or fn]) | Getter/setter for the node object mass accessor function (fn(node)) or a constant (num) for all nodes. Mass affects the symmetry of the energy transfer between two colliding nodes. By default it is proportional to the node's area. | Math.pow(radius(node), 2) |
| onImpact([fn]) | Callback function triggered at every collision, with the signature onImpact(node1, node2)` ||

Giving Back

 If this project has helped you and you'd like to contribute back, you can always buy me a ☕!

[npm-img]: https://img.shields.io/npm/v/d3-force-bounce
[npm-url]: https://npmjs.org/package/d3-force-bounce
[build-size-img]: https://img.shields.io/bundlephobia/minzip/d3-force-bounce
[build-size-url]: https://bundlephobia.com/result?p=d3-force-bounce
[npm-downloads-img]: https://img.shields.io/npm/dt/d3-force-bounce
[npm-downloads-url]: https://www.npmtrends.com/d3-force-bounce