oxbow.from_bam

Contents

oxbow.from_bam#

oxbow.from_bam(source: str | Path | Callable[[], IO[bytes] | str], compression: Literal['bgzf', None] = 'bgzf', *, fields: list[str] | None = None, tag_defs: list[tuple[str, str]] | None = None, tag_scan_rows: int = 1024, regions: str | list[str] | None = None, index: str | Path | Callable[[], IO[bytes] | str] | None = None, batch_size: int = 131072) → BamFile#

Create a BAM file data source.

Parameters:

  • source (str, pathlib.Path, or Callable) – The URI or path to the BAM file, or a callable that opens the file as a file-like object.

  • compression (Literal["bgzf", None], default: "bgzf") – Compression of the source bytestream. By default, BAM sources are assumed to be BGZF-compressed. If None, the source is assumed to be uncompressed. For more custom decoding, provide a callable source instead.

  • fields (list[str], optional) – Specific fixed fields to project. By default, all fixed fields are included.

  • tag_defs (list[tuple[str, str]], optional [default: None]) – Definitions for variable tag fields to project. These will be nested in a “tags” column. If None, tag definitions are discovered by scanning records in the file, which is controlled by the tag_scan_rows parameter. To omit tags entirely, set tag_defs=[].

  • tag_scan_rows (int, optional [default: 1024]) – Number of rows to scan for tag definitions.

  • regions (str | list[str], optional) – One or more genomic regions to query. Only applicable if an associated index file is available.

  • index (str, pathlib.Path, or Callable, optional) – An optional index file associated with the SAM file. If source is a URI or path, is BGZF-compressed, and the index file shares the same name with a “.tbi” or “.csi” extension, the index file is automatically detected.

  • batch_size (int, optional [default: 131072]) – The number of records to read in each batch.

Returns:

A data source object representing the BAM file.

Return type:

BamFile

Notes

Binary Alignment Map (BAM) is a binary representation of SAM files.

See also

from_sam

Create a SAM file data source.

from_cram

Create a CRAM file data source.

Contents