Robot control, planning and learning framework.
Golem major dependencies:
Name | Description | CMake options |
---|---|---|
Expat | Mandatory | |
Freeglut | Mandatory | |
Boost >= 1.58 | Mandatory | |
OpenCV 2.4.X | Mandatory | |
PCL >= 1.7 | Mandatory | |
NVIDIA PhysX 2.8.X | Optional physics simulation | GOLEM_BUILD_\*_PHYS |
ZeroC Ice | Optional Tiny Interface | GOLEM_BUILD_\*_PTINY |
This is an example installation on Ubuntu 16.04.06 LTS.
Update package database.
sudo apt-get update
Install essential c++ development packages.
sudo apt-get install build-essential cmake git
Install mandatory dependencies.
sudo apt-get install libpopt-dev zlib1g-dev libxmu-dev libxi-dev libproj-dev libboost-dev libexpat-dev freeglut3-dev libpcl-dev libopencv-dev
Install optional dependencies (Optional).
- NVIDIA Physx SDK 2.8.* . Download and install PhysX from NVIDIA site: unpack
*.deb
files and runsudo dpkg -i libphysx*.deb
. - Tiny Interface (using ZeroC Ice). Run
sudo apt-get install ice35-translators libzeroc-ice35-dev
Create project workspace.
mkdir Projects
cd Projects
Download Golem.
mkdir Golem
git clone https://github.com/RobotsLab/Golem Golem
Configure Golem (without optional dependencies).
cd Golem
mkdir build
cd build
mkdir build && cd build && cmake build .. -DCMAKE_BUILD_TYPE=RELEASE -DCMAKE_INSTALL_PREFIX=/usr/local
Build and install Golem.
sudo make install -j
Notes
- Make sure that the system is informed about locations of libraries, which are controlled by system variable
LD_LIBRARY_PATH
. For example if CMAKE_INSTALL_PREFIX is set to/usr/local
, thenLD_LIBRARY_PATH
must contain/usr/local/bin
. Open bash configgedit ~/.bashrc
, add at the end of the fileexport LD_LIBRARY_PATH=/usr/local/bin:${LD_LIBRARY_PATH}
, then updatesource ~/.bashrc
. - The default xml configuration files of Golem applications assume that they are all in the same working application directory together with shared Golem libraries and corresponding xml files. By default it is a temporary location of files during build (see Ubuntu installation -> Configure), as well as the directory for executables pointed by CMAKE_INSTALL_PREFIX (typically
/usr/local/bin
). - In some hardware and software configurations (e.g. in virtual machines) direct OpenGL rendering may need to be disabled. Open bash config
gedit ~/.bashrc
, add at the end of the fileexport LIBGL_ALWAYS_INDIRECT=yes
, then updatesource ~/.bashrc
. - When operating real robots, all applications should be launched as
root
to allow runnig the robot drivers' threads in a real-time priority mode. - Some Golem applications require write permissions to the currunt directory.
Update library search path
export LD_LIBRARY_PATH=/usr/local/bin:${LD_LIBRARY_PATH}
Golem Grasp application.
GolemAppGrasp /usr/local/bin/GolemAppGrasp_RobotBoris.xml GolemAppGrasp.log stdout
Golem Grasp Neural Network client.
GolemAppGrasp /usr/local/bin/GolemAppGrasp_RobotBorisNNLearning.xml GolemAppGrasp.log stdout
- Press
R
thenG
in the OpenGL window to run the client.
We assume here that you have Docker Engine already installed on your system. There are several available tutorials on the Web, for example Install Docker Engine on Ubuntu.
Copy all Golem docker files to some local directory.
Create docker image golem_test
.
./Dockerfile.sh golem_test
Run Golem Grasp application for Birmingham Boris robot.
./run_Grasp.sh golem_test Boris