For new projects, start with SuperJupiter Sensor Toolkit. This standalone package and its published releases remain available. Existing installations need no change.
If migrating with PlatformIO, replace the standalone dependency with:
lib_deps = superjupiter/SuperJupiterSensorToolkit@0.1.0Replace this standalone include:
#include <SuperJupiterTimeAggregate.h>with this consolidated include:
#include <SuperJupiter/SensorToolkit/TimeAggregate.h>The component namespace and behaviour are preserved from standalone 0.1.1. If using an earlier version, review its API migration requirements first. Use one implementation of this component per application; do not mix standalone and consolidated copies.
See the consolidated migration guide and consolidated README for Arduino/CMake installation. Hardware validation pending.
Fixed-period observation summaries with explicit empty buckets and coverage.
Version 0.1.1: evolving preview. Hardware validation pending.
Original MIT-licensed portable C++11 by SuperJupiter. No mandatory service, hidden clock reads, network calls or heap allocation in the core.
Buckets start at the first accepted timestamp and are half-open [start,start+period). push returns Completed when an observation enters a later bucket; takeCompleted reads the last completed bucket. Skipped empty buckets are counted, not fabricated as measurements. Consume Completed results before another push. Coverage is first-to-last finite observation span divided by period, not continuous sensing proof. Invalid observations are counted and retained in bucket totals; means use finite samples only. No time weighting.
PlatformIO exact release (after registry publication):
lib_deps = superjupiter/SuperJupiterTimeAggregate@0.1.1Arduino: use the versioned GitHub release ZIP. Library Manager registration and index propagation are separate steps; check the official index before relying on IDE availability.
#include <SuperJupiterTimeAggregate.h>
using namespace superjupiter::time_aggregate;
int main() {
TimeAggregate minutes(60000);
minutes.push(20,0);minutes.push(21,1000);minutes.push(22,60000);
Summary previous;
minutes.takeCompleted(previous);
return 0;
}
For Arduino, open examples/Minimal. It uses synthetic data only.
Results are deliberately local so applications can inspect outcomes before adding I/O.
add_subdirectory(path/to/superjupiter-time-aggregate)
target_link_libraries(your_app PRIVATE SuperJupiter::TimeAggregate)For an installed package use find_package(SuperJupiterTimeAggregate 0.1 CONFIG REQUIRED).
Top-level CMake builds tests/examples; a subproject does not enable developer tools by default.
cmake -S . -B build/cmake
cmake --build build/cmake
ctest --test-dir build/cmake --output-on-failure
python3 tools/check_release.py --tag v0.1.1Keep raw observations and their provenance in your application. Derived results are not physical truth. Do not use fast-math or finite-math-only compiler assumptions. AVR double may have float precision. Software tests, board compilation and physical validation are reported separately.
Complements SensorQuality and SampleWindow without a required dependency. Each component can be used independently. Domain models, customer data and proprietary applications are excluded.
MIT. Report reproducible bugs through repository issues; private security reports: info@superjupiter.net. Include version, configuration, inputs, expected and observed behaviour. No credentials or private customer data.
This patch includes independent regression tests and a reviewed interoperability contract. Hardware validation pending.
- Removed unused duplicated math helpers and unnecessary includes.
- Valid long consecutive intervals cross buckets and wraps correctly; stable means and explicit numeric validity retain accurate finite counts.