FITS
FITS Data Cube
FITS Mutiple Extension
Data Cube
FITS Mosaic
FITS Mosaic Data Cube
FITS RGB
Split FITS
Data Array
External Format Support
External Analysis Support
Region Files
Color Lookup Table
WCS
Preference File
Startup File
TCL
Example:
$ds9 foo.fits # default load
$ds9 foo.fits[1] # load first extension, image or
bin table
$ds9 foo.fits[BCKGRD] # load extension named 'BCKGRD'
$ds9 foo.fits[bin=detx,dety] # load FITS bin table, bin on
detx,dety
$ds9 foo.fits[2][bin=rawx,rawy] # load FITS bin table, ext 2,
cols rawx,rawy
$ds9 foo.fits[bg_events,bin=rawx,rawy] # load FITS bin table
$ds9 foo.fits[bin=x,y,pha] # load FITS bin table,
bin on x,y,pi
$ds9 foo.fits[bin=pi] # load FITS bin table, bin on x,y,pi
$ds9 foo.fits[events][pha>5,pi<2] # load extension 'events'
and filter
The shell environment variable DS9_BINKEY may be used
to specify default bin cols for FITS bin tables. Example:
$export DS9_BINKEY='[bin=rawx,rawy]'
$ds9 foo.fits # load FITS bin table, bin on rawx,
rawy
The following algorithm is used to locate and to load the FITS image if no additional information is provide:
FITS keyword inheritance is supported. All valid FITS BITPIX
values are supported, along with -16, for UNSIGNED SHORT.
The following FITS keywords are supported:
FITS Data Cube
A FITS Data Cube is a FITS image which contains more than 2 axes (NAXES>2). DS9 will automatically detect if a data cube is present and will load all additional images. At the same time, DS9 will display the DataCube dialog box which allows the user to select which 2 image to be displayed.
Example:
$ds9 -medatacube foo.fits # load multiple extension fits file as data cube
DS9 supports three forms of mosaics:
IRAF |
contains the DETSEC and DETSIZE
keywords. See NOAO
IRAF Mosaic Data Structures |
WCS |
each FITS image or FITS bin table
must contain a vaild equatorial wcs. |
HST WFPC2 |
valid HST WFPC2 data cube,
consisting of 4 planes, along with a fits ascii table containing wcs
information. |
In General, DS9 by default will first try to load as
an IRAF mosaic. If the IRAF keywords are not present, DS9 will then try
to load as a WCS mosaic.. This behavior can be modified to force either
IRAF or WCS from the preference menu.
Example:
$ds9 -mosaicimageiraf foo.fits # load mosaic iraf
from one fits file with mulitple exts
$ds9 -mosaiciraf foo.fits bar.fits wow.fits # load mosaic
iraf from 3 files
$ds9 -mosaicimagewcs foo.fits # load mosaic wcs from one fits file with
mulitple exts
$ds9 -mosaicimagenext wcs foo.fits # load mosaic wcs from one fits file
with mulitple exts
$ds9 -mosaicwcs foo.fits bar.fits wow.fits # load mosaic wcs
from 3 files
$ds9 -mosaicimagewfpc2 bar.fits # load wfpc2 mosaic
$ds9 -mosaic foo.fits bar.fits wow.fits # load mosaic (iraf or wcs)
from 3 files
FITS Mosaic Data Cube
A FITS Mosaic Data Cube is a FITS mosaic image which contains more than 2 axes (NAXES>2). DS9 will automatically detect if a mosaic data cube is present and will load all additional images. At the same time, DS9 will display the DataCube dialog box which allows the user to select which 2 image to be displayed.
FITS RGB
A FITS RGB image may exist as three of FITS images, one FITS file with three extensions, or as a FITS 3D Data cube, with three slices, each representing the red, green, and blue channel. A FITS RGB image may be loaded all a one time, or by the channel. Once loaded, the multiple FITS images are treated as one FITS image.
Example:
$ds9 -rgbimage rgb.fits # load rgb image consisting of one fits file with 3 image exts
$ds9 -rgbcube cube.fits # load rgb image consisting of one fits data cube
$ds9 -rgb -red foo.fits -green bar.fits -blue wow.fits # rgb image from 3 fits images
Split FITS
A split fits is a valid fits file in which two files contain the header and data segments.
filename[options]
options are:
or alternate format:
filename[array(<type><dim><:skip><endian>)]
type:
The shell environment variable DS9_ARRAY may be used to
specify default array parameters. Example:
$export DS9_ARRAY='[dim=256,bitpix=-32]'
$ds9 -array foo.arr # load 256x256 float
At start-up, DS9 first searches for the ASCII file, named .ds9.fil,in the local directory, then in the users home directory.
The file command first is macro-expanded to fill in user-defined arguments and then is executed externally.
The ASCII file that defines the known image files consists of one
or more file descriptors, each of
which has the following format:
Note that blank lines separate the file descriptions and should not be used as part of a description.- Help description
- A space-separated list of templates
- A space-separated list of file types (not currently used)
- The command line for the loading this file type
The following macros are supported:
|
|
filename | insert current full file name |
For Example:
# File access descriptions:
# help explanation
# file template
# file type
# access command
IRAF IMH files
*.imh
IMH
i2f -s $filename
DS9 uses the file extension to determine the color table format:
|
|
.lut | XImtool, SAOtng |
.lasc | Skycat |
.sao | DS9, SAOimage |
any other | DS9 |