Export a PDS table from an ISIS Table. More...

#include <ExportPdsTable.h>

Collaboration diagram for Isis::ExportPdsTable:

Public Member Functions
	ExportPdsTable (Table isisTable)
	Construct an ExportPdsTable object and set default member variable values.

	~ExportPdsTable ()
	Destructs for ExportPdsTable objects.

PvlObject	exportTable (char *pdsTableBuffer, int pdsFileRecordBytes, QString pdsByteOrder)
	This methods fills the given buffer with the binary PDS table data and returns label information.

QString	formatPdsTableName ()
	Format the PDS table object name using the ISIS table name.

Static Public Member Functions
static QString	formatPdsTableName (QString isisTableName)
	Static method that formats the given ISIS table name in PDS format.

Private Member Functions
void	Pack (TableRecord record, char buffer, EndianSwapper endianSwap)
	Pack the buffer with data from the table record, swapping bytes if needed.

PvlObject	fillMetaData ()
	Creates a PvlObject to be added to the PDS label with needed TABLE information.

Private Attributes
Table *	m_isisTable
	Input ISIS Table object to be exported.

int	m_numRows
	The number of rows in the exported PDS table.

int	m_outputRecordBytes
	The number of bytes per record in the exported PDS file.

int	m_rowBytes
	The number of bytes per row in the exported PDS table.

QString	m_pdsByteOrder
	A string indicating the byte order of the exported PDS file.

Detailed Description

Export a PDS table from an ISIS Table.

This class ingests an ISIS Table and converts it to a PDS Table.

NOTE: This class exports BINARY format PDS tables. The PDS Standards Reference document indicates that for files containing multiple tables with binary data, the records should be FIXED_LENGTH (not STREAM) and that this value should be the length of the longest record in the file (Appendix A, PDS Standards, last updated February 27, 2009). This document also indicates that all table rows that are less than the fixed record length value should be padded (ususally with nulls).

See also: http://pds.nasa.gov/standards-reference.shtml; http://pds.nasa.gov/documents/sr/AppendixA.pdf

ExportPdsTable pdsTable(isisTable);

pdsTable.exportToPds(buffer, recordBytes, "LSB");

Isis::ExportPdsTable

Export a PDS table from an ISIS Table.

Definition ExportPdsTable.h:52

Author: 2012-07-21 Jeannie Backer

History: 2012-11-21 Original Version. References #678.

Todo: This class is currently only exporting BINARY format PDS tables. Implementation may be added later to export ASCII PDS tables.

Definition at line 52 of file ExportPdsTable.h.

Constructor & Destructor Documentation

◆ ExportPdsTable()

Isis::ExportPdsTable::ExportPdsTable ( Table isisTable )

Construct an ExportPdsTable object and set default member variable values.

This constructor sets the following defaults:

BYTEORDER = "LSB"
ROWS = Records
ROW_BYTES = RecordSize

Parameters

isisTable The ISIS Table object to be exported.

Definition at line 38 of file ExportPdsTable.cpp.

References m_isisTable, m_numRows, m_outputRecordBytes, m_pdsByteOrder, m_rowBytes, and Isis::Table::RecordSize().

◆ ~ExportPdsTable()

Isis::ExportPdsTable::~ExportPdsTable ( )

Destructs for ExportPdsTable objects.

Definition at line 51 of file ExportPdsTable.cpp.

References m_isisTable.

Member Function Documentation

◆ exportTable()

PvlObject Isis::ExportPdsTable::exportTable	(	char *	pdsTableBuffer,
		int	outputFileRecordBytes,
		QString	pdsTableByteOrder )

This methods fills the given buffer with the binary PDS table data and returns label information.

Parameters

pdsTableBuffer	This buffer will be filled with binary PDS table data.
pdsFileRecordBytes	The number or RECORD_BYTES in the PDS file.
pdsByteOrder	A string containing the byte order of the PDS file. Valid values are "LSB" or "MSB".

Returns: PvlObject A Pvl containing the PDS table's label information.

Definition at line 67 of file ExportPdsTable.cpp.

References fillMetaData(), m_isisTable, m_outputRecordBytes, m_pdsByteOrder, m_rowBytes, Isis::Table::Name(), Pack(), Isis::Table::Records(), Isis::TableRecord::RecordSize(), Isis::toString(), and Isis::IException::Unknown.

◆ fillMetaData()

PvlObject Isis::ExportPdsTable::fillMetaData ( )

private

Creates a PvlObject to be added to the PDS label with needed TABLE information.

Returns: PvlObject containing PDS Table metadata.

Definition at line 125 of file ExportPdsTable.cpp.

References Isis::TableField::Double, formatPdsTableName(), Isis::TableField::Integer, m_isisTable, m_outputRecordBytes, m_pdsByteOrder, m_rowBytes, Isis::IException::Programmer, Isis::TableField::Real, Isis::Table::RecordFields(), Isis::Table::Records(), Isis::TableField::Text, and Isis::toString().

Referenced by exportTable().

◆ formatPdsTableName() [1/2]

QString Isis::ExportPdsTable::formatPdsTableName ( )

Format the PDS table object name using the ISIS table name.

Returns: QString containing the formatted PDS table name.

Definition at line 205 of file ExportPdsTable.cpp.

References formatPdsTableName(), m_isisTable, and Isis::Table::Name().

Referenced by fillMetaData(), and formatPdsTableName().

◆ formatPdsTableName() [2/2]

QString Isis::ExportPdsTable::formatPdsTableName ( QString isisTableName )

static

Static method that formats the given ISIS table name in PDS format.

This method takes the upper camel case Isis table name and returns a PDS table name that is underscore separated, all upper case and with "_TABLE" appended to the end of the name, if not already present.

Parameters

isisTableName An QString containing the ISIS upper camel case table name.

Returns: QString containing the formatted PDS table name.

Definition at line 219 of file ExportPdsTable.cpp.

◆ Pack()

void Isis::ExportPdsTable::Pack	(	TableRecord	record,
		char *	buffer,
		EndianSwapper *	endianSwap )

private

Pack the buffer with data from the table record, swapping bytes if needed.

Parameters

record	ISIS TableRecord to be exported
buffer	Output buffer to be filled with PDS table row data in the appropriate byte order.
endianSwap	Pointer to EndianSwapper object to swap bytes if the input Isis Table byte order is not the same as the output PDS byte order.

Definition at line 249 of file ExportPdsTable.cpp.

References Isis::TableRecord::Fields(), m_isisTable, m_rowBytes, Isis::Table::Name(), Isis::IException::Programmer, and Isis::IException::Unknown.

Referenced by exportTable().

Member Data Documentation

◆ m_isisTable

Table* Isis::ExportPdsTable::m_isisTable

private

Input ISIS Table object to be exported.

Definition at line 63 of file ExportPdsTable.h.

Referenced by ExportPdsTable(), exportTable(), fillMetaData(), formatPdsTableName(), Pack(), and ~ExportPdsTable().

◆ m_numRows

int Isis::ExportPdsTable::m_numRows

private

The number of rows in the exported PDS table.

This value is the same as the number of records the ISIS Table.

Definition at line 64 of file ExportPdsTable.h.

Referenced by ExportPdsTable().

◆ m_outputRecordBytes

int Isis::ExportPdsTable::m_outputRecordBytes

private

The number of bytes per record in the exported PDS file.

Definition at line 67 of file ExportPdsTable.h.

Referenced by ExportPdsTable(), exportTable(), and fillMetaData().

◆ m_pdsByteOrder

QString Isis::ExportPdsTable::m_pdsByteOrder

private

A string indicating the byte order of the exported PDS file.

Definition at line 73 of file ExportPdsTable.h.

Referenced by ExportPdsTable(), exportTable(), and fillMetaData().

◆ m_rowBytes

int Isis::ExportPdsTable::m_rowBytes

private

The number of bytes per row in the exported PDS table.

This value is the same as the RecordSize (number of bytes per record) of the ISIS Table.

Definition at line 69 of file ExportPdsTable.h.

Referenced by ExportPdsTable(), exportTable(), fillMetaData(), and Pack().

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

src/base/objs/ExportPdsTable/ExportPdsTable.h
src/base/objs/ExportPdsTable/ExportPdsTable.cpp

Public Member Functions

Static Public Member Functions

Private Member Functions

Private Attributes

Detailed Description

Constructor & Destructor Documentation

◆ ExportPdsTable()

◆ ~ExportPdsTable()

Member Function Documentation

◆ exportTable()

◆ fillMetaData()

◆ formatPdsTableName() [1/2]

◆ formatPdsTableName() [2/2]

◆ Pack()

Member Data Documentation

◆ m_isisTable

◆ m_numRows

◆ m_outputRecordBytes

◆ m_pdsByteOrder

◆ m_rowBytes