Create piecewise linear scales à la d3:
Although continuous scales typically have two values each in their domain and range, specifying more than two values produces a piecewise scale.
- Supports domains and ranges with more than two values each.
- Supports clamping to range.
- No dependencies.
For many more features, see d3-scale.
For an even simpler version that does not support multiple piecewise scales, see simple-linear-scale.
As a Node.js module:
$ yarn add polylinear-scale
# or
$ npm install polylinear-scale
CDN version:
<!-- Minified -->
<script src="https://unpkg.com/polylinear-scale/dist/polylinear-scale.min.js"></script>
<!-- Un-minified -->
<script src="https://unpkg.com/polylinear-scale/dist/polylinear-scale.js"></script>
domain (Array)
: The input domain (default is[0, 1]
).range (Array)
: The output range (default is[0, 1]
).clamp (Boolean)
: Enable or disable clamping (default isfalse
).
(Function)
: The resulting scaling function.
const polylinearScale = require('polylinear-scale')
// Create a linear scale
const linear = polylinearScale([0, 1], [0, 100])
console.log(linear(0.5)) // 50
// Create a polylinear scale
const polylinear = polylinearScale([0, 100, 300], [0, 50, 100])
console.log(polylinear(10)) // 5
console.log(polylinear(-10)) // -5
// Clamp results to the given range
const clamped = polylinearScale([-10, 0, 10], [-5, 2, 10], true)
console.log(clamped(11)) // 10
Uses JavaScript Standard Style.
# test
$ npm run test