Nitrate Processed Mincemeat
    Wondering what’s next for npm?Check out our public roadmap! »

    d3-force-constant

    1.1.1 • Public • Published

    d3.forceConstant

    NPM

    A constant acceleration force type for the d3-force simulation engine.

    This force accelerates nodes in a particular direction by a constant amount at each tick. Both the force strength and the direction can be set custom per node, or global for all the nodes equally.

    It can be used, for example to simulate weight caused by earth's gravity (constant acceleration pointing down), as well as wind blowing or a current flowing in an arbitrary direction.

    This force plugin is also compatible with d3-force-3d and can function in a one, two (default) or three dimensional space.

    Quick start

    import d3ForceConstant from 'd3-force-constant';
    

    or

    d3.forceConstant = require('d3-force-constant');
    

    or even

    <script src="//unpkg.com/d3-force-constant"></script>
    

    then

    d3.forceSimulation()
        .nodes(<myNodes>)
        .force('gravity', d3.forceConstant()
            .strength(0.5)
            .direction(90)   
        );
    

    API reference

    Method Description Default
    strength([num or fn]) Getter/setter for the node object strength accessor function (fn(node)) or a constant (num) for all nodes. This represents the strength of the force, in terms of velocity deltas per tick, i.e. px/tick^2. 1
    direction([num or fn]) Getter/setter for the node object direction accessor function (fn(node)) or a constant (num) for all nodes. This defines the orientation of the force in the XY plane in degrees, with 0 representing only X increases (rightwards in SVG convention) and 90 only Y increases (downwards). 90
    zAngle([num or fn]) Getter/setter for the node object Z axis angle accessor function (fn(node)) or a constant (num) for all nodes. Mainly applicable in 3D scenarios when using d3-force-3d. This defines the angle of the force in degrees against the XY plane, with 0 indicating parallel (no Z influence) and -90 (far) / 90 (near) perpendicular (direction has no effect in this case). Values below -90 or above 90 invert direction on the XY plane. 0

    Install

    npm i d3-force-constant

    DownloadsWeekly Downloads

    19

    Version

    1.1.1

    License

    MIT

    Unpacked Size

    146 kB

    Total Files

    25

    Last publish

    Collaborators

    • avatar