fits2cub
NAME
fits2cub - 3 dimensional data converter from FITS to cub data
SYNOPSIS
fits2cub [ filename | -fit filename | -in_fits filename ]
[ -cub filename | -out_cub filename ]
[ -unit_km/s | -unit_m/s ]
DESCRIPTION
The command converts a FITS file in simple format.
Some format cannot read even if it is also FITS, such as
random group FITS and binary table FITS.
The effective dimension is limited less than 3.
The effective dimension means that the number of axes of the FITS
along which have more than 2 elements.
The FITS keywords is reflect the cub.head as many as possible.
The respected keywords are referred to
Japan FITS comittee web page, version 3.3.
A FITS file with header keywords different from this definition may
not be read correctly by this command.
If keywords about unit is missed in FITS,
the command assume the unit as following;
- position
- pixel
- velocity
- m/s
- If the option -unit_km/s is assigned, this is force to set km/s
to correct the FITS maker's misunderstanding.
- pixel value
- K
FILTER TYPE
fits2cub | .cub
OPTIONS
- filename | -fit filename | -in_fits filename
- Input FITS filename. The extension must be *.fit or *.fits.
- -cub filename | -out_cub filename
- Give a default cub name for output flow.
- -unit_km/s | -unit_m/s
- Force to read as km/s even if the unit of velocity axis in the
FITS header is blank or different.
DEFAULTS
- -prm fits2cub.prm
- -cub
- If you do not give a output filename, the command makes it
from an input FITS name (but extension is replaced by .cub).
- -unit_m/s
SEE ALSO
nsfits2scn, .cub, cubsave
BUGS
- Not simple FITS cannot be read even if it is FITS.
For exsample random group FITS, binary table FITS.
The FITS file must be a single multi-dimensional FITS
with a single part of keywords.
- The input FITS file is with extension name .fit or .fits.
If you have both, *.fit is read.
- The command cannot deal with the FITS,
if the file is out of FITS specification.
I have already found "FITS files" with illegal keywords, inconsistent
pair of keywords, and/or illegal endian images.
In such case the bugs are in the FITS exporting programs.
You should correct the FITS file by other tools or contact
the FITS origin.
HISTORY
- ver.3.02
- 2002/5/7 T.Handa
MANUAL VERSION
- 2002/5/7 T.Handa