Skip to content
SoftCon: Simulation and Control of Soft-Bodied Animals with Biomimetic Actuators
C++ CMake Python C
Branch: master
Clone or download
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
cmake_module 🐙 First commit. Sep 4, 2019
data 🐙 First commit. Sep 4, 2019
learn 🐙 First commit. Sep 4, 2019
render 🐙 First commit. Sep 4, 2019
sim 🐙 First commit. Sep 4, 2019
.gitignore 🐙 First commit. Sep 4, 2019
CMakeLists.txt 🐙 First commit. Sep 4, 2019
LICENSE 🐙 First commit. Sep 4, 2019
README.md 🐙 First commit. Sep 4, 2019
SoftCon.png 🐙 Add image file for README.md Sep 4, 2019

README.md

SoftCon: Simulation and Control of Soft-Bodied Animals with Biomimetic Actuators

SoftCon

The octopus swims by actuating muscles embedded in the soft tissues.

Abstract

SoftCon is an open source code that implements the work SoftCon: Simulation and Control of Soft-Bodied Animals with Biomimetic Actuators. With our framework, user can generate the swimming animation of under-water animals with deformable body simulator, biomimetic muscle pattern generator, and swimming controller based on deep reinforcement learning. This code is written in C++ and Python, based on Tensorflow and OpenAI Baselines.

Publication

Sehee Min, Jungdam Won, Seunghwan Lee, Jungnam Park, and Jehee Lee. 2019. SoftCon: Simulation and Control of Soft-Bodied Animals with Biomimetic Actuators. ACM Trans. Graph. 38, 6, 208. (SIGGRAPH Asia 2019)

Project page : http://mrl.snu.ac.kr/publications/ProjectSoftCon/SoftCon.html
Paper : http://mrl.snu.ac.kr/publications/ProjectSoftCon/SoftCon.pdf
Youtube : https://www.youtube.com/watch?v=I2ylkhPSkT4

How to install

We recommend users to install and run this framework on Ubuntu. We checked code works in Ubuntu 16.04 and 18.04.

C++

Basic C++ library

sudo apt-get update
sudo apt-get install build-essential cmake-curses-gui git
sudo apt-get install libeigen3-dev freeglut3-dev libtinyxml-dev libpython3-dev python3-numpy libopenmpi-dev

Boost 1.66 with Python3 : Boost library should install from the source code!

cd boost_1_66_0
sudo ./bootstrap.sh --with-python=python3
sudo ./b2 --with-python --with-filesystem --with-system install

Python

Virtual environment

sudo apt-get install python3-pip
sudo pip3 install virtualenv
virtualenv venv
source venv/bin/activate

Python library with pip install

pip install numpy
pip install scipy
pip install matplotlib
pip install tensorflow
pip install mpi4py
pip install OpenCV-Python

Baselines Installation for Deep RL

  • OpenAI Gym
pip install gym
  • OpenAI Baselines
sudo apt-get update && sudo apt-get install cmake zlib1g-dev
git clone https://github.com/openai/baselines.git
cd baselines
pip install -e .

How to compile & run

Install this repository

git clone http://github.com/seiing/SoftCon

Build

cd SoftCon
mkdir build
cd build 
cmake ..
make -j8

Run

Default render

./render/render
  • space : play/pause.
  • k : play with default key.
  • r :reset the scene.

Render with trained network

./render/render ../network/(network_name)

Training

cd SoftCon/learn
mpirun -np 8 python -m run -type=train
You can’t perform that action at this time.