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

ISIS 2

Documentation
Tutorials
Technical Documents
USGS

ISIS Application Documentation

ascii2isis

Standard View | TOC | Home

Import ascii file as a cube

Description
Categories
Groups
Examples
History

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

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

Files: FROM

Description

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

Type filename
File Mode input
Filter *.txt

Files: TO

Description

The file name of the output cube.

Type cube
File Mode output
Pixel Type real
Filter *.cub

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.

Ascii file dimensions: SAMPLES

Description

This defines the number of samples in the ascii.

Type integer

Ascii file dimensions: LINES

Description

This defines the number of lines in the raw image.

Type integer

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

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

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

Special Pixels: NULLMIN

Description

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

Type double
Inclusions
  • SETNULLRANGE

Special Pixels: NULLMAX

Description

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

Type double
Inclusions
  • SETNULLRANGE

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

Special Pixels: HRSMIN

Description

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

Type double
Inclusions
  • SETHRSRANGE

Special Pixels: HRSMAX

Description

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

Type double
Inclusions
  • SETHRSRANGE

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

Special Pixels: LRSMIN

Description

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

Type double
Inclusions
  • SETLRSRANGE

Special Pixels: LRSMAX

Description

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

Type double
Inclusions
  • SETLRSRANGE

Examples

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

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.

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.