README.md

---

license: mit
tags:
- pytorch
- safetensors
- threshold-logic
- neuromorphic
- encoder
---


# threshold-binarytothermometer

Converts 3-bit binary to 7-bit thermometer code. A single-layer threshold circuit.

## Circuit

```

       b₂      b₁      b₀

        │       │       │

        │       │       │

    ┌───┴───┬───┴───┬───┴───┐

    │       │       │       │

    ▼       ▼       ▼       ▼

┌──────┐┌──────┐┌──────┐┌──────┐

│  y₀  ││  y₁  ││  y₂  ││ ...  │

│w:4,2,1│w:4,2,1│w:4,2,1│      │

│b: -1 ││b: -2 ││b: -3 ││      │

└──────┘└──────┘└──────┘└──────┘

    │       │       │       │

    ▼       ▼       ▼       ▼

   y₀      y₁      y₂  ... y₆

```

## Thermometer Code

Thermometer encoding represents value n as n consecutive ones:

| Value | Binary | Thermometer |
|-------|--------|-------------|
| 0 | 000 | 0000000 |
| 1 | 001 | 1000000 |
| 2 | 010 | 1100000 |
| 3 | 011 | 1110000 |
| 4 | 100 | 1111000 |
| 5 | 101 | 1111100 |
| 6 | 110 | 1111110 |
| 7 | 111 | 1111111 |

Like mercury rising in a thermometer - higher values fill more positions.

## Mechanism

Each output yᵢ fires when value > i:

```

yᵢ: (4·b₂ + 2·b₁ + 1·b₀) - (i+1) ≥ 0

```

The weights [4, 2, 1] compute the binary value. The bias sets the threshold.

| Output | Bias | Fires when |
|--------|------|------------|
| y₀ | -1 | value ≥ 1 |
| y₁ | -2 | value ≥ 2 |
| y₂ | -3 | value ≥ 3 |
| y₃ | -4 | value ≥ 4 |
| y₄ | -5 | value ≥ 5 |
| y₅ | -6 | value ≥ 6 |
| y₆ | -7 | value ≥ 7 |

## Why Thermometer?

Thermometer codes are used in:

- **DACs/ADCs**: Monotonic, glitch-free conversion
- **Flash ADCs**: Each comparator outputs one thermometer bit
- **Priority queues**: Natural ordering representation
- **Neural networks**: Unary encoding preserves magnitude relationships

## Single-Layer Elegance

This is one of the rare multi-output functions computable in a single layer. Each output is a simple threshold on the input value - no inter-neuron dependencies.

## Parameters

All neurons share the same weights, only biases differ:

| Component | Value |
|-----------|-------|
| Weights (all) | [4, 2, 1] |
| Biases | [-1, -2, -3, -4, -5, -6, -7] |

**Total: 7 neurons, 28 parameters, 1 layer**

## Usage

```python

from safetensors.torch import load_file

import torch



w = load_file('model.safetensors')



def binary_to_therm(b2, b1, b0):

    inp = torch.tensor([float(b2), float(b1), float(b0)])

    return [int((inp * w[f'y{i}.weight']).sum() + w[f'y{i}.bias'] >= 0)

            for i in range(7)]



# Value 5 -> thermometer with 5 ones

therm = binary_to_therm(1, 0, 1)

print(therm)  # [1, 1, 1, 1, 1, 0, 0]

```

## Files

```

threshold-binarytothermometer/

├── model.safetensors

├── model.py

├── config.json

└── README.md

```

## License

MIT