Dataset acquisition and local layout

August 12, 2026 ยท View on GitHub

Expected object format

Each benchmark dataset lives in its own local directory:

Data/<dataset>/<dataset>.RData
Data/<dataset>/<dataset>_float32.RData
Data/<dataset>/MATERIALS_AND_METHODS.md

The standard R file should define dataset, a list with:

dataset$data    # samples by variables matrix
dataset$labels  # vector/factor of length nrow(dataset$data)

The float32 companion is used only by fastEmbedR paths that accept float::float32. Reference R packages must load the ordinary R matrix rather than a converted float32 object. Generated KNN, PCA, Python NPZ, and validation objects belong under fastEmbedR-input/, never under a replicate result directory.

Publication panel

DatasetRedistribution in this repositoryAcquisition/preparation rule
COIL20NoDownload from the Columbia Object Image Library provider or another source whose terms permit your use; record image preprocessing.
USPSNoObtain from OpenML or the original provider; optional Kaggle replication requires the user's own credentials and acceptance of Kaggle terms.
FashionMNISTNoDownload from the Zalando Research release; retain source checksums.
MNISTNoDownload the official IDX files or an equivalent documented public mirror; benchmark flattened 28 by 28 images.
MetRefNoLoad from the KODAMA R package and apply the documented zero-column removal, normalization, scaling, and donor-label procedure.
flow18 and mass41NoObtain from the source accompanying the opt-SNE study/release and retain its labels and preprocessing metadata.
FlowRepository FR-FCM-ZYRMNoObtain from FlowRepository accession FR-FCM-ZYRM under its access terms; record channel selection and transformation.
Tabula MurisNoObtain from the Tabula Muris project/Figshare or Bioconductor TabulaMurisData; record QC, normalization, feature selection, PCA, and tissue labels.
Macosko2015 retinaNoObtain from the Macosko et al. retinal single-cell release/GEO source; record filtering, normalization, feature selection, and labels.
ImageNet featuresRestrictedThe user must obtain ImageNet under ImageNet's terms and generate or lawfully obtain the documented feature representation. Do not upload images, labels tied to restricted files, or derived feature matrices unless redistribution is expressly permitted.

This table is a reproducibility guide, not legal advice. Verify the current provider terms before downloading or redistributing any dataset.

Dataset identity

For every local file, record at minimum:

sha256sum Data/<dataset>/<file>

or on macOS:

shasum -a 256 Data/<dataset>/<file>

The benchmark manifest should also store nrow, ncol, label count, class count, storage type, preprocessing date, source URL/accession, and the script commit used to create the file. Checksums verify local identity but do not authorize redistribution.

Missing or restricted data

Benchmark scripts must not silently replace a missing dataset with another matrix. A missing file should produce a dataset-level unavailable status and continue with the remaining datasets. The result row should state the expected path and acquisition instruction without revealing credentials or restricted content.

The broader paper-inspired dataset inventory is available in data-manifests/paper_benchmark_datasets.csv and data-manifests/paper_benchmark_datasets.md.