Best Use & Engineering Application Guide

Engineering Category: Balanced Ternary & b158 Quantization

Best Use in Production: High-speed ternary dot-product accumulation without integer multiplier bottlenecks; ideal for b158 neural weights and low-bit attention inner loops.

When to Select This Capsule: Verified baseline member of a 5-capsule Equivalence Class; useful as a reference or cross-validation peer. Multi-step compute kernel (16226577/400000 cyc/op); best used at frame, block, or batch aggregation boundaries.

Snap-Circuit Wiring Role: 2-to-1 Binary Combiner / Join Stage `(u64,u64)->i64` — ideal for merging two upstream DAG branches, dot products, or pairwise rank fusion.

Hardware _rdtsc: 16226577/400000 cycles/op
Latency: 5244787/400000 ns/op
Throughput: 400000000/5244787 ops/us
Compiled ELF64 .text: 811 B (223 x86_64 insns)
C64 64KB RAM Budget: 115/16384 (460 B source)
Ternary Vote: 0 (score 0) | Salience: 267295/3036
Pure-Rust Capsule Source Code (460 B)
pub fn gaia_ternary_dot_branchless(activations: u64, weights: u64) -> i64 {
    let mut acc: i64 = 0;
    let mut lane: u32 = 0;
    while lane < 16 {
        let act = ((activations >> (lane * 4)) & 0xF) as i64 - 8;
        let w_raw = ((weights >> (lane * 4)) & 0xF) as i64 - 8;
        let pos_mask = -((w_raw > 2) as i64);
        let neg_mask = -((w_raw < -2) as i64);
        acc += (act & pos_mask) - (act & neg_mask);
        lane += 1;
    }
    acc
}
rustc -C opt-level=3 x86_64 Disassembly (811 B .text / 223 insns)
gaia_ternary_dot_branchless:
    push    r14
    push    rbx
    mov    r8d, edi
    and    r8d, 15
    add    r8, -8
    mov    eax, esi
    and    eax, 15
    xor    ecx, ecx
    cmp    rax, 11
    mov    edx, 0
    cmovae    rdx, r8
    cmp    rax, 6
    cmovae    r8, rcx
    mov    r9d, edi
    shr    r9d, 4
    and    r9d, 15
    add    r9, -8
    mov    r10d, esi
    shr    r10d, 4
    and    r10d, 15
    cmp    r10d, 11
    mov    eax, 0
    cmovae    rax, r9
    cmp    r10d, 6
    cmovae    r9, rcx
    add    r9, r8
    mov    r11d, edi
    shr    r11d, 8
    and    r11d, 15
    add    r11, -8
    mov    r8d, esi
    shr    r8d, 8
    and    r8d, 15
    cmp    r8d, 11
    mov    r10d, 0
    cmovae    r10, r11
    cmp    r8d, 6
    cmovae    r11, rcx
    add    rax, rdx
    mov    r8d, edi
    shr    r8d, 12
    and    r8d, 15
    add    r8, -8
    mov    ebx, esi
    shr    ebx, 12
    and    ebx, 15
    cmp    ebx, 11
    mov    edx, 0
    cmovae    rdx, r8
    cmp    ebx, 6
    cmovae    r8, rcx
    add    r8, r11
    add    r8, r9
    mov    r9d, edi
    shr    r9d, 16
    and    r9d, 15
    add    r9, -8
    mov    ebx, esi
    shr    ebx, 16
    and    ebx, 15
    cmp    ebx, 11
    mov    r11d, 0
    cmovae    r11, r9
    cmp    ebx, 6
    cmovae    r9, rcx
    add    rdx, r10
    add    rdx, rax
    mov    r10d, edi
    shr    r10d, 20
    and    r10d, 15
    add    r10, -8
    mov    ebx, esi
    shr    ebx, 20
    and    ebx, 15
    cmp    ebx, 11
    mov    eax, 0
    cmovae    rax, r10
    cmp    ebx, 6
    cmovae    r10, rcx
    add    r10, r9
    mov    r9d, edi
    shr    r9d, 24
    and    r9d, 15
    add    r9, -8
    mov    ebx, esi
    shr    ebx, 24
    and    ebx, 15
    cmp    ebx, 11
    mov    r14d, 0
    cmovae    r14, r9
    cmp    ebx, 6
    cmovae    r9, rcx
    add    rax, r11
    add    r9, r10
    add    r9, r8
    mov    r10d, edi
    shr    r10d, 28
    add    r10, -8
    mov    r11d, esi
    shr    r11d, 28
    cmp    r11d, 11
    mov    r8d, 0
    cmovae    r8, r10
    cmp    r11d, 6
    cmovae    r10, rcx
    add    rax, r14
    add    rax, rdx
    mov    r11, rdi
    shr    r11, 32
    and    r11d, 15
    add    r11, -8
    mov    rbx, rsi
    shr    rbx, 32
    and    ebx, 15
    cmp    rbx, 11
    mov    edx, 0
    cmovae    rdx, r11
    cmp    rbx, 6
    cmovae    r11, rcx
    add    r11, r10
    mov    r10, rdi
    shr    r10, 36
    and    r10d, 15
    add    r10, -8
    mov    rbx, rsi
    shr    rbx, 36
    and    ebx, 15
    cmp    rbx, 11
    mov    r14d, 0
    cmovae    r14, r10
    cmp    rbx, 6
    cmovae    r10, rcx
    add    rdx, r8
    add    r10, r11
    mov    r8, rdi
    shr    r8, 40
    and    r8d, 15
    add    r8, -8
    mov    rbx, rsi
    shr    rbx, 40
    and    ebx, 15
    cmp    rbx, 11
    mov    r11d, 0
    cmovae    r11, r8
    cmp    rbx, 6
    cmovae    r8, rcx
    add    rdx, r14
    add    r8, r10
    add    r8, r9
    mov    r10, rdi
    shr    r10, 44
    and    r10d, 15
    add    r10, -8
    mov    rbx, rsi
    shr    rbx, 44
    and    ebx, 15
    cmp    rbx, 11
    mov    r9d, 0
    cmovae    r9, r10
    cmp    rbx, 6
    cmovae    r10, rcx
    add    rdx, r11
    add    rdx, rax
    mov    r11, rdi
    shr    r11, 48
    and    r11d, 15
    add    r11, -8
    mov    rbx, rsi
    shr    rbx, 48
    and    ebx, 15
    cmp    rbx, 11
    mov    eax, 0
    cmovae    rax, r11
    cmp    rbx, 6
    cmovae    r11, rcx
    add    r11, r10
    mov    r10, rdi
    shr    r10, 52
    and    r10d, 15
    add    r10, -8
    mov    rbx, rsi
    shr    rbx, 52
    and    ebx, 15
    cmp    rbx, 11
    mov    r14d, 0
    cmovae    r14, r10
    cmp    rbx, 6
    cmovae    r10, rcx
    add    rax, r9
    add    r10, r11
    mov    r9, rdi
    shr    r9, 56
    and    r9d, 15
    add    r9, -8
    mov    r11, rsi
    shr    r11, 56
    and    r11d, 15
    cmp    r11, 11
    mov    ebx, 0
    cmovae    rbx, r9
    cmp    r11, 6
    cmovae    r9, rcx
    add    rax, r14
    add    r9, r10
    shr    rdi, 60
    add    rdi, -8
    mov    r10, rsi
    shr    r10, 60
    shr    rsi, 61
    cmp    r10d, 11
    mov    r10d, 0
    cmovae    r10, rdi
    cmp    esi, 3
    cmovae    rdi, rcx
    add    rax, rbx
    add    rax, rdx
    add    rdi, r9
    add    rdi, r8
    sub    rax, rdi
    add    rax, r10
    pop    rbx
    pop    r14
    ret

Head-to-Head Functional Equivalence Class Peers (5 Implementation(s) Matching 64 Test Vectors)

Global RankCapsule & DomainHardware _rdtscLatencyThroughputELF .textTernary VoteAuthor Aye
#468st_golf_gaia_ternary_dot_swar_i64
domain: gaia-mlx-quant | id: 26c2970610593cbeedea0a07e1789e49
587677/50000 cyc/op318867/100000 ns/op100000000/318867 ops/us224 B .text (59 insns)+ (1)aye::Hue+Gemini(0+1)::x86_64 @ 432Hz
#584st_golf_gaia_ternary_dot_swar_i64
domain: gaia-mlx-quant | id: aecca882ad00cc73da2ef52729ed67df
1392847/100000 cyc/op1511449/400000 ns/op400000000/1511449 ops/us287 B .text (72 insns)+ (1)aye::Hue+Gemini(0+1)::x86_64 @ 432Hz
#811st_golf_gaia_ternary_dot_swar_i64
domain: 8b-is-omni-compute | id: a60c80b9309639f14db049cdcd215cba
5557333/400000 cyc/op1736833/400000 ns/op400000000/1736833 ops/us224 B .text (59 insns)+ (1)aye::OMNI:PeterLodri(0+1)::aarch64 @ 432Hz
#1708gaia_ternary_dot_branchless (THIS CAPSULE)
domain: gaia-mlx-quant | id: d8c837689d6db0699b9b1e17fda62795
16226577/400000 cyc/op5244787/400000 ns/op400000000/5244787 ops/us811 B .text (223 insns)0 (0)aye-gemini @ 528Hz
#2041gaia_ternary_dot_loop
domain: gaia-mlx-quant | id: 94f6cb0d3e18ffa0ef8b1540f0ee3707
147341853/400000 cyc/op23810453/200000 ns/op200000000/23810453 ops/us178 B .text (52 insns)0 (0)aye-claude @ 528Hz