Hummingbird is a simple rigid body physics engine.
Currently, the engine supports collision between spherical bodies and solid walls. Optical properties such as shading is present to facilitate easier viewing and distinction of spherical objects.
To build the engine, you will need:
- g++ (with OpenMP support)
- GNU Make
Additionally, Hummingbird uses various AVX instructions to improve performance. As a result, you will need to have a modern x86-64 machine to run Hummingbird.
Currently, Hummingbird can be built for Linux. It has not been tested on MacOS, BSDs, or Windows.
To build Hummingbird, run the following:
To run Hummingbird on a configuration file, run the following:
You may use the following flags:
- -h: prints help info
- -r: record the simulation for playback
- -p: playback a simulation
Here are some example usages:
./hummingbird <json_file> # runs Hummingbird on the provided json ./hummingbird -r <json_file> # runs Hummingbird on the provided json, and records the simulation (will write to a file called <json_file>.rec) ./hummingbird -p <recording> # plays back a recording file ./hummingbird -h # prints help info
We have provided an example json file. To run Hummingbird with it, you can run:
To build and run the test suite, run the following:
Note on JSON files
In the JSON files you can adjust the gravity, the boundaries of the simulation, and the number of spherical bodies that you are simulating.