org.biojava.bio.program.ssaha
Class NIODataStoreFactory

java.lang.Object
  org.biojava.bio.program.ssaha.NIODataStoreFactory

All Implemented Interfaces:

DataStoreFactory

public class NIODataStoreFactory
extends Object
implements DataStoreFactory

Builder for a datastore that has no practical file size limit.

This implementation of the data store factory uses longs as indecies internaly, so can be used with files exceeding 2 gigs in size.

The data store file has the following structure.

 file: header, hash table, nameTable, hitTable

 header:
   long hashTablePos, // byte offset in file
   long hitTablePos,  // byte offset in file
   long nameTablePos, // byte offset in file
   int wordLength,
   int serializedPackingLength,
   byte[] serializedPacking

 hashTable:
   long hashTableLength,
   long[hashTableLength] hits // byte offset into hitTable

 nameTable:
   int nameTableSize, // size in bytes
   (short nameLength, char[nameLength] name)[nameTableSize] names

 hitTable:
   long hitTableSize, // size in bytes
   hitTableRecord[hitTableSize] hits

 hitTableRecord:
   int hitCount,
   hitRecord[hitCount] hit

 hit:
   long seqOffset, // byte offset into sequence names table
   int pos         // biological position in sequence
 

Author:

Matthew Pocock

Constructor Summary

NIODataStoreFactory()

Method Summary

DataStore	buildDataStore(File storeFile, SequenceDB seqDB, Packing packing, int wordLength, int threshold) Build a new DataStore.
DataStore	getDataStore(File storeFile) Get a pre-built data store associated with a file.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

NIODataStoreFactory

public NIODataStoreFactory()

Method Detail

getDataStore

public DataStore getDataStore(File storeFile)
                       throws IOException

Description copied from interface: DataStoreFactory

Get a pre-built data store associated with a file.

Specified by:

getDataStore in interface DataStoreFactory

Parameters:

storeFile - the File to map in as a data store

Returns:

the DataStore made by mapping the file

Throws:

IOException - if the file could not be mapped

buildDataStore

public DataStore buildDataStore(File storeFile,
                                SequenceDB seqDB,
                                Packing packing,
                                int wordLength,
                                int threshold)
                         throws IllegalAlphabetException,
                                IOException,
                                BioException

Description copied from interface: DataStoreFactory

Build a new DataStore.

Specified by:

buildDataStore in interface DataStoreFactory

Parameters:

storeFile - the file to store the data store

seqDB - the SequenceDB to store in the data store

packing - the Packing used to bit-encode the sequences

wordLength - the number of symbols per word

threshold - the number of times a word must appear to be ignored

Throws:

IllegalAlphabetException - if the packing does not agree with the sequences

BioException - if there is a problem building the data store

IOException