Package jpl.mipl.io.vicar

VICAR Image I/O package.

See:
Description

Interface Summary

VicarInput	This interface includes everything needed to access an input VICAR file.
VicarIOBase	This interface includes everything that's common between the VicarInput and VicarOutput interfaces, such as file opening and label access.
VicarOutput	This interface includes everything needed to access an output VICAR file.

Class Summary

ISISInputFile	This class manages a single ISIS input image file.
IsisSystemLabel	This class is a bean that maintains all VICAR system label information.
LabelEntry	This class describes a single label entry and how to translate it to/from Bean properties.
LabelToBean	This class provides static functions which transfer data between VicarLabelSet objects and a JavaBean object described by an array of LabelEntry's.
OaImageKeywords
PDSInputFile	This class manages a single PDS input image file.
PDSNativeInputFile
PDSOutputFile	This class manages a single PDS output image file.
SystemLabel	This class is a bean that maintains all VICAR system label information.
VicarBinaryHeader	This class holds all the data for the binary header of a Vicar image.
VicarBinaryLabel	Manages a piece of Vicar Binary Label data, either the entire header or one line's worth of prefix.
VicarBinaryLinePrefix	This class holds all the data for the binary prefixs of a Vicar image.
VicarDataFormat	This class handles all aspects of data in different host representation.
VicarDataInputDIWrapper	VicarDataInputDIWrapper lets an application read primitive data types from a DataInput object; the data are converted (if necessary) from the int and real formats specified in the VicarDataFormat object that is passed in via the constructor.
VicarDataInputStream	VicarDataInputStream lets an application read primitive data types from an input stream; the data are converted (if necessary) from the int and real formats specified in the VicarDataFormat object that is passed in via the constructor.
VicarDataOutputDOWrapper	VicarDataOutputDOWrapper lets an application write primitive data types to a DataOutput object; the data are converted (if necessary) to the int and real formats specified in the VicarDataFormat object that is passed in via the constructor.
VicarDataOutputStream	VicarDataOutputStream lets an application write primitive data types to an output stream; the data are converted (if necessary) to the int and real formats specified in the VicarDataFormat object that is passed in via the constructor.
VicarInputFile	This class manages a single VICAR input image file.
VicarInputImage	This class manages a set of VICAR input image files, making the set appear like one image to the outside world.
VicarIO	This class is a convenient place to collect static functions related to the VICAR I/O system.
VicarLabel	This class maintains a VICAR label in various data structures, and provides access to it.
VicarLabelCategory	This class maintains a category of VICAR labels (i.e.
VicarLabelItem	This class maintains the key/value pair for a single VICAR label item, and provides mechanisms to retrieve and modify the key and value.
VicarLabelParser	This class parses and returns keyword/value pairs from a VICAR label string (incorporated into a stream).
VicarLabelSet	This class maintains an entire set (property set, history task, or system) of VICAR labels, with a collection of key/value pairs (Item's).
VicarOutputFile	This class manages a single VICAR output image file.
VicarOutputImage	This class manages a set of VICAR output image files, making the set appear like one image to the outside world.
VicarSwapDataInputDIWrapper	VicarSwapDataInputDIWrapper lets an application read primitive data types from a DataInput; the data are converted to Java's integer and real representations (HIGH, IEEE respectively) from LOW/RIEEE int/real representations.
VicarSwapDataInputStream	VicarSwapDataInputStream lets an application read primitive data types from an input stream; the data are converted to Java's integer and real representations (HIGH, IEEE respectively) from LOW/RIEEE int/real representations.
VicarSwapDataOutputDOWrapper	VicarSwapDataOutputDOWrapper lets an application write primitive data types to a DataOutput; the data are converted from Java's integer and real representations (HIGH, IEEE respectively) to LOW/RIEEE int/real representations.
VicarSwapDataOutputStream	VicarSwapDataOutputStream lets an application write primitive data types to an output stream; the data are converted from Java's integer and real representations (HIGH, IEEE respectively) to LOW/RIEEE int/real representations.
VicarVaxDataInputDIWrapper	VicarVaxDataInputDIWrapper lets an application read primitive data types from DataInput; the data are converted (if necessary) from the int and real formats specified in the VicarDataFormat object that is passed in via the constructor.
VicarVaxDataInputStream	VicarVaxDataInputStream lets an application read primitive data types from an input stream; the data are converted (if necessary) from the int and real formats specified in the VicarDataFormat object that is passed in via the constructor.
VicarVaxDataOutputDOWrapper	VicarVaxDataOutputDOWrapper lets an application write primitive data types to a DataOutput object; the data are converted (if necessary) to the int and real formats specified in the VicarDataFormat object that is passed in via the constructor.
VicarVaxDataOutputStream	VicarVaxDataOutputStream lets an application write primitive data types to an output stream; the data are converted (if necessary) to the int and real formats specified in the VicarDataFormat object that is passed in via the constructor.

Exception Summary

AlreadyOpenException	Attempt was made to set a property that has already been set, and cannot be set more than once.
BinaryFormatMismatchException	The format (host data representation) of a VicarBinaryLabel does not match the BINTFMT/BREALFMT of the file it is being written to.
BinarySizeMismatchException	The size of a VicarBinaryLabel does not match the size of the header or prefix of the file it is being written to.
NonSequentialAccessException	An attempt was made to access a sequential-only file in a non-sequential manner.
VicarLabelSyntaxException	An error occurred while parsing the VICAR label.

Package jpl.mipl.io.vicar Description

VICAR Image I/O package. Currently only Input and Output are supported; in-place Update of files is not. The package's major features are:

• Full label parsing
• Low-level (record-based) I/O API
• Mid-level (tile-based) I/O API
• Thread-safe
• Data type translation for any valid VICAR file
• Binary label supported (although discouraged)

Note that Complex data is not fully supported.

While direct access to VICAR files via this API is possible, it is recommended that the higher-level "codec" from the jpl.mipl.io.codec package be used instead. This codec is automatically registered with JAI using the OperationRegistrySpi interface. The codec supports tiling and access to the VICAR metadata.

Information on the mid- and low-level interfaces can be found in the javadoc for the VicarInput and VicarOutput interfaces.

Support files for the PDS and ISIS image formats have been added. These classes are used by the PDS reader and writer. ISIS has a reader only.