Realm
A city of illuminated compute pathways representing the OA Data module

Data into models.
Contracts intact.

Small enough to understand. Complete enough to train.

OA Data owns deterministic dataset composition and batch iteration. Domain transforms stay with Vision, Audio, and Ml; device execution remains with the shared engine.

01

Dataset and Sample

Datasets expose indexed retrieval and stable size. Each sample carries an input Matrix and an optional target Matrix without creating another tensor type.
02

Seeded split and shuffle

FnDataset produces reproducible shuffled indices and train, validation, and test splits from explicit seeds and ratios.
03

Zero-copy subsets

DsSubset owns only an index list and borrows its parent dataset; sample storage is not duplicated to create a split.
04

Checked collation

Samples stack along a leading batch dimension only when shape, dtype, storage, and target presence agree.
05

Deterministic iteration

DataLoader owns batch order, batch size, seeded shuffling, drop-last behavior, epoch reset, and current-batch state.
06

Native training values

Batches remain OA matrices and enter the Ml path directly, preserving the same device and execution contract as the model.

The old streaming experiments are not the product.

Earlier OA trees explored broad data infrastructure. The current public contract keeps only the parts with clear ownership and tests; advanced sources return when a real consumer can prove them.

01

No hidden I/O

The current Data surface does not claim an implicit filesystem, network, mmap, or io_uring backend.
02

No phantom workers

There is no invisible prefetch pool, background upload path, or infinite-streaming runtime behind DataLoader.
03

No second tensor system

Samples and batches use OA Matrix values rather than crossing into a parallel host array or framework contract.
04

Future work stays bounded

Async sources and prefetch return only as explicit sessions with cancellation, backpressure, completion, and workload evidence.