casa  $Rev:20696$
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Friends Defines
Public Member Functions | Protected Member Functions | Private Member Functions | Private Attributes | Friends
casa::TblAsRasterDD Class Reference

Class for displaying data within a table as a raster image. More...

#include <TblAsRasterDD.h>

Inheritance diagram for casa::TblAsRasterDD:
casa::ActiveCaching2dDD casa::CachingDisplayData casa::DisplayData casa::DisplayOptions casa::DisplayEH casa::DlTarget

List of all members.

Public Member Functions

 TblAsRasterDD (Table *table)
 constructors given an already constructed table
 TblAsRasterDD (const String tablename)
 given a string which gives the full pathname and filename of a table on disk
virtual ~TblAsRasterDD ()
 Destructor.
virtual String showValue (const Vector< Double > &world)
 format the table value at the give world position
virtual const Unit dataUnit (const String column)
 get the data unit
virtual const Unit dataUnit ()
virtual void setDefaultOptions ()
 install the default options for this DisplayData
virtual Bool setOptions (Record &rec, Record &recOut)
 Apply options stored in rec to the DisplayData.
virtual Record getOptions ()
 Retrieve the current and default options and parameter types.
virtual Display::DisplayDataType classType ()
 Return the type of this DisplayData.
virtual CachingDisplayMethodnewDisplayMethod (WorldCanvas *worldCanvas, AttributeBuffer *wchAttributes, AttributeBuffer *ddAttributes, CachingDisplayData *dd)
 Create a new TblAsRasterDM for drawing on the given WorldCanvas when the AttributeBuffers are suitably matched to the current state of this DisplayData and of the WorldCanvas/Holder.
virtual AttributeBuffer optionsAsAttributes ()
 Return the current options of this DisplayData as an AttributeBuffer.
Tabletable ()
 provide read-only access to the table
virtual void cleanup ()
 Clean up (ie.

Protected Member Functions

 TblAsRasterDD ()
 (Required) default constructor.
 TblAsRasterDD (const TblAsRasterDD &other)
 (Required) copy constructor.
void operator= (const TblAsRasterDD &other)
 (Required) copy assignment.
template<class T >
Bool getTableKeyword (T &value, const String keyword) const
 Get the value of the named keyword, or the first keyword matching regex, and return it in value.
template<class T >
Bool getTableKeyword (T &value, const Regex &regex) const
template<class T >
Bool getColumnKeyword (T &value, const String column, const String keyword) const
 Get the value of the named keyword, or the first keyword matching regex for the named column, and return it in value.
template<class T >
Bool getColumnKeyword (T &value, const String column, const Regex &regex) const

Private Member Functions

void installDefaultOptions ()
 set the default options for this display data
Bool arrangeQueryTable ()
 Arrange the query table (called after changing an option).
void getCoordinateSystem ()
 update/set the coordinate system
void setCoordinateSystem ()
void getTableColumnNames ()
 get all of the table columnNames
Vector< double > columnStatistics (const String &columnName)
 get the table column world coordinate range
Vector< StringgetColumnNamesOfType (const Bool isarray)
 get all of the table columnNames with a certain data type
void constructParameters ()
 Construct and destruct the parameter set.
void destructParameters ()

Private Attributes

TableitsTable
 The table to be displayed.
TableitsQueryTable
 The result from a table query.
Vector< StringitsColumnNames
 store all the table column names
DParameterChoiceitsXColumnName
 what columns are we displaying and do we have a movie axis available
DParameterChoiceitsYColumnName
DParameterChoiceitsMColumnName
DParameterChoiceitsMColumnSet
String itsOptQueryString
 options - what is the query string and is it unset?
Bool itsOptQueryStringUnset
CoordinateSystem itsCoord
 holder for the current coordinate system
Vector< DoubleitsLinblc
Vector< DoubleitsLintrc

Friends

class TblAsRasterDM
 
                                                                   


Detailed Description

Class for displaying data within a table as a raster image.

Intended use:

Internal or

Intended use:

Internal

Prerequisite

Etymology

"TblAsRasterDD" is a implementation of a ActiveCaching2dDD which provides for the display of data held within a table to be displayed as a raster image in an environment where individual depictions of the data are automatically cached.

Synopsis

This class adds to the interface defined in DisplayData . It adds the capability to display vector/array data from a Table column as a raster image. It is assumed that the Y axis is defined to be either the row number of the table column being displayed or the scalar value from the same row number in a different table column (e.g. plotting intensity as a function of frequency against row number or time determined from a different column of the table). The X axis is assumed to be a one dimensional array or vector of of data for each row in the column being displayed. It is assumed that the length of this array/vector does not change throughout the column of the table.

Example

A TblAsRasterDD object could be construed and used as follows:

       TblAsRasterDD *tardd1 = 0;
       tardd1 = new TblAsRasterDD("tablename");
       Colormap cmap1("Hot Metal 2");
       tardd1->setColormap(&cmap1, 1.0);
       wcHolder->addDisplayData((DisplayData *)tardd1);

Motivation

To allow the display of data from a table as a raster image.

Template Type Argument Requirements (T)

To Do

Definition at line 116 of file TblAsRasterDD.h.


Constructor & Destructor Documentation

constructors given an already constructed table

given a string which gives the full pathname and filename of a table on disk

virtual casa::TblAsRasterDD::~TblAsRasterDD ( ) [virtual]

Destructor.

(Required) default constructor.

casa::TblAsRasterDD::TblAsRasterDD ( const TblAsRasterDD other) [protected]

(Required) copy constructor.


Member Function Documentation

Arrange the query table (called after changing an option).

Return the type of this DisplayData.

Implements casa::DisplayData.

Definition at line 151 of file TblAsRasterDD.h.

References casa::Display::Raster.

virtual void casa::TblAsRasterDD::cleanup ( ) [virtual]

Clean up (ie.

delete any existing cached display list).

Reimplemented from casa::ActiveCaching2dDD.

Vector<double> casa::TblAsRasterDD::columnStatistics ( const String columnName) [private]

get the table column world coordinate range

Construct and destruct the parameter set.

virtual const Unit casa::TblAsRasterDD::dataUnit ( const String  column) [virtual]

get the data unit

virtual const Unit casa::TblAsRasterDD::dataUnit ( ) [virtual]
template<class T >
Bool casa::TblAsRasterDD::getColumnKeyword ( T &  value,
const String  column,
const String  keyword 
) const [protected]

Get the value of the named keyword, or the first keyword matching regex for the named column, and return it in value.

The return value is True for success, and False for failure, which is the result if // the wrong type T is requested, or if the keyword doesn't exist.

template<class T >
Bool casa::TblAsRasterDD::getColumnKeyword ( T &  value,
const String  column,
const Regex regex 
) const [protected]

get all of the table columnNames with a certain data type

update/set the coordinate system

virtual Record casa::TblAsRasterDD::getOptions ( ) [virtual]

Retrieve the current and default options and parameter types.

Reimplemented from casa::ActiveCaching2dDD.

get all of the table columnNames

template<class T >
Bool casa::TblAsRasterDD::getTableKeyword ( T &  value,
const String  keyword 
) const [protected]

Get the value of the named keyword, or the first keyword matching regex, and return it in value.

The return value is True for success, and False for failure, which is the result if the wrong type T is requested.

template<class T >
Bool casa::TblAsRasterDD::getTableKeyword ( T &  value,
const Regex regex 
) const [protected]

set the default options for this display data

Reimplemented from casa::CachingDisplayData.

virtual CachingDisplayMethod* casa::TblAsRasterDD::newDisplayMethod ( WorldCanvas worldCanvas,
AttributeBuffer wchAttributes,
AttributeBuffer ddAttributes,
CachingDisplayData dd 
) [virtual]

Create a new TblAsRasterDM for drawing on the given WorldCanvas when the AttributeBuffers are suitably matched to the current state of this DisplayData and of the WorldCanvas/Holder.

The tag is a unique number used to identify the age of the newly constructed CachingDisplayMethod.

Implements casa::CachingDisplayData.

void casa::TblAsRasterDD::operator= ( const TblAsRasterDD other) [protected]

(Required) copy assignment.

Return the current options of this DisplayData as an AttributeBuffer.

Reimplemented from casa::ActiveCaching2dDD.

virtual void casa::TblAsRasterDD::setDefaultOptions ( ) [virtual]

install the default options for this DisplayData

Reimplemented from casa::ActiveCaching2dDD.

virtual Bool casa::TblAsRasterDD::setOptions ( Record rec,
Record recOut 
) [virtual]

Apply options stored in rec to the DisplayData.

A return value of True means a refresh is needed. recOut contains any fields which were implicitly changed as a result of the call to this function.

Reimplemented from casa::ActiveCaching2dDD.

virtual String casa::TblAsRasterDD::showValue ( const Vector< Double > &  world) [virtual]

format the table value at the give world position

Implements casa::DisplayData.

provide read-only access to the table


Friends And Related Function Documentation

friend class TblAsRasterDM [friend]

                                                                   

Definition at line 209 of file TblAsRasterDD.h.


Member Data Documentation

store all the table column names

Definition at line 218 of file TblAsRasterDD.h.

holder for the current coordinate system

Definition at line 237 of file TblAsRasterDD.h.

Definition at line 238 of file TblAsRasterDD.h.

Definition at line 238 of file TblAsRasterDD.h.

Definition at line 223 of file TblAsRasterDD.h.

Definition at line 224 of file TblAsRasterDD.h.

options - what is the query string and is it unset?

Definition at line 227 of file TblAsRasterDD.h.

Definition at line 228 of file TblAsRasterDD.h.

The result from a table query.

Definition at line 215 of file TblAsRasterDD.h.

The table to be displayed.

Definition at line 212 of file TblAsRasterDD.h.

what columns are we displaying and do we have a movie axis available

Definition at line 221 of file TblAsRasterDD.h.

Definition at line 222 of file TblAsRasterDD.h.


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