Scroll to navigation



MakeCatalog - Make a catalog from labeled input images


astmkcatalog [OPTION...] ASTRdata


MakeCatalog is part of GNU Astronomy Utilities 0.8. MakeCatalog will create a catalog from an input, labeled, and noise images.

For more information, please run any of the following commands. In particular the second contains a very comprehensive explanation of MakeCatalog's invocation: expected input(s), output(s), and a full description of all the options.

All options and their values:
$ astmkcatalog -P
Inputs/Outputs and options:
$ info astmkcatalog
Full section in manual/book:
$ info MakeCatalog
Full Gnuastro manual/book:
$ 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

MakeCatalog options:

Clump labels extension name or number.
-h, --hdu=STR/INT
Extension name or number of input data.
-l, --clumpsfile=STR
Dataset containing clump labels.
-s, --insky=STR/FLT
Input Sky value or dataset.
Sky image extension name or number.
Sky STD extension name or number.
Subtract the Sky dataset from the values.
-t, --instd=STR/FLT
Sky standard deviation value or dataset.
-v, --valuesfile=STR
Values/brightness dataset.
Name or number of extension containing values.
STD input dataset is actually variance.
Zeropoint magnitude of input dataset.
Tessellation (tile grid):
Tile IDs in an image, the size of input.
-F, --remainderfrac=FLT
Fraction of remainder to split last tile.

-M, --numchannels=INT[,..] No. of channels in dim.s (FITS order).

Display 1 element/tile, not full input res.
-Z, --tilesize=INT[,INT]
Regular tile size on dim.s (FITS order).
-C, --clumpscat
Make a clumps catalog also.
-D, --dontdelete
Don't delete output if it exists.
-K, --keepinputdir
Keep input directory for automatic output.
Don't sort the clumps catalog by ID.
-o, --output=STR
Output file name.
Surface brightness area (in arcseconds^2).
Surface brightness multiple of Sky STD.
Table format: `fits-ascii', `fits-binary'.
Upper limit magnitude settings:

--checkuplim=INT[,INT] Check random distribution for one label.

-e, --envseed
Use GSL_RNG_SEED environment variable for seed.
Mask image file name only for upper limit.
Mask image HDU only for upper limit.
Multiple of sigma to define upperlimit.
Number of randomly positioned samples
Range of random positions (pix) around target.
Sigma multiple and, tolerance or number.
Identifier columns
-i, --ids
All IDs of objects and clumps.
ID of clump in host object.
-j, --hostobjid
ID of object hosting this clump.
Object label/ID.
Positional columns (pixel)
Geometric center of all clumps in obj. (X).
Geometric center of all clumps in obj. (Y).
Flux.wht center of all clumps in obj. (X).
Flux.wht center of all clumps in obj. (Y).
Geometric center in first FITS axis.
Geometric center in second FITS axis.
Maximum first FITS axis position.
Maximum second FITS axis position.
Minimum first FITS axis position.
Minimum second FITS axis position.
-x, --x
Flux weighted center in first FITS axis.
-y, --y
Flux weighted center in second FITS axis.
Positional columns (WCS)
Geometric center of all clumps in 1st WCS.
Geometric center of all clumps in 2nd WCS.
Flux.wht center of all clumps in 1st WCS.
Flux.wht center of all clumps in 2nd WCS.
-d, --dec
Flux weighted center declination.
Geometric center in first WCS axis.
Geometric center in second WCS axis.
-r, --ra
Flux weighted center right ascension.
Flux weighted center in first WCS axis.
Flux weighted center in second WCS axis.
Brightness/magnitude related columns
-b, --brightness
Brightness (sum of pixel values).
Error (1-sigma) in measuring brightness.
Sky (not river) subtracted clump brightness.
Brightness of clumps in an object.
Magnitude of all clumps in object.
-G, --magnitudeerr
Magnitude error of objects or clumps.
Mean of values in object/clump.
Median of values in object/clump.
-m, --magnitude
Total magnitude of objects or clumps.
-n, --sn
Signal to noise ratio of objects or clumps.
Average river value surrounding a clump.
Number of river pixels around a clump.
Average Sky value under this clump or object.
Average Sky standard deviation under label.
Upper-limit value, use other options to config.
-u, --upperlimitmag
Upper-limit mag. use other options to config.
Upper-limit one sigma value.
Quantile in random distribution (max 1).
Place in random distribution (sigma multiple).
(Mean-Median)/STD of random distribution.
Morphology/shape related columns
-a, --area
Number of non-blank valued pixels.
-A, --semimajor
Flux weighted semi-major axis.
-B, --semiminor
Flux weighted semi-minor axis.
-c, --numclumps
Number of clumps in this object.
Non-blank area covered by clumps.
Area labled region (irrespective of value).
Geometric axis ratio.
Geometric position angle.
Geometric semi-major axis.
Geometric semi-minor axis.
-p, --positionangle
Flux weighted position angle.
-Q, --axisratio
Flux weighted axis ratio.
Area used for value weighted positions.
Operating modes:
-?, --help
give this help list
BibTeX citation for this program.
Read configuration file STR immediately.
Do not parse any more configuration files.
Minimum bytes in array to not use ram RAM.
-N, --numthreads=INT
Number of CPU threads to use.
Only run if the program version is STR.
-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.
give a short usage message
-U, --setusrconf
Set default values for this user and abort.
-V, --version
print program version

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

GNU Astronomy Utilities home page:


Report bugs to


Copyright © 2015-2018, 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.

Written/developed by Mohammad Akhlaghi


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

should give you access to the complete manual.

December 2018 GNU Astronomy Utilities 0.8