|
casa
5.7.0-16
|
All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Friends Macros Groups Pages
|
casa
5.7.0-16
|
This class interprets a VLA logical record. More...
#include <VLALogicalRecord.h>
Public Member Functions | |
| VLALogicalRecord () | |
| Create an object that is not good for anything except that it can be assigned to (using the assigment operator). More... | |
| VLALogicalRecord (VLAArchiveInput *input) | |
| Create an object that reads its data from the specified VLAArchiveInput object. More... | |
| VLALogicalRecord (const VLALogicalRecord &other) | |
| The copy constructor uses reference semantics. More... | |
| ~VLALogicalRecord () | |
| The destructor just cleans up. More... | |
| VLALogicalRecord & | operator= (const VLALogicalRecord &other) |
| The assignment operator uses reference semantics. More... | |
| casacore::ByteSource & | logicalRecord () |
| This returns the reconstructed VLA archive record from the input stream. More... | |
| casacore::Bool | read () |
| Reads the next logical record from the ByteSource. More... | |
| casacore::Bool | isValid () const |
| Returns true if this class is attached to a VLAArchiveInput object. More... | |
| const VLARCA & | RCA () const |
| returns a reference to a class which can be used to interpret the data in the casacore::Record Control Area of the current logical record. More... | |
| const VLASDA & | SDA () const |
| returns a reference to a class which can be used to interpret the data in the Subarray casacore::Data Area of the current logical record. More... | |
| const VLACDA & | CDA (casacore::uInt which) const |
| returns a reference to a class which can be used to interpret the data in the Correlator casacore::Data Area of the current logical record. More... | |
| const VLAADA & | ADA (casacore::uInt which) const |
| returns a reference to a class which can be used to interpret the data in the Antenna casacore::Data Area (ADA) of the current logical record. More... | |
| casacore::Vector < casacore::Stokes::StokesTypes > | polarisations (VLAEnum::CDA cda, casacore::uInt ant1=0, casacore::uInt ant2=0) const |
| Return the polarisations of the data in the specified CDA. More... | |
Private Attributes | |
| casacore::CountedPtr < VLAArchiveInput > | itsRecordPtr |
| VLARCA | itsRCA |
| VLASDA | itsSDA |
| casacore::Block< VLAADA > | itsADA |
| casacore::Block< VLACDA > | itsCDA |
This class interprets a VLA logical record.
This class is designed to reconstitute VLA archive data records.
This class is designed to read VLA archive data. The data may be read from a disk, tape drive or any other data source supported by the IO module. A call to the operator++() function assembles the next reconstructed VLA archive data record from the input. A reference to this data can be obtained using the logicalRecord function.
Refer to the "VLA Archive casacore::Data casacore::Format", VLA Computer Memorandum 186 by G.C. Hunt, K.P. Sowinski, and T.J. Bottomly; June 1993. (This is also available as AIPS++ note 159)
The VLA archive records are always a multiple of 2048 bytes. The record sizes were designed for use with magnetic tapes, so there is a maximum physical record size of 13*2048=26624 bytes.
The low level class (blockio), that actually does the I/O, allows for a record (hereinafter chunk) size and for a input block size of a multiple of the chunk size. The low level read operation tests for the number of bytes actually read from the device.
The helper classes VlaDiskInput, VlaTapeInput, and VlaStdInput are designed to deal with the low level input from the devices in an analogous fashion to the ones used for casacore::FITS input.
Since a read may be issued for an arbitrary number of bytes from a disk, the chunk multiple is arbitrary and may be used to tune the speed of operation. There is an obvious trade-off between the block size created in the blockio class and the number of read operations.
The story is quite different for tape input. A read request for at least the maximum physical record size must be made to avoid loss of data. Since a single tape record will be read with a single read operation, there is no point is having it any larger. The chunk multiple must be exactly 13 so that the block size is 26624.
The reconstitution algorithm is as follows:
The first two 16-bit integers should contain the values 1 and n, where n is the number of "physical records" in the current "logical record." (If the first value is not 1, then the chunk is rejected and a new one read until the first 16-bit value is 1.) These two values are not part of the reconstituted "logical record."
The chunks are copied into the buffer until the "logical record" is complete. For "logical records" longer than 26620 byte, this is not the whole story. Each "physical record" contains maximum of 13 chunks. When the first "physical record" of 13 chunks has been read, the next chunk will be the first of the next "physical record." The first two 16-bit integers will now be 2 and n, to indicate that this is the second "physical record" of the sequence. These 4 bytes are decoded and the rest of this chunk is copied to the buffer. And so on...
An end-of-file condition on the input will cause record processing to be declared complete.
To open and read a VLA archive data file VLAArchiveInput *in; casacore::Block <casacore::Char> *buff; casacore::String fileName = " "; casacore::String fileType = "tape";
if (fileType == casacore::String("tape")) { in = new VLAArchiveInput(fileName.chars(), VLAArchiveInput::Tape); } else { in = new VLAArchiveInput(fileName.chars(), VLAArchiveInput::Disk); }
casacore::uInt record = 0; for (buff=&(in->next()); in->atEnd()==false; buff=&(in->next()), record++) { cout << "casacore::Record" << record << endl; process record pointed to by buff }
Definition at line 169 of file VLALogicalRecord.h.
| VLALogicalRecord::VLALogicalRecord | ( | ) |
Create an object that is not good for anything except that it can be assigned to (using the assigment operator).
| VLALogicalRecord::VLALogicalRecord | ( | VLAArchiveInput * | input | ) |
Create an object that reads its data from the specified VLAArchiveInput object.
The supplied pointer should be obtained from new and is "taken over". Hence the user should not delete it.
| VLALogicalRecord::VLALogicalRecord | ( | const VLALogicalRecord & | other | ) |
The copy constructor uses reference semantics.
| VLALogicalRecord::~VLALogicalRecord | ( | ) |
The destructor just cleans up.
| const VLAADA& VLALogicalRecord::ADA | ( | casacore::uInt | which | ) | const |
returns a reference to a class which can be used to interpret the data in the Antenna casacore::Data Area (ADA) of the current logical record.
A logical record has one ADA for each antenna that contributed to the data in this record and the argument is used to specify which one you are interested in. And exception is thrown if the input argument is not less than the number of antennas in this subarray.
| const VLACDA& VLALogicalRecord::CDA | ( | casacore::uInt | which | ) | const |
returns a reference to a class which can be used to interpret the data in the Correlator casacore::Data Area of the current logical record.
A logical record can have have up to four correlator data areas and the argument is used to specify which one you are interested in. And exception is thrown if the input argument is greater than three.
| casacore::Bool VLALogicalRecord::isValid | ( | ) | const |
Returns true if this class is attached to a VLAArchiveInput object.
| casacore::ByteSource& VLALogicalRecord::logicalRecord | ( | ) |
This returns the reconstructed VLA archive record from the input stream.
This casacore::ByteSource has the data stored in memory, and hence is seekable. casacore::Data read from this casacore::ByteSource will have the ModComp numeric conversions applied.
| VLALogicalRecord& VLALogicalRecord::operator= | ( | const VLALogicalRecord & | other | ) |
The assignment operator uses reference semantics.
| casacore::Vector<casacore::Stokes::StokesTypes> VLALogicalRecord::polarisations | ( | VLAEnum::CDA | cda, |
| casacore::uInt | ant1 = 0, |
||
| casacore::uInt | ant2 = 0 |
||
| ) | const |
Return the polarisations of the data in the specified CDA.
This information is obtained from knowing what the correlator modes represent and checking the IF transfer switch for the specified antennas.
| const VLARCA& VLALogicalRecord::RCA | ( | ) | const |
returns a reference to a class which can be used to interpret the data in the casacore::Record Control Area of the current logical record.
| casacore::Bool VLALogicalRecord::read | ( | ) |
Reads the next logical record from the ByteSource.
Returns false if there was a problem assembling the next record.
| const VLASDA& VLALogicalRecord::SDA | ( | ) | const |
returns a reference to a class which can be used to interpret the data in the Subarray casacore::Data Area of the current logical record.
|
private |
Definition at line 247 of file VLALogicalRecord.h.
|
private |
Definition at line 251 of file VLALogicalRecord.h.
|
private |
Definition at line 239 of file VLALogicalRecord.h.
|
private |
Definition at line 235 of file VLALogicalRecord.h.
|
private |
Definition at line 243 of file VLALogicalRecord.h.
1.8.5