Skip to main content

A header-only C++ library with full Python bindings for handling, converting, and storing 3D motions and poses.

Project description

Motion3D

A header-only C++ library with full Python bindings for handling, converting, and storing 3D motions and poses.

It supports converting, chaining and applying transformations in many common representations:

  • Axis-angle rotation and translation vector
  • Dual quaternion
  • Euler angles and translation vector
  • SE(3) transformation matrix
  • Rotation quaternion and translation vector

Using the TransformInterface base class, transformations can be applied and chained without worrying about the underlying type.

The TransformContainer enables handling multiple transformations as motions or as poses, with or without corresponding timestamps. Furthermore, the M3DWriter and M3DReader can be used to store and load transformations from both C++ and Python in the M3D file format.

Installation

Requirements

Dependency Version Note
CMake >= 3.14
GCC >= 9.4 C++17 is required
Eigen >= 3.3
Python >= 3.6

With Ubuntu 20.04, all dependencies can be installed using:

apt install build-essential cmake libeigen3-dev python3 python3-dev python3-pip

See docker/motion3d.dockerfile for further installation details, e.g., for packages required for development.

C++

After all requirements are available, use CMake and Make to install the library headers:

mkdir build && cd build
cmake ..
make install

For uninstalling use make uninstall.

Python

The library can be installed either over PyPI using pip:

python3 -m pip install motion3d

or directly from within the cloned repository:

python3 -m pip install .

If Eigen is not found on the system, the setup downloads a suitable version locally before building the package.

Documentation

Fore more information about the transformation types, definitions, and the usage in C++ and Python, see the documentation.

The doc directory provides a detailed readme on how to create the documentation directly from the repository.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

motion3d-0.1.1.tar.gz (69.4 kB view details)

Uploaded Source

File details

Details for the file motion3d-0.1.1.tar.gz.

File metadata

  • Download URL: motion3d-0.1.1.tar.gz
  • Upload date:
  • Size: 69.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.8.10

File hashes

Hashes for motion3d-0.1.1.tar.gz
Algorithm Hash digest
SHA256 80f0407d550dad22135189d4bfec51d74aa39e6ee97fa515513721c093170bc1
MD5 7b6973253f87b9e98471dfbfe3d1a726
BLAKE2b-256 9d52d38a5b3385dd8771d524d0e68f3dd5dba7dcdaaf4d7e852671b9e423ea65

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page