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

fits2isis

Printer Friendly View | TOC | Home

Import fits files into Isis format

Overview Parameters Example 1

Description

This program will import fits (Flexible Image Transport System) image files into ISIS format. FITS files with extensions are supported upto and including the first non-image extension. Images follwing the first non-image extension can not be accessed (i.e., NAXIS = 0 , implying extensions with data, are not supported). Some common header data is transfered to the ISIS labels. Primary image data is transfered completely.

Categories

Related Objects and Documents

Applications

History

Mackenzie Boyd2009-10-27 Original version.
Stuart Sides2014-08-29 Added the ability to read image extensions.
Kristin Berry2015-06-02 Added the ability to set the organization of the input file to BIL, BSQ, or BIP. Added tests for these new options.
Jeannie Backer and Kaj Williams2017-07-07 Modified to reflect ProcessImportFits method name change from fitsLabel to fitsImageLabel.

Parameter Groups

Files

Name Description
FROM A fits file to be converted to an isis cube
TO Output file converted to cube format

Controls

Name Description
IMAGENUMBER A fits file to be converted to an ISIS cube

Options

Name Description
ORGANIZATIONImage Organization
X

Files: FROM

Description

Use this parameter to select the filename of a fits file to be converted to a cube. Currently extensions and files with no initial data, NAXIS = 0, are not supported.

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

Files: TO

Description

The cube output file, containing image data and applicable headers.

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

Controls: IMAGENUMBER

Description

Use this parameter to select which image to extract from the FITS file. The primary image is 0, the first image extension is 1, the second image extension is 2, and so on. NOTE: Image extensions following any non-image extension can not be accessed.

Type integer
Default 0
Close Window
X

Options: ORGANIZATION

Description

The organization of lines, samples, and bands in the file.

Type string
Default BSQ
Option List:
Option Brief Description
BSQBand Sequential The first line of data is followed immediately by the next line in the same spectral band.
BILBand Interleaved By Line The first line of data is followed immediately by the first line of data in the next band.
BIPBand Interleaved By Pixel The first pixel for all bands is followed by the second pixel for all bands.
Close Window

Example 1

Usage of this import application

Description

This example shows how to import a fits file to the isis cube format.

Command Line

fits2isis from=fitsFile.fits to=imported.cub
The command line arguments to import a file to cube format.

GUI Screenshot

The application's gui

The gui for the application, with parameters set to import a fits file to a cube.