imagetool - Image Manipulation Utility for CRUSH maps and more.
SYNOPSIS
imagetool
[options]
<filename>
DESCRIPTION
imagetool
provides a set of manipulation tools for the
FITS
images produced by
crush(1)
(and also by
BoA).
Image operations can be specified by the options (see below), which are parsed in order. After all operations are complete, the result is written in an output
FITS
file, which may overwite the input unless the
-name
or
-out
option specifies a different image.
OPTIONS
[Output Options]
-out=
Full output file name with path. Default overwrites input.
-name=
Output file name relative to input path.
-pick=
Writes a single image
(flux|s2n|rms|time)
then exits.
[Clipping/Cropping]
-crop
Automatically crop the image at its edges.
-crop=
Crop at offsets
dX1,dY1,dX2,dY2
(in arcsec).
-pxlCrop=
Crop at pixel indices (0-based)
imin,jmin,imax,jmax
-s2nClip=
Flag pixels below the specified significance level.
-minExp=
Flag pixels with smaller realtive exposures.
-maxNoise=
Flag pixels with higher relative noise levels.
-growFlags=
Specify a radius (in arcsec) by which flagged areas are increased.
[Smoothing/Filtering]
-convolve=
Convolve with the specified FWHM beam size (arcsec).
-smooth=
Smooth map to the specified FWHM beam size (arcsec).
-extFilter=
Filter extended structures above the specified FWHM (arcsec).
-deconvolve[=]
Deconvolve image. Optional argument is either:
BeamFWHM[:replacementFWHM]
<BeamFITSFile>[:replacementFWHM].
[Masking Options]
-mask=
Specify a region mask file (see
example.mask).
-masks=
Perform tasks with mask files. Defined tasks are:
forget
Delete existing masks.
add
Add as Gaussian sources.
remove
Remove as Gaussian sources.
pointadd
Add as point sources.
pointremove
Remove as point sources.
flag
Flag circular regions.
xflag
Flag outside circular regions.
stack
Stack sources from mask.
match:<rms>
Match sources to mask assuming an rms pointing error in arcsecs.
extract:<rms>
Find counterparts assuming an rms pointing error in arcsecs.
-flag=
Specify a FITS image for image flagging.
-profile
Obtain radial profiles around circular regions.
-azimuthal[=]
Obtain azimuthal profiles around circular regions. (Optional argument is the resolution in degrees.)
[FITS Header]
-source=
Change the source name.
-Jy=
Specify the voltage response for a 1 Jy point source.
-shift=
Shift map alignment by the comma separated offsets (arcsec).
-changeKey=
Change an entry in the FITS header (key:value)
-printHeader
Print the FITS image header.
[Miscellaneous]
-noise=
Select the source of the noise estimate.
(data,imageorguess).
-regrid=
Regrid image to the specified grid size (arcsec).
-correct=
Apply flux corrections to the specified FWHM source(s).
-scale=
Scale the map and noise with the specified factor.
-rmsScale=
Scale the map noise with the specified factor.
-offset=
Add a specified offset (in map units).
-origin=
Comma separated offsets or coordinates of the new origin.
-unit=
Specify the output map unit.
-random
Creates an unsmoothed random map based on the supplied map.
-replace=
plane:file
to replace an image
plane
(flux, weight, time or rms)
with the FITS image from
file.
-help
Provides this help screen.
FILES
~/.crush2/startup/imagetool/
Location of user-specific
java(1)
runtime configurations.
/usr/share/crush/example.mask
BUGS
If you find them, please report them to the author (see below).