This is an installation guide for Ubuntu. For Mac/Windows, please follow the official RaiSim installation guide.
Install prerequisites
$ sudo apt install cmake libeigen3-dev
Create the workspace in your desired directory:
$ mkdir raisim && cd raisim
$ mkdir raisim_build
Clone the artigrasp repository:
$ git clone https://github.com/zdchan/artigrasp.git
$ cd artigrasp
Build the simulation backbone:
$ mkdir build && cd build
Run the following command and replace $LOCAL_INSTALL by the path to the raisim_build folder created above (e.g. ~/raisim/raisim_build) and $(python3 -c "import sys; print(sys.executable)") by the path to the python executable of your virtual environment:
$ cmake .. -DCMAKE_INSTALL_PREFIX=$LOCAL_INSTALL -DRAISIM_EXAMPLE=ON \
-DRAISIM_PY=ON \
-DPYTHON_EXECUTABLE=$(python3 -c "import sys; print(sys.executable)")
$ make install -j4
$ cd ..
Add the following lines to your ~/.bashrc file:
export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:<PATH_TO_RAISIM_BUILD_FOLDER>/lib
export PYTHONPATH=$PYTHONPATH:<PATH_TO_RAISIM_BUILD_FOLDER>/lib
Do not use ~ to reference your home directory. Write the full path.
First we need to install minizip and ffmpeg:
$ sudo apt install minizip ffmpeg
Next, we need to install Vulkan:
$ sudo add-apt-repository ppa:oibaf/graphics-drivers
$ sudo apt update
$ sudo apt upgrade
$ sudo apt install libvulkan1 mesa-vulkan-drivers vulkan-utils
Make sure that you run raisimUnity executable in raisimUnity/<OS>/RaiSimUnity before you run the examples.
In Ubuntu 22.04, the following line should be executed to correctly link the package:
sudo ln -s /lib/x86_64-linux-gnu/libdl.so.2 /lib/x86_64-linux-gnu/libdl.so
The last part consists of installing the artigrasp environments.
Run the following to do so:
$ cd raisimGymTorch
$ python setup.py develop
All the environments are run from this raisimGymTorch folder.
Note that every time you change the environment.hpp, you need to run python setup.py develop again to build the environments.
You should be all set now. Last thing to do is acquire an activation key for the simulator.
Rename the activation key that you received by email to activation.raisim. Save that file in /home/<YOUR-USERNAME>/.raisim.
RaiSim will check the path you set by raisim::World::setActivationKey(). If the file is not found, it will search in the user directory, where you saved your activation.raisim file.