ISIS Application Documentation
ascii2isis | Standard View | TOC | Home |
Import ascii file as a cube
Description
Categories
Groups
Examples
History
Name | Description |
---|---|
FROM | Input ascii file |
TO | Output cube |
Name | Description |
---|---|
ORDER | Storage order of data |
SAMPLES | Number of samples in ascii |
LINES | Number of lines in raw image |
BANDS | Number of bands in raw image |
SKIP | Number of bytes to skip before reading data |
Name | Description |
---|---|
SETNULLRANGE | Create special pixel values |
NULLMIN | Minimum valid value |
NULLMAX | Maximum valid value |
SETHRSRANGE | Create special pixel values |
HRSMIN | Minimum valid value |
HRSMAX | Maximum valid value |
SETLRSRANGE | Create special pixel values |
LRSMIN | Minimum valid value |
LRSMAX | Maximum valid value |
The file name of the input ascii file to be converted to cube.
Type | filename |
---|---|
File Mode | input |
Filter | *.txt |
The file name of the output cube.
Type | cube |
---|---|
File Mode | output |
Pixel Type | real |
Filter | *.cub |
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: |
|
This defines the number of samples in the ascii.
Type | integer |
---|
This defines the number of lines in the raw image.
Type | integer |
---|
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 |
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 |
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 |
|
Minimum valid value. Anything below this value will be set to LRS.
Type | double |
---|---|
Inclusions |
|
Maximum valid value. Anything above this value will be set to HRS.
Type | double |
---|---|
Inclusions |
|
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 |
|
Minimum valid value. Anything below this value will be set to LRS.
Type | double |
---|---|
Inclusions |
|
Maximum valid value. Anything above this value will be set to HRS.
Type | double |
---|---|
Inclusions |
|
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 |
|
Minimum valid value. Anything below this value will be set to LRS.
Type | double |
---|---|
Inclusions |
|
Maximum valid value. Anything above this value will be set to HRS.
Type | double |
---|---|
Inclusions |
|
Converting an ascii file to an Isis Cube
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 |
Ascii input file. | This is the ascii data |
---|
Output Image
|
Output Isis Cube The is the output Isis Cube peaks.cub generated from this example. |
Tracie L Sucharski | 2006-08-05 | Original version |
Brendan George | 2006-09-28 | Documentation fixes |
Brendan George | 2007-01-11 | Fixed problems with mixed separators. Added appTest. |
Steven Koechle | 2008-08-30 | Added ability to change special pixel ranges. Added example. |
Makayla Shepherd | 2015-07-15 | Fixed a problem with non-numeric characters in the file which resulted ascii2isis hanging. Fixes #2066. |
Ian Humphrey | 2017-03-16 | Added an error message when the reading fails if the file header isn't skipped. Fixes #4596. |