Home

Quick Links

Software Manual
GitHub
API Reference

Documentation Versions

Public Release
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


ascii2isis

Printer Friendly View | TOC | Home

Import ascii file as a cube

Overview Parameters Example 1

Description

This program will read an ascii file and create a cube. The ascii values can be delimited by spaces, tabs, commas or any other character that is not a number, a period, a plus sign or a minus sign.

Categories


History

Tracie L Sucharski2006-08-05 Original version
Brendan George2006-09-28 Documentation fixes
Brendan George2007-01-11 Fixed problems with mixed separators. Added appTest.
Steven Koechle2008-08-30 Added ability to change special pixel ranges. Added example.
Makayla Shepherd2015-07-15 Fixed a problem with non-numeric characters in the file which resulted ascii2isis hanging. Fixes #2066.
Ian Humphrey2017-03-16 Added an error message when the reading fails if the file header isn't skipped. Fixes #4596.

Parameter Groups

Files

Name Description
FROMInput ascii file
TOOutput cube

Ascii file dimensions

Name Description
ORDERStorage order of data
SAMPLESNumber of samples in ascii
LINESNumber of lines in raw image
BANDSNumber of bands in raw image
SKIPNumber of bytes to skip before reading data

Special Pixels

Name Description
SETNULLRANGECreate special pixel values
NULLMIN Minimum valid value
NULLMAX Maximum valid value
SETHRSRANGECreate special pixel values
HRSMINMinimum valid value
HRSMAXMaximum valid value
SETLRSRANGECreate special pixel values
LRSMINMinimum valid value
LRSMAXMaximum valid value
X

Files: FROM


Description

The file name of the input ascii file to be converted to cube.

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

Files: TO


Description

The file name of the output cube.

Type cube
File Mode output
Pixel Type real
Filter *.cub
Close Window
X

Ascii file dimensions: ORDER


Description

Storage order of image data defines which dimension varies the fastest and the third varying the slowest (sample, line or band). BSQ = Band Sequential (sample, line, band) BIL = Band Interleaved by Line (sample, band, line) BIP = Band Interleaved by Pixel (band, sample, line)

Type string
Default BSQ
Option List:
Option Brief Description
BSQBand Sequential (sample, line, band) The data is stored with the sample dimension varying the fastest, followed by the line dimension, then the band dimension. All samples for the first line are followed by all samples for the second line and so on until the final line for band 1. This pattern is then repeated for each band.
BILBand Interleaved by Line (sample, band, line) The data is stored with the sample dimension varying the fastest, followed by the band dimension, then the line dimension. All samples for line 1 band 1 are followed by all samples for line 1 band 2 and so on until the final band. This pattern is then repeated for each line.
BIPBand Interleaved by Pixel (band, sample, line) The data is stored with the band dimension varying the fastest, followed by the sample dimension, then the line dimension. Sample 1 for all bands are followed by sample 2 for all bands and so on for all samples for line 1. This pattern is then repeated for each line.
Close Window
X

Ascii file dimensions: SAMPLES


Description

This defines the number of samples in the ascii.

Type integer
Close Window
X

Ascii file dimensions: LINES


Description

This defines the number of lines in the raw image.

Type integer
Close Window
X

Ascii file dimensions: BANDS


Description

This defines the number of bands in the raw image. If greater than 1, the image is assumed to be in band sequential order.

Type integer
Default 1
Close Window
X

Ascii file dimensions: SKIP


Description

This defines the number of bytes to skip before the actual image data is read. This would be for raw images with header data.

Type integer
Default 0
Close Window
X

Special Pixels: SETNULLRANGE


Description

If this option is used input raw pixels below minimum and above maximum will be converted to LRS and HRS respectively. Otherwise pixels in the input raw file will be left unchanged in most cases. For example, importing a raw 8-bit file and outputing to a 16-bit or 32-bit real will cause 0 and 255 to be actual values. If left as 8-bit then 0 will be NULL and 255 will be HRS.

Type boolean
Default NO
Inclusions
  • NULLMIN
  • NULLMAX
Close Window
X

Special Pixels: NULLMIN


Description

Minimum valid value. Anything below this value will be set to LRS.

Type double
Inclusions
  • SETNULLRANGE
Close Window
X

Special Pixels: NULLMAX


Description

Maximum valid value. Anything above this value will be set to HRS.

Type double
Inclusions
  • SETNULLRANGE
Close Window
X

Special Pixels: SETHRSRANGE


Description

If this option is used input raw pixels below minimum and above maximum will be converted to LRS and HRS respectively. Otherwise pixels in the input raw file will be left unchanged in most cases. For example, importing a raw 8-bit file and outputing to a 16-bit or 32-bit real will cause 0 and 255 to be actual values. If left as 8-bit then 0 will be NULL and 255 will be HRS.

Type boolean
Default NO
Inclusions
  • HRSMIN
  • HRSMAX
Close Window
X

Special Pixels: HRSMIN


Description

Minimum valid value. Anything below this value will be set to LRS.

Type double
Inclusions
  • SETHRSRANGE
Close Window
X

Special Pixels: HRSMAX


Description

Maximum valid value. Anything above this value will be set to HRS.

Type double
Inclusions
  • SETHRSRANGE
Close Window
X

Special Pixels: SETLRSRANGE


Description

If this option is used input raw pixels below minimum and above maximum will be converted to LRS and HRS respectively. Otherwise pixels in the input raw file will be left unchanged in most cases. For example, importing a raw 8-bit file and outputing to a 16-bit or 32-bit real will cause 0 and 255 to be actual values. If left as 8-bit then 0 will be NULL and 255 will be HRS.

Type boolean
Default NO
Inclusions
  • LRSMIN
  • LRSMAX
Close Window
X

Special Pixels: LRSMIN


Description

Minimum valid value. Anything below this value will be set to LRS.

Type double
Inclusions
  • SETLRSRANGE
Close Window
X

Special Pixels: LRSMAX


Description

Maximum valid value. Anything above this value will be set to HRS.

Type double
Inclusions
  • SETLRSRANGE
Close Window

Example 1

Converting an ascii file to an Isis Cube

Description

This example will show the conversion from a ascii file to a cube.

Command Line

ascii2isis FROM=input.txt TO=out.cub samples=10 lines=10 skip=35
Convert the image input.txt to the Isis Cube out.cub

GUI Screenshot

Convert ascii.txt to the Isis Cube out.cub

Convert the image input.txt to the Isis Cube out.cub

The is the GUI for ascii2isis when converting the ascii file input.txt to the Isis Cube out.cub

Data File

Links open in a new window.
Ascii input file. This is the ascii data

Output Image

Output Image

Output Isis Cube

The is the output Isis Cube peaks.cub generated from this example.