casa  5.7.0-16
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Friends Macros Groups Pages
Public Member Functions | Protected Member Functions | Protected Attributes | Static Protected Attributes | Private Attributes | List of all members
VLAArchiveInput Class Referenceabstract

This class reads VLA archive records from a Tape. More...

#include <VLAArchiveInput.h>

Inheritance diagram for VLAArchiveInput:
VLADiskInput VLAOnlineInput VLATapeInput

Public Member Functions

virtual ~VLAArchiveInput ()
 The destructor is virtual to ensure that the destructor in a derived class is actually used. More...
 
casacore::ByteSourcelogicalRecord ()
 This returns a reconstructed VLA logical record from the input stream. More...
 
const casacore::ByteSourcelogicalRecord () const
 
virtual casacore::Bool read ()=0
 Reads the next logical record from specified IO source. More...
 
casacore::Bool hasData () const
 Returns if true if the current record contains data. More...
 

Protected Member Functions

 VLAArchiveInput ()
 

Protected Attributes

casacore::MemoryIO itsMemIO
 
casacore::ByteSinkSource itsRecord
 

Static Protected Attributes

static const casacore::uInt BlockSize
 
static const casacore::uInt HeaderSize
 
static const casacore::uInt MaxBlocksPerPhysicalRecord
 

Private Attributes

casacore::ModcompDataConversion itsModComp
 
casacore::ConversionIO itsCtrIO
 

Detailed Description

This class reads VLA archive records from a Tape.

Prerequisite

  1. The IO Module

Etymology

This class is designed to reads VLA archive records from a Tape

Synopsis

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:

  1. Read a 2048 chunk from the input.

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."

  1. The next 32-bit integer contains the length of the "logical record" in 16-bit words. The buffer is resized so that it can contain the whole reconstituted "logical record."
  2. The remainder of the chunk is copied to the buffer.
  3. Successive chunks are read from the input.

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.

Example

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 }

Motivation

To Do

  1. Bulletproofing - check for realistic buffer size (<1e6)
  2. Bulletproofing - check newn and newm on each read
  3. What happens after a single end-of-file on a tape drive?
  4. Add record skipping
  5. Should it work with stdin? This is in place but not debugged.

Definition at line 166 of file VLAArchiveInput.h.

Constructor & Destructor Documentation

virtual VLAArchiveInput::~VLAArchiveInput ( )
virtual

The destructor is virtual to ensure that the destructor in a derived class is actually used.

VLAArchiveInput::VLAArchiveInput ( )
protected

Member Function Documentation

casacore::Bool VLAArchiveInput::hasData ( ) const

Returns if true if the current record contains data.

The current record could be empty for a number of reasons including:

  • You attempted to read beyond the end of the file.
  • The physical record sequence numbers were not the expected ones
  • An I/O Error occured while trying to read from the file.
  • The beginning of a logical record could not be found. This is after searching 5MB of data.
casacore::ByteSource& VLAArchiveInput::logicalRecord ( )

This returns a reconstructed VLA logical 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.

const casacore::ByteSource& VLAArchiveInput::logicalRecord ( ) const
virtual casacore::Bool VLAArchiveInput::read ( )
pure virtual

Reads the next logical record from specified IO source.

Returns false if there was a problem assembling the next record ie., it returns the value of the hasData() member function.

Implemented in VLATapeInput, VLADiskInput, and VLAOnlineInput.

Member Data Documentation

const casacore::uInt VLAArchiveInput::BlockSize
staticprotected

Definition at line 201 of file VLAArchiveInput.h.

const casacore::uInt VLAArchiveInput::HeaderSize
staticprotected

Definition at line 203 of file VLAArchiveInput.h.

casacore::ConversionIO VLAArchiveInput::itsCtrIO
private

Definition at line 214 of file VLAArchiveInput.h.

casacore::MemoryIO VLAArchiveInput::itsMemIO
protected

Definition at line 210 of file VLAArchiveInput.h.

casacore::ModcompDataConversion VLAArchiveInput::itsModComp
private

Definition at line 213 of file VLAArchiveInput.h.

casacore::ByteSinkSource VLAArchiveInput::itsRecord
protected

Definition at line 217 of file VLAArchiveInput.h.

const casacore::uInt VLAArchiveInput::MaxBlocksPerPhysicalRecord
staticprotected

Definition at line 205 of file VLAArchiveInput.h.


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