tinyso3

TinySO3 is a compact and efficient library designed to handle 3D rotations using various mathematical representations including rotation matrices, quaternions, and Lie groups (SO(3)). Whether you're working on robotics, computer graphics, or aerospace applications, TinySO3 provides the essential tools for managing and manipulating 3D rotational data with precision and ease.

Theory document

Features

Rotation Matrices: Functions for creating, transforming, and composing rotation matrices.
- Supported Convention : Passive(Alias) and Active(Alibi)
Quaternions: Comprehensive support for quaternion algebra, including conversion, interpolation, and normalization.
- Supported Convention : Hamilton and JPL
Axis Angle: Tools for representing and converting rotations using the axis-angle representation.
Euler Angles: Support for multiple Euler angle conventions and conversion between Euler angles and other representations.
- Supported Convention : Intrinsic and Extrinsic
- All 12 representation of euler angles are supported, including Tait-Bryan and Proper.
Lie Groups: Efficient methods for working with Lie group representations of rotations, specifically SO(3).
Interoperability: Seamless conversion between different rotation representations.
Conversion between Euler Rate and Angular Velocity
Performance: Optimized for speed and minimal memory usage, making it suitable for real-time applications.
C++11 Header-Only library.
Standard C++ library is not required.
No dynamic allocations.

Installation

tinyso3 has no dependencies except testing(disabled by default).

tinyso3 follows general steps of CMake projects.

Before installation, you can configure default template arguments.

pip install kconfiglib
make config

Or manually configure config.hpp, version.hpp

Option 1 (CMake)

mkdir -p build && cd build
cmake .. -DCMAKE_BUILD_TYPE=Release
cmake --build . -- -j
cmake --install .

find_package(tinyso3 REQUIRED)
add_executable(myapp main.cpp)
target_link_library(myapp PRIVATE tinyso3::tinyso3)

Option 2 (CMake FetchContents)

include(FetchContent)
FetchContent_Declare(tinyso3 GIT_REPOSITORY
https://github.com/timetravelCat/tinyso3)
FetchContent_MakeAvailable(tinyso3)
...
target_link_libraries(myapp PRIVATE tinyso3)

Option 3 (Copy & Paste)

Copy include/tinyso3 folder to your project. C++11 compiler is required.

Tutorials

See the test directory for detailed examples.

tutorial.cpp

(Work in Progress)

Development

Running the tests

Install Catch2 v3.4 or higher

mkdir -p build && cd build
cmake .. -DBUILD_TESTING=ON
cmake --build . -- -j
ctest # or make test

Formatting

Install clang-format and cmake-format

pip install cmake-format
sudo apt install clang-format

make format # all c++ files and cmake files will be formatted.

If you are using vscode, install clang-format extension.

Static Analyzers

sudo apt install cppcheck clang-tidy

Documentations

pip3 install mkdocs mkdocs-material pymdown-extensions mkdocs-dracula-theme 
mkdocs build
mkdocs serve

License

This project is licensed under the BSD-3-Clause - see the LICENSE file for details

Contact

timetravelCat - timetraveler930@gmail.com

lightAxis/tinyso3