skbio.table.Table.read#
- Table.read(format=None, **kwargs)[source]#
Create a new
Table
instance from a file.This is a convenience method for
skbio.io.registry.read()
. For more information about the I/O system in scikit-bio, please seeskbio.io
.Supported file formats include:
'biom'
(skbio.io.format.biom
)
- Parameters:
- fileopenable (filepath, URL, filehandle, etc.)
The location to read the given format into. Something that is understood by
skbio.io.util.open()
. Filehandles are not automatically closed, it is the responsibility of the caller.- formatstr, optional
The format of the file. The format must be a format name with a reader for
Table
. If None, the format will be inferred.- kwargsdict, optional
Additional arguments passed to
skbio.io.registry.read()
and the reader forTable
.
- Returns:
Table
A new instance.