NAME

       rawtran - RAW to FITS converter

SYNOPSIS

       rawtran [options] file(s)

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 should be available
       independently.

       This manual page summarises usage only. Visit homepage [1] for additional description.

OPTIONS

       -c [X|Y|Z|R|V|B|clear|scotopic], [Ri,Gi,Gi1,Gi2,Bi] or [plain,all]
              Select a colour band.

       -o filename
              Specify an output file name. If this option is not used,  the  output  filename  is
              determined  from  the  input: any suffix like *.CR2 is replaced by *.fits.  Precede
              the filename with exclamation point(!) to overwrite an existing file.

       --no-clobber
              do not overwrite an existing file

       -eV    Values are stored as an energy-like rather than photon-like quantity.

       -D RAW dark filename
              Use the raw photo as a dark frame. Rawtran will try to  convert  the  file  to  PGM
              format  by the dcraw recommended command `dcraw -D -4 -j -t 0 file.RAW' and pass it
              as `dcraw -K file.pgm'.   Note  that  sometimes  can  be  necessary  to  switch-off
              automatic frame rotation by using -A "-t 0" option.

       -E FITS dark filename
              Use  the  FITS  file as a dark frame. The FITS file must be previously converted as
              `dcraw -D -4 -j -t 0 dark.RAW'.

       -C options
              Conversions options for dcraw. Default is '-4 -o 5' for standard photometry filters
              and '-4 -D' for instrumental bands. Defaults are usually satisfactory

       -X options
              Specify  options  to conversion by dcraw itself. One represents default parameters:
              '-q 3 -w'. See also -A.

       -A 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.

       -h, --help
              Show summary of options.

       --version
              Display software version.

EXIT STATUS

       0 indicates successful run. A non-zero value is returned when  an  error  occurred  during
       conversion:  1  means  and general error, 2 any RAW file(s) conversion has failed.  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

       Produce a colour FITS and show it in xmunipack:

       $ rawtran -o IMG_0666.fits IMG_0666.CR2
       $ xmunipack IMG_0666.fits

       A large set of RAW images can be converted as:

       $ rawtran *.CR2

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

       $ rawtran -c Y -o IMG_0666_Y.fits IMG_0666.CR2

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

       $ rawtran -c B -o IMG_0666_B.fits IMG_0666.CR2

       Get green component of RAW:

       $ rawtran -c Gi -o IMG_0666_Gi.fits IMG_0666.CR2

       Subtract dark frame:

       $ rawtran -D IMG_DARK.CR2 IMG_0666.CR2

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