VyntriVyntri
API Reference

vyntri.data

Dataset loading, splitting, and folder dataset utilities.

vyntri.data

split(dataset, *, train=0.7, val=None, test=0.2, seed=42)

Create an explicit train/val/test split from a folder-per-class dataset. Returns a SplitResult.

ParameterTypeDescription
datasetstrPath to a folder-per-class dataset
trainfloatTraining fraction (default 0.7)
valfloat | NoneValidation fraction. When None, computed as 1 - train - test.
testfloatTest fraction (default 0.2)
seedintDeterministic seed (default 42)

Returns: SplitResult

Raises: SplitError if the dataset already has an explicit layout.

SplitResult

Reusable result of split(). Contains logical FolderDataset subsets (no file copy).

FieldTypeDescription
trainFolderDatasetTraining subset
valFolderDataset | NoneValidation subset (None for two-way split)
testFolderDataset | NoneTest subset (None if test=0)
seedintSeed used for the split
fractionsdictFractions per split
countsdictSample counts per split
manifestdictFull provenance record
class_nameslist[str]Sorted class names
Example
from vyntri.data import split
from vyntri import Vyntri

s = split("./my_dataset", train=0.7, test=0.2, seed=42)
model = Vyntri()
model.fit(train=s.train, val=s.val)
result = model.evaluate(s.test)
print(f"Accuracy: {result.accuracy:.1%}")

FolderDataset.from_ids(root, sample_ids)

Create a logical subset by sample IDs. No physical file copy.