Official websites use .gov
A .gov website belongs to an official government organization in the United States.

Secure .gov websites use HTTPS
A lock ( ) or https:// means you’ve safely connected to the .gov website. Share sensitive information only on official, secure websites.

ISIS Documentation

table2cube

Converts a table to a cube

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

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.

Parameters

Files

Specify the input file containing table data.
Type filename
File Mode input

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

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

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

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

Specify the number of records to convert, this starts with the first record specified by STARTREC. One Based.
Type integer
Internal Default All

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

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

Example 1

Converting a table to a cube using table2cube

Converting a table to a cube using table2cube.

Command Line

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

GUI Screenshot

table2cube GUI with defaults

Convert table to cube

table2cube GUI with defaults

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

Table after being converted

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).