sensorbox

A package for processing sensor data.

Core C++ Library

Prerequisites

Dependency	Version	Description
CMake	>= 3.21	CMake Build Tool
cmakebox	>= 0.0.9	CMake Functions and Utilities
cppbox	>= 0.1.5	C++ Package
Eigen3	>= 3.4.0	Linear Algebra Package
nlohmann_json	>= 3.7.3 (< g++-10) or >= 3.8.0 (>= g++-10)	JSON Package
mathbox	0.7.0	Math Package

There are several ways to include sensorbox within your project:

• [Preferred] Via FetchContent allowing package to be built as a submodule.
• Via find_package, requiring package to be installed to the system, locally, or to a catkin workspace.

Include via FetchContent

It is recommended to leverage the functionality of cmakebox by including the following lines in the CMakeLists.txt (replace X.Y.Z with version):

set(CMAKEBOX_VERSION "0.0.9")
FetchContent_Declare(
    cmakebox
    GIT_REPOSITORY git@github.com:willat343/cmakebox.git
    GIT_TAG v${CMAKEBOX_VERSION}
)
FetchContent_MakeAvailable(cmakebox)
list(APPEND CMAKE_MODULE_PATH "${cmakebox_SOURCE_DIR}/cmake")
include(CMakeBox)

set(SENSORBOX_VERSION "X.Y.Z")
import_dependency(
    sensorbox
    TARGET sensorbox::sensorbox
    VERSION ${SENSORBOX_VERSION}
    GIT_REPOSITORY git@github.com:willat343/sensorbox
    GIT_TAG v${SENSORBOX_VERSION}
)

Without relying on cmakebox, this can be achieved with (replace X.Y.Z with version):

set(SENSORBOX_VERSION "X.Y.Z")
FetchContent_Declare(
    sensorbox
    GIT_REPOSITORY git@github.com:willat343/sensorbox
    GIT_TAG        v${SENSORBOX_VERSION}
)
FetchContent_MakeAvailable(sensorbox)

Include via Install

Clone

git clone git@github.com:willat343/sensorbox.git
cd sensorbox

Configure

For system install:

cmake -S . -B build

For local install:

cmake -S . -B build -DCMAKE_INSTALL_DIR=$HOME/.local

Build

cmake --build build -j

Install

sudo cmake --build build --target install

Include

Include with the following lines in the CMakeLists.txt:

find_package(sensorbox REQUIRED)
target_link_libraries(<target> PUBLIC sensorbox::sensorbox)

Uninstall

sudo cmake --build build --target uninstall

Include in Catkin Workspace

A package.xml is supplied to facilitate an isolated installation within a catkin workspace (e.g. for ROS applications).

Clone

cd /path/to/catkin_ws/src
git clone git@github.com:willat343/sensorbox.git

Build

cd /path/to/catkin_ws
catkin build sensorbox

Include

To use the package in a downstream project, one should add to their package.xml:

<depend>sensorbox</depend>

One can then include sensorbox package by includeing in the CMakeLists.txt:

find_package(sensorbox REQUIRED)
target_link_libraries(<target> PUBLIC sensorbox::sensorbox)

Clean

cd /path/to/catkin_ws
catkin clean sensorbox

Documentation

Documentation must be turned on by setting the -DBUILD_DOCUMENTATION=ON cmake argument.

To view the HTML documentation, open the build/docs/html/index.html file.

To view the LaTeX documentation, build it with:

cd build/docs/latex
make

Then open the file refman.pdf.

Tests

Tests must be turned on by setting the -DBUILD_TESTS=ON cmake argument.

They can then be run with ctest:

ctest --test-dir test

For more explicit output, the test executables can be run directly from the build directory.