Skip to content
This repository contains EusLisp software developed and used by JSK at The University of Tokyo
Branch: master
Clone or download
Latest commit d52624b Jan 7, 2019
Type Name Latest commit message Commit time
Failed to load latest commit information.
doc [jskeus/doc] add irtviewer.tex and figures for irtviewer manual. Dec 13, 2018
images downsized null-space-ik.png Jun 17, 2015
irteus Merge pull request #534 from k-okada/fix-angle-vector Jan 6, 2019 need install make by brew Jan 7, 2019
.travis.yml try to run more irt tests Dec 30, 2018
CHANGELOG.rst 1.2.1 Jan 7, 2019
Makefile add ARCHDIR/lib to LD_LIBRARY_PATH Jul 17, 2018
circle.yml circle.yml run apt-get update before apt-get install Sep 21, 2017

JSK EusLisp repository Build Status

Join the chat at

This repository contains software developed and used by JSK at The University of Tokyo.

1. Getting started

1.1 Install binary (RECOMMENDED: Ubuntu 14.04)

1.1.1 Setup ROS repository

sudo sh -c 'echo "deb `lsb_release -cs` main" > /etc/apt/sources.list.d/ros-latest.list'
wget -O - | sudo apt-key add -
echo "source /opt/ros/indigo/setup.bash" >> ~/.bashrc
sudo apt-get update

1.1.2 Install Euslisp

sudo apt-get install ros-indigo-euslisp

1.2 Install via Homebrew (OSX)

brew install euslisp/jskeus/jskeus

2 Playing with Demo programs

2.1 Motion generation

$ irteusgl irteus/demo/demo.l

and type any command, such as '(crank-motion)' or '(dual-arm-ik)'

full-body-ik dual-arm-ik dual-manip-ik crank-motion hand-grasp hanoi-arm particle null-space-ik

2.2 Robots and objects models

$ irteusgl models/irt-all-robots.l "(make-all-robots)"

all robots

$ irteusgl models/irt-all-objects.l "(make-all-objects)"

all objects

3 Getting started for ROS and PR2 users

3.1 Install binaries (RECOMMENDED: Ubuntu 14.04)

3.1.1 Setup ROS repository

You can skip this procedure if you have already setup your ROS system

sudo sh -c 'echo "deb `lsb_release -cs` main" > /etc/apt/sources.list.d/ros-latest.list'
wget -O - | sudo apt-key add -
echo "source /opt/ros/indigo/setup.bash" >> ~/.bashrc
sudo apt-get update

3.1.2 Install pr2/euslisp programs

sudo apt-get install ros-indigo-pr2eus

3.3 Running demo programs

3.3.1 Visualization of pr2 robot

$ rosrun euscollada


3.3.2 For real PR2 users

After you set ROS_MASTER_URI and ROS_IP to your PR2 robot (or simulated PR2), try the following command:

$ roscd pr2eus
;; read joint state and display in euslisp viewer, print jacobian
$ roslaunch ./pr2-read-state.launch
;; sample program to show how to make pr2 posture from euslisp, THIS WILL MOVE REAL ROBOT, CAUTION!!!
$ roslaunch ./pr2-send-joints.launch

You can use our script to set ROS_MASTER_URI and ROS_IP

$ source `rospack find jsk_tools`/src/bashrc.ros
$ rossetrobot # change to your environment
$ rossetip


Have a look at roseus package in repository for ROS client library for euslisp

3.4 Support and Trouble Shooting

Open an issue on our issue tracker if something doesn't work as expected, or if you want new features implemented.

Use the pull requests system to send us solutions for the issues so we can implement them in this repository.

3.5 Online Documents (Currently only Japanese is available)

See online manual

PDF files are also available from here

3.6 Install euslisp from source code (EXPERTS ONLY)

3.6.1 Installing dependent libraries

For Ubuntu users:

$ sudo apt-get install git make gcc g++ libjpeg-dev libxext-dev libx11-dev libgl1-mesa-dev libglu1-mesa-dev libpq-dev libpng12-dev xfonts-100dpi xfonts-75dpi gsfonts-x11 texlive-fonts-extra xfonts-100dpi-transcoded xfonts-75dpi-transcoded msttcorefonts

For Mac OSX users using Homebrew:

$ brew install jpeg libpng mesalib-glw wget

'''NOTE:''' EusLisp needs X11 Library, but Mac OSX mountain lion no longer supports it. Given this case, you'll need to install XQuartz.

Also for Mac OSX lion (or older) users it's better to install the latest XQuartz for safety and compatibility reasons.

(If XQuartz is older than 2.7.3, the installation of EusLisp will fail. You should install the latest XQuartz.)

For Raspberry Pi users using debian(Raspbian "wheezy"):

$ sudo apt-get install git gcc g++ libjpeg62-dev libxext-dev libx11-dev libgl1-mesa-dev libglu1-mesa-dev libpq-dev libpng12-dev xfonts-100dpi xfonts-75dpi
## additional install for using OpenGL on raspberry pi
$ sudo apt-get install libgl1-mesa-dri xserver-xorg-video-vesa xutils

For Cygwin(only works with 32bit systems)

Packages listed below should be intalled using setup.exe.

git, gcc-core, gcc-g++, make
libjpeg-devel, libpng-devel
libGL-devel, libGLU-devel, libglut-devel, libX11-devel, libXext-devel
X-start-menu-icons (for startxwin.exe)
mesa-demo (for glxinfo)
bitmap fonts (all bitmap font packages -75dpi, -100dpi, -misc )

3.6.2 Downloading and building EusLisp

$ git clone jskeus
$ cd jskeus
$ make
you will see instructions to add EUSDIR, ARCHDIR, PATH, LD_LIBRARY_PATH environment variable in your bashrc to invoke euslisp program
$ echo "source ~/" >> ~/.bashrc

3.6.3 Install ROS and jsk-ros-pkg repository

See for more details

$ sudo apt-get install python-rosdep python-rosinstall-generator python-wstool python-rosinstall build-essential
$ mkdir -p ~/ros_catkin_ws/src
$ cd ~/ros_catkin_ws/src
$ wstool init src
$ wget
$ sh ./
$ cd ..
$ catkin_make
$ source devel/setup.bash

3.7 Acknowledgment

Software in this repository is based on the EusLisp language.

You can’t perform that action at this time.