Provided by: gnuastro_0.22-3.1build2_amd64 
NAME
MakeCatalog - Make a catalog from labeled input images
SYNOPSIS
astmkcatalog [OPTION...] ASTRdata
DESCRIPTION
MakeCatalog is part of GNU Astronomy Utilities 0.22. 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:
Input:
--clumpshdu=STR
Clump labels extension name or number.
--forcereadstd
Read STD even if no columns need it.
-h, --hdu=STR/INT
Extension name or number of input data.
-l, --clumpsfile=FITS
Dataset containing clump labels.
--sigmaclip=FLT,FLT
Sigma-clip column multiple and tolerance.
--skyhdu=STR
Sky image extension name or number.
--stdhdu=STR
Sky STD extension name or number.
--subtractsky
Subtract the Sky dataset from the values.
-s, --insky=FITS/FLT
Input Sky value or file.
-t, --instd=STR/FLT
Sky standard deviation value or dataset.
--valueshdu=STR
Name or number of extension containing values.
--variance
STD input dataset is actually variance.
-v, --valuesfile=FITS
Values/brightness dataset.
--zeropoint=FLT
Zeropoint magnitude of input dataset.
Tessellation (tile grid):
--checktiles
Tile IDs in an image, the size of input.
-F, --remainderfrac=FLT
Fraction of remainder to split last tile.
--interpmetric=STR
Interpolation metric (radial, manhattan).
-M, --numchannels=INT[,..] No. of channels in dim.s (FITS order).
--oneelempertile
Display 1 element/tile, not full input res.
-Z, --tilesize=INT[,INT]
Regular tile size on dim.s (FITS order).
Output:
-C, --clumpscat
Make a clumps catalog also.
-D, --dontdelete
Don't delete output if it exists.
--inbetweenints
Keep rows (integer ids) with no labels.
-K, --keepinputdir
Keep input directory for automatic output.
--noclumpsort
Don't sort the clumps catalog by ID.
--outfitsnocommit
No Git commit in 0-th HDU of output FITS.
--outfitsnoconfig
No metadata in 0-th HDU of output FITS.
--outfitsnodate
No 'DATE' in 0-th HDU of output FITS.
--outfitsnoversions
No versions in 0-th HDU of output FITS.
-o, --output=STR
Output file name.
--sfmagarea=FLT
Surface brightness area (in arcseconds^2).
--sfmagnsigma=FLT
Surface brightness multiple of Sky STD.
--tableformat=STR
Table fmt: 'fits-ascii', 'fits-binary', 'txt'.
--wcslinearmatrix=STR
WCS linear matrix of output ('pc' or 'cd').
Upper limit magnitude settings:
--checkuplim=INT[,INT] Check random distribution for one label.
-e, --envseed
Use GSL_RNG_SEED environment variable for seed.
--upmaskfile=FITS
Mask image file name only for upper limit.
--upmaskhdu=STR
Mask image HDU only for upper limit.
--upnsigma=FLT
Multiple of sigma to define upperlimit.
--upnum=INT
Number of randomly positioned samples
--uprange=INT,INT
Range of random positions (pix) around target.
--upsigmaclip=FLT,FLT
Sigma multiple and, tolerance or number.
Settings for other columns:
--frac-max=FLT[,FLT]
Fraction(s) in --frac-max* options.
--spatialresolution=FLT
Spatial resolution (for surf. brightness err).
Identifier columns
--id-in-host-obj
ID of clump in host object.
-i, --ids
All IDs of objects and clumps.
-j, --host-obj-id
ID of object hosting this clump.
--obj-id
Object label/ID.
Positional (pixel/image) measurements
--area-max-val
Number of pixels used in '--max-val-*'.
--area-min-val
Number of pixels used in '--min-val-*'.
--clumps-geo-x
Geometric center of all clumps in obj. (X).
--clumps-geo-y
Geometric center of all clumps in obj. (Y).
--clumps-geo-z
Geometric center of all clumps in obj. (Z).
--clumps-x
Flux.wht center of all clumps in obj. (X).
--clumps-y
Flux.wht center of all clumps in obj. (Y).
--clumps-z
Flux.wht center of all clumps in obj. (Z).
--geo-x
Geometric center in first FITS axis.
--geo-y
Geometric center in second FITS axis.
--geo-z
Geometric center in third FITS axis.
--max-val-x
Maximum value's X axis position.
--max-val-y
Maximum value's Y axis position.
--max-val-z
Maximum value's Z axis position
--max-x
Maximum X axis position.
--max-y
Maximum Y axis position.
--max-z
Maximum Z axis position.
--min-val-x
Minimum value's X axis position.
--min-val-y
Minimum value's Y axis position.
--min-val-z
Minimum value's Z axis position.
--min-x
Minimum X axis position.
--min-y
Minimum Y axis position.
--min-z
Minimum Z axis position
-x, --x
Flux weighted center in first FITS axis.
-y, --y
Flux weighted center in second FITS axis.
-z, --z
Flux weighted center in third FITS axis.
Positional (WCS) measurements
--clumps-geo-w1
Geometric center of all clumps in 1st WCS.
--clumps-geo-w2
Geometric center of all clumps in 2nd WCS.
--clumps-geo-w3
Geometric center of all clumps in 3rd WCS.
--clumps-w1
Flux.wht center of all clumps in 1st WCS.
--clumps-w2
Flux.wht center of all clumps in 2nd WCS.
--clumps-w3
Flux.wht center of all clumps in 3rd WCS.
-d, --dec
Flux weighted center declination.
--geo-w1
Geometric center in first WCS axis.
--geo-w2
Geometric center in second WCS axis.
--geo-w3
Geometric center in third WCS axis.
-r, --ra
Flux weighted center right ascension.
--w1 Flux weighted center in first WCS axis.
--w2 Flux weighted center in second WCS axis.
--w3 Flux weighted center in third WCS axis.
Brightness/magnitude (only using pixel value/error) measurements
--clumps-magnitude
Magnitude of all clumps in object.
--clumps-sum
Brightness of clumps in an object.
--magnitude-error
Magnitude error of objects or clumps.
--maximum
Maximum value (mean of top three pixels)
--mean Mean of values in object/clump.
--median
Median of values in object/clump.
-m, --magnitude
Total magnitude of objects or clumps.
--river-max
Maximum river value around clump.
--river-mean
Mean river value surrounding a clump.
--river-min
Minimum river value around clump.
--river-num
Number of river pixels around a clump.
--sigclip-mean
Mean after Sigma-clipping
--sigclip-median
Median after Sigma-clipping
--sigclip-number
Number of pixels in Sigma-clipped measurement.
--sigclip-std
Standard deviation after Sigma-clipping
--sky Sky value (per pixel).
--sky-std
Sky standard deviation (per pixel).
--sn Signal to noise ratio of objects or clumps.
--std Standard dev. of values in object/clump.
--sum Sum of pixel values in each label.
--sum-error
Error (1-sigma) in measuring sum.
--sum-no-river
Sky (not river) subtracted clump sum.
--upperlimit
Upper-limit value, use other options to config.
--upperlimit-mag
Upper-limit mag. use other options to config.
--upperlimit-onesigma
Upper-limit one sigma value.
--upperlimit-quantile
Quantile in random distribution (max 1).
--upperlimit-sigma
Place in random distribution (sigma multiple).
--upperlimit-skew
(Mean-Median)/STD of random distribution.
Surface brightness measurements (all: mag/arcsec^2)
--half-max-sb
Surface brightness within half the maximum.
--half-sum-sb
Surface brightness within --halfsumarea.
--sb Surface brightness.
--sb-error
Surface brightness error from STD/VAR image.
--sigclip-mean-sb
Surface brightness of sigclip-mean (1 pix area).
--sigclip-mean-sb-delta
sigclip-mean-sb delta from sigclip'd STD.
--sigclip-std-sb
Surface brightness of sigclip-std (1 pix area).
--upperlimit-sb
Upper-limit surface brightness.
Morphology/shape (non-parametric) measurements
--area Number of non-blank valued pixels.
--area-arcsec2
Area of labeled region in arcsec^2.
--area-xy
Projected area in first two dimensions.
--clumps-area
Non-blank area covered by clumps.
--frac-max1-area
Area containing 1st fraction of maximum.
--frac-max1-radius
Radius calculated from --fracmaxarea1.
--frac-max1-sum
Sum of pixels brighter than 1st frac. of max.
--frac-max2-area
Area containing 2nd fraction of maximum.
--frac-max2-radius
Radius calculated from --fracmaxarea2.
--frac-max2-sum
Sum of pixels brighter than 2nd frac. of max.
--fwhm Full width at half max (non-parametric).
--geo-area
Area labled region (irrespective of value).
--geo-area-xy
Projected geo-area in first two dimensions.
--half-max-area
No. pixels valued above half the max.
--half-max-radius
Radius at half the maximum (non-parametric).
--half-max-sum
Sum of pixels above half the maximum.
--half-sum-area
Area containing half of --brightness.
--half-sum-radius
Radius calculated from --halfsumarea.
--num-clumps
Number of clumps in this object.
--weight-area
Area used for value weighted positions.
Morphology/shape (elliptical) measurements
--axis-ratio
Flux weighted axis ratio.
--geo-axis-ratio
Geometric (ignoring values, only lab) axis ratio.
--geo-position-angle
Geometric (ignoring values, only lab) pos. angle.
--geo-semi-major
Geometric RMS along major axis (ignoring value).
--geo-semi-minor
Geometric RMS along minor axis (ignoring value).
--position-angle
Flux weighted position angle.
--semi-major
RMS along major axis (in pixels).
--semi-minor
RMS along minor axis (in pixels).
Vector (multi-valued) measurements
--area-in-slice
[3D input] Number of labeled in each slice.
--area-other-in-slice
[3D input] Area of other lab. in projected area.
--area-proj-in-slice
[3D input] Num. voxels in '--sum-proj-in-slice'.
--sum-err-in-slice
[3D input] Error in '--sum-in-slice'.
--sum-in-slice
[3D input] Sum of values in each slice.
--sum-other-err-in-slice
[3D input] Area in '--sum-other-in-slice'.
--sum-other-in-slice
[3D input] Sum of other lab. in projected area.
--sum-proj-err-in-slice
[3D input] Error of '--sum-proj-in-slice'.
--sum-proj-in-slice
[3D input] Sum of projected area in each slice.
Operating modes:
-?, --help
give this help list
--checkconfig
List all config files and variables read.
--cite BibTeX citation for this program.
--config=STR
Read configuration file STR immediately.
--config-prefix=STR
Custom prefix of option names config files.
--lastconfig
Do not parse any more configuration files.
--minmapsize=INT
Min. bytes to avoid RAM automatically.
-N, --numthreads=INT
Number of CPU threads to use.
--onlyversion=STR
Only run if the program version is STR.
-P, --printparams
Print parameter values to be used and abort.
--quietmmap
Don't print mmap'd file's name and size.
-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
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/
REPORTING BUGS
Report bugs to bug-gnuastro@gnu.org.
COPYRIGHT
Copyright © 2015-2024 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
SEE ALSO
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.
GNU Astronomy Utilities 0.22 February 2024 MAKECATALOG(1)