welcome: please sign in
location: Diff for "move3d"
Differences between revisions 5 and 6
Revision 5 as of 2011-11-15 14:40:39
Size: 2248
Editor: matthieu
Comment: softs -> trac
Revision 6 as of 2014-07-16 08:33:15
Size: 3847
Editor: bvadant
Comment:
Deletions are marked like this. Additions are marked like this.
Line 7: Line 7:
BioMove3D is used to develop algorithms to compute kinematic (geometric) paths in cluttered 3D environments for a generic multi-body system with any type of links, it is also used to compute molecular (nano particles) motions. The configuration space representation coded inside the software enables the development of generic planning methods implemented in C/C++ such as probabilistic roadmaps (PRM) and lately rapidly exploring random trees (RRTs). The newest investigation concerns the study of large molecular systems and human aware motion planning for friendly robots. Move3D is used to develop algorithms to compute kinematic (geometric) paths in cluttered 3D environments for a generic multi-body system with any type of links, it is also used to compute molecular (nano particles) motions. The configuration space representation coded inside the software enables the development of generic planning methods implemented in C/C++ such as probabilistic roadmaps (PRM) and lately rapidly exploring random trees (RRTs). The newest investigation concerns the study of large molecular systems and human aware motion planning for friendly robots.
Line 11: Line 11:
BioMove3D comes as a set of libraries and executables. To name a few: Move3D comes as a set of libraries and executables. To name a few:
Line 13: Line 13:
 * `libhri` (the human-robot interaction libraries)  * `libmove3d-hri` (the human-robot interaction library)
 * `l
ibmove3d-planners` (the planning library )
Line 16: Line 17:
=== Via robotpkg === === Install from robotpkg ===
Line 18: Line 19:
The supported way to install `libmove3d` is through '''robotpkg''': You will have to install robotpkg and robotpkg/wip [[http://robotpkg.openrobots.org/|HowToHere]]
Line 20: Line 21:
`robotpkg` is a package management system for robotics module we use at the LAAS. It handles dependencies and compilation automatically. If you don't know it, [[http://robotpkg.openrobots.org|have a look here]].  1) Go to wip/libmove3d and install the package
  {{{
  make update
  }}}
 2) Go to wip/libmove3d-hri and install the package
  {{{
  make update
  }}}
 3) Check the install version of boost : if you are on ubuntu 12.10 or 13.04, the default version of boost is the version 1.49 which contains a bug. You HAVE TO install another release. Don't worry, it is fairly easy :
  {{{
  sudo apt-get install libboost1.50-all-dev
  }}}
 4) Go to wip/libmove3d-planners and install the package
  {{{
  make update
  }}}
 5) Install the last version of qwt
  {{{
  sudo apt-get install libqwt-dev 'or' sudo yum install qwt
  }}}
 6) Go to wip/move3d-studio and Here you have the choice
  a) You only want Move3d-studio
   {{{
   make update
   }}}
  b) You want Move3d-remote
   {{{
   make PKG_OPTIONS.move3d-studio=qtremote update confirm
   }}}
 
Line 22: Line 52:
You will need as well the ''work-in-progress'' repository: === Get the source from git repository ===

Get the four libraries
{{{
cd ${HOME}/openrobots/src
git clone git://trac.laas.fr/git/robots/libmove3d
git clone git://trac.laas.fr/git/robots/libmove3d-hri
git clone git://trac.laas.fr/git/robots/libmove3d-planners
git clone git://trac.laas.fr/git/robots/move3d-studio
}}}

==== Build and install ====
All libraires and executables use CMake : [[http://www.cmake.org/cmake/help/cmake-2-8-docs.html|CMake Doc]]

If not set already, add the pkgconfig folder to the PKG_CONFIG_PATH environment variable :
{{{
export PKG_CONFIG_PATH="${PKG_CONFIG_PATH}:${HOME}/openrobots/lib/pkgconfig"
}}}


Then you have to configure and install the libraries and the executable :
* For the libraries :
{{{
cd ${HOME}/openrobots/src/libmove3d* * = ""|-hri|-planners
mkdir build
cd build
cmake .. -DCMAKE_INSTALL_PREFIX=${HOME}/openrobots
make install
}}}

* For the executable
{{{
cd ${HOME}/openrobots/src/move3d-studio
mkdir build-qt
cd build-qt
cmake .. -DMOVE3D_QT=ON -DCMAKE_INSTALL_PREFIX=${HOME}/openrobots
cmake ..
make install
}}}

== P3D Files ==

In order to run move3d, you will need p3d files that describe the environment and the robot. You can get p3d files like that :
Line 25: Line 97:
> cd $ROBOTPKG_BASE
> git clone http://trac.laas.fr/git/robots/robotpkg-wip.git
cd ~/openrobots/share
mkdir move3d && cd move3d
git clone git://trac.laas.fr/git/robots/move3d-assets assets
Line 29: Line 102:
Once installed, you can add the `libmove3d` package very easily: == Example use ==
Line 32: Line 105:
> cd $ROBOTPKG_BASE/wip/libmove3d
> make update
move3d-qt-studio -f ${HOME}/openrobots/share/move3d/assets/CostDistanceKCD/2dof/Stones.p3d
Line 35: Line 107:

You're done!

=== From the sources ===

To get the latest version of BioMove3D, you can check-out the sources with GIT:

{{{
> git clone http://trac.laas.fr/git/robots/BioMove3D.git
}}}

TODO: list dependencies!

You can then compile the stock `libmove3d` with:
{{{
> cd BioMove3D
> mkdir build && cd build
> cmake -DGENERATE_LIBMOVE3D ..
> make install
}}}

Move3D

move3d_screenshot1.jpg

move3d_screenshot2.jpg

Programming system for motion planning, includes services like collision detection, robot kinematics and an OpenGL viewer.

Move3D is used to develop algorithms to compute kinematic (geometric) paths in cluttered 3D environments for a generic multi-body system with any type of links, it is also used to compute molecular (nano particles) motions. The configuration space representation coded inside the software enables the development of generic planning methods implemented in C/C++ such as probabilistic roadmaps (PRM) and lately rapidly exploring random trees (RRTs). The newest investigation concerns the study of large molecular systems and human aware motion planning for friendly robots.

Installation

Move3D comes as a set of libraries and executables. To name a few:

  • libmove3d (the core library)

  • libmove3d-hri (the human-robot interaction library)

  • libmove3d-planners (the planning library )

  • move3d-studio (the graphical development environment)

Install from robotpkg

You will have to install robotpkg and robotpkg/wip HowToHere

  • 1) Go to wip/libmove3d and install the package
    •   make update 
    2) Go to wip/libmove3d-hri and install the package
    •   make update 
    3) Check the install version of boost : if you are on ubuntu 12.10 or 13.04, the default version of boost is the version 1.49 which contains a bug. You HAVE TO install another release. Don't worry, it is fairly easy :
    •   sudo apt-get install libboost1.50-all-dev
    4) Go to wip/libmove3d-planners and install the package
    •   make update 
    5) Install the last version of qwt
    •   sudo apt-get install libqwt-dev 'or' sudo yum install qwt
    6) Go to wip/move3d-studio and Here you have the choice
    • a) You only want Move3d-studio
      •    make update 
      b) You want Move3d-remote
      •    make PKG_OPTIONS.move3d-studio=qtremote update confirm

Get the source from git repository

Get the four libraries

cd ${HOME}/openrobots/src
git clone git://trac.laas.fr/git/robots/libmove3d
git clone git://trac.laas.fr/git/robots/libmove3d-hri
git clone git://trac.laas.fr/git/robots/libmove3d-planners
git clone git://trac.laas.fr/git/robots/move3d-studio

Build and install

All libraires and executables use CMake : CMake Doc

If not set already, add the pkgconfig folder to the PKG_CONFIG_PATH environment variable :

export PKG_CONFIG_PATH="${PKG_CONFIG_PATH}:${HOME}/openrobots/lib/pkgconfig"

Then you have to configure and install the libraries and the executable : * For the libraries :

cd ${HOME}/openrobots/src/libmove3d*    * = ""|-hri|-planners 
mkdir build
cd build
cmake .. -DCMAKE_INSTALL_PREFIX=${HOME}/openrobots
make install

* For the executable

cd ${HOME}/openrobots/src/move3d-studio
mkdir build-qt
cd build-qt
cmake ..  -DMOVE3D_QT=ON -DCMAKE_INSTALL_PREFIX=${HOME}/openrobots
cmake ..
make install

== P3D Files ==

In order to run move3d, you will need p3d files that describe the environment and the robot. You can get p3d files like that :

cd ~/openrobots/share
mkdir move3d && cd move3d
git clone git://trac.laas.fr/git/robots/move3d-assets assets

Example use

move3d-qt-studio -f ${HOME}/openrobots/share/move3d/assets/CostDistanceKCD/2dof/Stones.p3d

Documentation

Doxygen documentation is available online.

OpenrobotsWiki: move3d (last edited 2017-05-02 16:19:32 by matthieu)