A protocol-agnostic physics simulation library for embedded systems.
FluxGraph is a standalone C++ library that provides signal storage, graph compilation, transforms, models, and deterministic tick execution. FluxGraph enables embeddable physics simulation in any C++ host application.
- Zero dependencies - Core library has no external dependencies
- Protocol-agnostic - No assumptions about YAML, gRPC, or protobuf in core
- Single-writer design - No internal synchronization overhead
- Embeddable - Works in any C++ host application
- Scientific rigor - Dimensional analysis, topological correctness, stability validation
- C++17 - Modern C++ with clean API
- CMake 3.20 or later
- C++17 compatible compiler (MSVC 2019+, GCC 9+, Clang 10+)
# Clone
git clone https://github.com/FEASTorg/fluxgraph.git
cd fluxgraph
# Prerequisite
export VCPKG_ROOT=/path/to/vcpkg
# Configure + build (preset-first)
cmake --preset dev-release
cmake --build --preset dev-release
# Run tests
ctest --preset dev-release# Windows (MSVC presets)
$env:VCPKG_ROOT = "D:\\Tools\\vcpkg"
cmake --preset dev-windows-release
cmake --build --preset dev-windows-release --config Release
ctest --preset dev-windows-releaseOptional graph loaders can be enabled:
| Option | Default | Description |
|---|---|---|
FLUXGRAPH_JSON_ENABLED |
OFF | Enable JSON graph loader (requires nlohmann-json) |
FLUXGRAPH_YAML_ENABLED |
OFF | Enable YAML graph loader (requires yaml-cpp) |
Dependency/build/CI governance: docs/dependencies.md.
Dependencies are resolved via vcpkg manifests and find_package(...) (no FetchContent drift in CI).
See examples/ for complete usage patterns. Here's a minimal example:
#include <fluxgraph/engine.hpp>
#include <fluxgraph/core/signal_store.hpp>
#include <fluxgraph/core/namespace.hpp>
#include <fluxgraph/graph/compiler.hpp>
int main() {
// 1. Create namespaces and signal store
fluxgraph::SignalNamespace sig_ns;
fluxgraph::FunctionNamespace func_ns;
fluxgraph::SignalStore store;
// 2. Build graph specification
fluxgraph::GraphSpec spec;
fluxgraph::EdgeSpec edge;
edge.source_path = "sensor.voltage_in";
edge.target_path = "sensor.voltage_out";
edge.transform.type = "linear";
edge.transform.params["scale"] = 2.0;
edge.transform.params["offset"] = 1.0;
spec.edges.push_back(edge);
// 3. Compile and load
fluxgraph::GraphCompiler compiler;
auto program = compiler.compile(spec, sig_ns, func_ns);
fluxgraph::Engine engine;
engine.load(std::move(program));
// 4. Get signal ports
auto input_sig = sig_ns.resolve("sensor.voltage_in");
auto output_sig = sig_ns.resolve("sensor.voltage_out");
// 5. Simulation loop
store.write(input_sig, 5.0, "V");
engine.tick(0.1, store);
double result = store.read_value(output_sig); // 11.0V (2*5 + 1)
return 0;
}More examples:
01_basic_transform- Simple signal transformation02_thermal_mass- Physics simulation with models03_json_graph- Load graph from JSON file04_yaml_graph- Load graph from YAML file
fluxgraph/
+-- include/fluxgraph/ # Public API headers
| +-- core/ # Core types, signal storage, namespaces
| +-- transform/ # Signal transforms
| +-- model/ # Physics models
+-- src/ # Implementation
+-- tests/ # Unit and analytical tests
+-- examples/ # Example applications
+-- docs/ # DocumentationAGPL v3 License - See LICENSE for details
This project is part of the FEAST ecosystem. See CONTRIBUTING.md for guidelines.
- anolis-provider-sim - Simulation provider which uses FluxGraph for physics simulation
- anolis - FEAST automation runtime
0.1.1 - Current pre-release
