PlotJuggler Core

C++20 foundation libraries for PlotJuggler.

Modules

Module	Description	Dependencies
pj_base	Vocabulary types: Timestamp, DatasetId, TopicId, type trees, Expected<T>, Span<T>	None
pj_datastore	Columnar in-memory storage engine + ObjectStore (for media blobs) + DerivedEngine; typed schemas, chunk-based encoding, range/latest-at queries, derived transform DAG, Arrow IPC import	pj_base, fmt, tsl::robin_map, nanoarrow
pj_plugins	C-ABI plugin protocol (DataSource, MessageParser, Dialog, Toolbox families), C++ SDK base classes, plugin discovery, host-side loaders, and config helpers	pj_base, nlohmann/json

Getting Started

Prerequisites: C++20 compiler (GCC 11+), Conan 2, CMake 3.22+.

LLVM tooling (clang-format, clangd, clang-tidy)

wget https://apt.llvm.org/llvm.sh
chmod +x llvm.sh
sudo ./llvm.sh 22
sudo apt install clangd-22 clang-format-22 clang-tidy-22

Build and test

git clone <this repo>
cd plotjuggler_core

./build.sh              # RelWithDebInfo (build/)
./build.sh --debug      # Debug + ASAN (build/debug_asan)
./test.sh               # runs tests in all discovered build dirs
./run_clang_tidy.sh     # clang-tidy via clangd-22

Project Layout

pj_base/                   Vocabulary types (zero deps)
pj_datastore/              Columnar engine + ObjectStore + DerivedEngine
pj_plugins/                C-ABI plugin protocol, SDK, host loaders
docs/                      Project-wide design guides

License

See LICENSE file.