bullet3 README

The project's README from github.com/bulletphysics/bullet3. As one markdown file: README.md.

Travis Build Status Appveyor Build status

Bullet Physics SDK

This is the official C++ source code repository of the Bullet Physics SDK: real-time collision detection and multi-physics simulation for VR, games, visual effects, robotics, machine learning etc.

PyBullet

Issues

The Issue tracker was flooded with support questions and is closed until it is cleaned up. Use the PyBullet forums to discuss with others.

PyBullet

It is highly recommended to use PyBullet Python bindings for improved support for robotics, reinforcement learning and VR. Use pip install pybullet and checkout the PyBullet Quickstart Guide.

Installation is simple:

pip3 install pybullet --upgrade --user
python3 -m pybullet_envs.examples.enjoy_TF_AntBulletEnv_v0_2017may
python3 -m pybullet_envs.examples.enjoy_TF_HumanoidFlagrunHarderBulletEnv_v1_2017jul
python3 -m pybullet_envs.deep_mimic.testrl --arg_file run_humanoid3d_backflip_args.txt

If you use PyBullet in your research, please cite it like this:

@MISC{coumans2021,
author =   {Erwin Coumans and Yunfei Bai},
title =    {PyBullet, a Python module for physics simulation for games, robotics and machine learning},
howpublished = {\url{http://pybullet.org}},
year = {2016--2021}
}

Requirements for Bullet Physics C++

A C++ compiler for C++ 2003. The library is tested on Windows, Linux, Mac OSX, iOS, Android, but should likely work on any platform with C++ compiler. Some optional demos require OpenGL 2 or OpenGL 3, there are some non-graphical demos and unit tests too.

Contributors and Coding Style information

https://docs.google.com/document/d/1u9vyzPtrVoVhYqQOGNWUgjRbfwfCdIts_NzmvgiJ144/edit

Requirements for experimental OpenCL GPGPU support

The entire collision detection and rigid body dynamics can be executed on the GPU.

A high-end desktop GPU, such as an AMD Radeon 7970 or NVIDIA GTX 680 or better. We succesfully tested the software under Windows, Linux and Mac OSX. The software currently doesn't work on OpenCL CPU devices. It might run on a laptop GPU but performance will not likely be very good. Note that often an OpenCL drivers fails to compile a kernel. Some unit tests exist to track down the issue, but more work is required to cover all OpenCL kernels.

License

All source code files are licensed under the permissive zlib license (http://opensource.org/licenses/Zlib) unless marked differently in a particular folder/file.

Build instructions for Bullet using vcpkg

You can download and install Bullet using the vcpkg dependency manager:

git clone https://github.com/Microsoft/vcpkg.git
cd vcpkg
./bootstrap-vcpkg.sh
./vcpkg integrate install
./vcpkg install bullet3

The Bullet port in vcpkg is kept up to date by Microsoft team members and community contributors. If the version is out of date, please create an issue or pull request on the vcpkg repository.

Build instructions for Bullet using premake. You can also use cmake instead.

Windows

Click on build_visual_studio_vr_pybullet_double.bat and open build3/vs2010/0_Bullet3Solution.sln When asked, convert the projects to a newer version of Visual Studio. If you installed Python in the C:\ root directory, the batch file should find it automatically. Otherwise, edit this batch file to choose where Python include/lib directories are located.

Windows Virtual Reality sandbox for HTC Vive and Oculus Rift

Build and run the App_SharedMemoryPhysics_VR project, preferably in Release/optimized build. You can connect from Python pybullet to the sandbox using:

import pybullet as p
p.connect(p.SHARED_MEMORY) #or (p.TCP, "localhost", 6667) or (p.UDP, "192.168.86.10",1234)

Linux and Mac OSX gnu make

Make sure gcc and cmake is installed (sudo apt-get install build-essential and sudo apt-get install cmake for Linux, brew install cmake for Mac, or https://cmake.org)

In a terminal type:

./build_cmake_pybullet_double.sh

This script will invoke cmake and build in the build_cmake directory. You can find pybullet in Bullet/examples/pybullet. The BulletExampleBrowser binary will be in Bullet/examples/ExampleBrowser.

You can also build Bullet using premake. There are premake executables in the build3 folder. Depending on your system (Linux 32bit, 64bit or Mac OSX) use one of the following lines Using premake:

cd build3
./premake4_linux --double gmake
./premake4_linux64 --double gmake
./premake4_osx --double --enable_pybullet gmake

Then

cd gmake
make

Note that on Linux, you need to use cmake to build pybullet, since the compiler has issues of mixing shared and static libraries.

Mac OSX Xcode Click on build3/xcode4.command or in a terminal window execute

./premake_osx xcode4

Usage

The App_ExampleBrowser executables will be located in the bin folder. You can just run it though a terminal/command prompt, or by clicking it.

[--start_demo_name="Demo Name"]     Start with a selected demo  
[--mp4=moviename.mp4]               Create a mp4 movie of the window, requires ffmpeg installed
[--mouse_move_multiplier=0.400000]  Set the mouse move sensitivity
[--mouse_wheel_multiplier=0.01]     Set the mouse wheel sensitivity
[--background_color_red= 0.9]       Set the red component for background color. Same for green and blue
[--fixed_timestep= 0.0]             Use either a real-time delta time (0.0) or a fixed step size (0.016666)

You can use mouse picking to grab objects. When holding the ALT or CONTROL key, you have Maya style camera mouse controls. Press F1 to create a series of screenshots. Hit ESCAPE to exit the demo app.

Check out the docs folder and the Bullet physics forums for further information.

bullet3 (bulletphysics/bullet3)

Searching Database…

14.8K ·GitHub
Bullet3
What is this?Bullet Physics SDK is the official C++ library for real-time collision detection and multi-physics simulation, used in VR, games, visual effects, robotics and machine learning.
Is this a C++ library I link into my own app, or a standalone program?It is primarily a C++ library with optional example/demo apps (AppExampleBrowser) built on top of it; there are also Python bindings called PyBullet for scripting without touching C++.
How do I get it running?For Python, just run 'pip install pybullet'. For C++, build with vcpkg ('vcpkg install bullet3'), or use cmake/premake: on Windows run the Visual Studio batch/solution files, on Linux/Mac run the build script with gcc/cmake, or use Xcode on Mac.
Do I need a C++ compiler or just Python?For PyBullet you only need Python and pip; for the native library you need a C++ compiler (C++2003), cmake or premake, and make/gcc on Linux/Mac (build-essential, cmake).
Does the GPU/OpenCL support work out of the box?Experimental OpenCL GPGPU support needs a high-end desktop GPU like a Radeon 7970 or GTX 680 or better; it doesn't work on OpenCL CPU devices, laptop GPU performance is poor, and some OpenCL drivers fail to compile kernels.
Which platforms does it run on?It's tested on Windows, Linux, Mac OSX, iOS and Android, and should work on any platform with a C++ compiler.
Can I get support if I run into an issue?The GitHub issue tracker was closed because it got flooded with support questions; users are directed to the PyBullet forums instead.
How do I control the demo app once it's running?Run the AppExampleBrowser executable, use mouse picking to grab objects, hold ALT/CONTROL for Maya-style camera controls, F1 for screenshots, and ESCAPE to exit.
Why would I use PyBullet instead of the raw C++ library?PyBullet gives improved, higher-level support specifically for robotics, reinforcement learning and VR workflows compared to using the raw C++ API.
What are similar projects?genesis-world, JoltPhysics, project_superdex, carla, AirSim, GR00T-WholeBodyControl, jumper, mujoco
Which topics is it in?simulator, physics-engine, opencl, virtual-reality, physics-simulation, robotics, simulation, game-development, reinforcement-learning, 3d, browser, c++
Creator
bulletphysics
Size
290.1 MB
Stars
14.8K
Updated
CommitOct 09Release3.25Apr 24
Age
15y
Commits · 90 Days