omicverse.read

omicverse.read(path, backend='python', **kwargs)[source]

Read common omics file formats into AnnData or pandas DataFrame.

Parameters:

  • path (str or pathlib.Path) – Input file path.

  • backend ({'python', 'rust'}, default='python') – Backend used for .h5ad reading.

  • **kwargs – Additional keyword arguments forwarded to backend readers.

Returns:

Loaded AnnData object (for .h5ad) or DataFrame (for table files).

Return type:

anndata.AnnData or pandas.DataFrame

Raises:

  • ImportError – If backend='rust' is requested but snapatac2 is unavailable.

  • ValueError – If backend is invalid for .h5ad reading or the file suffix is unsupported.