Enum DatasetError 

pub enum DatasetError {
    DataNotFound {
        path: PathBuf,
        message: String,
    },
    InvalidFormat {
        path: PathBuf,
        message: String,
    },
    IoError {
        path: PathBuf,
        source: Error,
    },
    SubcarrierMismatch {
        path: PathBuf,
        found: usize,
        expected: usize,
    },
    IndexOutOfBounds {
        idx: usize,
        len: usize,
    },
    NpyReadError {
        path: PathBuf,
        message: String,
    },
    MetadataError {
        subject_id: u32,
        message: String,
    },
    Format(String),
    DirectoryNotFound {
        path: String,
    },
    NoSubjectsFound {
        data_dir: PathBuf,
        requested: Vec<u32>,
    },
    Io(Error),
    InvalidSplit(String),
}

Errors produced while loading or accessing dataset samples.

Production training code MUST NOT silently suppress these errors. If data is missing, training must fail explicitly so the user is aware. The SyntheticCsiDataset is the only source of non-file-system data and is restricted to proof/testing use.

Variants

DataNotFound

A required data file or directory was not found on disk.

Fields

path: PathBuf

Path that was expected to contain data.

message: String

Additional context.

InvalidFormat

A file was found but its format or shape is wrong.

Fields

path: PathBuf

Path of the malformed file.

message: String

Description of the problem.

IoError

A low-level I/O error while reading a data file.

Fields

path: PathBuf

Path being read when the error occurred.

source: Error

Underlying I/O error.

SubcarrierMismatch

The number of subcarriers in the file doesn’t match expectations.

Fields

path: PathBuf

Path of the offending file.

found: usize

Subcarrier count found in the file.

expected: usize

Subcarrier count expected.

IndexOutOfBounds

A sample index is out of bounds.

Fields

idx: usize

The requested index.

len: usize

Total length of the dataset.

NpyReadError

A numpy array file could not be parsed.

Fields

path: PathBuf

Path of the .npy file.

message: String

Error description.

MetadataError

Metadata for a subject is missing or malformed.

Fields

subject_id: u32

Subject whose metadata was invalid.

message: String

Description of the problem.

Format(String)

A data format error (e.g. wrong numpy shape) occurred.

This is a convenience variant for short-form error messages where the full path context is not available.

DirectoryNotFound

The data directory does not exist.

Fields

path: String

The path that was not found.

NoSubjectsFound

No subjects matching the requested IDs were found.

Fields

data_dir: PathBuf

Root data directory.

requested: Vec<u32>

IDs that were requested.

Io(Error)

An I/O error that carries no path context.

InvalidSplit(String)

A train/test split is invalid — it leaks information across the boundary (a subject appears in both partitions, or a window is shared) or is degenerate (an empty partition). ADR-155 §Tier-1.2.

Implementations

impl DatasetError

pub fn not_found<S: Into<String>>(path: impl Into<PathBuf>, msg: S) -> Self

Construct a DatasetError::DataNotFound.

pub fn invalid_format<S: Into<String>>(path: impl Into<PathBuf>, msg: S) -> Self

Construct a DatasetError::InvalidFormat.

pub fn io_error(path: impl Into<PathBuf>, source: Error) -> Self

Construct a DatasetError::IoError.

pub fn subcarrier_mismatch( path: impl Into<PathBuf>, found: usize, expected: usize, ) -> Self

Construct a DatasetError::SubcarrierMismatch.

pub fn npy_read<S: Into<String>>(path: impl Into<PathBuf>, msg: S) -> Self

Construct a DatasetError::NpyReadError.

Trait Implementations

impl Debug for DatasetError

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Display for DatasetError

fn fmt(&self, __formatter: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Error for DatasetError

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.

impl From<DatasetError> for TrainError

fn from(source: DatasetError) -> Self

Converts to this type from the input type.

impl From<Error> for DatasetError

fn from(source: Error) -> Self

Converts to this type from the input type.