NAME

       rawtran - RAW to FITS converter

SYNOPSIS

       rawtran [options] file

DESCRIPTION

       Rawtran  is an utility to convert of raw photos in .CR2, .CRW, MRW, NEF, RAF, etc. formats to the general
       astronomical FITS image format [4].  The identification of raw photo type and decoding itself is done via
       DCRAW utility by D.Coffin [2]. Dcraw needs to be available independently.

       Rawtran produces following kinds of FITS files:

       Type: color (-t 0)
              The output image is the color FITS image (as specified  by  Munipack  [3]).  It  is  intended  for
              representation of color images.

       Type: instrumental (-t 1)
              The  type  provides  absolutely  raw  access  to  data  in FITS format.  According to astronomical
              terminology, the single bands are in instrumental photometric system.

       Type: single spectral band (-t . -c .)
              The type is intended for representation of the brightness in the selected color band.

              All produced data are RELATIVE quantities only.

       Rawtran internally uses 4-byte (float) data representation for all operations.

OPTIONS

       -t [0|1]
              Specify a type of conversion. 0 for the standard spectral band(s) (default).  1  for  Instrumental
              spectral band(s).

       -c [X|Y|Z|R|V|B|u|s] or [Ri,Gi,Gi1,Gi2,Bi]
              Select a color band. Wrong specification is silently ignored.

       -B [8|16|32|-32]
              Select  bits  per  pixel  of  an  output  image.  Possible values are: 8 (0-255), 16 (0-65535), 32
              (0-4294967296) and -32 (-10^38 .. 10^38), (values in braces indicates numerical range). An optimal
              bitpix for raw (instrumental) data is 16 (default) which covers a full range of  digital  cameras.
              The  representation occupies width*height*2 bytes. Some out of range (rare) values will suppressed
              (cut off). The representing by float numbers (eg. -32) is recommended value  for  images  intended
              for  further  processing because saves numerical precision and their numerical range (but occupies
              of twice more space with respect to 16). 8 bits reduces range (eg. suppress dynamical  range)  and
              32 wastes a lot of storage place only.

       -o filename
              Specify  an output file name. If the option is not used, the output is stored as rawtran.fits. Use
              dash '-' for redirection to the standard output. Precede the filename  with  exclamation  point(!)
              to overwrite existing file.

       -X options
              Specify  additional  options  to  dcraw  itself.  If  you  passed an option with parameter or more
              options, please, enclose ones to quotes or apostrophes.  In doubts, use -X "-v" to  show  detailed
              description of conversion by dcraw.

       --help Show summary of options.

       --version
              Display software version.

RETURN VALUE

       The  zero  indicates  successful  conversion.  A  non-zero  value is returned when an error occurs during
       conversion. If the utility is launched without options or with  -h  switch,  zero  means  that  rawtran's
       internal checker can run dcraw binary and non-zero value otherwise.

EXAMPLES

       Convert an image to be equivalent to humans eye brightness sensitivity at day:

       bash$ rawran IMG_0666.CR2 -o IMG_0666.fits

       Convert an image to be equivalent to Landolt's B filter:

       bash$ rawran -c B IMG_0666.CR2 -o IMG_0666.fits

       Produce a color FITS and show it in xmunipack:

       $ rawran IMG_0666.CR2 -o IMG_0666.fits

       $ xmunipack IMG_0666.fits

       Get green component of RAW:

       $ rawran -t 1 -c Gi IMG_0666.CR2 -o IMG_0666.fits

       Overwrite an output file:

       $ rawran IMG_0666.CR2 -o '!IMG_0666.fits'

       A large set of RAW images can be converted with help of shell:

       $ for A in *.CR2; do rawtran $A -o ${A%CR2}fits; done

AUTHOR

       Filip Hroch (hroch@physics.muni.cz)

SEE ALSO

       dcraw(1), fitspng(1)

       [1] Rawtran homepage: http://integral.physics.muni.cz/rawtran,

       [2] Dcraw homepage: http://cybercom.net/~dcoffin/dcraw/,

       [3] http://munipack.physics.muni.cz/

       [4] http://fits.gsfc.nasa.gov/

       [5] http://integral.physics.muni.cz/fitspng

Rawtran                                             Mar 2015                                          RAWTRAN(1)