bix

README

bix

Tabix files in go.

![GoDoc] (https://godoc.org/github.com/brentp/bix?status.png)

Bixis a pure go tabix reader. Tabix has a minimum resolution of 16K bases. So, for dense annotations like ExAC, repeated queries will have to re-parse the same intervals. To mitigate this, Bix caches all annotations for the blocks from each query and re-uses them for later querires to the same block. In practice, this results in 10X-100X speedup for any type of data.

tbx, err := bix.New(f)

// Query returns an io.Reader
ph := true // print header ?
rdr, err := tbx.Query(chrom, start, end, ph)
buf := bufio.NewReader(rdr)
for {
	line, err := bufr.ReadString('\n')
	if err == io.EOF {
		break
	}
	fmt.Println(line)
}
// or

intervals := tbx.Get(chrom, start, end)

where intervals will be either a vcfgo.Variant or an Interval object with a Chrom(), Start(), and End() method.

Documentation

Overview

Tabix queries for go

Index

• type Bix
  • func New(path string, workers ...int) (*Bix, error)
  • func (tbx *Bix) AddInfoToHeader(id, number, vtype, desc string)
  • func (tbx *Bix) ChunkedReader(chrom string, start, end int) (io.ReadCloser, error)
  • func (b *Bix) Close() error
  • func (tbx *Bix) GetHeaderDescription(field string) string
  • func (tbx *Bix) GetHeaderNumber(field string) string
  • func (tbx *Bix) GetHeaderType(field string) string
  • func (tbx *Bix) Query(region interfaces.IPosition) (interfaces.RelatableIterator, error)

Types

type Bix

type Bix struct {
	*tabix.Index

	VReader *vcfgo.Reader
	// contains filtered or unexported fields
}

Bix provides read access to tabix files.

func New

func New(path string, workers ...int) (*Bix, error)

New returns a &Bix

func (*Bix) AddInfoToHeader

func (tbx *Bix) AddInfoToHeader(id, number, vtype, desc string)

func (*Bix) ChunkedReader

func (tbx *Bix) ChunkedReader(chrom string, start, end int) (io.ReadCloser, error)

func (*Bix) Close

func (b *Bix) Close() error

func (*Bix) GetHeaderDescription

func (tbx *Bix) GetHeaderDescription(field string) string

func (*Bix) GetHeaderNumber

func (tbx *Bix) GetHeaderNumber(field string) string

func (*Bix) GetHeaderType

func (tbx *Bix) GetHeaderType(field string) string

func (*Bix) Query

func (tbx *Bix) Query(region interfaces.IPosition) (interfaces.RelatableIterator, error)