Sequence 📿

An ordered collection of hypervectors with positional encoding. See Composites: Sequence for the conceptual overview.

Constructor

# Constructing a sequence, with logical index start at 1 (default to 0).
seq = hv.Sequence(hv.Seed128(0, 42), first, second, third, start=1)

seq := hv.NewSequence(hv.NewSeed128(0, 42), 1, first, second, third)

#![allow(unused)]
fn main() {
let seq = Sequence::new(Seed128::new(0, 42), 1, members);
}

Derived Sequences: Append / Prepend / Reset

Append, Prepend, and Reset all return a new Sequence — a Sequence is an immutable value, so the receiver is never changed.

Append(more...) — members added at the end. start is unchanged.
Prepend(more...) — members added at the front; start decrements by len(more) so existing members keep their positional binding.
Reset(start) — shift the starting index. Returns an equal Sequence when start equals the current start.

The result equals what you’d get by building a fresh NewSequence(seed, new_start, all_members...) — the domain/pod seed is preserved.

seq = hv.Sequence(hv.Seed128(0, 42), a, b, c)

# Append / Prepend are variadic and return new Sequences.
s1 = seq.append(d, e)       # [a, b, c, d, e]; seq unchanged
s2 = seq.prepend(x, y)      # [x, y, a, b, c], start -= 2; seq unchanged
s3 = seq.reset(10)          # starting index 10; seq unchanged

seq := hv.NewSequence(hv.NewSeed128(0, 42), 0, a, b, c)

s1 := seq.Append(d, e)      // [a, b, c, d, e]; seq unchanged
s2 := seq.Prepend(x, y)     // [x, y, a, b, c], start -= 2; seq unchanged
s3 := seq.Reset(10)         // starting index 10; seq unchanged

#![allow(unused)]
fn main() {
let seq = Sequence::new(Seed128::new(0, 42), 0, vec![a, b, c]);

// Consuming self: clone first when deriving several from one base.
let s1 = seq.clone().append(vec![d, e]); // [a, b, c, d, e]
let s2 = seq.clone().prepend(vec![x, y]); // [x, y, a, b, c], start -= 2
let s3 = seq.reset(10); // starting index 10; consumes seq
}

Keyboard shortcuts

Kongming HV Documentation

Sequence 📿

Constructor

Derived Sequences: Append / Prepend / Reset