IRAF help page for package proto, program binfil

from NOAO binfil -- create a 16 bit binary raster file from an IRAF image USAGEPARAMETERSDESCRIPTIONEXAMPLESTIME REQUIREMENTSBUGSSEE ALSO

binfil -- create a 16 bit binary raster file from an IRAF image


USAGE

binfil input


PARAMETERS

input

The list of input images to be converted.

scale_fact = 1.0

A multiplicative scale factor to be applied to each pixel during the conversion process. This parameter provides the means to minimize loss of precision when converting from the dynamic range of the iraf image pixels to the dynamic range of the output 16-bit signed integer, -32768 to 32767.

header = no

Prepend a short descriptive header to the output binary raster file?

DESCRIPTION

BINFIL generates a simple signed 16-bit binary raster file from IRAF images. BINFIL can be useful when programs other than IRAF applications are to be used to examine the data. The format of the resulting file is a simple string of pixels, with the exception that the first 90 bytes or 45 words may optionally form a minimal header.

The header elements are stored as follows:

.nj

	word 1    : nrows
	word 2    : ncols
	word 3    : IRAF pixel type flag 
	word 4-13 : reserved space
	word 14-45: image title (ASCII 64 bytes)
.ju

Pixels from the input images are converted to short integers after scaling by the scale_fact parameter. The resultant pixel values are limited to the maximum range of a short integer and then written to the binary file.

The output binary file assumes the name of the input image with an appended ".b" to indicate binary.


EXAMPLES

Convert the iraf image irafimage to the binary file irafimage.b.

.nj

cl> binfil irafimage scale=0.01
.ju


TIME REQUIREMENTS


BUGS

Only the first 64 characters of the image title are placed in the binary file header.

There is no way to specify the output binary file names.


SEE ALSO

irafil,


This page automatically generated from the iraf .hlp file. If you would like your local iraf package .hlp files converted into HTML please contact Dave Mills at NOAO.

dmills@noao.edu