---
name: "rawtran"
section: "1"
platform: "linux"
package: "rawtran"
version: "1.1-1+b5"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/rawtran"
---

# rawtran(1)

RAW to FITS converter

## 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)](/dcraw/1.md), [fitspng(1)](/fitspng/1.md)

\[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