STScI Logo

mperfits xray.xdataio


NAME · USAGE · PARAMETERS · DESCRIPTION · EXAMPLES · BUGS

NAME

mperfits -- convert MIDAS FITS image data files to IRAF image files

USAGE

mperfits fits_file file_list iraf_file

PARAMETERS

fits_file
The FITS data source. This is either a template describing a list of disk files or a tape file specification of the form mt*[n], where mt indicates a mag tape device, * represents a density, and [n] is the tape file number. If the tape file number n is specified then only that file is converted. If the general tape device name is given, i.e. mta, mtb800, etc, then the files specified by the file_list parameter will be read from the tape.
file_list
The files to be read from a tape are specified by the file_list string. The string can consist of any sequence of file numbers separated by at least one of comma, or dash. A dash specifies a range of files. For example the string

"1,2,3-5,8-6"

will convert the files 1 through 8.

iraf_file
The IRAF file which will receive the FITS data if the make_image parameter switch is set. Iraf_file can be a template of output image names or a root output image name. In the former case one output image name must be specified for every input file. In the latter case iraf_file is a root output image name to which the input file sequence number or tape file number is appended if the number of input files > 1. For example reading files 1 and 3 from a FITS tape with a value of iraf_file of "data" will produce the files data0001 and data0003, whereas reading the same two files with a value of iraf_file of "data1,data2" will produce the files data1 and data2.
make_image = yes
This switch determines whether FITS image data is converted to an IRAF image file. This switch is set to no to obtain just header information with the long_header or short_header switches.
long_header = no
If this switch is set the full FITS header is printed on the standard output.
short_header = yes
If this switch is set only the output filename, the title string, and the image dimensions are printed.
datatype
The IRAF image file may be of a different data type than the FITS image data. The data type may be specified as s for short, i for integer, l for long, r for real, and d for double. The user must beware of truncation problems if an inappropriate data type is specified. If an incorrect data_type or a null string is given for this parameter then a default data type is used which is the appropriate minimum size for the input pixel values. If the bscale and bzero parameters in the FITS header are undefined or equal to 1.0 and 0.0 respectively, rfits selects datatype s or l depending on bitpix. If bscale and bzero are set to other than 1.0 and 0.0, rfits selects datatype r.
blank = 0.
The IRAF image value of a blank pixel.
scale = yes
If scale equals no the integers are read directly off the tape. Otherwise RFITS checks the values of bscale and bzero. If these numbers are not 1. and 0. respectively, RFITS scales the data before output.
oldirafname = no
If the oldirafname switch is set RFITS will attempt to restore the image to disk with the filename defined by the IRAFNAME parameter in the FITS header.
offset = 0
Offset is an integer parameter specifying the offset to the current tape file number. For example if offset = 100, iraf_file = "fits" and file_list = "1-3" then the output file names will be "fits0101", "fits0102" and "fits0103" respectively rather than "fits0001", "fits0002" and "fits0003".

DESCRIPTION

FITS data is read from the specified source; either disk or magnetic tape. The FITS header may optionally be printed on the standard output as either a full listing or a short description. The FITS long blocks option is supported. At present non-standard FITS files (SIMPLE = F) and files containing group data are skipped and a warning message is issued. A warning message will be issued if the default user area allocated in memory is too small to hold all the FITS parameter cards being read in by RFITS. Since the default user area is 8000 characters and a single card image is 81 characters long, the normal user area will hold 98 complete card images. RFITS will not permit partial cards to be written. The user can overide the default user area length by setting the environment variable min_lenuserarea (see example below).

EXAMPLES

Convert a set of FITS files on tape to a set of IRAF image files, allowing rfits to select the output datatype. Blanks are set to zero.

	cl> mperfits mtb1600 1-999 images

Convert a list of FITS files on disk to a set of IRAF images. In the first case the files specified by fits* are written to the images images0001, images0002, etc. In the second case the fits disk files listed one per line in the text file fitslist are written to the output images listed one per line in the file imlist.

	cl> mperfits fits* * images

	cl. mperfits @fitslist * @imlist

List the contents of a FITS tape on the standard output without creating any image files.

	cl> mperfits mtb1600 1-999 images ma-

Convert FITS files directly to IRAF images without scaling.

	cl> mperfits mtb1600 1-999 images scal-

Convert the first three FITS files on tape to IRAF files setting blanks to -1.

	cl> mperfits mta 1-3 images blan=-1

Read in a FITS file with a header roughly twice the usual IRAF length of 8000 characters.

	cl> set min_lenuserarea = 16300
	cl> mperfits mta 1 images

Read a FITS tape with 5 normal fits records (2880 bytes) to a tape record. Notice that no extra parameters are needed.

	cl> mperfits mta 1-3 fits

BUGS

At present MPERFITS cannot read images with excessively long lines due to memory allocation restrictions in image i/o. Blank pixels are counted, set to a user determined vlaue but not flagged in the image header.


Search Form · STSDAS