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

isis2ascii

Export cube to an ascii file

This program converts sn ISIS cube to ASCII file format. Special pixels such as NULL, LIS, LRS, HIS and HRS have predetermined pixel values. You may opt to assign a range of pixel values to the individual Special Pixels using the SETPIXELVALUES parameter. Bands in the cube will be output in band sequential format.

Beware: The output file will be roughly 3 times as big as the input.

Categories

Related Applications to Previous Versions of ISIS

This program replaces the following applications existing in previous versions of ISIS:
  • list
  • cube2ascii

History

Tracie L Sucharski2002-06-28 Original version
Tracie Sucharski2002-10-25 Fixed bug-was writing LRS for LIS values.
K Teal Thompson2002-11-25 Add example
Tracie Sucharski2003-01-28 Remove from Utility category.
K Teal Thompson2003-02-03 Make images smaller.
K Teal Thompson2003-03-19 Add /image and /thumb directory.
Tracie Sucharski2003-04-03 Added-lien:Use IsisString class when outputing pixel values.
Stuart Sides2003-04-04 Fixed problem with isiscvs not checking in the thumb and image directories.
Kim Sides2003-05-13 Added application test
Stuart Sides2003-05-16 Modified schema location from astogeology... to isis.astrogeology..."
Stuart Sides2003-07-29 Modified filename parameters to be cube parameters where necessary
Jeff Anderson2003-08-27 Changed default extension handling mechanism
Brendan George2006-09-28 Documentation fixes
Steven Lambright2008-05-12 Removed references to CubeInfo
Makayla Shepherd2015-01-30 Increased precision of the DNs in the output text file from 6 to 7
Adam Paquette2016-06-15 Added the ability for a user to specify the special pixel values
Adam Paquette2020-06-08 Changed the formatting of the header to be easier to parse using a space delimited CSV reader.
Adam Paquette2020-06-09 Changed output formatting to use a delimiter that is placed after each entry, rather than depending on a set width.

Parameters

Files

The file name of the input cube to be listed.
Type cube
File Mode input
Filter *.cub

The file name of the ascii output file.
Type filename
File Mode output
Filter *.txt

Options

If set to yes, a brief header will be printed to the ascii file which will include the cube name and dimensions.
Type boolean
Default YES

Sets the value to place between entries in the output file. This will default to a space if nothing is entered.
Type string
Default

Special Pixels

Determine whether the user would like a specific output for the special pixels in the image.
Type boolean
Default NO
Inclusions
  • NULLVALUE
  • LRSVALUE
  • LISVALUE
  • HISVALUE
  • HRSVALUE

Value that will replace any null pixel within a cub with the number entered. Defaults to NULL if nothing is entered.
Type string
Default NULL
Inclusions
  • SETPIXELVALUES

Value that will replace any LRS pixel within a cub with the number entered. Defaults to LRS if nothing is entered.
Type string
Default LRS
Inclusions
  • SETPIXELVALUES

Value that will replace any LIS pixel within a cub with the number entered. Defaults to LIS if nothing is entered.
Type string
Default LIS
Inclusions
  • SETPIXELVALUES

Value that will replace any HIS pixel within a cub with the number entered. Defaults to HIS if nothing is entered.
Type string
Default HIS
Inclusions
  • SETPIXELVALUES

Value that will replace any HRS pixel within a cub with the number entered. Defaults to HRS if nothing is entered.
Type string
Default HRS
Inclusions
  • SETPIXELVALUES

Example 1

Header default

Demonstrate the isis2ascii application with header

Command Line

Convert Viking ISIS image to ascii file. Let header default to yes.
isis2ascii f=../IN/f332s28.cub t=OUT/isis2ascii.txt

GUI Screenshot

isis2ascii GUI

Example GUI

isis2ascii GUI

Screenshot of GUI with parameters filled in to perform the isis2ascii application

Input Image

Input image

Input image for isis2ascii

Input image

Parameter Name: FROM

This is the input image f332s28.cub to be converted to ascii.

Output Image

Output image showing results of the isis2ascii application.

Example output ascii text from isis2ascii run

Output image showing results of the isis2ascii application.

Parameter Name: TO

This is the output ascii text file isis2ascii.txt with the header.