mRotate(1) · carta

Usage

mRotate [-d level] [-s statusfile] [-r rotang] in.fits out.fits [ra dec xsize [ysize]]

Overview

Rotates a FITS image by an arbitrary angle. This module is meant for quick-look only; it is not flux conserving.

Options

-d level: Print out additional debugging information (level can be 1-3)

-s statusfile: Output and errors are written to statusfile instead of stdout.

-r rotang: Provide an angle (in degrees) to rotate the image.

Arguments

in.fits: Input FITS image.

out.fits: Path to output (rotated) FITS image.

ra dec xsize: Center location and width (in degrees) of output image - optional. By default, entire input image area will be included in output image.

ysize: Height (in degrees) of output image, if a new center location and width are provided. Optional - defaults to xsize.

Result

[struct stat="OK"]

Output file will contain the same image as the input file, but rotated by rotang degrees. If a new center location and width were provided, the output image will be the "subimage" covering that area.

Messages

OK: [struct stat="OK"]

ERROR: No status file name given

ERROR: Cannot open status file: statusfile

ERROR: No rotation angle given

ERROR: Rotation angle string is invalid: 'rotang'

ERROR: No debug level given

ERROR: Debug level string is invalid: 'level'

ERROR: Debug level value cannot be negative

ERROR: Invalid input file 'in.fits'

ERROR: Invalid output file 'out.fits'

ERROR: Center RA string (ra) cannot be interpreted as a real number

ERROR: Center Dec string (dec) cannot be interpreted as a real number

ERROR: X size string (xsize) cannot be interpreted as a real number

ERROR: Y size string (ysize) cannot be interpreted as a real number

ERROR: Invalid 'x' size

ERROR: Invalid 'y' size

ERROR: Location is off image

ERROR: No pixels match output area

ERROR: No pixels match input area

ERROR: wcsinit() failed

ERROR: Image file in.fits missing or invalid FITS

ERROR: FITS library error

Examples

$ mRotate -r 90 in.fits out.fits: [struct stat="OK"]

History

Debian 13 (Trixie) to Debian 10 (Buster): the text shown here
Debian 9 (Stretch)