A Javascript implementation of the Poincaré disk model of the hyperbolic plane, on an HTML canvas.
Usage examples can be found on the project site.
npm install --save hyperbolic-canvas
Pass a unique selector of a div element, to the function HyperbolicCanvas.create. Nonzero width and height styling must be specified. Absolute px values in a 1:1 ratio are recommended:
<div id="hyperbolic-canvas" style="width: 600px; height: 600px;"></div>let canvas = HyperbolicCanvas.create('#hyperbolic-canvas');See API.md for a list of functions and their descriptions.
This library prioritizes the visualization of hyperbolic geometry over precise mathematical calculation. Due to the less-than-infinite precision of floating-point numbers, and because certain trigonometric functions are ill-conditioned, these goals are often at odds.
The arbitrary constants HyperbolicCanvas.INFINITY and HyperbolicCanvas.ZERO have been defined for use in internal comparisons in place of Infinity and 0, respectively. Their values may be overridden, but increased accuracy will tend to lead to more unpredictable behavior.
Certain browsers do not provide support for the hyperbolic trigonometric functions. Polyfills are available.
Install dependencies via pnpm:
pnpm installSetup Husky to format code on commit:
pnpm prepare