Poses
                              Version 0.2.3




WHAT IS THE POSES PROJECT ?

This project tries to extract important Poses from Dance Motion Data based on VPM files via the MotionX
project. (http://github.com/rennhak/MotionX)

We are dealing with several concepts such as

  o Keyposes

    This term was coined by T. Shiratori and his collegues to describe important dance motions which
    occur when the hand and the foot end-effectors stop in conjunction with musical beat [1]. These
    motions are considered to be the "essence" of the dance from the viewpoint of structure importance.

  o Turning poses

    This term was coined by B. Rennhak and his collegues to describe the most important poses as
    shown in the dance master illustrations. These poses convey temporal importance as well as style
    and details for a complete dance reconstruction [2]. These motions are considered to be the
    "essence" of the dance from the viewpoint of a dance teacher.

  o Turning motions

    This term was coined by B. Rennhak and his collegues to describe the most characteristic
    trajectory representations of state to state intervalls of a given dance.

Subprojects:

  Directory:    "src/BodyComponents"
  Description:  "Body components w/ middle arms and projection from 3D->2D"
  Keywords:     "Golden Section, Body components, vpm, projection, turning points"
  Dependencies:  MotionX->plugins->VPM ; http://raa.ruby-lang.org/project/deep-clone/ (for marshal ; copy&pasted)
                  https://webfiles.colorado.edu/alken/www/gsl/ndlinear-1.0.tar.gz Ruby GSL etc.
  FIXME:         Change to MotionX XYAML interface.


Libraries:

Libraries can be found in base/

They are not submodules but simple clones from the original source. Submodules seem to be not the
right solution.



FEATURES


  o  Application
    o  Commandline arguments interface
    o  Supports flexible templates to handle different dance data
    o  Runs only on Ruby VM 1.9.x

  o  Feature Providing Base Libraries
    o  MotionX to handle reading/writing VPM

  o  Supported Ressources
    o  Extraction of Keyposes (with Rennhak/Audio package support)
    o  Extraction of Turning poses

  o  Development

  o  Development Base Libraries

  o  Code Quality


ON WHAT HARDWARE DOES IT RUN?

    This Software was originally developed and tested on 32-bit x86 / SMP based PCs running on
    Ubuntu and Gentoo GNU/Linux 2.6.x. Other direct Linux and Unix derivates should be viable too as
    long as all dynamical linking dependencys are met. 


DOCUMENTATION


    A general developers API guide can be extracted from the Doxygen
    subdirectory which is able to generate HTML as well as PDF docs. Please refer to the
    [Rake|Make]file for additional information how to generate this documentation.


INSTALLING

    If you got this package as a packed tar.gz or tar.bz2 please unpack the contents in
    an appropriate folder e.g. ~/jokemachine/ and follow the supplied INSTALL or README
    documentation. Please delete or replace existing versions before unpacking/installing
    new ones.


SOFTWARE REQUIREMENTS

    This package was developed and compiled under Gentoo GNU/Linux 2.6.x with the Ruby 1.8.x MRI
    interpreter.


BUILD PROCESS

CONFIGURING

COMPILING

RUNNING

IF SOMETHING GOES WRONG

    In case you enconter bugs which seem to be related to the JOKESMACHINE package please check in
    the MAINTAINERS file for the associated person in charge and contact him or her directly. If
    there is no valid address then try to mail Bjoern Rennhak <bjoern AT rennhak DOT com> to get
    some basic assistance in finding the right person in charge of this section of the JOKESMACHINE
    project.


NOTES

    This README file was last modified on the $LastChangedDate$
    by $LastChangedBy$. Current file version is $Rev$ (which is a minor revision number) .


COPYRIGHT

    (c) 2009-2011, Bjoern Rennhak, under a dual license of GPLv2 and MIT ( http://www.opensource.org/licenses/mit-license.php )

    Please refer to the COPYRIGHT file in the various folders for explicit copyright notice.  Unless
    otherwise stated all remains protected and copyrighted by Bjoern Rennhak <bjoern AT rennhak DOT
    com>.


REFERENCES

[1]   Detecting Dance Motion Structure using Motion Capture and Musical Information
      Takaaki Shiratori, Atsushi Nakazawa, Katsushi Ikeuchi
      In Proc. International Conference on Virtual Systems and Multimedia (VSMM 2004), November 2004
      URL: http://www.cs.cmu.edu/~siratori/pub/VSMM2004shiratori.pdf

[2]   Detecting Dance Motion Structure Using Body Components and Turning Motions
      Bjoern Rennhak, Takaaki Shiratori, Shunsuke Kudoh, Phongtharin Vinayavekhin, Katsushi Ikeuchi
      In Proc. IEEE/RSJ International Conference on Intelligent Robots and Systems (IROS 2010), October 2010



# vim:ts=2:tw=100:wm=100