Over a million developers have joined DZone.

WebAssembly Cephes: Mathematical Special Functions in JavaScript

DZone 's Guide to

WebAssembly Cephes: Mathematical Special Functions in JavaScript

JavaScript isn't typically thought of as a data language, but maybe it should be. See how the open source Cephes project is making JS a competitor to R and Python.

· Big Data Zone ·
Free Resource


A lot of the mathematical implementations we do at NearForm depends on so-called mathematical special functions. There are no clearly defined criteria for what a special function is, but suffice to say they are functions that often turn up in mathematics and most of them are notoriously hard to compute. Often they are defined as the solution to a well-posed problem. However, the solution itself is not easy to compute.

JavaScript is severely lacking in implementations of these special functions, especially trusted implementations. If you are lucky, you can find a basic implementation in npm. However, the implementations often have numerous undocumented issues and only work somewhat well for a small and undocumented input range.

In R these functions are often built-in, and in Python, SciPy implements these functions. Deep within the SciPy source code, we find the Cephes library which is what implements many of these functions.

Cephes is a pure C library, that doesn't depend on anything, including the C standard library. This makes it ideal to be compiled to WebAssembly using emscripten, as it means there won't be calls between JavaScript and WebAssembly which could otherwise cause performance issues.

We have released the WebAssembly version of Cephes on npm, see https://www.npmjs.com/package/cephes. So all you need is to install it with npm install cephes.

Using our Cephes module is very simple, as we have wrapped each WebAssembly function in a custom JavaScript function that takes care of all the memory management.

const cephes = require('cephes');
const value = cephes.gamma(2);


Below are just a few examples of the 125 available functions. You can see all of them in our README file.

All of the values that make up the graph are calculated dynamically in your browser. This gives you an idea of just how fast Cephes in WebAssembly is.

1. The Bessel function is the solution to the equation:

Image title

The Bessel function is typically used in partial differential equations, where will often be a fixed integer.

Image title

2. The Gamma function is used in many probability distributions.

Image title

As its value increases very quickly, it is often the function that is used in practice. Cephes has dedicated implementations for both. The DiGamma function =, is its derivative and also appear frequently in probably theory: 

Image title

Image title

3. The beta distribution is central in a lot of Bayesian statistics.

Image title

The cumulative distribution function is notoriously hard to compute, but this function is also implemented by Cephes.

Image title

Image title

4. The Airy functionAi(x), is the solution to the differential equation.

Image title

It is often used in physics such as quantum mechanics. Cephes also defines it compimentary function Bi(x) and their derivatives and Ai'(x) and Bi'(x).

Image title

Cephes as an Open Source Project

Whilst Cephes lacks a general license, its author, Stephen L. Moshier, has kindly granted us permission to license it as BSD-3-Clause. Whilst the library continues to be maintained, it doesn't use some of the more modern approximation methods for many of the special functions.

The good news is that R and SciPy are working together on making a better Open Source library of these special functions. But it will take a while before that library is ready and until then Cephes is by far the best choice.

big data ,javascript ,data visualization ,javascript for big data ,open source libraries

Published at DZone with permission of

Opinions expressed by DZone contributors are their own.

{{ parent.title || parent.header.title}}

{{ parent.tldr }}

{{ parent.urlSource.name }}