GNU Astronomy Utilities

6.1.4.2 ImageCrop output

When a catalog is given, the value of --output (see Common options) will be seen as the directory to store the output cropped images. In such cases, the outputs will consist of two parts: a variable part (the row number of each target starting from 1) along with a fixed string which you can set with the --suffix option. Note that in catalog mode, only one image can be input.

When the crop box is specified on the command-line, the value to --output will be used as a file name. If no output is specified or if it is a directory, the output file name will follow the automatic output names of Gnuastro, see Automatic output for the input image.

The header of each output cropped image will contain the names of the input image(s) it was cut from. If a name is longer than the 70 character space that the FITS standard allows for header keyword values, the name will be cut into several keywords from the nearest slash (/). The keywords have the following format: ICFn_m. Where n is the number of the image used in this crop and m is the part of the name. Following the name is another keyword named ICFnPIX which shows the pixel range from that input image in the same syntax as Crop section syntax.

Once done, a log file will be created in the current directory named astimgcrop.log. For each input row, this file will have three columns:

1. The cropped image file name for that row.
2. The number of input images that were used to create that image.
3. A 0 if the central few pixels (value to the --checkcenter option) are blank and 1 otherwise.

There are also comments on the top explaining basic information about the run. If the log file cannot be created (for example you don’t have write permission in the directory you are running ImageCrop in) or you have specifically asked for no log file (with the --nolog option), then a log file will not be created (unless --individual is called). The same columns will be printed in verbose mode on the command-line for each row.

Read in other formats.

GNU Astronomy Utilities 0.2.28-34fb manual, October 2016.