imagetool

Section: User Manuals (1)
Updated: 22 JUN 2019
Return to Main Contents

     

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

AUTHOR

Attila Kovács <attila[AT]sigmyne.com>  

SEE ALSO

crush(1), show(1), coadd(1), difftool(1), histogram(1), detect(1)

     


This document was created with the help of man2html, using the manual pages.
Time: 23:56:58 GMT, January 03, 2020