Class CompressedImageData

java.lang.Object

nom.tam.fits.Data

nom.tam.fits.AbstractTableData

nom.tam.fits.BinaryTable

nom.tam.image.compression.hdu.CompressedImageData

All Implemented Interfaces:

Cloneable, FitsElement, TableData

public class CompressedImageData
extends BinaryTable

FITS representation of a compressed image. Compressed images are essentially stored as FITS binary tables. They are distinguished only by a set of mandatory header keywords and specific column data structure. The image-specific header keywords of the original image are re-mapped to keywords starting with 'Z' prefixed so as to not interfere with the binary table description. (e.g. NAXIS1 of the original image is stored as ZNAXIS1 in the compressed table).

See Also:

• CompressedImageHDU

Nested Class Summary

Nested classes/interfaces inherited from class BinaryTable

BinaryTable.ColumnDesc

Modifier and Type	Class	Description
static class	BinaryTable.ColumnDesc	Describes the data type and shape stored in a binary table column.

Method Summary

Modifier and Type	Method	Description
void	fillHeader(Header h)

Methods inherited from class BinaryTable

addBitsColumn, addColumn, addColumn, addComplexColumn, addFlattenedColumn, addRow, addStringColumn, addVariableSizeColumn, compact, containsHeap, convertToBits, copy, createColumnDataFor, defragment, deleteColumns, deleteRows, fromColumnMajor, fromRowMajor, get, getArrayElement, getArrayElementAs, getBases, getColumn, getData, getDescriptor, getDescriptor, getDescriptor, getDimens, getDouble, getElement, getFlatColumns, getFlattenedColumn, getLogical, getLong, getModelRow, getNCols, getNRows, getNumber, getRawElement, getRow, getSizes, getString, getTypes, indexOf, parseTDims, read, reserveHeapSpace, reserveRowSpace, set, setColumn, setComplexColumn, setElement, setFlattenedColumn, setRow, toHDU, updateAfterDelete, write

Modifier and Type	Method	Description
int	addBitsColumn(Object o)	Adds a column of bits.
int	addColumn(Object o)	Adds a new column with the specified data array, with some default mappings.
int	addColumn(BinaryTable.ColumnDesc descriptor)	Adds a new empty column to the table to the specification.
int	addComplexColumn(Object o, Class<?> decimalType)	Adds a column of complex values stored as the specified decimal type of components in the FITS.
int	addFlattenedColumn(Object o, int... dims)	Deprecated. (for internal use) No longer used, will be removed in the future
int	addRow(Object[] o)	Adds a row to the table.
int	addStringColumn(String[] o)	Adds a column of string values (one per row), optimized for storage size.
int	addVariableSizeColumn(Object o)	Adds a new variable-length data column, populating it with the specified data object.
void	compact()	Discard the information about the original heap size (if this table was read from an input), and instead use the real size of the actual heap (plus reserved space around it) when writing to an output.
final boolean	containsHeap()	Checks if this table contains a heap for storing variable length arrays (VLAs).
boolean	convertToBits(int col)	Converts a column from FITS logical values to bits.
BinaryTable	copy()	Returns an independent copy of the binary table.
static void	createColumnDataFor(BinaryTable table)	Deprecated. (for internal use) It may become a private method in the future.
long	defragment()	Defragments the heap area of this table, compacting the heap area, and returning the number of bytes by which the heap size has been reduced.
void	deleteColumns(int start, int len)	Removes a set of consecutive columns from this table, without updating assocu=iated the header information for the columns that were removed.
void	deleteRows(int row, int len)	Removes a set of consecutive rows from this table without updating any associated header information for an encompassing HDU.
static BinaryTable	fromColumnMajor(Object[] columns)	Creates a binary table from existing data in column-major format order.
static BinaryTable	fromRowMajor(Object[][] table)	Creates a binary table from existing table data in row-major format.
Object	get(int row, int col)	Returns a table element using the usual Java boxing for primitive scalar (singleton) entries, or packaging complex values as ComplexValue, or as appropriate primitive or object arrays.
Object	getArrayElement(int row, int col)	Returns a table element as an array of the FITS storage type.
Object	getArrayElementAs(int row, int col, Class<?> asType)	Returns a numerical table element as an array of a specific underlying other numerical type.
Class<?>[]	getBases()	Deprecated. (for internal use) Ambiguous, use BinaryTable.ColumnDesc.getElementClass() instead.
Object	getColumn(int col)	Returns the data for a particular column in as an array of elements.
ColumnTable<?>	getData()	Returns the underlying Java representation of the data contained in this HDU's data segment.
BinaryTable.ColumnDesc	getDescriptor(int column)	Returns the column descriptor of a given column in this table
BinaryTable.ColumnDesc	getDescriptor(String name)	Returns the (first) column descriptor whose name matches the specified value.
static BinaryTable.ColumnDesc	getDescriptor(Header header, int col)	Extracts a column descriptor from the FITS header for a given column index
int[][]	getDimens()	Deprecated. (for internal use) Use BinaryTable.ColumnDesc.getEntryShape() to access the shape of Java elements individually for columns instead.
final double	getDouble(int row, int col)	Returns the decimal value, if possible, of a scalar table entry.
Object	getElement(int row, int col)	Returns a table element as a Java array.
Object[]	getFlatColumns()	Deprecated. (for internal use) It may be private in the future.
Object	getFlattenedColumn(int col)	Deprecated. (for internal use) It may be reduced to private visibility in the future.
final Boolean	getLogical(int row, int col)	Returns the boolean value, if possible, for scalar elements.
final long	getLong(int row, int col)	Returns a 64-bit integer value, if possible, of a scalar table entry.
Object[]	getModelRow()	Deprecated. (for internal use) Use BinaryTable.getElement(int, int) instead for low-level reading of tables in deferred mode.
int	getNCols()	Returns the number of columns contained in this table.
int	getNRows()	Returns the number of columns contained in this table.
final Number	getNumber(int row, int col)	Returns the numerical value, if possible, for scalar elements.
Object	getRawElement(int row, int col)	Deprecated. (for internal use) Will reduce visibility in the future.
Object[]	getRow(int row)	Returns an array of elements in a particualr table row.
int[]	getSizes()	Deprecated. (for internal use) Use BinaryTable.ColumnDesc.getElementCount() instead.
final String	getString(int row, int col)	Returns the string value, if possible, for scalar elements.
char[]	getTypes()	Deprecated. (for internal use) Use BinaryTable.ColumnDesc.getElementClass() instead.
int	indexOf(String name)	Returns the Java index of the first column by the specified name.
static int[]	parseTDims(String tdims)	Deprecated. (for internal use) It may be reduced to private visibility in the future.
void	read(ArrayDataInput in)	Reads the data or skips over it for reading later, depending on whether reading from a stream or a random acessible input, respectively.
void	reserveHeapSpace(int bytes)	Reserves space in the file at the end of the heap for future heap growth (e.g. different/longer or new VLA entries).
void	reserveRowSpace(int rows)	Reserves space for future addition of rows at the end of the regular table.
void	set(int row, int col, Object o)	The Swiss-army knife of setting table entries, including Java boxing, and with some support for automatic type conversions.
void	setColumn(int col, Object o)	Sets new data for a table column.
boolean	setComplexColumn(int index)	Convert a column from float/double to float complex/double complex.
void	setElement(int row, int col, Object o)	Consider using the more Java-friendly BinaryTable.set(int, int, Object) with implicit scalar type conversions.
void	setFlattenedColumn(int col, Object data)	Deprecated. (for internal use) It may be reduced to private visibility in the future.
void	setRow(int row, Object[] data)	Sets new data for a table row.
BinaryTableHDU	toHDU()	Returns an approprotae HDU object that encapsulates this FITS data, and contains the minimal mandatory header description for that data.
void	updateAfterDelete(int oldNcol, Header hdr)	Deprecated. It is not entirely foolproof for keeping the header in sync -- it is better to (re)wrap tables in a new HDU after column deletions, and then edit the new header as necessary to incorporate custom entries.
void	write(ArrayDataOutput os)	Writes the contents of the element to a data sink, adding padding as necessary if the element (such as a header or data segment) is expected to complete the FITS block of 2880 bytes.

Methods inherited from class Data

calcChecksum, detach, getFileOffset, getKernel, getSize, isDeferred, isEmpty, reset, rewrite, rewriteable

Modifier and Type	Method	Description
long	calcChecksum()	Computes and returns the FITS checksum for this data, for example to compare against the stored DATASUM in the FITS header (e.g. via BasicHDU.getStoredDatasum()).
void	detach()	Detaches this data object from the input (if any), such as a file or stream, but not before loading data from the previously assigned input into memory.
long	getFileOffset()	Returns the byte offset at which this element starts ina file.
final Object	getKernel()	Same as Data.getData().
long	getSize()	Returns the size of this elements in the FITS representation.
boolean	isDeferred()	Checks if the data should be assumed to be in deferred read mode.
boolean	isEmpty()	Checks if the data content is currently empty, i.e. no actual data is currently stored in memory.
boolean	reset()	Reset the input stream to point to the beginning of this element
void	rewrite()	Rewrite the contents of the element in place.
boolean	rewriteable()	Checks if we can write this element back to its source.

Methods inherited from class Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface TableData

addRowEntries, setRowEntries

Modifier and Type	Method	Description
default int	addRowEntries(Object... entries)	Like TableData.addRow(Object[]), but with a vararg list of row entries.
default void	setRowEntries(int row, Object... entries)	Like TableData.setRow(int, Object[]) but with vararg list of entries.

Method Details

fillHeader

public void fillHeader(Header h)
                throws FitsException

Overrides:

fillHeader in class BinaryTable

Throws:

FitsException