Документ взят из кэша поисковой машины. Адрес
оригинального документа
: http://www.atnf.csiro.au/computing/software/casacore/casacore-1.2.0/doc/html/group__TableMeasures__module.html
Дата изменения: Unknown Дата индексирования: Mon Feb 14 22:34:53 2011 Кодировка: Поисковые слова: agn |
Create and use scalar and array columns of Quanta and Measures in Tables. More...
Classes | |
class | casa::ROArrayMeasColumn< M > |
Read only access to table array Measure columns. More... | |
class | casa::ArrayMeasColumn< M > |
Read write access to table array Measure columns. More... | |
class | casa::ROArrayQuantColumn< T > |
Provides read-only access to Array Quantum columns in Tables. More... | |
class | casa::ArrayQuantColumn< T > |
Provides read/write access to Array Quantum columns in Tables. More... | |
class | casa::ROScalarMeasColumn< M > |
Read only access to table scalar Measure columns. More... | |
class | casa::ScalarMeasColumn< M > |
Read write access to table scalar Measure columns. More... | |
class | casa::ROScalarQuantColumn< T > |
Provides read-only access to Scalar Quantum Columns in Tables. More... | |
class | casa::ScalarQuantColumn< T > |
Provides read/write access to Scalar Quantum Columns in Tables. More... | |
class | casa::ROTableMeasColumn |
Read only access to table scalar Measure columns. More... | |
class | casa::TableMeasDesc< M > |
Definition of a Measure column in a Table. More... | |
class | casa::TableMeasOffsetDesc |
Definition of a Measure Offset in a Table. More... | |
class | casa::TableMeasRefDesc |
Definition of a Measure Reference in a Table. More... | |
class | casa::TableMeasValueDesc |
Definition of a Measure Value in a Table. More... | |
class | casa::TableQuantumDesc |
A class for defining Quantum columns in Tables. More... | |
Modules | |
TableMeasures_module_internal_classes | |
Internal TableMeasures_module classes and functions. |
Create and use scalar and array columns of Quanta and Measures in Tables.
See below for an overview of the classes in this module.
Table columns containing Measures and Quanta
The TableMeasures system exists to provide a way of creating (defining) Measure and Quantum Table columns thus enabling the direct storage of Quanta and Measures in Aips++ Tables.
Defining Quantum and Measure columns is a once only operation (for each column). It can be seen as an extension to the existing Column Descriptor mechanism which adds a column of a specified type to a table. The (see ())<class=TableMeasDesc>TableMeasDesc and (see ())<class=TableQuantumDesc>TableQuantumDesc class hierarchies are used to define Measure and Quantum columns.
Once defined, Measure and Quantum column objects are used to access a column for reading and writing of Measures and Quanta. For Quantum column objects see the classes (see ())<class=ROScalarQuantColumn>ScalarQuantColumn and (see ())<class=ROArrayQuantColumn>ArrayQuantColumn . For Measure column objects see (see ())<class=ROScalarMeasColumn>ScalarMeasColumn and (see ())<class=ROArrayMeasColumn>ArrayMeasColumn .
The classes accessing the data use the underlying Quanta or Measures classes to convert the units or references of the measures or quanta. The TableMeasures classes do not test if a conversion is possible.
In general one can say that about every unit conversion is possible. The Unit class adjusts units as needed.
Conversions of Measures are only possible if enough information is supplied for the measure's reference.
Take a look at the abovementioned modules to find out about conversions.
Using the TableMeasures classes makes it easier to deal with measures in tables. However, there is a performance penalty compared to handling the values directly in the table using the Tables classes ScalarColumn and ArrayColumn .
The performance of the TableMeasures classes depends on how the measures are stored; thus if a fixed or variable offset and reference are used. Of course, it also depends on whether the measures have to be converted before they can be stored.
The TableMeasures classes are always slower than the Tables classes, but they offer more convenience. In general one can say that for large tables it is better to use the Tables classes directly to put/get the data. However, even when putting directly using the Tables classes, the column itself should be defined as a TableMeasure. In that way there is one standard way of defining columns as table measures.
For example, the TIME column in a MeasurementSet should be handled directly uisng the Tables classes (because it is so large). On the other hand, the FIELD table is very small and it may make life easier to handle its columns through the TableMeasures classes.
In a test putting an array of quanta using class ArrayQuantColumn took about 5 times as long as doing it directly using class ArrayColumn . The quantum column had variable units. so for each row the unit had to be written as well. Reading it back took about 3 times as long.
When using a qunatum column with fixed units, putting took about 2.5 times as long as using ArrayColumn
directly. Each put involved a unit conversion. Reading it back took only 10% more than when using ArrayColumn
.
The standard Aips++ Table system does not directly support Quantum and Measure columns. These classes overcome this limitation.