File size: 2,638 Bytes
1c68242
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
---

license: mit
tags:
- pytorch
- safetensors
- threshold-logic
- neuromorphic
- modular-arithmetic
---


# threshold-mod3

Computes Hamming weight mod 3 for 8-bit inputs. Multi-layer network using thermometer encoding.

## Circuit

```

  xβ‚€ x₁ xβ‚‚ x₃ xβ‚„ xβ‚… x₆ x₇

   β”‚  β”‚  β”‚  β”‚  β”‚  β”‚  β”‚  β”‚

   β””β”€β”€β”΄β”€β”€β”΄β”€β”€β”΄β”€β”€β”Όβ”€β”€β”΄β”€β”€β”΄β”€β”€β”΄β”€β”€β”˜

               β–Ό

       β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”

       β”‚ Thermometer β”‚  Layer 1: 9 neurons

       β”‚  Encoding   β”‚  Fires when HW β‰₯ k

       β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜

               β”‚

               β–Ό

       β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”

       β”‚  MOD-3      β”‚  Layer 2: 2 neurons

       β”‚  Detection  β”‚  Weight pattern (1,1,-2)

       β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜

               β”‚

               β–Ό

       β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”

       β”‚  Classify   β”‚  Output: 3 classes

       β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜

               β”‚

               β–Ό

          {0, 1, 2}

```

## Algebraic Insight

The weight pattern `(1, 1, -2)` causes cumulative sums to cycle mod 3:

```

HW=0: sum=0 β†’ 0 mod 3

HW=1: sum=1 β†’ 1 mod 3

HW=2: sum=2 β†’ 2 mod 3

HW=3: sum=0 β†’ 0 mod 3  (reset: 1+1-2=0)

HW=4: sum=1 β†’ 1 mod 3

...

```

The key: `1 + 1 + (1-3) = 0`. Every 3 increments, the sum resets.

This generalizes to MOD-m: use `(1, 1, ..., 1, 1-m)` with m-1 ones.

## Architecture

| Layer | Neurons | Function |
|-------|---------|----------|
| Input | 8 | Binary bits |
| Hidden 1 | 9 | Thermometer: fires when HW β‰₯ k |
| Hidden 2 | 2 | MOD-3 detection |
| Output | 3 | One-hot classification |

**Total: 14 neurons, 110 parameters**

## Output Distribution

| Class | HW values | Count/256 |
|-------|-----------|-----------|
| 0 | 0, 3, 6 | 85 |
| 1 | 1, 4, 7 | 86 |
| 2 | 2, 5, 8 | 85 |

## Usage

```python

from safetensors.torch import load_file

import torch



w = load_file('model.safetensors')



def forward(x):

    x = x.float()

    x = (x @ w['layer1.weight'].T + w['layer1.bias'] >= 0).float()

    x = (x @ w['layer2.weight'].T + w['layer2.bias'] >= 0).float()

    out = x @ w['output.weight'].T + w['output.bias']

    return out.argmax(dim=-1)



inp = torch.tensor([[1,0,1,1,0,0,1,0]])  # HW=4

print(forward(inp).item())  # 1 (4 mod 3 = 1)

```

## Files

```

threshold-mod3/

β”œβ”€β”€ model.safetensors

β”œβ”€β”€ model.py

β”œβ”€β”€ config.json

└── README.md

```

## License

MIT