Struct noodles_bam::record::Record

pub struct Record(_);

A BAM record.

A BAM record encodes the same fields as a SAM record:

• reference sequence ID (RNAME equiv.),
• position (POS),
• mapping quality (MAPQ),
• flags (FLAG),
• mate reference sequence ID (RNEXT equiv.),
• mate position (PNEXT),
• template length (TLEN),
• read name (QNAME),
• CIGAR operations (CIGAR),
• sequence (SEQ),
• quality scores (QUAL), and
• optional data fields.

Additionally, it encodes the BAM index bin (bin).

A bam::Record wraps a raw byte buffer, and the fields should be considered immutable.

Implementations

impl Record

pub fn try_from_sam_record(
    reference_sequences: &ReferenceSequences,
    record: &Record
) -> Result<Self>

Converts a SAM record to a BAM record.

Examples

use noodles_bam as bam;
use noodles_sam::{self as sam, header::ReferenceSequences};

let reference_sequences = ReferenceSequences::default();
let sam_record = sam::Record::default();

let record = bam::Record::try_from_sam_record(&reference_sequences, &sam_record)?;
assert_eq!(record, bam::Record::default());

pub fn try_into_sam_record(
    &self,
    reference_sequences: &ReferenceSequences
) -> Result<Record>

Converts this record to a SAM record.

Examples

use noodles_bam as bam;
use noodles_sam as sam;

let reference_sequences = sam::header::ReferenceSequences::default();

let record = bam::Record::default();
let sam_record = record.try_into_sam_record(&reference_sequences)?;

assert_eq!(sam_record, sam::Record::default());

impl Record

pub fn reference_sequence_id(&self) -> Option<ReferenceSequenceId>

Returns the reference sequence ID of this record.

The reference sequence ID is the index of the associated reference sequence in the SAM header or BAM reference sequences.

Examples

use noodles_bam as bam;
let record = bam::Record::default();
assert!(record.reference_sequence_id().is_none());

pub fn position(&self) -> Option<Position>

Returns the start position of this record.

Despite the BAM format using 0-based positions, this normalizes the value as a 1-based position.

Examples

use noodles_bam as bam;
let record = bam::Record::default();
assert!(record.position().is_none());

pub fn mapping_quality(&self) -> MappingQuality

Returns the mapping quality of this record.

Examples

use noodles_bam as bam;
use noodles_sam as sam;
let record = bam::Record::default();
assert!(record.mapping_quality().is_none());

pub fn bin(&self) -> u16

Returns the index bin that includes this record.

Examples

use noodles_bam as bam;
let record = bam::Record::default();
assert_eq!(record.bin(), 4680);

pub fn flags(&self) -> Flags

Returns the SAM flags of this record.

Examples

use noodles_bam as bam;
use noodles_sam as sam;
let record = bam::Record::default();
assert_eq!(record.flags(), sam::record::Flags::UNMAPPED);

pub fn mate_reference_sequence_id(&self) -> Option<ReferenceSequenceId>

Returns the reference sequence ID of the mate of this record.

The mate reference sequence ID is the index of the associated reference sequence in the SAM header or BAM reference sequences.

Examples

use noodles_bam as bam;
let record = bam::Record::default();
assert!(record.mate_reference_sequence_id().is_none());

pub fn mate_position(&self) -> Option<Position>

Returns the start position of the mate of this record.

Despite the BAM format using 0-based positions, this normalizes the value as a 1-based position.

Examples

use noodles_bam as bam;
let record = bam::Record::default();
assert!(record.mate_position().is_none());

pub fn template_length(&self) -> i32

Returns the template length of this record.

Examples

use noodles_bam as bam;
let record = bam::Record::default();
assert_eq!(record.template_length(), 0);

pub fn read_name(&self) -> Result<&CStr, FromBytesWithNulError>

Returns the read name of this record.

This is also called the query name.

Examples

use noodles_bam as bam;
let record = bam::Record::default();
assert_eq!(record.read_name()?.to_bytes(), b"*");

pub fn cigar(&self) -> Cigar<'_>

Returns the CIGAR operations that describe how the read was mapped.

Examples

use noodles_bam as bam;
let record = bam::Record::default();
assert!(record.cigar().is_empty());

pub fn sequence(&self) -> Sequence<'_>

Returns the bases in the sequence of this record.

Examples

use noodles_bam as bam;
let record = bam::Record::default();
assert!(record.sequence().is_empty());

pub fn quality_scores(&self) -> QualityScores<'_>

Returns the quality score for each base in the sequence.

Examples

use noodles_bam as bam;
let record = bam::Record::default();
assert!(record.quality_scores().is_empty());

pub fn data(&self) -> Data<'_>

Returns the optional data fields for this record.

Examples

use noodles_bam as bam;
let record = bam::Record::default();
assert!(record.data().is_empty());

Trait Implementations

impl Clone for Record

fn clone(&self) -> Record

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Record

fn fmt(&self, fmt: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for Record

fn default() -> Self

Returns the “default value” for a type.

impl Deref for Record

type Target = [u8]

The resulting type after dereferencing.

fn deref(&self) -> &[u8]

Dereferences the value.

impl DerefMut for Record

fn deref_mut(&mut self) -> &mut [u8]

Mutably dereferences the value.

impl From<Vec<u8, Global>> for Record

fn from(bytes: Vec<u8>) -> Self

Performs the conversion.

impl PartialEq<Record> for Record

fn eq(&self, other: &Record) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Record) -> bool

This method tests for !=.

impl Eq for Record

impl StructuralEq for Record

impl StructuralPartialEq for Record