Base class for accessing ISIS blobs. More...

#include <Blobber.h>

Inheritance diagram for Isis::Blobber:

Collaboration diagram for Isis::Blobber:

Public Member Functions
	Blobber ()
	Default basic constructor that is mostly not useful. More...

	Blobber (const QString &blobname, const QString &fieldname, const QString &name="Blob")
	Name-only based constructor. More...

	Blobber (Cube &cube, const QString &blobname, const QString &fieldname, const QString &name="Blob")
	Constructor using an ISIS cube class. More...

virtual	~Blobber ()
	Destructor of this object. More...

Blobber	deepcopy () const
	Create a unique copy of this blob. More...

void	setName (const QString &name)
	Specifies the name of this class instantiation. More...

void	setBlobName (const QString &bname)
	Sets the name of the ISIS BLOB object that contains the data. More...

void	setFieldName (const QString &fname)
	Sets field name in the ISIS BLOB object that contains data. More...

int	size () const
	Returns the total number of elements (rows * columns) in blob. More...

int	Lines () const
	Number of rows or lines in the BLOB. More...

int	Samples () const
	Number of columns or samples in the BLOB. More...

QString	getName () const
	Returns the name of the BLOB given to refer to this instantiation. More...

QString	getBlobName () const
	Retrieves the name of the Table object. More...

QString	getFieldName () const
	Retreive the name of the field in the Tabel object BLOB. More...

double *	operator[] (int i)
	Returns the ith row/line in the BLOB that can be further referenced into samples. More...

double const *	operator[] (int i) const
	Returns the ith row/line in the BLOB that can be further referenced into samples. More...

void	load (const QString &filename)
	Loads the contents of a BLOB from a cube file. More...

void	load (Cube &cube)
	Loads the contents of a BLOB from a Cube object. More...

Protected Types
typedef TNT::Array2D< double >	BlobBuf
	Internal buffer uses TNT. More...

Protected Member Functions
const BlobBuf &	ref () const
	Returns a const reference to the internal buffer for ease of use to derived objects. More...

Detailed Description

Base class for accessing ISIS blobs.

This class will read any ISIS BLOB and provide generalized access to its data. Developers can derive new classes that define access information in the form of names of the Isis Object and field name.

The entire contents of the field are read in and internally stored as double floating point values. All recognized ISIS special pixels are converted when read.

Note that this provides read access only. Currently, no output is performed in this implementation although it could be acheived in derived classes.

This class does not maintain persistant access to the BLOB. This means that the entire contents of the BLOB are read and stored and the interface to the ISIS BLOB is then terminated.

Below is an example using this class to access a HiRISE BLOB. It loads the BLOB, reports the number of lines and samples and then computes the mean and standard deviation using the Statistics class:

Cube cube("hirise.cub");
Blobber hiblob(cube, "HiRISE Calibration Image", "Calibration",
                  "CalibrationImage");
std::cout << "Number of lines:   " << hiblob.Lines() << std::endl;
std::cout << "Number of samples: " << hiblob.Samples() << std::endl;
Statistics stats;
for (int line = 0 ; line < hiblob.Lines() ; line++) {
  stats.AddData(hiblob[line], hiblob.Samples());
}
std::cout << "Average: " << stats.Average() << std::endl;
std::cout << "StdDev:  " << stats.StandardDeviation() << std::endl;

In the above example, the name of the ISIS Table (BLOB) is "HiRISE Calibration Image" and the field of interest in that table is "Calibration". Upon instantiation, the BLOB contents are read and converted to double precision floating point values.

Note that this class is reuseable and reentrant. This provides the user to specify a different cube to load the data from.

One special thing to note that assigning these objects to other object variables results in a reference to the data...it is not copied. The following illustrates this concept:

Cube cube('hirise.cub');
Blobber hiblob(cube, "HiRISE Calibration Image", "Calibration",
                  "CalibrationImage");
Blobber myblob(hiblob);
Blobber blob2 = myblob;

In this example, hiblob, myblob and blob2 refer to the same blob data. Changing a pixel element in one blob results in the change in all instances of the blob. To get a completely independant copy of the data, use the deepcopy() method.

Author: 2005-12-16 Kris Becker

Member Typedef Documentation

◆ BlobBuf

typedef TNT::Array2D<double> Isis::Blobber::BlobBuf

protected

Internal buffer uses TNT.

Constructor & Destructor Documentation

◆ Blobber() [1/3]

Isis::Blobber::Blobber ( )

Default basic constructor that is mostly not useful.

This basic constructor may only be required so that Blobbers can be used in STL constructs (as they require a default constructor)

◆ Blobber() [2/3]

Isis::Blobber::Blobber	(	const QString &	blobname,
		const QString &	fieldname,
		const QString &	name = `"Blob"`
	)

Name-only based constructor.

This constructor does not require an accompanying cube and allows the user to simply define the Table object and field names to establish these for multiple reads from different cubes.

Parameters

[in]	blobname	(const QString&) specifies the name of the ISIS BLOB that contains the field to read the data from
[in]	fieldname	(const QString&) specifies the name of the field in blobname to read and convert to double precision floating point data
[in]	name	(const QString&) Associates a name of the implementors choosing that identifies an instantiation of this class

◆ Blobber() [3/3]

Isis::Blobber::Blobber	(	Cube &	cube,
		const QString &	blobname,
		const QString &	fieldname,
		const QString &	name = `"Blob"`
	)

Constructor using an ISIS cube class.

Reads the contents of the specified field (fieldname) from an ISIS table BLOB (blobname). Upon instatiation of this class, the BLOB data is read in and converted to double precision floating point data. Upon successful return from this construtor, the data is accessble through various methods.

Parameters

[in]	cube	(Cube&) Reference to an ISIS cube file that has been opened or created in the Cube object. This file is expected to contain a Table object that is named blobname and must contain a field called fieldname.
[in]	blobname	(const QString&) specifies the name of the ISIS BLOB that contains the field to read the data from
[in]	fieldname	(const QString&) specifies the name of the field in blobname to read and convert to double precision floating point data
[in]	name	(const QString&) Associates a name of the implementors choosing that identifies an instantiation of this class

References load().

◆ ~Blobber()

virtual Isis::Blobber::~Blobber ( )

inlinevirtual

Destructor of this object.

Member Function Documentation

◆ deepcopy()

Blobber Isis::Blobber::deepcopy ( ) const

Create a unique copy of this blob.

This method creates a fully new copy of this object. The default copy constructors/methods create a reference to the data read from the Table object. For example, the following code fragment will result in two Blobbers that refer to the same memory location that stores the BLOB data:

Blobber myblob = yourblob;

To ensure you have two unique storage areas of the BLOB data so they can change independantly, use:

Blobber myblob = yourblob.deepcopy();

Returns: (Blobber) Returns a completely new copy, including data, to caller.

◆ getBlobName()

QString Isis::Blobber::getBlobName ( ) const

inline

Retrieves the name of the Table object.

Returns: (string) Name of the Table

Referenced by load().

◆ getFieldName()

QString Isis::Blobber::getFieldName ( ) const

inline

Retreive the name of the field in the Tabel object BLOB.

Returns: (string) Name of the BLOB field

Referenced by load().

◆ getName()

QString Isis::Blobber::getName ( ) const

inline

Returns the name of the BLOB given to refer to this instantiation.

Returns: Name of BLOB instance

◆ Lines()

int Isis::Blobber::Lines ( ) const

inline

Number of rows or lines in the BLOB.

Returns: The lines or rows

Referenced by size().

◆ load() [1/2]

void Isis::Blobber::load ( const QString & filename )

Loads the contents of a BLOB from a cube file.

Provides the I/O interface for ISIS cube files.

Parameters

[in] filename (string&) Name of ISIS cube file to read

References Isis::Cube::open().

Referenced by Blobber().

◆ load() [2/2]

void Isis::Blobber::load ( Cube & cube )

Loads the contents of a BLOB from a Cube object.

Provides the I/O interface for the Cube object. One thing to note here is that it creates a CubeInfo object from the Cube object and then calls the CubeInfo load method. Hence, this method is required as an intermediary method that cascades to the actual method that does the real work.

Parameters

[in] cube (Cube&) Reference to an ISIS cube file that has been opened or created in the Cube object.

References _FILEINFO_, getBlobName(), getFieldName(), Isis::TableField::isDouble(), Isis::TableField::isInteger(), Isis::IException::Programmer, and Isis::Cube::read().

◆ operator[]() [1/2]

double* Isis::Blobber::operator[] ( int i )

inline

Returns the ith row/line in the BLOB that can be further referenced into samples.

To access the 2nd sample in the 10th line use:

double sample = blobber[9][1];

Parameters

i Index

Returns: Pointer to the ith row in the BLOB

◆ operator[]() [2/2]

double const* Isis::Blobber::operator[] ( int i ) const

inline

Returns the ith row/line in the BLOB that can be further referenced into samples.

This method provides const access to the data in row matrix form. To access the 2nd sample in the 10th line use:

double sample = blobber[9][1];

Parameters

i Index

Returns: Const pointer to the ith row in the BLOB

◆ ref()

const BlobBuf& Isis::Blobber::ref ( ) const

inlineprotected

Returns a const reference to the internal buffer for ease of use to derived objects.

Returns: Const reference to BLOB buffer

Referenced by Isis::HiBlob::buffer().

◆ Samples()

int Isis::Blobber::Samples ( ) const

inline

Number of columns or samples in the BLOB.

Returns: The number of samples or columns

Referenced by size().

◆ setBlobName()

void Isis::Blobber::setBlobName ( const QString & bname )

inline

Sets the name of the ISIS BLOB object that contains the data.

This is name of a ISIS Table object that contains one or more fields that make up the BLOB. This is the value of the [i]Name[/i] keyword in the Table object.

Parameters

bname Blobber name

◆ setFieldName()

void Isis::Blobber::setFieldName ( const QString & fname )

inline

Sets field name in the ISIS BLOB object that contains data.

This method sets the name of the field contained within the Table object BLOB from which the data is extracted.

Parameters

fname Field name

◆ setName()

void Isis::Blobber::setName ( const QString & name )

inline

Specifies the name of this class instantiation.

This is just an additional name that can be used to identify instantiations of this class. It provides a way to uniquely identify each object.

Parameters

name	Unique name

◆ size()

int Isis::Blobber::size ( ) const

inline

Returns the total number of elements (rows * columns) in blob.

Returns: The product of rows and columns

References Lines(), and Samples().

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

/usgs/pkgs/isis3.9.0_docs/ISIS3/isis/src/base/objs/Blobber/Blobber.h
/usgs/pkgs/isis3.9.0_docs/ISIS3/isis/src/base/objs/Blobber/Blobber.cpp

Public Member Functions

Protected Types

Protected Member Functions

Detailed Description

Member Typedef Documentation

◆ BlobBuf

Constructor & Destructor Documentation

◆ Blobber() [1/3]

◆ Blobber() [2/3]

◆ Blobber() [3/3]

◆ ~Blobber()

Member Function Documentation

◆ deepcopy()

◆ getBlobName()

◆ getFieldName()

◆ getName()

◆ Lines()

◆ load() [1/2]

◆ load() [2/2]

◆ operator[]() [1/2]

◆ operator[]() [2/2]

◆ ref()

◆ Samples()

◆ setBlobName()

◆ setFieldName()

◆ setName()

◆ size()