Discrete helpers/binv

This is a simple helper class for binary vectors.

from discretehelpers.binv import Binv


binv = Binv('1101000')

# properties
assert binv.length == 7
assert binv.weight == 3
assert binv.vector == [True, True, False, True, False, False, False]
assert binv.string == '1101000'
assert binv.exposet == {0, 1, 3}  # little-endian
assert binv.intval == 11  # 2**0 + 2**1 + 2**3
assert binv.changes == 3  # changes between 0 and 1 (down, up, down)
assert binv.complement == ~binv == Binv('0010111')

# equivalent instantiations
assert binv == Binv('11 01 000')
assert binv == Binv([1, 1, 0, 1, 0, 0, 0])
assert binv == Binv(intval=11, length=7)
assert binv == Binv(exposet={0, 1, 3}, length=7)

The property pretty can be used when the length is a power of two up to 64:

Binv(intval=38505).pretty == '1001 0110 0110 1001'

integer values

The smallest bit is on the left!

An important use is conversion to and from decimal. The interpretation is little-endian, i.e. the least-significant bit is on the left.

for i in range(16):
    s = Binv(intval=i, length=4).string
    padded_i = str(i).zfill(2)
    print(padded_i, s)