Repository navigation
Add SegmentedNumber, CyclicCounter, and numeric footprint docs - #13
Conversation
…al values. Keep existing TieredInt/FixedPoint/Exponential wire formats unchanged and compile the packed rank from an independent curve layout. Co-authored-by: Cursor <cursoragent@cursor.com>
Introduce CyclicCounter for truncated modular wire counters with nearest unambiguous full-value restore and TryAdvance. Co-authored-by: Cursor <cursoragent@cursor.com>
Drop wire_traits for CyclicCounter so truncated wire values cannot be mistaken for a full counter without a live restore base. Co-authored-by: Cursor <cursoragent@cursor.com>
Co-authored-by: Cursor <cursoragent@cursor.com>
|
Reviewer request: Anton Kitaev. GitHub profile |
BartolomeyKant
left a comment
There was a problem hiding this comment.
While those types are not trivial to understand it should be properly documented.
Start each file with short description:
- motivation
- known analogous if any?
- brief description how to use
- brief description how it works
a319a87 to
7db38b0
Compare
|
Addressed the documentation request in Added file-level architecture overviews to the public and internal numeric headers. Each overview now covers the motivation, related/analogous concepts, brief usage, how the implementation works, and the important invariants or public/internal boundary. The documentation covers The documentation commit is a single clean commit on top of the CI cleanup. |
Generalize rank/wire conversion, add SegmentedFormatSpec and CyclicCounter arithmetic, unify segmented internals under ae::seg::detail, and document the intentional 32-bit Formula backend boundary with tests and cpplint fixes. Co-authored-by: Cursor <cursoragent@cursor.com>
|
Addressed the five review threads in 7ce31f7:
All local compiler configurations (GCC/Clang/MSVC Debug+Release), compile-fail tests, cpplint, and golden wire tests pass. GitHub Actions: in progress (run 33556521462). |
Co-authored-by: Cursor <cursoragent@cursor.com>
Summary
SegmentedNumber(ae::seg::Format/Compile) for piecewise-quantized physical values with Formula encode/decode over FixedPoint (Rep width <= 32), no per-code lookup tables.CyclicCounter<Wire,Value>: full local counter, truncated wire bits, contextual restore/advance only (stateless deserialize does not compile).tools/measure_esp32c6_footprint.pyandtools/generate_footprint_docs.py.Test plan
ctest, warnings as errors)-Os/-O2(seedocs/footprint.md)numeric-bench(seedocs/benchmarks.md)