espnet3.components.data.dataset_module.instantiate_dataset_reference

source

espnet3.components.data.dataset_module.instantiate_dataset_reference(config: Mapping[str, Any] | DictConfig, recipe_dir: str | Path | None = None)

Instantiate a dataset class from a dataset entry config.

• Parameters:
  • config – Dataset entry mapping. Expected keys are:
    • data_src: optional dataset source reference.
    • data_src_args: optional constructor kwargs for Dataset.
  • recipe_dir – Recipe root used when resolving local modules.
• Returns: Instantiated dataset object from module.Dataset(**data_src_args).
• Raises:
  • AttributeError – If the target module does not expose Dataset.
  • ModuleNotFoundError – If dataset module resolution fails.
  • TypeError – If data_src_args is incompatible with dataset constructor, or Dataset does not inherit BaseDataset.

Notes

Only data_src_args is forwarded to the dataset constructor. Top-level config fields other than data_src_args are not passed through.

Examples

>>> cfg = {"data_src": "mini_an4/esp2_asr", "data_src_args": {"split": "train"}}
>>> ds = instantiate_dataset_reference(cfg, recipe_dir="egs3/mini_an4/esp2_asr")
>>> hasattr(ds, "__len__")
True

Local dataset module loading (no data_src):

cfg = {“data_src_args”: {“split”: “test”}} _ = instantiate_dataset_reference(cfg, recipe_dir=”egs3/mini_an4/esp2_asr”)