rawtran - RAW to FITS converter
rawtran [options] file(s)
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.
- -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.
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.
Filip Hroch <hroch@physics.muni.cz>
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