NAME

       Bio::DB::Bam::Query -- Object representing the query portion of a BAM/SAM alignment

SYNOPSIS

       Given an alignment retrieved from a Bio::DB::Sam database,

        my $query = $alignment->query;

        my $name   = $query->display_name;
        my $start  = $query->start;
        my $end    = $query->end;
        my $dna    = $query->dna;    # dna string
        my $seq    = $query->seq;    # Bio::PrimarySeq object
        my @scores = $query->qscore; # quality score

DESCRIPTION

       This is a simple Bio::SeqFeatureI object that represents the query part of a SAM
       alignment.

   Methods
       $seqid = $query->seq_id
           The name of the read.

       $name = $query->name
           The read name (same as seq_id in this case).

       $name = $query->display_name
           The read display_name (same as seq_id in this case).

       $tag = $query->primary_tag
           The string "match".

       $tag = $query->source_tag
           The string "sam/bam".

       $start = $query->start
           The start of the match in read coordinates.

       $end = $query->end
           The end of the match in read coordinates;

       $len = $query->length
           The length of the read.

       $seq = $query->seq
           A Bio::PrimarySeq representing the read sequence in REFERENCE orientation.

       $scores = $query->qscore
           The read quality scores. In a list context, a list of integers equal in length to the
           read sequence length. In a scalar context, an array ref. The qscores are in REFERENCE
           sequence orientation.

       $dna = $query->dna
           The DNA string in reference sequence orientation.

       $strand = $query->strand
           If the query was reversed to align it, -1. Otherwise +1.

       $seq = $query->subseq($start,$end)
           Return a Bio::PrimarySeq object representing the requested subsequence on the read.

SEE ALSO

       Bio::Perl, Bio::DB::Sam, Bio::DB::Bam::Alignment, Bio::DB::Bam::Constants

AUTHOR

       Lincoln Stein <lincoln.stein@oicr.on.ca>.  <lincoln.stein@bmail.com>

       Copyright (c) 2009-2015 Ontario Institute for Cancer Research.

       This package and its accompanying libraries are free software; you can redistribute it
       and/or modify it under the terms of the Artistic License 2.0, the Apache 2.0 License, or
       the GNU General Public License (version 1 or higher).  Refer to LICENSE for the full
       license text.