State Operations

State operations affect which sequences are in a Pool and how they are ordered, without directly modifying sequence content. They include methods to replicate, sample, slice, reorder, synchronize, filter, score, and eagerly evaluate Pool contents.

repeat

Repeat the state space of a pool N times (also available as *).

sample

Draw a fixed number of sequences, optionally with a reproducibility seed.

slice_states

Retain a contiguous slice of the state space.

shuffle_states

Randomly reorder the state space.

sync

Synchronize multiple pools to iterate in lockstep (in-place).

filter

Retain only sequences satisfying a predicate function.

score

Evaluate a function on each sequence and record the result as a design card column.

materialize

Eagerly generate sequences and cache them in a new standalone pool.