Bio.Align.psl module

Bio.Align support for the “psl” pairwise alignment format.

The Pattern Space Layout (PSL) format, described by UCSC, stores a series of pairwise alignments in a single file. Typically they are used for transcript to genome alignments. PSL files store the alignment positions and alignment scores, but do not store the aligned sequences.

See http://genome.ucsc.edu/FAQ/FAQformat.html#format2

You are expected to use this module via the Bio.Align functions.

Coordinates in the PSL format are defined in terms of zero-based start positions (like Python) and aligning region sizes.

A minimal aligned region of length one and starting at first position in the source sequence would have start == 0 and size == 1.

As we can see in this example, start + size will give one more than the zero-based end position. We can therefore manipulate start and start + size as python list slice boundaries.

class Bio.Align.psl.AlignmentWriter(target, header=True, mask=None, wildcard='N')

Bases: AlignmentWriter

Alignment file writer for the Pattern Space Layout (PSL) file format.

fmt: str | None = 'PSL'
__init__(target, header=True, mask=None, wildcard='N')

Create an AlignmentWriter object.

Arguments:

  • target - output stream or file name

  • header - If True (default), write the PSL header consisting of

    five lines containing the PSL format version and a header for each column. If False, suppress the PSL header, resulting in a simple tab-delimited file.

  • mask - Specify if repeat regions in the target sequence are

    masked and should be reported in the repMatches field of the PSL file instead of in the matches field. Acceptable values are None : no masking (default); “lower”: masking by lower-case characters; “upper”: masking by upper-case characters.

  • wildcard - Report alignments to the wildcard character in the

    target or query sequence in the nCount field of the PSL file instead of in the matches, misMatches, or repMatches fields. Default value is ‘N’.

write_header(stream, alignments)

Write the PSL header.

format_alignment(alignment)

Return a string with a single alignment formatted as one PSL line.

__abstractmethods__ = frozenset({})
class Bio.Align.psl.AlignmentIterator(source)

Bases: AlignmentIterator

Alignment iterator for Pattern Space Layout (PSL) files.

Each line in the file contains one pairwise alignment, which are loaded and returned incrementally. Alignment score information such as the number of matches and mismatches are stored as attributes of each alignment.

fmt: str | None = 'PSL'
__abstractmethods__ = frozenset({})