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

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.
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:09
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