Calculate voronoi cells within a 3D box.
Voro3D is a thin wrapper around the WebAssembly output of the Voro++ Emscripten project. It behaves like a regular module and hides loading the main wasm
file which makes it easier to use. Also, the C++ vector types are converted into regular JavaScript arrays. TypeScript definitions are added as well.
The module exports just one type and one class. Import the module and create a container instance:
import { Voro3D } from 'voro3d';
const container = await Voro3D.create(-10, 10, -10, 10, -10, 10, 2, 2, 2);
Call the asynchronous create
function to create a new container. The function accepts 9 optionals arguments. The first six arguments define the dimensions of the box (xMin, xMax, yMin, yMax, zMin, zMax). The last three arguments are used for the calculation of the voronoi cells where the box is divided into n respective sub computation boxes in x, y and z direction.
Now, calculate the voronoi cells. The function accepts either an array of vertices or a flattened array as well as the optional parameter to convert the vertices to world coordinates or to keep them in the cell coordinate system:
const points = [ /* ... */ ];
const cells = container.computeCells(points, true);
The cells
output is a list of Cell
type objects. A cell contains information about their particle id, the coordinate of its particle as well as a list of vertices and faces with vertex indices.
Find a full example in the src/test/
folder and have a look at voro3d.ts
for the full types.
The license is based on the license of Voro++ and can be found here.