Home

Quick Links

Software Manual
GitHub
API Reference

Documentation Versions

Latest Release
Dev
8.3.0
8.2.0
8.1.0
8.0.0
7.2.0
7.1.0
7.0.0
6.0.0
3.9.0
3.5.0
USGS

ISIS Application Documentation

isis2ascii

Printer Friendly View | TOC | Home

Export cube to an ascii file

Overview Parameters Example 1

Description

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.
U.S. Department of the Interior | U.S. Geological Survey
ISIS | Privacy & Disclaimers | Astrogeology Research Program
To contact us, please post comments and questions on the USGS Astrogeology Discussion Board
To report a bug, or suggest a feature go to: ISIS Github
File Modified: 02/21/2025 19:28:11
X

Files: FROM

Description

The file name of the input cube to be listed.

Type cube
File Mode input
Filter *.cub
Close Window
X

Files: TO

Description

The file name of the ascii output file.

Type filename
File Mode output
Filter *.txt
Close Window
X

Options: HEADER

Description

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
Close Window
X

Options: DELIMITER

Description

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

Type string
Default
Close Window
X

Special Pixels: SETPIXELVALUES

Description

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
Close Window
X

Special Pixels: NULLVALUE

Description

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
Close Window
X

Special Pixels: LRSVALUE

Description

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
Close Window
X

Special Pixels: LISVALUE

Description

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
Close Window
X

Special Pixels: HISVALUE

Description

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
Close Window
X

Special Pixels: HRSVALUE

Description

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
Close Window