Negligent Parachute Maintainers

npm

Ready to take your JavaScript development to the next level? Meet npm Enterprise - the ultimate in enterprise JavaScript. Learn more »

@gmod/bam

1.0.15 • Public • Published

Generated with nod NPM version Build Status Coverage Status Greenkeeper badge

Install

$ npm install --save @gmod/bam

Usage

const {BamFile} = require('@gmod/bam');
 
const t = new BamFile({
        bamPath: 'test.bam',
});
 
var header = await t.getHeader()
 
var records = await t.getRecordsForRange('ctgA', 1, 50000)

Input are 0-based half-open coordinates (note: not the same as samtools view coordinate inputs!)

Documentation

BAM class constructor infers BAI by default as bamPath+'.bai', or you can specify it explicitely via baiPath (also accepts csiPath)

BAM({ bamPath: "yourfile.bam", baiPath: "yourfile.bai" })

Or accepts filehandles, this is an abstract filehandle concept that can represent remote files. The remote file concept is not built into this repository, but see @gmod/cram for example of the remoteFile.js class

BAM({ bamFilehandle: new FileHandle("http://localhost/file.bam", baiFilehandle: new FileHandle("yourfile.bai") })

The method getRecordsForRange(refName, start, end, opts) has the opts blob that can contain

  • opts.signal - an AbortSignal to indicate stop processing
  • opts.viewAsPairs - re-dispatches requests to find mate pairs
  • opts.pairAcrossChr - control the viewAsPairs option behavior to pair across chromosomes
  • opts.maxInsertSize - control the viewAsPairs option behavior to limit distance within a chromosome to fetch

The returned features from BAM are lazy features meaning that it delays processing of all the feature tags until necessary. You can perform feature.get('field') to get the value of a feature attribute

Example

	feature.get('seq_id')
	feature.get('start')
	feature.get('name') // QNAME
	feature.get('seq') // get feature sequence

This may change in future versions to make it raw records but will be a major version bump

License

MIT © Colin Diesh

install

npm i @gmod/bam

Downloadsweekly downloads

453

version

1.0.15

license

MIT

homepage

github.com

repository

Gitgithub

last publish

collaborators

  • avatar
  • avatar
  • avatar
  • avatar
  • avatar
Report a vulnerability