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

Data into models.
Contracts intact.

From sample to model. Every boundary explicit.

Index, partition, collate, and iterate through one deterministic contract. Batches stay OA matrices when they enter training.

A dense city of illuminated data pathways viewed from above

Indexed samples

Datasets expose stable size and indexed retrieval; each sample carries an input Matrix and an optional target Matrix.

An interconnected city seen from above the Earth

Seeded partitions

Explicit seeds produce reproducible shuffle order and train, validation, and test splits.

A symmetrical compute room with server racks and a central illuminated structure

Checked batches

Collation stacks samples only when their shapes, dtypes, storage, and target presence agree.

A tree surrounded by fine data visualizations in a dark gallery

Model-ready values

DataLoader yields deterministic batches as ordinary OA matrices ready for the Ml path.

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.

One library. Across the stack.

Follow the same Engine, values, and explicit execution contract into another module.