imagetool(1)

NAME
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).

-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.
    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.

  [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 or image).

-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
/usr/share/crush/example.mask

BUGS
If you find them, please report them to the author (see below).

AUTHOR
Attila Kovacs <attila[AT]submm.caltech.edu>

SEE ALSO
crush(1), coadd(1), show(1), difference(1), histogram(1), detect(1)