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

table2cube

Standard View | TOC | Home

Converts a table to a cube

Description
Categories
Groups
Examples
History

Description

This program converts a single field of a table into a cube. The table records will become lines in the output cube, and the table field data will become samples. So, a field with an array of size three and twenty records will produce a 3 sample by 20 line cube.

Categories

Parameter Groups

Files

Name Description
FROM Input file name
TO Output file name

Settings

Name Description
TABLENAME Table Name
FIELD Field Name
STARTREC Starting Record
NUMREC Number of records
STARTELEM Starting element in field
NUMELEM Number of elements in field

Files: FROM

Description

Specify the input file containing table data.

Type filename
File Mode input

Files: TO

Description

Specify the output file, which will be a cube populated with the data from the table.

Type cube
File Mode output
Pixel Type real
Filter *.cub

Settings: TABLENAME

Description

Specify the table name inside of the table input file (FROM).

Type string

Settings: FIELD

Description

Specify the field name inside of the cube to gather the data from. The size of the array inside of this field will be the same as the number of samples in the output cube (unless otherwise specified).

Type string

Settings: STARTREC

Description

Specify the starting record inside of the table. Use this if you want to skip initial data. One Based.

Type integer
Default 1

Settings: NUMREC

Description

Specify the number of records to convert, this starts with the first record specified by STARTREC. One Based.

Type integer
Internal Default All

Settings: STARTELEM

Description

Specify the starting element in the field. For example, if you have an array of size three but only want the last element this should be set to three. One Based.

Type integer
Default 1

Settings: NUMELEM

Description

Specify the number of elements in the field to convert into the output cube, this starts with the first record specified by STARTELEM. One Based.

Type integer
Internal Default All

Examples

Example 1

Converting a table to a cube using table2cube

Description

Converting a table to a cube using table2cube.

Command Line

table2cube from=out.tbl to=out.cub tablename=Example field=Data
In this example table2cube will convert the table "Example," field "Data" from out.tbl to out.cub

GUI Screenshot

table2cube GUI with defaults

Convert table to cube

In this example table2cube will convert the table "Example," field "Data" from out.tbl to out.cub .

Output Image

Table after being converted

Image after conversion

Parameter Name: TO

This is the table from out.tbl after being converted to an Isis cube. The file "out.tbl" was constructed by making a 500 by 500 table of the mathematical equation: element mod row (effectively x % y).

History

Steve Koechle and Steven Lambright2007-06-15 Original Version
Jeannie Backer2012-10-04 PROG: Changed references to TableField methods to lower camel case. Ordered includes. Added g_ prefix to global variables. References #1169.