Home

User Documentation

Getting Started
Learn More
Explore in Detail
Get Inspired

Contributor Documentation

Getting Started
Learn More
Explore in Detail
Get Inspired

Quick Links

Software Manual
AstroDiscuss
GitHub
API Reference

Documentation Versions


ISIS 2

Documentation
Tutorials
Technical Documents
USGS

ISIS Application Documentation


tabledump

Standard View | TOC | Home

Program to output a selected table to a file

Description
Categories
Groups
History


Description

This program takes a cube with one or more table blobs in it, and, through input provided by the user, outputs a selected table to an ASCII file, with formatting determined by user input.

Helper button has been provided in the GUI mode for the NAME parameter. The helper button will sequentially fill in the name of each table when pressed, clear the field to blank after the last table has been reached, and then wrap back to the beginning.


Categories


Parameter Groups

Files

Name Description
FROM Input Cube
TO Output file

Specifications

Name Description
NAME The name of the table
DELIMIT The character to be inserted between table entries
CUSTOMUser-defined delimiter

Files: FROM

Description

This is the cube containing the table to be output.

Type cube
File Mode input
Filter *.cub

Files: TO

Description

This is the output file where the table will be written.

Type filename
File Mode output
Internal Default No Output file will be created
Filter *.txt

Specifications: NAME

Description

This is the name of the table to be output. The name is found in the labels, in the relevant object, as the value of the Keyword "Name." This value is set by the program creating the table, and is standardized to certain conventions.

Type string

Specifications: DELIMIT

Description

This option will determine which character will be used to separate table entries, with the default option as a comma. The other options are space, to separate with a single space, or "OTHER," which allows the user to input whatever they wish as the delimiter character.

Type string
Default COMMA
Option List:
Option Brief Description
COMMASeparate with commas This option will cause the table entries to be separated by commas.

Exclusions

  • CUSTOM
SPACESeparate with spaces This option will cause the table entries to be separated by single space when output.

Exclusions

  • CUSTOM
OTHERSeparate with user-defined characters This option allows the user to determine what character is used to separate entries. When this option is selected, the CUSTOM parameter is used to determine what will be used. Whatever string the user enters will be used in between the entries.

Inclusions

  • CUSTOM

Specifications: CUSTOM

Description

This parameter is only used if the user has selected "OTHER" as a delimiter. The user then enters something into this parameter to use as a delimiter.

Type string

History

Brendan George2006-10-26 Original version
Brendan George2006-12-18 Fixed helper button
Steven Lambright2007-07-27 Changed category from Utility to Import and Export
Steven Koechle2008-05-20 Changed TO parameter to function like other applications in ISIS. It now defaults to console output when no TO file is enterd.
Christopher Austin2008-06-19 Fixed string representation and display.
Travis Addair2009-03-03 Changed helper button to only place one table name into the NAME parameter each time it is pressed
Kris Becker2010-12-10 Added a newline to the last line of the output TO file.
Jeannie Backer2012-10-04 Changed references to TableField methods to lower camel case. Ordered includes. Added g_ prefix to global variables. Added padding to control statements. References #1169.
Steven Lambright2012-12-10 Text field outputs are no longer padded with NULL (ASCII 0) characters; these characters were not intended to be part of the output. This was fixed because preserving this behavior would have been much more difficult than fixing it. References #1312.