IO Handler for Isis Cubes using the tile format. More...

#include <CubeTileHandler.h>

Inheritance diagram for Isis::CubeTileHandler:

Collaboration diagram for Isis::CubeTileHandler:

Public Member Functions
	CubeTileHandler (QFile dataFile, const QList< int > virtualBandList, const Pvl &label, bool alreadyOnDisk)
	Construct a tile handler.

	~CubeTileHandler ()
	Writes all data from memory to disk.

void	updateLabels (Pvl &label)
	Update the cube labels so that this cube indicates what tile size it used.

void	read (Buffer &bufferToFill) const
	Read cube data from disk into the buffer.

void	write (const Buffer &bufferToWrite)
	Write buffer data into the cube data on disk.

void	addCachingAlgorithm (CubeCachingAlgorithm *algorithm)
	This will add the given caching algorithm to the list of attempted caching algorithms.

void	clearCache (bool blockForWriteCache=true) const
	Free all cube chunks (cached cube data) from memory and write them to disk.

BigInt	getDataSize () const

void	setVirtualBands (const QList< int > *virtualBandList)
	This changes the virtual band list.

QMutex *	dataFileMutex ()
	Get the mutex that this IO handler is using around I/Os on the given data file.

Protected Member Functions
virtual void	readRaw (RawCubeChunk &chunkToFill)
	This needs to populate the chunkToFill with unswapped raw bytes from the disk.

virtual void	writeRaw (const RawCubeChunk &chunkToWrite)
	This needs to write the chunkToWrite directly to disk with no modifications to the data itself.

int	bandCount () const

int	getBandCountInChunk () const

BigInt	getBytesPerChunk () const

int	getChunkCountInBandDimension () const

int	getChunkCountInLineDimension () const

int	getChunkCountInSampleDimension () const

int	getChunkIndex (const RawCubeChunk &) const
	Given a chunk, what's its index in the file.

BigInt	getDataStartByte () const

QFile *	getDataFile ()

int	lineCount () const

int	getLineCountInChunk () const

PixelType	pixelType () const

int	sampleCount () const

int	getSampleCountInChunk () const

void	setChunkSizes (int numSamples, int numLines, int numBands)
	This should be called once from the child constructor.

Detailed Description

IO Handler for Isis Cubes using the tile format.

This class is used to open, create, read, and write data from Isis cube files.

Author: 2003-02-14 Jeff Anderson

Constructor & Destructor Documentation

◆ CubeTileHandler()

Isis::CubeTileHandler::CubeTileHandler	(	QFile *	dataFile,
		const QList< int > *	virtualBandList,
		const Pvl &	labels,
		bool	alreadyOnDisk )

Construct a tile handler.

This will determine a good chunk size to put into the output cube.

Parameters

dataFile	The file with cube DN data in it
virtualBandList	The mapping from virtual band to physical band, see CubeIoHandler's description.
labels	The Pvl labels for the cube
alreadyOnDisk	True if the cube is allocated on the disk, false otherwise

References Isis::PvlObject::findObject(), Isis::CubeIoHandler::lineCount(), Isis::CubeIoHandler::pixelType(), Isis::CubeIoHandler::sampleCount(), Isis::CubeIoHandler::setChunkSizes(), and Isis::SizeOf().

◆ ~CubeTileHandler()

Isis::CubeTileHandler::~CubeTileHandler ( )

Writes all data from memory to disk.

References Isis::CubeIoHandler::clearCache().

Member Function Documentation

◆ addCachingAlgorithm()

void Isis::CubeIoHandler::addCachingAlgorithm ( CubeCachingAlgorithm * algorithm )

inherited

This will add the given caching algorithm to the list of attempted caching algorithms.

The algorithms are tried in the opposite order that they were added - the first algorithm added is the last algorithm tried.

This method takes ownership of algorithm.

Parameters

algorithm The caching algorithm to add to the Cube for I/O

Referenced by Isis::Cube::addCachingAlgorithm().

◆ bandCount()

int Isis::CubeIoHandler::bandCount ( ) const

protectedinherited

Returns: the number of physical bands in the cube.

◆ clearCache()

void Isis::CubeIoHandler::clearCache ( bool blockForWriteCache = true ) const

inherited

Free all cube chunks (cached cube data) from memory and write them to disk.

Child destructors need to call this method.

This method should only be called otherwise when lots of cubes are in memory and the many caches cause problems with system RAM limitations.

Parameters

blockForWriteCache This should be true unless this method is called from the write thread.

Referenced by Isis::Cube::clearIoCache(), Isis::Cube::copy(), Isis::CubeBsqHandler::~CubeBsqHandler(), and ~CubeTileHandler().

◆ dataFileMutex()

QMutex * Isis::CubeIoHandler::dataFileMutex ( )

inherited

Get the mutex that this IO handler is using around I/Os on the given data file.

A lock should be acquired before doing any reads/writes on the data file externally.

Returns: A mutex that can guarantee exclusive access to the data file

Referenced by Isis::Cube::read(), and Isis::Cube::write().

◆ getBandCountInChunk()

int Isis::CubeIoHandler::getBandCountInChunk ( ) const

protectedinherited

Returns: the number of bands per chunk for this cube.

Referenced by Isis::CubeIoHandler::getChunkIndex(), and Isis::CubeIoHandler::read().

◆ getBytesPerChunk()

BigInt Isis::CubeIoHandler::getBytesPerChunk ( ) const

protectedinherited

Returns: the byte size of each chunk in the cube. Currently they must be constant size, but this is planned to be changed at some point in time.; Number of bytes in a cube chunk

References Isis::SizeOf().

Referenced by Isis::CubeIoHandler::getDataSize().

◆ getChunkCountInBandDimension()

int Isis::CubeIoHandler::getChunkCountInBandDimension ( ) const

protectedinherited

Returns: the total number of chunks in the band (Z) dimension. This is always enough to contain every band in the cube.

Referenced by Isis::CubeIoHandler::getDataSize().

◆ getChunkCountInLineDimension()

int Isis::CubeIoHandler::getChunkCountInLineDimension ( ) const

protectedinherited

Returns: the total number of chunks in the line (Y) dimension. This is always enough to contain every line in the cube.

Referenced by Isis::CubeIoHandler::getChunkIndex(), Isis::CubeIoHandler::getDataSize(), and Isis::CubeIoHandler::read().

◆ getChunkCountInSampleDimension()

int Isis::CubeIoHandler::getChunkCountInSampleDimension ( ) const

protectedinherited

Returns: the total number of chunks in the sample (X) dimension. This is always enough to contain every sample in the cube.

Referenced by Isis::CubeIoHandler::getChunkIndex(), Isis::CubeIoHandler::getDataSize(), and Isis::CubeIoHandler::read().

◆ getChunkIndex()

int Isis::CubeIoHandler::getChunkIndex ( const RawCubeChunk & chunk ) const

protectedinherited

Given a chunk, what's its index in the file.

Chunks are ordered from left to right, then top to bottom, then front to back (BSQ). The first chunk is at the top left of band 1 and is index 0, for example. In other words, this is going from the value of m_rawData to the key.

Chunks which sit outside of the cube entirely must not be passed into this method; the results will be wrong.

Returns: The chunk's index into the file

References Isis::CubeIoHandler::getBandCountInChunk(), Isis::CubeIoHandler::getChunkCountInLineDimension(), Isis::CubeIoHandler::getChunkCountInSampleDimension(), Isis::CubeIoHandler::getLineCountInChunk(), and Isis::CubeIoHandler::getSampleCountInChunk().

◆ getDataFile()

QFile * Isis::CubeIoHandler::getDataFile ( )

protectedinherited

Returns: the QFile containing cube data. This is what should be read from and written to.; The data file for I/O

Referenced by Isis::CubeBsqHandler::readRaw(), readRaw(), Isis::CubeBsqHandler::writeRaw(), and writeRaw().

◆ getDataSize()

BigInt Isis::CubeIoHandler::getDataSize ( ) const

inherited

Returns: the number of bytes that the cube DNs will take up. This includes padding caused by the cube chunks not aligning with the cube dimensions.

References Isis::CubeIoHandler::getBytesPerChunk(), Isis::CubeIoHandler::getChunkCountInBandDimension(), Isis::CubeIoHandler::getChunkCountInLineDimension(), and Isis::CubeIoHandler::getChunkCountInSampleDimension().

Referenced by Isis::CubeIoHandler::setChunkSizes(), and Isis::Cube::write().

◆ getDataStartByte()

BigInt Isis::CubeIoHandler::getDataStartByte ( ) const

protectedinherited

Returns: the byte offset to the beginning of the cube data.

Referenced by Isis::CubeIoHandler::setChunkSizes().

◆ getLineCountInChunk()

int Isis::CubeIoHandler::getLineCountInChunk ( ) const

protectedinherited

Returns: the number of lines in each chunk of the cube.

Referenced by Isis::CubeIoHandler::getChunkIndex(), Isis::CubeIoHandler::read(), and updateLabels().

◆ getSampleCountInChunk()

int Isis::CubeIoHandler::getSampleCountInChunk ( ) const

protectedinherited

Returns: the number of samples in each chunk of the cube.

Referenced by Isis::CubeIoHandler::getChunkIndex(), Isis::CubeIoHandler::read(), and updateLabels().

◆ lineCount()

int Isis::CubeIoHandler::lineCount ( ) const

protectedinherited

Returns: the number of lines in the cube. This does not include lines created by the chunk overflowing the line dimension.

Referenced by Isis::CubeBsqHandler::CubeBsqHandler(), and CubeTileHandler().

◆ pixelType()

PixelType Isis::CubeIoHandler::pixelType ( ) const

protectedinherited

Returns: the physical cube DN format.

Referenced by Isis::CubeBsqHandler::CubeBsqHandler(), and CubeTileHandler().

◆ read()

void Isis::CubeIoHandler::read ( Buffer & bufferToFill ) const

inherited

Read cube data from disk into the buffer.

This is not const because it caches the read cube chunks from the disk.

Parameters

bufferToFill The buffer to populate with cube data.

References Isis::CubeIoHandler::getBandCountInChunk(), Isis::CubeIoHandler::getChunkCountInLineDimension(), Isis::CubeIoHandler::getChunkCountInSampleDimension(), Isis::CubeIoHandler::getLineCountInChunk(), Isis::CubeIoHandler::getSampleCountInChunk(), and Isis::Null.

Referenced by Isis::Cube::read().

◆ readRaw()

void Isis::CubeTileHandler::readRaw ( RawCubeChunk & chunkToFill )

protectedvirtual

This needs to populate the chunkToFill with unswapped raw bytes from the disk.

See also: CubeTileHandler::readRaw()

Parameters

chunkToFill The container that needs to be filled with cube data.

Implements Isis::CubeIoHandler.

References _FILEINFO_, Isis::CubeIoHandler::getDataFile(), and Isis::IException::Io.

◆ sampleCount()

int Isis::CubeIoHandler::sampleCount ( ) const

protectedinherited

Returns: the number of samples in the cube. This does not include samples created by the chunk overflowing the sample dimension.

Referenced by Isis::CubeBsqHandler::CubeBsqHandler(), and CubeTileHandler().

◆ setChunkSizes()

void Isis::CubeIoHandler::setChunkSizes	(	int	numSamples,
		int	numLines,
		int	numBands )

protectedinherited

This should be called once from the child constructor.

This determines the chunk sizes used for the cube and often should remain constant for a particular cube (BSQ, for example, doesn't need it to be constant but Tile does). These being large can cause excessive use of disk space that stores no cube data. These being large can also drastically increase the amount of RAM consumed.

Parameters

numSamples	The chunk size in the sample dimension
numLines	The chunk size in the line dimension
numBands	The chunk size in the band dimension

References _FILEINFO_, Isis::CubeIoHandler::getDataSize(), Isis::CubeIoHandler::getDataStartByte(), and Isis::IException::Programmer.

Referenced by Isis::CubeBsqHandler::CubeBsqHandler(), and CubeTileHandler().

◆ setVirtualBands()

void Isis::CubeIoHandler::setVirtualBands ( const QList< int > * virtualBandList )

inherited

This changes the virtual band list.

Parameters

virtualBandList A list where the indices are the vbands and the values are the physical bands. The values are 1-based. This can be specified as NULL, in which case the vbands are the physical bands. The virtual band list is copied (the pointer provided isn't remembered).

Referenced by Isis::CubeIoHandler::CubeIoHandler(), and Isis::Cube::setVirtualBands().

◆ updateLabels()

void Isis::CubeTileHandler::updateLabels ( Pvl & labels )

virtual

Update the cube labels so that this cube indicates what tile size it used.

Parameters

labels The "Core" object in this Pvl will be updated

Implements Isis::CubeIoHandler.

References Isis::PvlObject::findObject(), Isis::CubeIoHandler::getLineCountInChunk(), Isis::CubeIoHandler::getSampleCountInChunk(), Isis::PvlContainer::Replace, and Isis::toString().

◆ write()

void Isis::CubeIoHandler::write ( const Buffer & bufferToWrite )

inherited

Write buffer data into the cube data on disk.

This could do no IO if the cube chunks required are already in memory and our caching algorithms say to not free any of the cube chunks afterwards.

Parameters

bufferToWrite The buffer to get cube data from.

Referenced by Isis::Cube::write().

◆ writeRaw()

void Isis::CubeTileHandler::writeRaw ( const RawCubeChunk & chunkToWrite )

protectedvirtual

This needs to write the chunkToWrite directly to disk with no modifications to the data itself.

See also: CubeTileHandler::writeRaw()

Parameters

chunkToWrite The container that needs to be put on disk.

Implements Isis::CubeIoHandler.

References _FILEINFO_, Isis::CubeIoHandler::getDataFile(), and Isis::IException::Io.

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

/Users/chkim/repos/ISIS3/isis/src/base/objs/Cube/CubeTileHandler.h
/Users/chkim/repos/ISIS3/isis/src/base/objs/Cube/CubeTileHandler.cpp

Public Member Functions

Protected Member Functions

Detailed Description

Constructor & Destructor Documentation

◆ CubeTileHandler()

◆ ~CubeTileHandler()

Member Function Documentation

◆ addCachingAlgorithm()

◆ bandCount()

◆ clearCache()

◆ dataFileMutex()

◆ getBandCountInChunk()

◆ getBytesPerChunk()

◆ getChunkCountInBandDimension()

◆ getChunkCountInLineDimension()

◆ getChunkCountInSampleDimension()

◆ getChunkIndex()

◆ getDataFile()

◆ getDataSize()

◆ getDataStartByte()

◆ getLineCountInChunk()

◆ getSampleCountInChunk()

◆ lineCount()

◆ pixelType()

◆ read()

◆ readRaw()

◆ sampleCount()

◆ setChunkSizes()

◆ setVirtualBands()

◆ updateLabels()

◆ write()

◆ writeRaw()