phanerozoic / threshold-atmost2outof8

threshold-atmost2outof8

At-most-2-out-of-8 detector. Fires when two or fewer inputs are active. The error-tolerance bound.

Circuit

  x₀ x₁ x₂ x₃ x₄ x₅ x₆ x₇
   │  │  │  │  │  │  │  │
   └──┴──┴──┴──┼──┴──┴──┴──┘
               ▼
          ┌─────────┐
          │ w: -1×8 │
          │ b:  +2  │
          └─────────┘
               │
               ▼
           HW ≤ 2?

The Double-Error Budget

This circuit allows:

• Zero active inputs (silence)
• One active input (single event)
• Two active inputs (pair/double event)

Three or more is considered "too many."

Mechanism

sum = -HW + 2

The bias of +2 grants a budget of two active inputs.

Error Detection Context

In coding theory:

• A code with minimum distance d can detect d-1 errors
• AtMost2 accepts patterns with ≤2 bit flips from all-zeros
• Useful for validating that corruption is within correctable limits

Dual of AtLeast6

Bitwise NOT maps AtMost2 inputs to AtLeast6 inputs.

Coverage

Fires on 1 + 8 + 28 = 37 of 256 inputs (14.5%).

Parameters

Usage

from safetensors.torch import load_file
import torch

w = load_file('model.safetensors')

def atmost2(bits):
    inp = torch.tensor([float(b) for b in bits])
    return int((inp * w['weight']).sum() + w['bias'] >= 0)

# Double event: allowed
print(atmost2([1,0,0,0,1,0,0,0]))  # 1

# Triple event: rejected
print(atmost2([1,0,0,1,1,0,0,0]))  # 0

Files

threshold-atmost2outof8/
├── model.safetensors
├── model.py
├── config.json
└── README.md

License

MIT