ISIS Application Documentation
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:
History
Tracie L Sucharski 2002-06-28
Original version
Tracie Sucharski 2002-10-25
Fixed bug-was writing LRS for LIS values.
K Teal Thompson 2002-11-25
Add example
Tracie Sucharski 2003-01-28
Remove from Utility category.
K Teal Thompson 2003-02-03
Make images smaller.
K Teal Thompson 2003-03-19
Add /image and /thumb directory.
Tracie Sucharski 2003-04-03
Added-lien:Use IsisString class when outputing pixel values.
Stuart Sides 2003-04-04
Fixed problem with isiscvs not checking in the thumb and image directories.
Kim Sides 2003-05-13
Added application test
Stuart Sides 2003-05-16
Modified schema location from astogeology... to isis.astrogeology..."
Stuart Sides 2003-07-29
Modified filename parameters to be cube parameters where necessary
Jeff Anderson 2003-08-27
Changed default extension handling mechanism
Brendan George 2006-09-28
Documentation fixes
Steven Lambright 2008-05-12
Removed references to CubeInfo
Makayla Shepherd 2015-01-30
Increased precision of the DNs in the output text file from 6 to 7
Adam Paquette 2016-06-15
Added the ability for a user to specify the special pixel values
Adam Paquette 2020-06-08
Changed the formatting of the header to be easier to parse using
a space delimited CSV reader.
Adam Paquette 2020-06-09
Changed output formatting to use a delimiter that is placed after each
entry, rather than depending on a set width.
Parameter Groups
Files
Name
Description
FROM Input cube
TO Output ascii file
Options
Special Pixels
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 :
DELIMITER
Description
Sets the value to place between entries in the output file. This will
default to a space if nothing is entered.
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
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
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
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
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
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.
