mSubimage1
Create a "cutout" of a fits image
Usage
mSubimage [-d]
[-a]
[-h
hdu]
[-s
statusfile]
in.fits
out.fits
ra
dec
xsize
[ysize]
mSubimage -p
[-d]
[-h
hdu]
[-s
statusfile]
in.fits
out.fits
xstartpix
ystartpix
xpixsize
[ypixsize]
Overview
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.
-
-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
- $ mSubimage image1.fits subimage.fits 307.9 37.29 .01 .01
-
[struct stat="OK", content="normal"]
Releases
5 releases since Debian 9 (Stretch); the text changed 1 time.