Scroll to navigation

IMAGECROP(1) User Commands IMAGECROP(1)

NAME

ImageCrop - crop regions of an image

SYNOPSIS

astimgcrop [OPTION...] [ASCIIcatalog] ASTRdata ...

DESCRIPTION

ImageCrop is part of GNU Astronomy Utilities 0.2.33-8a3b. ImageCrop will create cutouts, thumbnails, postage stamps or crops of region(s) from input image(s) using image or celestial coordinates. If muliple crops are desired, a catalog must be provided. When in WCS mode, if the cut out covers more than one input image, all overlapping input images will be stitched in the output.

For more information, please run any of the following commands. They will respectively show you the `Invoking ImageCrop' subsection, the complete `ImageCrop' section, or the full GNU Astronomy Utilities manual. In particular the first contains a very complete explanation of each option.

info astimgcrop
info ImageCrop
info gnuastro

If you couldn't find your answer in the manual, you can get direct help from experienced Gnuastro users and developers. For more information, please run:

info help-gnuastro

ImageCrop options:

Input:
--hendwcs=INT
Header keyword number to stop reading WCS.
--hstartwcs=INT
Header keyword number to start reading WCS.
-h, --hdu=STR
Extension name or number of input data.
Output:
-b, --noblank
Remove parts of the crop box out of input image.
-c, --checkcenter=INT
Side of box (in pixels) to check.
-D, --dontdelete
Don't delete output if it exists.
-k, --keepblankcenter
Keep crop if the central parts are not filled.
-K, --keepinputdir
Do not remove input's dir info for output.
-o, --output=STR
Output file or directory name.
-p, --suffix=STR
Suffix (postfix) of cropped images.
Crop:
-a, --iwidth=INT
Image mode width (in pixels).
-d, --dec=FLT
Declination of one crop box center.
-f, --racol=INT
Column of Right Ascension (RA) in catalog.
-g, --deccol=INT
Column of Declination (Dec) in catalog.
-i, --xcol=INT
Column of X (first FITS axis) value in catalog.
-j, --ycol=INT
Column of Y (second FITS axis) in catalog.
-l, --polygon=STR
Polygon vertices of region to crop.
--outpolygon
Keep the polygon's outside, mask the inside.
-r, --ra=FLT
Right ascension of one crop box center.
-s, --section=STR
Image section string specifying crop range.
-w, --wwidth=FLT
WCS mode width (in arc seconds).
-x, --xc=FLT
First axis position for only one crop.
-y, --yc=FLT
Second axis position for only one crop.
-z, --zeroisnotblank
0.0 in float or double images are not blank.
Operating modes:
-?, --help
give this help list
--cite
BibTeX citation for ImageCrop.
-I, --imgmode
Use image coordinates (x and y).
--nolog
No log file for programs which make one.
-N, --numthreads=INT
Number of CPU threads to use.
--onlydirconf
Only read current directory configuration file.
--onlyversion=STR
Only run if the program version is this.
-P, --printparams
Print parameter values to be used and abort.
-q, --quiet
Only report errors, remain quiet about steps.
-S, --setdirconf
Set default values for this directory and abort.
--usage
give a short usage message
-U, --setusrconf
Set default values for this user and abort.
-V, --version
print program version
-W, --wcsmode
Use WCS coordinates (Ra and Dec).

Mandatory or optional arguments to long options are also mandatory or optional for any corresponding short options.

GNU Astronomy Utilities home page: http://www.gnu.org/software/gnuastro/

AUTHOR

Written by Mohammad Akhlaghi

REPORTING BUGS

Report bugs to bug-gnuastro@gnu.org.

COPYRIGHT

Copyright © 2015-2016, Free Software Foundation, Inc. License GPLv3+: GNU General public license version 3 or later.
This is free software: you are free to change and redistribute it. There is NO WARRANTY, to the extent permitted by law.

SEE ALSO

The full documentation for ImageCrop is maintained as a Texinfo manual. If the info and ImageCrop programs are properly installed at your site, the command
info ImageCrop

should give you access to the complete manual.

October 2016 GNU Astronomy Utilities 0.2.33-8a3b