sdu_controllers

sdu_controllers is a C++ library that implements fundamental robot controllers. The library is developed and maintained by the SDU Robotics group at University of Southern Denmark (SDU). Python bindings and a MATLAB Simulink interface is provided making it possible to use it as a Python library or in Simulink with very little overhead.

Prerequisites

Building sdu_controllers requires the following software installed:

A C++17-compliant compiler
CMake >= 3.9
Eigen3 >= 3.3 for linear algebra.
yaml-cpp for loading robot models.
Doxygen (optional, documentation building is skipped if missing)
Python >= 3.9 for building Python bindings

Building sdu_controllers

Dependencies

In order to build sdu_controllers you must first install the dependencies, see how to do that on your operating system here:

Ubuntu

sudo apt update && sudo apt install libeigen3-dev libyaml-cpp-dev

Windows

vcpkg install eigen3 yaml-cpp

macOS

brew install eigen yaml-cpp

If you plan to build tests and python bindings you must install Catch2 and nanobind with:

git submodule update --init --recursive

When building the Python bindings with CMake directly, install the Python packages used during stub generation into the same Python interpreter that CMake finds:

python -m pip install nanobind typing-extensions numpy

Build procedure

The following sequence of commands builds sdu_controllers. It assumes that your current working directory is the top-level directory of the freshly cloned repository:

mkdir build
cd build
cmake -DCMAKE_BUILD_TYPE=Release ..
cmake --build .

The build process can be customized with the following CMake variables, which can be set by adding -D<var>={ON, OFF} to the cmake call:

BUILD_TESTING: Enable building of the test suite (default: ON)
BUILD_DOCS: Enable building the documentation (default: ON)
BUILD_PYTHON: Enable building the Python bindings (default: ON)
BUILD_EXAMPLES: Enable building the examples (default: ON)

For some controllers, hardware specific examples have been implemented which can be run on a real robot. These are disabled by default.

BUILD_UR_EXAMPLES: Enable building UR specific examples (default: OFF)

If you wish to build and install the project as a Python project without having access to C++ build artifacts like libraries and executables, you can do so using pip from the root directory:

python -m pip install .

Testing sdu_controllers

When built according to the above explanation (with -DBUILD_TESTING=ON), the C++ test suite of sdu_controllers can be run using ctest from the build directory:

cd build
ctest

The Python test suite can be run by first pip-installing the Python package and then running pytest from the top-level directory:

python -m pip install .
pytest

Documentation

sdu_controllers provides a Sphinx-based documentation, that can be browsed online at readthedocs.org. To build it locally, first ensure the requirements are installed by running this command from the top-level source directory:

pip install -r doc/requirements.txt

Then build the sphinx documentation from the top-level build directory:

cmake --build . --target sphinx-doc

The web documentation can then be browsed by opening doc/sphinx/index.html in your browser.

License
- OSI Approved :: MIT License
Operating System
- OS Independent
Programming Language
- Python :: 3

Download files

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

Source Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distributions

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

sdu_controllers-0.0.2-cp314-cp314-win_amd64.whl (4.9 MB view details)

Uploaded Aug 8, 2026 CPython 3.14Windows x86-64

sdu_controllers-0.0.2-cp314-cp314-win32.whl (4.5 MB view details)

Uploaded Aug 8, 2026 CPython 3.14Windows x86

sdu_controllers-0.0.2-cp314-cp314-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl (1.5 MB view details)

Uploaded Aug 8, 2026 CPython 3.14manylinux: glibc 2.27+ x86-64manylinux: glibc 2.28+ x86-64

sdu_controllers-0.0.2-cp314-cp314-macosx_11_0_arm64.whl (1.1 MB view details)

Uploaded Aug 8, 2026 CPython 3.14macOS 11.0+ ARM64

sdu_controllers-0.0.2-cp313-cp313-win_amd64.whl (4.9 MB view details)

Uploaded Aug 8, 2026 CPython 3.13Windows x86-64

sdu_controllers-0.0.2-cp313-cp313-win32.whl (4.5 MB view details)

Uploaded Aug 8, 2026 CPython 3.13Windows x86

sdu_controllers-0.0.2-cp313-cp313-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl (1.5 MB view details)

Uploaded Aug 8, 2026 CPython 3.13manylinux: glibc 2.27+ x86-64manylinux: glibc 2.28+ x86-64

sdu_controllers-0.0.2-cp313-cp313-macosx_11_0_arm64.whl (1.1 MB view details)

Uploaded Aug 8, 2026 CPython 3.13macOS 11.0+ ARM64

sdu_controllers-0.0.2-cp312-cp312-win_amd64.whl (4.9 MB view details)

Uploaded Aug 8, 2026 CPython 3.12Windows x86-64

sdu_controllers-0.0.2-cp312-cp312-win32.whl (4.5 MB view details)

Uploaded Aug 8, 2026 CPython 3.12Windows x86

sdu_controllers-0.0.2-cp312-cp312-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl (1.5 MB view details)

Uploaded Aug 8, 2026 CPython 3.12manylinux: glibc 2.27+ x86-64manylinux: glibc 2.28+ x86-64

sdu_controllers-0.0.2-cp312-cp312-macosx_11_0_arm64.whl (1.1 MB view details)

Uploaded Aug 8, 2026 CPython 3.12macOS 11.0+ ARM64

sdu_controllers-0.0.2-cp311-cp311-win_amd64.whl (4.9 MB view details)

Uploaded Aug 8, 2026 CPython 3.11Windows x86-64

sdu_controllers-0.0.2-cp311-cp311-win32.whl (4.5 MB view details)

Uploaded Aug 8, 2026 CPython 3.11Windows x86

sdu_controllers-0.0.2-cp311-cp311-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl (1.5 MB view details)

Uploaded Aug 8, 2026 CPython 3.11manylinux: glibc 2.27+ x86-64manylinux: glibc 2.28+ x86-64

sdu_controllers-0.0.2-cp311-cp311-macosx_11_0_arm64.whl (1.1 MB view details)

Uploaded Aug 8, 2026 CPython 3.11macOS 11.0+ ARM64

sdu_controllers-0.0.2-cp310-cp310-win_amd64.whl (4.9 MB view details)

Uploaded Aug 8, 2026 CPython 3.10Windows x86-64

sdu_controllers-0.0.2-cp310-cp310-win32.whl (4.5 MB view details)

Uploaded Aug 8, 2026 CPython 3.10Windows x86

sdu_controllers-0.0.2-cp310-cp310-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl (1.5 MB view details)

Uploaded Aug 8, 2026 CPython 3.10manylinux: glibc 2.27+ x86-64manylinux: glibc 2.28+ x86-64

sdu_controllers-0.0.2-cp310-cp310-macosx_11_0_arm64.whl (1.1 MB view details)

Uploaded Aug 8, 2026 CPython 3.10macOS 11.0+ ARM64

sdu_controllers-0.0.2-cp39-cp39-win_amd64.whl (4.9 MB view details)

Uploaded Aug 8, 2026 CPython 3.9Windows x86-64

sdu_controllers-0.0.2-cp39-cp39-win32.whl (4.5 MB view details)

Uploaded Aug 8, 2026 CPython 3.9Windows x86

sdu_controllers-0.0.2-cp39-cp39-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl (1.5 MB view details)

Uploaded Aug 8, 2026 CPython 3.9manylinux: glibc 2.27+ x86-64manylinux: glibc 2.28+ x86-64

sdu_controllers-0.0.2-cp39-cp39-macosx_11_0_arm64.whl (1.1 MB view details)

Uploaded Aug 8, 2026 CPython 3.9macOS 11.0+ ARM64

File details

Details for the file sdu_controllers-0.0.2-cp314-cp314-win_amd64.whl.

File metadata

Download URL: sdu_controllers-0.0.2-cp314-cp314-win_amd64.whl
Upload date: Aug 8, 2026
Size: 4.9 MB
Tags: CPython 3.14, Windows x86-64
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.13

File hashes

Hashes for sdu_controllers-0.0.2-cp314-cp314-win_amd64.whl
Algorithm	Hash digest
SHA256	`74aaebab0b5dc4ec88863b2392029b964d4a510f7cf2421f523b12a37b7d1024`
MD5	`09e135252836cb35872def174152d4bd`
BLAKE2b-256	`8767951ef9802b0591e9d50c04ae611654a6a7d05297a78d17b2071a9885a664`

Algorithm	Hash digest
SHA256	`a277d041c2f8f114782ea25bbe0720d4d0cbea15bc1f01adb928a0df983019ab`
MD5	`ab601fc4d60de4ee04398927a86d6c7d`
BLAKE2b-256	`b7103bb6a162a05148e7d613d255dae5815240a49473bb81293a2c8beac11d27`

Algorithm	Hash digest
SHA256	`93fa27a6966d5fed7033d734d6bcbfa3539e31f934af04712e0ae7754bbf7ba2`
MD5	`c56966650a29e9f5851cac079f1ff90d`
BLAKE2b-256	`b46d3c55b9a8f2962cba17d3f0b58fb89a005e6b4b96d301b71c3181c7fb51b2`

Algorithm	Hash digest
SHA256	`9ae836381a537ca5fb246ced7223efb7bb70b480072d5210f2b0ccf605ef55ba`
MD5	`3cb9736094a64cbbd7e978d9ecac79b6`
BLAKE2b-256	`5343d78e4ca4b9d0bd5e4eaf9b2fb8aea91c0876d16c604fb7c9772741b10f7a`

Algorithm	Hash digest
SHA256	`04f9dcc5e95fcaae377dd14d780d3604275fe4d213a25a31e58f46695ca4af71`
MD5	`3b079c4c7e121e28fec6e84bf29d2330`
BLAKE2b-256	`caf07800bf2faaf1d53d21755f9327c76073213ad316e75877b6bfcafa000cfa`

Algorithm	Hash digest
SHA256	`72090e1b61fc2ecf01e5c4d7a1135d204b0ab3c9938b5fe79bd3cf362d4b2346`
MD5	`5d24f0083cbb2e0a9b8ad29da45129cc`
BLAKE2b-256	`fdea54fb1e8be9dc946b034cf4786148eaf1bdff6aa22956694d7617e8cb46f3`

Algorithm	Hash digest
SHA256	`af04d0494a2d0db134b15eabaa7c8d22e4b8e3787e2845a4a153322b122b3079`
MD5	`d1ef7c66267542b4006edfeefdba340b`
BLAKE2b-256	`ded516788ed0df0cda66c56c47deaab74b238659e0b97da3ab6620fe0a3fdacb`

Algorithm	Hash digest
SHA256	`638acd1002eb07c40239254eb4cfc65e99010c8592f2bdbc850f02a12d709364`
MD5	`93c4596530316136884fcd40d9f4b768`
BLAKE2b-256	`58cea33d0a945a4765fa588e1caa64010765a80417348e46a2c736d8e2aee0b5`

Algorithm	Hash digest
SHA256	`60e8660948cf73024d6322b67ffccf0ce75bebca3c92b669c079c8124e166745`
MD5	`cf0c518a72332d0916710de0928e905b`
BLAKE2b-256	`5fe4e8659745a6d5da2d0aaffa8271aeb90776f651a9136a3065f2de1e6514d3`

Algorithm	Hash digest
SHA256	`3ec5bfc339e7bc2cc60dacf1571e18d27146e77d5de027618c8320ba3a9ea628`
MD5	`c0f46edeebfa0461369f0c9cd4548d84`
BLAKE2b-256	`ba25f666859031c02296b4f1fc7d0a0f3a066f8ec23d3a72d16541cd766f9241`

Algorithm	Hash digest
SHA256	`411b01ad5b1a9d2c57bca0a0a470be46331c9be2922f85b5eb046ad3b8297f45`
MD5	`05196aed24af2f91e3c776cef66bbe08`
BLAKE2b-256	`5e32fc45f01cb3fea8391300b6d4fede286a021fa8deb16a9ad8d3c726a5dd23`

Algorithm	Hash digest
SHA256	`f043849caabe9061901505b1aa61156b2eb62f7ec4cf7a39cb8cda17589e5123`
MD5	`d98b8de0805168f26fc0cbe685687ed9`
BLAKE2b-256	`224816030048a61a547735d6ba4b3906ea41e8bd6855943cec18edfa122383c6`

Algorithm	Hash digest
SHA256	`f834308d631cfa2a8171bb96de93389f8ef09c34cb50215f7394c06228f03590`
MD5	`2b3393d8c00e7797f5a70f2c4d41956a`
BLAKE2b-256	`535cb60935b231496e94e6c540935abd810704f06713b52db2e8f9c90f2812b9`

Algorithm	Hash digest
SHA256	`d0a2cda2239ca3d31c55decbdde168da3ce00d15eb582d05aea307eda5e33dd5`
MD5	`02b6cf81f0012503a32b3f457c849731`
BLAKE2b-256	`137c7cb40ce369dcda0721455a91ea0cb9b19abbbd2182d460b13e1f70b77f54`

Algorithm	Hash digest
SHA256	`aa3ca36df2d2eaf9d050d6509d91018c0e8ef22815a4c7278cc6bdc6925ad0ce`
MD5	`c08728fde11b2cfdad15bccddce2f72e`
BLAKE2b-256	`8523393796f8a01c127363d77087d343eb44168a156527677ca969dcd746522c`

Algorithm	Hash digest
SHA256	`8f58fb80f6770b589fcd616ff3ee2deb799228632291dfbff3d16d16210252d8`
MD5	`b71b6bf373256f2748fab027874507d2`
BLAKE2b-256	`d1e776e59435ff5435635a233079eb19c94748265bcc41a4b566ab4d3503a59c`

Algorithm	Hash digest
SHA256	`e43d11c1f2fe8de11dcd69d40512d6d27c2a2c8f3271979463957348ec8526d4`
MD5	`2feb5a7b6e9e58b31278eedae58016fb`
BLAKE2b-256	`d60e0f1005119866235f44a020c9b2ea3ca29bd7f5c2f2d26014f91207e476a2`

Algorithm	Hash digest
SHA256	`05a41c2fb429527a026f15324491c5d4b7e39d7d9932013144dd23196286759a`
MD5	`a0c28ddbdb5e322fa516571f336576f3`
BLAKE2b-256	`dba3f8176afbec3d0b68cc8e5b0c6d8b20729beed004e3c1575ecc0580e41ffb`

Algorithm	Hash digest
SHA256	`efe58a6c8a8aca28806d66165f5a1550e5c2096aa56453ad80b35ef0c4f1ed7a`
MD5	`e406f9b27863558297eb574bbc3cd24f`
BLAKE2b-256	`e7086180bbab8bf8ccd74d641424613b21192113bd30e474867fd57914a0deae`

Algorithm	Hash digest
SHA256	`cb35eafaac46788d159c3968a4cf87f8ef9e3772b39a9d6fe350674473a1729f`
MD5	`02fc096d0783e0e3f031daa4214d4b32`
BLAKE2b-256	`340dd353d7b2c903c8f9a840673a6bd5c928a069cc734fb9423d3564f2c2282e`

Algorithm	Hash digest
SHA256	`a3a30f5f8f89b010634d9f1725720c6ce45405002a6f11602ad3cd118395ee16`
MD5	`bb7bd360d86461baba899ce1c7fc8938`
BLAKE2b-256	`598816c6be64d4bc3f0c68c937b6beb4baea145dbc138d3a8be3a745d9c776a8`

sdu-controllers 0.0.2

sdu_controllers

Prerequisites

Building sdu_controllers

Dependencies

Build procedure

Testing sdu_controllers

Documentation

Key dates

1 maintainer

Credits

License

Requires

Classifiers

Download files

Source Distributions

Built Distributions

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Algorithm	Hash digest
SHA256	`6f1f0e5debcd173fa64bee04eafdb1c9e9ff642261b1f11ddd12b9e7995b9b74`
MD5	`9e7fe85edc4439a3a67cc719b50ff493`
BLAKE2b-256	`873d1aed5b7bb8e2e1f895f7dbd314135eb8895792010dde3f07aaf04864e8c2`

Algorithm	Hash digest
SHA256	`e55306d55c857de387a11cac260ed4d0c6a9b0dd1fb8559cbf039485157d9c60`
MD5	`d8bfbbfffdf2fe02945fe8a056959801`
BLAKE2b-256	`a686e84c2fbfa82d479d20a9f9603e53d9f6a5861fce6a00c448b0b598fb3daf`

Algorithm	Hash digest
SHA256	`8e8c4e8f354e2dd24144bfb8d6925d6e7773c1fd05945f89ce4136bb7e60d7ac`
MD5	`4feccf026fa86ad91496b72c4716edab`
BLAKE2b-256	`5cca2a8e8168560338521d54fea7beee5f14d362575ffbb9d0ef725a370eeb6e`