Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/vasturiano/d3-force-bounce
An elastic collision force type for the d3-force simulation engine
https://github.com/vasturiano/d3-force-bounce
collision d3js elastic-collisions force force-directed-graphs physics-simulation
Last synced: 10 days ago
JSON representation
An elastic collision force type for the d3-force simulation engine
- Host: GitHub
- URL: https://github.com/vasturiano/d3-force-bounce
- Owner: vasturiano
- License: mit
- Created: 2017-05-05T18:34:51.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2023-02-10T17:51:21.000Z (almost 2 years ago)
- Last Synced: 2024-10-26T18:45:17.450Z (17 days ago)
- Topics: collision, d3js, elastic-collisions, force, force-directed-graphs, physics-simulation
- Language: JavaScript
- Homepage:
- Size: 136 KB
- Stars: 17
- Watchers: 5
- Forks: 3
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
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](https://github.com/d3/d3-force#forceCollide), but allows for fully elastic collisions that [conserve kinetic energy](https://en.wikipedia.org/wiki/Momentum#Elastic_collisions). 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](https://observablehq.com/@vasturiano/collision-forces-comparison) between the two forces.
It can be used, for example to [simulate particle collisions](https://observablehq.com/@vasturiano/entropy) or in a [Newton's cradle](https://observablehq.com/@vasturiano/newtons-cradle).
See also [d3.forceSurface](https://github.com/vasturiano/d3-force-surface).
## 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
[](https://www.paypal.com/cgi-bin/webscr?cmd=_donations&business=L398E7PKP47E8¤cy_code=USD&source=url) If this project has helped you and you'd like to contribute back, you can always [buy me a ☕](https://www.paypal.com/cgi-bin/webscr?cmd=_donations&business=L398E7PKP47E8¤cy_code=USD&source=url)!
[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