This is the command mSubCube 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
mSubCube - Create a subimage of a cube
SYNOPSIS
mSubCube [-d] [-P minplane maxplane] [-a] [-h hdu] [-s statusfile] in.fits out.fits ra dec
xsize [ysize]
mSubCube -p [-d] [-P minplane maxplane] [-h hdu] [-s statusfile] in.fits out.fits
xstartpix ystartpix xpixsize [ypixsize]
DESCRIPTION
Creates a subimage (or "cutout") of a FITS file. Note that in "normal" mode,
all the parameters (location and size) are in degrees; in pixel (-p) mode, all of
them are in pixels.
OPTIONS
-d Turns on debugging.
-P The range to keep in the third dimension (usually wavelength-related)
-a All pixels - Force retrieval of whole image (useful to extract an entire HDU)
-h hdu Operate on the specified FITS header extension (HDU)
-s statusfile
Output and errors are sent to statusfile instead of to stdout
-p Pixel mode - create subimage using pixel locations, instead of a location on the
sky
ARGUMENTS
in.fits
Input FITS file.
out.fits
Path to output FITS file.
ra In normal mode, RA of center of output image.
dec In normal mode, declination of center of output image.
xstartpix
In pixel mode, pixel along the x-axis where the cutout image will begin
ystartpix
In pixel mode, pixel along the y-axis where the cutout image will begin
xsize In normal mode, width of output image in degrees.
ysize In normal mode, height of output image in degrees (default is equal to xsize.
xpixsize
In pixel mode, width of output image in pixels
ypixsize
In pixel mode, height of output image in pixels (default is equal to xpixsize
RESULT
[struct stat="OK", content="blank, flat or normal"]
The content keyword indicates whether all pixels where NaN (blank), all pixels were the
same value (flat), or the image appears to be normal.
MESSAGES
OK [struct stat="OK", content="blank, flat or normal"]
ERROR HDU value (hdu) must be a non-negative integer
ERROR Cannot open status file: statusfile
ERROR Center RA string (string) cannot be interpreted as a real number
ERROR Center Dec string (string) cannot be interpreted as a real number
ERROR X size string (string) cannot be interpreted as a real number
ERROR Y size string (string) cannot be interpreted as a real number
ERROR Invalid 'x' size
ERROR Invalid 'y' size
ERROR Image file filename missing or invalid FITS
ERROR Cannot find HDU hdu
ERROR Output wcsinit() failed.
ERROR Location is off image
ERROR Region outside image
ERROR No pixels match area.
ERROR Can't create output file: out.fits
ERROR FITS library error
EXAMPLES
$ mSubCube image1.fits subimage.fits 307.9 37.29 .01 .01
[struct stat="OK", content="normal"]
Use mSubCube online using onworks.net services
