WaspJS is a JavaScript library (LICENSE HERE) designed to perform discrete aggregations on the Web.

This implementation is authored by Roger Winkler and builds upon the original concept of the python-based Grasshopper plug-in WASP by Andrea Rossi. For more information on WASP, visit the original WASP repository.

Demo

To get an idea of the library, you can play around with the demo. The code for the demo can be found in the test folder. Example datasets can be found in the public/examples folder.

Usage

Installation

You can install WaspJS via npm:

npm install webwaspjs

Documentation

Current Classes

The Visualizer class is used to visualize the aggregation and perform other operations. It utilizes Three.js, a popular JavaScript library for 3D graphics. Additionally, the three-mesh-bvh library is used for collision detection. The camera-controls library is employed to change the scene's up axis from Y (default in Three.js) to Z (default in Rhino).

The Aggregation class in holds the initial parts, rules, and the aggregated parts.

The Part class contains all relevant information to describe a part, including connections to other parts and colliders.

The Connection class represents a possible connection plane and holds its current status.

The Plane class is introduced to hold information similar to the logic of a Grasshopper plane. This is necessary because the concept of a plane in Rhino3D (origin, X- and Y-axis) does not exist in Three.js (a plane in Three.js is a plane surface).

The Collider class is used for checking collisions based on simplified geometries before adding the original geometry to the aggregation. For collision detection, the three-mesh-bvh library is used.

The Rule class defines which part and connection type can connect to which others.

License

Option 1: MIT

This project is licensed under the MIT License. See the LICENSE file for details.

This project is inspired by the original WASP software, which was developed in Python and is licensed under the GNU Lesser General Public License, Version 3, 29 June 2007. For more information on the original WASP software, visit the original WASP repository.

Option 2: LGPL

This project is licensed under the GNU Lesser General Public License, Version 3, 29 June 2007. See the LICENSE file for details.

This project is a reverse-engineered version of the original WASP software, which was developed in Python and is licensed under the GNU Lesser General Public License, Version 3, 29 June 2007. For more information on the original WASP software, visit the original WASP repository.

Contact

For any questions or feedback, get in touch via [email protected].