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

Public Release
8.1.0
8.0.0
7.2.0
7.1.0
7.0.0
6.0.0
3.9.0
3.5.0

ISIS 2

Documentation
Tutorials
Technical Documents
USGS

ISIS Application Documentation


isis2ascii

Standard View | TOC | Home

Export cube to an ascii file

Description
Categories
Groups
Examples
History
Things To Do


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:

Parameter Groups

Files

Name Description
FROMInput cube
TOOutput ascii file

Options

Name Description
HEADERPrint header
DELIMITEROutput Delimiter

Special Pixels

Name Description
SETPIXELVALUESUser defined output for special pixels
NULLVALUEValue to set to any null pixel
LRSVALUEValue to set to any LRS pixel
LISVALUEValue to set to any LIS pixel
HISVALUEValue to set to any HIS pixel
HRSVALUEValue to set to any HRS pixel

Files: FROM

Description

The file name of the input cube to be listed.

Type cube
File Mode input
Filter *.cub

Files: TO

Description

The file name of the ascii output file.

Type filename
File Mode output
Filter *.txt

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

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

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

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

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

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

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

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

Examples


Example 1

Header default

Description

Demonstrate the isis2ascii application with header

Command Line

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

GUI Screenshot

isis2ascii GUI

Example GUI

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

Input Image

Input image

Input image for isis2ascii

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

Parameter Name: TO

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


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.