mRotate - Online in the Cloud

This is the command mRotate that can be run in the OnWorks free hosting provider using one of our multiple free online workstations such as Ubuntu Online, Fedora Online, Windows online emulator or MAC OS online emulator

PROGRAM:

NAME


mRotate - Rotate a FITS image by an arbitrary angle

SYNOPSIS


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

DESCRIPTION


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"]

Use mRotate online using onworks.net services



Latest Linux & Windows online programs