This class implements the BDS Data File/Stream access system. More...

#include <BdsDataFileBds.h>

Inheritance diagram for Bds::DataFileBds:

Public Types
enum	{ StreamsMax = 256 }

enum	{ DefaultBlockSize = 65536 }

enum	PackFormat { PackFormat_Unknown = 0, PackFormat_SM = 1, PackFormat_CM = 2, PackFormat_SM_CC = 3 }

Public Types inherited from Bds::DataFile
enum	DataOrder { DataOrderUnknown, DataOrderAll, DataOrderSample, DataOrderChannel }

enum	Features { FeatureNone = 0x00, FeatureCanWrite = 0x01, FeatureCanRead = 0x02 }

enum	WriteOptionsList { WriteOptionNone = 0x00, WriteOptionSensorData = 0x01, WriteOptionNoMetadata = 0x02 }

enum	ReadOptionsList { ReadOptionNone = 0x00, ReadOptionValidate = 0x01, ReadOptionFileNameProcess = 0x02, ReadOptionValidateCorruptions = 0x04, ReadOptionReorder = 0x08, ReadOptionDeleteDuplicates = 0x10, ReadOptionInfoExtra = 0x20, ReadOptionIgnoreSamplerate = 0x40, ReadOptionPrintBlocks = 0x80 }

Public Member Functions
	DataFileBds ()

	~DataFileBds ()

BError	open (BString fileName, BString mode)
	Open the file for reading or writing. More...

BError	close ()
	Close file. More...

BError	setFormat (BString format)
	Sets the sub-format. More...

BError	setInfo (DataInfo &dataInfo, ChannelInfos &channelInfos, WriteOptionsList options=WriteOptionSensorData)
	Sets the information. More...

BError	writeData (DataBlock &data)
	Writes a data block to the file. More...

DataOrder	getDataOrder ()
	Get the expected order of writing data, by sample or by channel. More...

BError	getInfo (DataInfo &dataInfo, DataFileOptions options, BList< DataError > &errors)
	Get information on open file. More...

BError	seekBlock (BUInt32 channel, BUInt segment, BTimeStamp time, BUInt32 &blockNumber, BUInt64 &sampleNumber, DataBlock &dataBlock)
	Find the block that contains the samples for the time requested. More...

BError	readData (BUInt32 channel, BUInt segment, BUInt32 blockNumber, DataBlock &dataBlock)
	Read the data block for the given channel or all channels if blockNumber is 0. More...

BError	setDiskBlockSize (BUInt32 blockSize)
	Sets up file/stream block size. More...

BUInt32	getDiskBlockSize ()
	Returns the data block size in bytes. More...

Public Member Functions inherited from Bds::DataFile
	DataFile ()

virtual	~DataFile ()

virtual void	init ()
	Initialise. More...

virtual BString	getFileName ()
	Return the file name. More...

virtual int	getFeatures ()
	Get bitmask of supported features. More...

virtual BError	start (BUInt channel, BUInt segment)
	Start next segment of data. More...

virtual BError	end ()
	End segment. More...

virtual BError	fileNameProcess ()
	Parse the file name for a date/time. More...

virtual BError	getFormat (BString &format)
	Get sub-format. More...

virtual BError	getMetaData (ChannelInfos &channelInfos)
	Return all known MetaData in the file. More...

void	dataErrorFixup (DataInfo &dataInfo, BList< DataError > &errors)
	Fixup data errors, mainly start/end times to be within data. More...

BInt64	timeCompare (BTimeStamp t1, BTimeStamp t2, BUInt diff)
	Compare timestamps with a margin. More...

int	duplicateCheck (DataBlock &data1, DataBlock &data2, BUInt channel=0)
	Check if blocks are duplicates. More...

BUInt64	getFilePosition ()

Static Public Member Functions
static DataFormat	getFormats ()
	Get the names of the supported formats. More...

Static Public Member Functions inherited from Bds::DataFile
static DataFormat	getFormats ()
	Get list of supported formats. More...

Private Member Functions
void	clear ()

BError	setInfoRepeat (BUInt32 repeat)
	Sets the reapeat period for the information packets. More...

BError	infoSet (BUInt32 streamlet, BTimeStamp startTime, BTimeStamp endTime, BDictString &info)
	Sets the information packet and writes this to the file/stream. More...

BError	infoGet (BdsDataPacket &packet, BDictString &info)
	Gets the information from an information packet. More...

BError	addInfoPacket ()

BError	addInfoExtraPacket ()

BError	streamletFromChannel (BUInt channel, BUInt &streamlet)
	Find streamlet given channel. More...

BError	dataAppend (DataBlock &data)
	Appends a data block to the file. More...

BError	dataGet (BUInt channel, BdsDataPacket &packet, DataBlock &data)
	Gets the data from a data packet. More...

BError	packetRead (BdsDataPacket &packet)
	Reads a packet from the file. More...

BError	packetWrite (BdsDataPacket &packet)
	Writes a packet to the file. More...

void	diskBlockReset ()
	Resets to disk block 0. More...

BError	diskBlockWrite (void *data, BUInt32 numBytes, int header=0)
	Writes data to a block in the file. More...

BError	diskBlockWriteFlush ()
	Flushes a semi-filled block to the file. More...

BError	diskBlockRead (void *data, BUInt32 numBytes, int header=0)
	Reads data from a block. More...

BError	diskBlockSeek (BUInt64 position)

Private Attributes
BString	oformat
	The format. More...

PackFormat	opackFormat
	The data packet format. More...

DataInfo	odataInfo
	Information on the channel data. More...

ChannelInfos	ochannelInfos
	Channel meta data information. More...

BUInt32	oinfoRepeat
	How often to output info packet. More...

BDictString	oinfo
	Info packet output. More...

BdsDataPacketHeader	oinfoHeader
	Info packet header. More...

BUInt32	odiskBlockSize
	The block size. More...

BdsDataBlock *	odiskBlock
	Data block buffer. More...

BUInt64	odiskPosition
	The disk block position. More...

BArray< BdsDataStreamlet >	ostreamlets
	Streamlet sequence numbers and positions. More...

BdsDataPacket	opacket
	Temporary packet for header/data packet generation. More...

BArray< BdsDataSegment >	osegments
	Data channel segments. More...

BArray< BArray< BdsDataBlockPos > >	oblockPositions
	Data block positions for seeking. More...

Additional Inherited Members
Protected Attributes inherited from Bds::DataFile
BString	ofileName

BString	omode

BTimeStamp	ofileNameTime

BFile	ofile

BString	oformat

Detailed Description

This class implements the BDS Data File/Stream access system.

Member Enumeration Documentation

anonymous enum

Enumerator
StreamsMax

anonymous enum

Enumerator
DefaultBlockSize

enum Bds::DataFileBds::PackFormat

Enumerator
PackFormat_Unknown
PackFormat_SM
PackFormat_CM
PackFormat_SM_CC

Constructor & Destructor Documentation

Bds::DataFileBds::DataFileBds ( )

Bds::DataFileBds::~DataFileBds ( )

Member Function Documentation

BError Bds::DataFileBds::addInfoExtraPacket ( )

private

BError Bds::DataFileBds::addInfoPacket ( )

private

void Bds::DataFileBds::clear ( )

private

BError Bds::DataFileBds::close ( )

virtual

Close file.

Reimplemented from Bds::DataFile.

BError Bds::DataFileBds::dataAppend ( DataBlock & data )

private

Appends a data block to the file.

BError Bds::DataFileBds::dataGet	(	BUInt	channel,
		BdsDataPacket &	packet,
		DataBlock &	data
	)

private

Gets the data from a data packet.

BError Bds::DataFileBds::diskBlockRead	(	void *	data,
		BUInt32	numBytes,
		int	header = `0`
	)

private

Reads data from a block.

void Bds::DataFileBds::diskBlockReset ( )

private

Resets to disk block 0.

BError Bds::DataFileBds::diskBlockSeek ( BUInt64 position )

private

BError Bds::DataFileBds::diskBlockWrite	(	void *	data,
		BUInt32	numBytes,
		int	header = `0`
	)

private

Writes data to a block in the file.

BError Bds::DataFileBds::diskBlockWriteFlush ( )

private

Flushes a semi-filled block to the file.

DataFile::DataOrder Bds::DataFileBds::getDataOrder ( )

virtual

Get the expected order of writing data, by sample or by channel.

Reimplemented from Bds::DataFile.

uint32_t Bds::DataFileBds::getDiskBlockSize ( )

Returns the data block size in bytes.

DataFormat Bds::DataFileBds::getFormats ( )

static

Get the names of the supported formats.

BError Bds::DataFileBds::getInfo	(	DataInfo &	dataInfo,
		DataFileOptions	options,
		BList< DataError > &	errors
	)

virtual

Get information on open file.

Reimplemented from Bds::DataFile.

BError Bds::DataFileBds::infoGet	(	BdsDataPacket &	packet,
		BDictString &	info
	)

private

Gets the information from an information packet.

BError Bds::DataFileBds::infoSet	(	BUInt32	streamlet,
		BTimeStamp	startTime,
		BTimeStamp	endTime,
		BDictString &	info
	)

private

Sets the information packet and writes this to the file/stream.

BError Bds::DataFileBds::open	(	BString	fileName,
		BString	mode
	)

virtual

Open the file for reading or writing.

Reimplemented from Bds::DataFile.

BError Bds::DataFileBds::packetRead ( BdsDataPacket & packet )

private

Reads a packet from the file.

BError Bds::DataFileBds::packetWrite ( BdsDataPacket & packet )

private

Writes a packet to the file.

BError Bds::DataFileBds::readData	(	BUInt32	channel,
		BUInt	segment,
		BUInt32	blockNumber,
		DataBlock &	dataBlock
	)

virtual

Read the data block for the given channel or all channels if blockNumber is 0.

Reimplemented from Bds::DataFile.

BError Bds::DataFileBds::seekBlock	(	BUInt32	channel,
		BUInt	segment,
		BTimeStamp	time,
		BUInt32 &	blockNumber,
		BUInt64 &	sampleNumber,
		DataBlock &	dataBlock
	)

virtual

Find the block that contains the samples for the time requested.

Reimplemented from Bds::DataFile.

BError Bds::DataFileBds::setDiskBlockSize ( BUInt32 blockSize )

Sets up file/stream block size.

BError Bds::DataFileBds::setFormat ( BString format )

virtual

Sets the sub-format.

Reimplemented from Bds::DataFile.

BError Bds::DataFileBds::setInfo	(	DataInfo &	dataInfo,
		ChannelInfos &	channelInfos,
		WriteOptionsList	options = `WriteOptionSensorData`
	)

virtual

Sets the information.

Reimplemented from Bds::DataFile.

BError Bds::DataFileBds::setInfoRepeat ( BUInt32 repeat )

private

Sets the reapeat period for the information packets.

BError Bds::DataFileBds::streamletFromChannel	(	BUInt	channel,
		BUInt &	streamlet
	)

private

Find streamlet given channel.

BError Bds::DataFileBds::writeData ( DataBlock & data )

virtual

Writes a data block to the file.

Reimplemented from Bds::DataFile.

Member Data Documentation

BArray<BArray<BdsDataBlockPos> > Bds::DataFileBds::oblockPositions

private

Data block positions for seeking.

ChannelInfos Bds::DataFileBds::ochannelInfos

private

Channel meta data information.

DataInfo Bds::DataFileBds::odataInfo

private

Information on the channel data.

BdsDataBlock* Bds::DataFileBds::odiskBlock

private

Data block buffer.

BUInt32 Bds::DataFileBds::odiskBlockSize

private

The block size.

BUInt64 Bds::DataFileBds::odiskPosition

private

The disk block position.

BString Bds::DataFileBds::oformat

private

The format.

BDictString Bds::DataFileBds::oinfo

private

Info packet output.

BdsDataPacketHeader Bds::DataFileBds::oinfoHeader

private

Info packet header.

BUInt32 Bds::DataFileBds::oinfoRepeat

private

How often to output info packet.

BdsDataPacket Bds::DataFileBds::opacket

private

Temporary packet for header/data packet generation.

PackFormat Bds::DataFileBds::opackFormat

private

The data packet format.

BArray<BdsDataSegment> Bds::DataFileBds::osegments

private

Data channel segments.

BArray<BdsDataStreamlet> Bds::DataFileBds::ostreamlets

private

Streamlet sequence numbers and positions.

The documentation for this class was generated from the following files:

/src/blacknest/bds/bds/bdsDataLib/BdsDataFileBds.h
/src/blacknest/bds/bds/bdsDataLib/BdsDataFileBds.cpp

Public Types

Public Member Functions

Static Public Member Functions

Private Member Functions

Private Attributes

Additional Inherited Members

Detailed Description

Member Enumeration Documentation

Constructor & Destructor Documentation

Member Function Documentation

Member Data Documentation